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>]

O cmdlet Set-CimInstance modifica uma instância do CIM em um servidor CIM.

Se o parâmetro InputObject não for especificado, o cmdlet funcionará de uma das seguintes maneiras:

• Se nem o parâmetro ComputerName nem o parâmetro CimSession forem especificados, esse cmdlet funcionará no WMI (Instrumentação de Gerenciamento do Windows) local usando uma sessão COM (Component Object Model).
• Se o parâmetro ComputerName ou o parâmetro CimSession for especificado, esse cmdlet funcionará no servidor CIM especificado pelo parâmetro ComputerName ou pelo parâmetro CimSession.

Se o parâmetro InputObject for especificado, o cmdlet funcionará de uma das seguintes maneiras:

• Se nem o parâmetro ComputerName nem o parâmetro CimSession forem especificados, esse cmdlet usará a sessão CIM ou o nome do computador do objeto de entrada.
• Se o parâmetro ComputerName ou o parâmetro CimSession for especificado, esse cmdlet usará o valor do parâmetro CimSession ou o valor do parâmetro ComputerName. Nota: Isto não é muito comum.

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

Este comando define o valor da propriedade VariableValue como abcd usando o parâmetro Query. Você pode modificar instâncias correspondentes a uma consulta WQL (Linguagem de Consulta da Instrumentação de Gerenciamento do Windows).

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

Este comando recupera o objeto de instância do CIM filtrado pelo parâmetro Query usando o cmdlet Get-CimInstance e, em seguida, passa os objetos para o cmdlet Set-CimInstance, que modifica o valor da propriedade VariableValue para abcd.

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

Esse conjunto de comandos recupera os objetos de instância do CIM filtrados pelo parâmetro Query em uma variável ($x) usando Get-CimInstance e, em seguida, passa o conteúdo da variável para o cmdlet Set-CimInstance. Set-CimInstance então modifica a propriedade VariableValue para somevalue. Como o parâmetro Passthru é usado, esse conjunto de comandos retorna um objeto de instância CIM modificado.

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

Esse conjunto de comandos recupera o objeto de instância do CIM especificado no parâmetro Query em uma variável ($x) usando o cmdlet Get-CimInstance e altera o valor da propriedade VariableValue do objeto a ser alterado. O objeto de instância do CIM é salvo usando o cmdlet Set-CimInstance. Como o parâmetro Passthru é usado, esse conjunto de comandos retorna um objeto de instância CIM modificado.

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

Este comando usa o parâmetro comum WhatIf para especificar que a modificação não deve ser feita, mas apenas o que aconteceria se fosse feita.

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

Este comando usa o parâmetro comum Confirm para especificar que a modificação deve ser feita somente após a confirmação do usuário.

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

Esse conjunto de comandos cria uma instância do CIM com as propriedades especificadas usando o cmdlet New-CimInstance e recupera seu conteúdo em uma variável ($x). Em seguida, a variável é passada para o cmdlet Set-CimInstance, que modifica o valor da propriedade VariableValue para algum valor. Como o parâmetro Passthru é usado, esse conjunto de comandos retorna um objeto de instância CIM modificado.

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Quando o parâmetro Passthru é especificado, esse cmdlet retorna um objeto de instância CIM modificado.