Set-CimInstance

参考

模块:: CimCmdlets

通过调用 CIM 类的 ModifyInstance 方法修改 CIM 服务器上的 CIM 实例。

语法

Set-CimInstance
   [-ComputerName <String[]>]
   [-ResourceUri <Uri>]
   [-OperationTimeoutSec <UInt32>]
   [-InputObject] <CimInstance>
   [-Property <IDictionary>]
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CimInstance
   -CimSession <CimSession[]>
   [-ResourceUri <Uri>]
   [-OperationTimeoutSec <UInt32>]
   [-InputObject] <CimInstance>
   [-Property <IDictionary>]
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CimInstance
   -CimSession <CimSession[]>
   [-Namespace <String>]
   [-OperationTimeoutSec <UInt32>]
   [-Query] <String>
   [-QueryDialect <String>]
   -Property <IDictionary>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CimInstance
   [-ComputerName <String[]>]
   [-Namespace <String>]
   [-OperationTimeoutSec <UInt32>]
   [-Query] <String>
   [-QueryDialect <String>]
   -Property <IDictionary>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

说明

此 cmdlet 仅在 Windows 平台上可用。

此 cmdlet 修改 CIM 服务器上的 CIM 实例。

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

如果未指定 ComputerName 参数和 CimSession 参数，则此 cmdlet 适用于本地 Windows Management Instrumentation (WMI) ，使用组件对象模型 (COM) 会话。
如果指定 了 ComputerName 参数或 CimSession 参数，则此 cmdlet 适用于 由 ComputerName 参数或 CimSession 参数指定的 CIM 服务器。

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

如果未指定 ComputerName 参数和 CimSession 参数，则此 cmdlet 使用输入对象中的 CIM 会话或计算机名称。
如果指定 了 ComputerName 参数或 CimSession 参数，则此 cmdlet 使用 CimSession 参数值或 ComputerName 参数值。这种情况并不常见。

示例

示例 1：设置 CIM 实例

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

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

示例 2：使用管道设置 CIM 实例属性

此示例使用 Get-CimInstance cmdlet 检索由 Query 参数筛选的 CIM 实例对象。 cmdlet Set-CimInstance 将 VariableValue 属性的值修改为 abcd。

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

示例 3：使用输入对象设置 CIM 实例属性

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

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

示例 4：设置 CIM 实例属性

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

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

示例 5：显示使用 WhatIf 修改的 CIM 实例列表

此示例使用通用参数 WhatIf 来指定不应执行修改，而只输出完成修改后将发生的情况。

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

示例 6：在用户确认后设置 CIM 实例

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

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

示例 7：设置创建的 CIM 实例

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

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

参数

-CimSession

在远程计算机上运行 cmdlet。输入计算机名称或会话对象，例如或 Get-CimSession cmdlet 的New-CimSession输出。

Type:	CimSession[]
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-ComputerName

指定要运行 CIM 操作的计算机的名称。可以 (FQDN) 或 NetBIOS 名称指定完全限定的域名。

如果未指定此参数，cmdlet 将使用组件对象模型 (COM) 在本地计算机上执行操作。

如果指定此参数，cmdlet 将使用 WsMan 协议创建与指定计算机的临时会话。

如果在同一台计算机上执行多个操作，则使用 CIM 会话进行连接可提供更好的性能。

Type:	String[]
Aliases:	CN, ServerName
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

提示你在运行 cmdlet 之前进行确认。

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

指定要用作输入的 CIM 实例对象。

InputObject 参数不枚举集合。如果传递集合，则会引发错误。使用集合时，通过管道传递输入以枚举值。

Type:	CimInstance
Aliases:	CimInstance
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Namespace

指定 CIM 操作的命名空间。默认命名空间为 root/cimv2。可以使用选项卡补全来浏览命名空间列表，因为 PowerShell 从本地 WMI 服务器获取命名空间列表以提供命名空间列表。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-OperationTimeoutSec

指定 cmdlet 等待计算机响应的时间量。默认情况下，此参数的值为 0，这意味着 cmdlet 使用服务器的默认超时值。

如果将 OperationTimeoutSec 参数设置为小于 3 分钟可靠连接重试超时的值，则持续超过 OperationTimeoutSec 参数值的网络故障不可恢复，因为服务器上的操作在客户端重新连接之前会超时。

Type:	UInt32
Aliases:	OT
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PassThru

返回一个代表你所处理的项目的对象。默认情况下，此 cmdlet 将不产生任何输出。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Property

使用名称/值对) 将 CIM 实例的属性指定为哈希表 (。仅更改使用此参数指定的属性。 CIM 实例的其他属性不会更改。

Type:	IDictionary
Aliases:	Arguments
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Query

指定要在 CIM 服务器上运行的查询，以检索要对其运行 cmdlet 的 CIM 实例。可以使用 QueryDialect 参数指定查询方言。

如果指定的值包含) (" 双引号、单引号 () ' 或反斜杠 (\) ，则必须用反斜杠 (\) 字符作为前缀来转义这些字符。如果指定的值使用 WQL LIKE 运算符，则必须通过将以下字符括在方括号 ([]) 中来转义以下字符：百分比 (%) 、下划线 (_) 或左方括号 ([) 。

Type:	String
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-QueryDialect

指定用于 Query 参数的查询语言。此参数的可接受值为： WQL 或 CQL。默认值为 WQL。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-ResourceUri

指定资源类或实例的资源统一资源标识符 (URI) 。 URI 用于标识计算机上特定类型的资源，例如磁盘或进程。

URI 由前缀和指向资源的路径组成。例如：

http://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_LogicalDisk
http://intel.com/wbem/wscim/1/amt-schema/1/AMT_GeneralSettings

默认情况下，如果未指定此参数，则使用 DMTF 标准资源 URI http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/ ，并将类名追加到其中。

ResourceURI 只能与使用 WSMan 协议创建的 CIM 会话一起使用，或者在指定 ComputerName 参数（使用 WSMan 创建 CIM 会话）时使用。如果在未指定 ComputerName 参数的情况下指定此参数，或者指定使用 DCOM 协议创建的 CIM 会话，则会收到错误，因为 DCOM 协议不支持 ResourceURI 参数。

如果同时指定 了 ResourceUri 参数和 Filter 参数，则会忽略 Filter 参数。

Type:	Uri
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-WhatIf

显示运行该 cmdlet 时会发生什么情况。此 cmdlet 未运行。

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

输入

CimInstance

输出

None

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