Set-CimInstance

Syntax

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

Beschreibung

Dieses Cmdlet ist nur auf der Windows-Plattform verfügbar.

Dieses Cmdlet ä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 InputObject-Parameter angegeben ist, funktioniert das Cmdlet auf eine der folgenden Arten:

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

Beispiele

Beispiel 1: Festlegen der CIM-Instanz

In diesem Beispiel 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.

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

Beispiel 2: Festlegen der CIM-Instanzeigenschaft mithilfe der Pipeline

In diesem Beispiel wird das CIM-Instanzobjekt abgerufen, das mithilfe des Get-CimInstance Cmdlets vom Query-Parameter gefiltert wird. Das Set-CimInstance Cmdlet ändert den Wert der VariableValue-Eigenschaft in abcd.

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

Beispiel 3: Festlegen der CIM-Instanzeigenschaft mithilfe des Eingabeobjekts

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

In diesem Beispiel werden die CIM-Instanzobjekte abgerufen, die vom Query-Parameter in eine Variable $x gefiltert Get-CimInstancewerden. Anschließend wird der Inhalt der Variablen an das Set-CimInstance Cmdlet übergeben. Set-CimInstance ändert dann die VariableValue-Eigenschaft in einen gewissen Wert. Da der PassThru-Parameter verwendet wird, gibt dieses Beispiel ein geändertes CIM-Instanzobjekt zurück.

Beispiel 4: Festlegen der CIM-Instanzeigenschaft

In diesem Beispiel wird das CIM-Instanzobjekt abgerufen, das im Query-Parameter angegeben ist, in eine Variable mithilfe des Cmdlets, und ändert den VariableValue-Eigenschaftswert des zu ändernden Objekts.This example retrieves the CIM instance object that is specified in a variable $x using the Get-CimInstance cmdlet, and changes the VariableValue property value of the object to change. Das CIM-Instanzobjekt wird dann mithilfe des Set-CimInstance Cmdlets gespeichert. Da der PassThru-Parameter verwendet wird, gibt dieses Beispiel 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

Beispiel 5: Anzeigen der Liste der CIM-Instanzen zum Ändern mithilfe von WhatIf

In diesem Beispiel wird der allgemeine Parameter WhatIf verwendet, um anzugeben, dass die Änderung nicht durchgeführt werden soll, sondern nur ausgeben, was passiert, wenn dies geschehen würde.

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

Beispiel 6: Festlegen der CIM-Instanz nach bestätigung des Benutzers

In diesem Beispiel wird der allgemeine Parameter Confirm verwendet, um anzugeben, dass die Änderung erst nach der Bestätigung des Benutzers erfolgen soll.

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

Beispiel 7: Festlegen der erstellten CIM-Instanz

In diesem Beispiel wird eine CIM-Instanz mit den angegebenen Eigenschaften mithilfe des New-CimInstance Cmdlets erstellt und deren Inhalt in einer Variablen $xabgerufen. Die Variable wird dann an das Set-CimInstance Cmdlet übergeben, das den Wert der VariableValue-Eigenschaft in einen bestimmten Wert ändert. Da der PassThru-Parameter verwendet wird, gibt dieses Beispiel ein geändertes CIM-Instanzobjekt zurück.

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

Parameter

-CimSession

-ComputerName

-Confirm

-InputObject

-Namespace

-OperationTimeoutSec

-PassThru

-Property

-Query

-QueryDialect

-ResourceUri

-WhatIf

Eingaben

CimInstance

Ausgaben

None

Standardmäßig gibt dieses Cmdlet keine Ausgabe zurück.

CimInstance

Wenn Sie den PassThru-Parameter verwenden, gibt dieses Cmdlet das geänderte CIM-Instanzobjekt zurück.

Hinweise

PowerShell enthält die folgenden Aliase für Set-CimInstance:

• Windows:
  • scim

Dieses Cmdlet ist nur auf Windows-Plattformen verfügbar.

Ähnliche Themen

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