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 cmdlet 修改 CIM 服务器上的 CIM 实例。

如果未指定 InputObject 参数，则 cmdlet 通过以下方式之一工作：

• 如果既未指定 ComputerName 参数，也没有指定 CimSession 参数，则此 cmdlet 使用组件对象模型 （COM） 会话在本地 Windows Management Instrumentation （WMI） 上运行。
• 如果指定了 ComputerName 参数或 CimSession 参数，则此 cmdlet 适用于由 ComputerName 参数或 CimSession 参数指定的 CIM 服务器。

如果指定了 InputObject 参数，则 cmdlet 通过以下方式之一工作：

• 如果既未指定 ComputerName 参数，也没有指定 CimSession 参数，则此 cmdlet 使用输入对象的 CIM 会话或计算机名称。
• 如果指定了 ComputerName 参数或 CimSession 参数，则此 cmdlet 使用 CimSession 参数值或 ComputerName 参数值。 注意：这不是很常见的。

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

此命令使用 Query 参数将 VariableValue 属性的值设置为 abcd。 可以修改与 Windows Management Instrumentation 查询语言（WQL）查询匹配的实例。

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

此命令使用 Get-CimInstance cmdlet 检索查询参数筛选的 CIM 实例对象，然后将对象传递给 Set-CimInstance cmdlet，该 cmdlet 将 VariableValue 属性的值修改为 abcd。

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

此命令集使用 Get-CimInstance 将查询参数筛选的 CIM 实例对象检索到变量（$x），然后将变量的内容传递给 Set-CimInstance cmdlet。 然后，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

此命令集使用 Get-CimInstance cmdlet 检索查询参数中指定的 CIM 实例对象，并将对象的 VariableValue 属性值更改为变量（$x）。 然后使用 Set-CimInstance cmdlet 保存 CIM 实例对象。 由于使用了 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 cmdlet 创建具有指定属性的 CIM 实例，并将其内容检索到变量（$x）。 然后，该变量将传递给 Set-CimInstance cmdlet，该 cmdlet 将 VariableValue 属性的值修改为某些值。 由于使用了 Passthru 参数，因此此命令集返回修改后的 CIM 实例对象。

此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。

指定 Passthru 参数时，此 cmdlet 返回修改后的 CIM 实例对象。