Set-CimInstance

Sintaxe

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

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

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

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

Description

Este cmdlet só está disponível na plataforma Windows.

Este cmdlet 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. Isso não é muito comum.

Exemplos

Exemplo 1: Definir a instância do CIM

Este exemplo 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).

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

Exemplo 2: Definir a propriedade da instância do CIM usando pipeline

Este exemplo recupera o objeto de instância CIM filtrado pelo parâmetro Query usando o Get-CimInstance cmdlet. O Set-CimInstance cmdlet modifica o valor da propriedade VariableValue para abcd.

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

Exemplo 3: Definir a propriedade da instância do CIM usando o objeto de entrada

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

Este exemplo recupera os objetos de instância do CIM filtrados pelo parâmetro Query para uma variável $x usando Get-CimInstanceo , e passa o conteúdo da variável para o Set-CimInstance cmdlet. Set-CimInstance em seguida, modifica a propriedade VariableValue para somevalue. Como o parâmetro PassThru é usado, Este exemplo retorna um objeto de instância CIM modificado.

Exemplo 4: Definir a propriedade da instância do CIM

Este exemplo recupera o objeto de instância CIM especificado no parâmetro Query em uma variável $x usando o Get-CimInstance cmdlet e altera o valor da propriedade VariableValue do objeto a ser alterado. O objeto de instância do CIM é salvo usando o Set-CimInstance cmdlet. Como o parâmetro PassThru é usado, Este exemplo 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

Exemplo 5: Mostrar a lista de instâncias CIM a serem modificadas usando WhatIf

Este exemplo 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"} -WhatIf

Exemplo 6: Definir a instância CIM após a confirmação do usuário

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

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

Exemplo 7: Definir a instância CIM criada

Este exemplo cria uma instância do CIM com as propriedades especificadas usando o New-CimInstance cmdlet e recupera seu conteúdo em uma variável $x. A variável é então passada para o Set-CimInstance cmdlet, que modifica o valor da propriedade VariableValue para somevalue. Como o parâmetro PassThru é usado, Este exemplo retorna um objeto de instância CIM modificado.

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

Parâmetros

-CimSession

-ComputerName

-Confirm

-InputObject

-Namespace

-OperationTimeoutSec

-PassThru

-Property

-Query

-QueryDialect

-ResourceUri

-WhatIf

Entradas

CimInstance

Saídas

None

Por padrão, esse cmdlet não retorna nenhuma saída.

CimInstance

Quando você usa o parâmetro PassThru , esse cmdlet retorna o objeto de instância CIM modificado.

Notas

O PowerShell inclui os seguintes aliases para Set-CimInstance:

• Windows:
  • scim

Este cmdlet só está disponível em plataformas Windows.

Ligações Relacionadas

• Get-CimInstance
• New-CimInstance
• Remove-CimInstance