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

Das Cmdlet Set-CimInstance ändert eine CIM-Instanz auf einem CIM-Server.

Wenn der InputObject-Parameter nicht angegeben ist, funktioniert das Cmdlet auf eine der folgenden Arten:

• Wenn weder der Parameter ComputerName noch der CimSession-Parameter angegeben ist, funktioniert dieses Cmdlet unter Verwendung einer COM-Sitzung (Component Object Model) für die lokale Windows-Verwaltungsinstrumentation (Windows Management Instrumentation, WMI).
• Wenn entweder der Parameter ComputerName oder der CimSession-Parameter angegeben ist, funktioniert dieses Cmdlet mit dem CIM-Server, der entweder durch den ComputerName-Parameter oder den CimSession-Parameter angegeben wird.

Wenn der Parameter InputObject angegeben ist, funktioniert das Cmdlet auf eine der folgenden Arten:

• Wenn weder der ComputerName-Parameter noch der CimSession-Parameter angegeben ist, verwendet dieses Cmdlet die CIM-Sitzung oder den Computernamen aus dem Eingabeobjekt.
• Wenn der Parameter ComputerName oder CimSession angegeben ist, verwendet dieses Cmdlet entweder den Parameterwert CimSession oder den Parameterwert ComputerName. Hinweis: Dies ist nicht sehr häufig.

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

Mit diesem Befehl wird der Wert der VariableValue-Eigenschaft mithilfe des Query-Parameters auf abcd festgelegt. Sie können Instanzen ändern, die einer Abfrage der Windows-Verwaltungsinstrumentationsabfrage (Windows Management Instrumentation Query Language, WQL) entsprechen.

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

Mit diesem Befehl wird das CIM-Instanzobjekt abgerufen, das mit dem Query-Parameter mithilfe des Cmdlets Get-CimInstance gefiltert wurde, und dann die Objekte an das Cmdlet Set-CimInstance übergeben, das den Wert der VariableValue-Eigenschaft in abcd ändert.

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

Dieser Satz von Befehlen ruft die CIM-Instanzobjekte, die durch den Query-Parameter gefiltert wurden, mithilfe von Get-CimInstance in eine Variable ($x) ab und übergibt dann den Inhalt der Variablen an das Cmdlet Set-CimInstance. Set-CimInstance ändert dann die VariableValue-Eigenschaft in somevalue. Da der Passthru-Parameter verwendet wird, gibt dieser Befehlssatz ein geändertes CIM-Instanzobjekt zurück.

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

Mit diesem Befehlssatz wird das CIM-Instanzobjekt, das im Query-Parameter angegeben ist, mithilfe des Cmdlets Get-CimInstance in eine Variable ($x) abgerufen und der VariableValue-Eigenschaftswert des Objekts geändert. Das CIM-Instanzobjekt wird dann mit dem Cmdlet Set-CimInstance gespeichert. Da der Passthru-Parameter verwendet wird, gibt dieser Befehlssatz ein geändertes CIM-Instanzobjekt zurück.

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

Dieser Befehl verwendet den allgemeinen Parameter WhatIf, um anzugeben, dass die Änderung nicht vorgenommen werden soll, sondern nur ausgegeben werden soll, was passieren würde, wenn sie durchgeführt würde.

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

Dieser Befehl verwendet den allgemeinen Parameter Confirmation, um anzugeben, dass die Änderung erst nach Bestätigung durch den Benutzer vorgenommen werden soll.

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

Mit diesem Befehlssatz wird mithilfe des Cmdlets New-CimInstance eine CIM-Instanz mit den angegebenen Eigenschaften erstellt und der Inhalt in einer Variablen ($x) abgerufen. Die Variable wird dann an das Cmdlet Set-CimInstance übergeben, das den Wert der VariableValue-Eigenschaft in einen beliebigen Wert ändert. Da der Passthru-Parameter verwendet wird, gibt dieser Befehlssatz ein geändertes CIM-Instanzobjekt zurück.

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Wenn der Passthru-Parameter angegeben wird, gibt dieses Cmdlet ein geändertes CIM-Instanzobjekt zurück.