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

此 cmdlet 仅在 Windows 平台上可用。

此 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 参数值。 这不是很常见。

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

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

此示例使用 cmdlet 检索由 Get-CimInstance 参数筛选的 CIM 实例对象。 Set-CimInstance cmdlet 将 VariableValue 属性的值修改为 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

此示例使用 $x检索查询参数筛选到变量 Get-CimInstance 筛选的 CIM 实例对象，然后将变量的内容传递给 Set-CimInstance cmdlet。 然后，Set-CimInstance 将 VariableValue 属性修改为 某些值。 由于使用了 PassThru 参数，此示例返回修改后的 CIM 实例对象。

此示例使用 cmdlet 将 $x 参数中指定的 CIM 实例对象检索到变量 Get-CimInstance，并更改要更改的对象的 VariableValue 属性值。 然后使用 Set-CimInstance cmdlet 保存 CIM 实例对象。 由于使用了 PassThru 参数，此示例返回修改后的 CIM 实例对象。

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

此示例使用通用参数 WhatIf 来指定不应完成修改，但仅输出在完成修改时会发生什么情况。

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

此示例使用通用参数 Confirm 指定仅在用户确认后才能完成修改。

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

此示例使用 New-CimInstance cmdlet 创建具有指定属性的 CIM 实例，并将其内容检索到变量 $x。 然后将变量传递给 Set-CimInstance cmdlet，该 cmdlet 将 VariableValue 属性的值修改为 某些值。 由于使用了 PassThru 参数，此示例返回修改后的 CIM 实例对象。

$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

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

默认情况下，此 cmdlet 不返回任何输出。

使用 PassThru 参数时，此 cmdlet 返回修改后的 CIM 实例对象。

PowerShell 包含以下与 Set-CimInstance相关的别名：

• 窗户：
  • scim

此 cmdlet 仅在 Windows 平台上可用。