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

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

Dieses Cmdlet ändert eine CIM-Instanz auf einem CIM-Server.

Wenn der parameter InputObject 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 lokale Windows-Verwaltungsinstrumentation (Windows Management Instrumentation, WMI).
• Wenn entweder der Parameter ComputerName oder der Parameter CimSession angegeben ist, funktioniert dieses Cmdlet mit dem CIM-Server, der durch entweder den Parameter ComputerName oder CimSession 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 wird, verwendet dieses Cmdlet den CIM-Sitzungs- oder Computernamen aus dem Eingabeobjekt.
• Wenn entweder der Parameter ComputerName oder der Parameter CimSession angegeben wird, dann verwendet dieses Cmdlet entweder den Wert des Parameters CimSession oder den Wert des Parameters ComputerName. Dies ist nicht sehr häufig.

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.

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

In diesem Beispiel wird das CIM-Instanzobjekt abgerufen, das mithilfe des 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"}

$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.

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

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.

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

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

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

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.

$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

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.

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

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

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

• Fenster:
  • scim

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