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

Polecenie cmdlet Set-CimInstance modyfikuje wystąpienie modelu CIM na serwerze CIM.

Jeśli nie określono parametru InputObject, polecenie cmdlet działa w jeden z następujących sposobów:

• Jeśli nie określono parametru ComputerName ani parametru CimSession, to polecenie cmdlet działa w lokalnej instrumentacji zarządzania Windows (WMI) przy użyciu sesji modelu obiektów składników (COM).
• Jeśli określono parametr ComputerName lub parametr CimSession, to polecenie cmdlet działa względem serwera CIM określonego przez parametr ComputerName lub cimSession parametru.

Jeśli określono parametr InputObject, polecenie cmdlet działa na jeden z następujących sposobów:

• Jeśli nie określono ani parametru ComputerName, ani parametru CimSession, to to polecenie cmdlet używa sesji modelu ciM lub nazwy komputera z obiektu wejściowego.
• Jeśli określono parametr ComputerName lub CimSession, to to polecenie cmdlet używa wartości parametru CimSession lub Wartości parametru ComputerName. Uwaga: nie jest to bardzo powszechne.

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

To polecenie ustawia wartość właściwości VariableValue na abcd przy użyciu parametru Query. Wystąpienia pasujące do zapytania Języka zapytań instrumentacji zarządzania Windows (WQL) można modyfikować.

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

To polecenie pobiera obiekt wystąpienia modelu CIM filtrowany przez parametr Query przy użyciu polecenia cmdlet Get-CimInstance, a następnie przekazuje obiekty do polecenia cmdlet Set-CimInstance, które modyfikuje wartość właściwości VariableValue na abcd.

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

Ten zestaw poleceń pobiera obiekty wystąpień modelu CIM filtrowane przez parametr Query w zmiennej ($x) przy użyciu polecenia Get-CimInstance, a następnie przekazuje zawartość zmiennej do polecenia cmdlet Set-CimInstance. Set-CimInstance następnie modyfikuje właściwość VariableValue na wartość somevalue. Ponieważ jest używany parametr Passthru, ten zestaw poleceń zwraca zmodyfikowany obiekt wystąpienia MODELU CIM.

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

Ten zestaw poleceń pobiera obiekt wystąpienia modelu CIM określony w parametrze Query do zmiennej ($x) przy użyciu polecenia cmdlet Get-CimInstance i zmienia wartość właściwości VariableValue obiektu w celu zmiany. Następnie obiekt wystąpienia modelu CIM jest zapisywany przy użyciu polecenia cmdlet Set-CimInstance. Ponieważ jest używany parametr Passthru, ten zestaw poleceń zwraca zmodyfikowany obiekt wystąpienia MODELU CIM.

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

To polecenie używa wspólnego parametru WhatIf, aby określić, że modyfikacja nie powinna być wykonywana, ale tylko dane wyjściowe, co by się stało, gdyby zostało wykonane.

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

To polecenie używa wspólnego parametru Potwierdź, aby określić, że modyfikacja powinna być wykonywana dopiero po potwierdzeniu od użytkownika.

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

Ten zestaw poleceń tworzy wystąpienie modelu CIM z określonymi właściwościami przy użyciu polecenia cmdlet New-CimInstance i pobiera jego zawartość do zmiennej ($x). Zmienna jest następnie przekazywana do polecenia cmdlet Set-CimInstance, które modyfikuje wartość właściwości VariableValue na pewną wartość. Ponieważ jest używany parametr Passthru, ten zestaw poleceń zwraca zmodyfikowany obiekt wystąpienia MODELU CIM.

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

Po określeniu parametru Passthru to polecenie cmdlet zwraca zmodyfikowany obiekt wystąpienia modelu CIM.