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

Set-CimInstance コマンドレットは、CIM サーバー上の CIM インスタンスを変更します。

InputObject パラメーターが指定されていない場合、コマンドレットは次のいずれかの方法で動作します。

• ComputerName パラメーターも CimSession パラメーターも指定されていない場合、このコマンドレットはコンポーネント オブジェクト モデル (COM) セッションを使用してローカル Windows Management Instrumentation (WMI) で動作します。
• ComputerName パラメーターまたは CimSession パラメーターが指定されている場合、このコマンドレットは ComputerName パラメーターまたは CimSession パラメーターで指定された CIM サーバーに対して動作します。

InputObject パラメーターが指定されている場合、コマンドレットは次のいずれかの方法で動作します。

• ComputerName パラメーターも CimSession パラメーターも指定されていない場合、このコマンドレットは入力オブジェクトの CIM セッションまたはコンピューター名を使用します。
• ComputerName パラメーターまたは CimSession パラメーターが指定されている場合、このコマンドレットは CimSession パラメーター値または ComputerName パラメーター値を使用します。 注:これはあまり一般的ではありません。

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

このコマンドは、Query パラメータを使用して、VariableValue プロパティの値を abcd に設定します。 Windows Management Instrumentation Query Language (WQL) クエリに一致するインスタンスを変更できます。

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

このコマンドは、Get-CimInstance コマンドレットを使用して Query パラメータでフィルタされた CIM インスタンス オブジェクトを取得し、そのオブジェクトを Set-CimInstance コマンドレットに渡します。 コマンドレットによって VariableValue プロパティの値が abcd に変更されます。

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

この一連のコマンドは、Query パラメーターでフィルター処理された CIM インスタンス オブジェクトを Get-CimInstance を使用して変数 ($x) に取得し、変数の内容を Set-CimInstance コマンドレットに渡します。 次に、Set-CimInstance VariableValue プロパティを somevalue に変更します。 Passthru パラメーターが使用されるため、このコマンド・セットは変更された CIM インスタンス・オブジェクトを戻します。

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

この一連のコマンドは、Query パラメーターで指定された CIM インスタンス オブジェクトを Get-CimInstance コマンドレットを使用して変数 ($x) に取得し、オブジェクトの VariableValue プロパティ値を変更対象に変更します。 その後、CIM インスタンス オブジェクトは Set-CimInstance コマンドレットを使用して保存されます。 Passthru パラメーターが使用されるため、このコマンド・セットは変更された CIM インスタンス・オブジェクトを戻します。

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

このコマンドは、共通パラメータ WhatIf を使用して、変更を行わず、変更を行った場合に何が起こるかのみを出力するように指定します。

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

このコマンドは、共通パラメータ Confirm を使用して、ユーザーからの確認後にのみ変更を行うように指定します。

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

この一連のコマンドは、New-CimInstance コマンドレットを使用して、指定されたプロパティを持つ CIM インスタンスを作成し、その内容を変数 ($x) に取得します。 その後、変数は Set-CimInstance コマンドレットに渡され、VariableValue プロパティの値が何らかの値に変更されます。 Passthru パラメーターが使用されるため、このコマンド・セットは変更された CIM インスタンス・オブジェクトを戻します。

このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。

Passthru パラメーターを指定すると、このコマンドレットは変更された CIM インスタンス オブジェクトを返します。