Set-CimInstance

Set-CimInstance
    [-InputObject] <CimInstance>
    [-ComputerName <String[]>]
    [-ResourceUri <Uri>]
    [-OperationTimeoutSec <UInt32>]
    [-Property <IDictionary>]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Set-CimInstance
    [-InputObject] <CimInstance>
    -CimSession <CimSession[]>
    [-ResourceUri <Uri>]
    [-OperationTimeoutSec <UInt32>]
    [-Property <IDictionary>]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Set-CimInstance
    [-Query] <String>
    -CimSession <CimSession[]>
    -Property <IDictionary>
    [-Namespace <String>]
    [-OperationTimeoutSec <UInt32>]
    [-QueryDialect <String>]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Set-CimInstance
    [-Query] <String>
    -Property <IDictionary>
    [-ComputerName <String[]>]
    [-Namespace <String>]
    [-OperationTimeoutSec <UInt32>]
    [-QueryDialect <String>]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Этот командлет доступен только на платформе Windows.

Этот командлет изменяет экземпляр CIM на сервере CIM.

Если параметр InputObject не указан, командлет работает одним из следующих способов:

• Если не указан ни параметр ComputerName, ни параметр CimSession, то этот командлет выполняется в локальном сеансе Windows Management Instrumentation (WMI) с помощью сеанса Component Object Model (COM).
• Если указан либо параметр ComputerName, либо параметр CimSession, тогда этот командлет работает с сервером CIM, заданным либо параметром ComputerName, либо параметром CimSession.

Если указан параметр InputObject, командлет работает одним из следующих способов:

• Если ни параметр ComputerName, ни параметр CimSession не указан, этот командлет использует сеанс CIM или имя компьютера из входного объекта.
• Если указан параметр ComputerName или параметр CimSession, этот командлет использует значение параметра CimSession или значение параметра ComputerName. Это не очень распространено.

В этом примере значение свойства VariableValue присваивается abcd с помощью параметра Query. Можно изменить экземпляры, соответствующие запросу языка запросов инструментария управления Windows (WQL).

$instance = @ {
    Query = 'Select * from Win32_Environment where name LIKE "testvar%"'
    Property = @{VariableValue="abcd"}
}
Set-CimInstance @instance

В этом примере извлекается объект экземпляра CIM, отфильтрованный параметром запроса с помощью командлета Get-CimInstance . Командлет Set-CimInstance изменяет значение свойства VariableValue на abcd.

Get-CimInstance -Query 'Select * from Win32_Environment where name LIKE "testvar%"' |
  Set-CimInstance -Property @{VariableValue="abcd"}

$x = Get-CimInstance -Query 'Select * from Win32_Environment where Name="testvar"'
Set-CimInstance -InputObject $x -Property @{VariableValue="somevalue"} -PassThru

В этом примере извлекаются объекты экземпляра CIM, отфильтрованные параметром запроса в переменную с помощью$x, а затем передает содержимое переменной Get-CimInstance командлетуSet-CimInstance. Set-CimInstance затем изменяет свойство VariableValue на некоторое значение. Так как используется параметр PassThru, в этом примере возвращается измененный объект экземпляра CIM.

В этом примере извлекается объект экземпляра CIM, указанный в параметре query , в переменную $x с помощью Get-CimInstance командлета, и изменяет значение свойства VariableValue объекта на изменение. Затем объект экземпляра CIM сохраняется с помощью командлета Set-CimInstance . Так как используется параметр PassThru, в этом примере возвращается измененный объект экземпляра CIM.

$x = Get-CimInstance -Query 'Select * from Win32_Environment where name="testvar"'
$x.VariableValue = "Change"
Set-CimInstance -CimInstance $x -PassThru

В этом примере используется общий параметр WhatIf , чтобы указать, что изменение не должно выполняться, но выводить только то, что произойдет, если это было сделано.

$instance = @{
    Query = 'Select * from Win32_Environment where name LIKE "testvar%"'
    Property = @{VariableValue="abcd"}
    WhatIf = $true
}
Set-CimInstance @instance

В этом примере используется общий параметр Confirm , чтобы указать, что изменение должно выполняться только после подтверждения от пользователя.

$instance = @{
    Query = 'Select * from Win32_Environment where name LIKE "testvar%"'
    Property = @{VariableValue="abcd"}
    Confirm = $true
}
Set-CimInstance @instance

В этом примере создается экземпляр CIM с указанными свойствами с помощью командлета New-CimInstance и извлекается его содержимое в переменную $x. Затем переменная передается командлету Set-CimInstance , который изменяет значение свойства VariableValue на некоторое значение. Так как используется параметр PassThru, в этом примере возвращается измененный объект экземпляра CIM.

$instance = @{
    ClassName = 'Win32_Environment'
    Property = @{
        Name="testvar"
        UserName="domain\user"
    }
    Key = 'Name', 'UserName'
    ClientOnly = $true
}
$x = New-CimInstance @instance
Set-CimInstance -CimInstance $x -Property @{VariableValue="somevalue"} -PassThru

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.

По умолчанию этот командлет не возвращает выходные данные.

При использовании параметра PassThru этот командлет возвращает измененный объект экземпляра CIM.

PowerShell включает следующие псевдонимы для Set-CimInstance:

• Виндоус:
  • scim

Этот командлет доступен только на платформах Windows.