@@ -17,33 +17,33 @@ Modifies a CIM instance on a CIM server by calling the ModifyInstance method of
1717### CimInstanceComputerSet (Default)
1818
1919```
20- Set-CimInstance [-ComputerName <String[]>] [-ResourceUri <Uri>] [-OperationTimeoutSec <UInt32>]
21- [-InputObject] <CimInstance> [-Property <IDictionary>] [-PassThru] [-WhatIf] [-Confirm ]
22- [<CommonParameters>]
20+ Set-CimInstance [-ComputerName <String[]>] [-ResourceUri <Uri>]
21+ [-OperationTimeoutSec <UInt32>] [- InputObject] <CimInstance> [-Property <IDictionary>]
22+ [-PassThru] [-WhatIf] [-Confirm] [ <CommonParameters>]
2323```
2424
2525### CimInstanceSessionSet
2626
2727```
28- Set-CimInstance -CimSession <CimSession[]> [-ResourceUri <Uri>] [-OperationTimeoutSec <UInt32>]
29- [-InputObject] <CimInstance> [-Property <IDictionary>] [-PassThru] [-WhatIf] [-Confirm ]
30- [<CommonParameters>]
28+ Set-CimInstance -CimSession <CimSession[]> [-ResourceUri <Uri>]
29+ [-OperationTimeoutSec <UInt32>] [- InputObject] <CimInstance> [-Property <IDictionary>]
30+ [-PassThru] [-WhatIf] [-Confirm] [ <CommonParameters>]
3131```
3232
3333### QuerySessionSet
3434
3535```
36- Set-CimInstance -CimSession <CimSession[]> [-Namespace <String>] [-OperationTimeoutSec <UInt32>]
37- [-Query] <String> [-QueryDialect <String>] -Property <IDictionary> [-PassThru] [-WhatIf] [-Confirm ]
38- [<CommonParameters>]
36+ Set-CimInstance -CimSession <CimSession[]> [-Namespace <String>]
37+ [-OperationTimeoutSec <UInt32>] [-Query] <String> [-QueryDialect <String> ]
38+ -Property <IDictionary> [-PassThru] [-WhatIf] [-Confirm] [<CommonParameters>]
3939```
4040
4141### QueryComputerSet
4242
4343```
44- Set-CimInstance [-ComputerName <String[]>] [-Namespace <String>] [-OperationTimeoutSec <UInt32>]
45- [-Query] <String> [-QueryDialect <String>] -Property <IDictionary> [-PassThru] [-WhatIf] [-Confirm ]
46- [<CommonParameters>]
44+ Set-CimInstance [-ComputerName <String[]>] [-Namespace <String>]
45+ [-OperationTimeoutSec <UInt32>] [-Query] <String> [-QueryDialect <String> ]
46+ -Property <IDictionary> [-PassThru] [-WhatIf] [-Confirm] [<CommonParameters>]
4747```
4848
4949## DESCRIPTION
@@ -76,7 +76,11 @@ parameter. You can modify instances matching a Windows Management Instrumentatio
7676(WQL) query.
7777
7878``` powershell
79- Set-CimInstance -Query 'Select * from Win32_Environment where name LIKE "testvar%"' -Property @{VariableValue="abcd"}
79+ $instance = @ {
80+ Query = 'Select * from Win32_Environment where name LIKE "testvar%"'
81+ Property = @{VariableValue="abcd"}
82+ }
83+ Set-CimInstance @instance
8084```
8185
8286### Example 2: Set the CIM instance property using pipeline
@@ -121,7 +125,12 @@ This example uses the common parameter **WhatIf** to specify that the modificati
121125done, but only output what would happen if it were done.
122126
123127``` powershell
124- Set-CimInstance -Query 'Select * from Win32_Environment where name LIKE "testvar%"' -Property @{VariableValue="abcd"} -WhatIf
128+ $instance = @{
129+ Query = 'Select * from Win32_Environment where name LIKE "testvar%"'
130+ Property = @{VariableValue="abcd"}
131+ WhatIf = $true
132+ }
133+ Set-CimInstance @instance
125134```
126135
127136### Example 6: Set the CIM instance after confirmation from the user
@@ -130,7 +139,12 @@ This example uses the common parameter **Confirm** to specify that the modificat
130139only after confirmation from the user.
131140
132141``` powershell
133- Set-CimInstance -Query 'Select * from Win32_Environment where name LIKE "testvar%"' -Property @{VariableValue="abcd"} -Confirm
142+ $instance = @{
143+ Query = 'Select * from Win32_Environment where name LIKE "testvar%"'
144+ Property = @{VariableValue="abcd"}
145+ Confirm = $true
146+ }
147+ Set-CimInstance @instance
134148```
135149
136150### Example 7: Set the created CIM instance
@@ -141,7 +155,16 @@ cmdlet, and retrieves its contents in to a variable `$x`. The variable is then p
141155Because the ** PassThru** parameter is used, This example returns a modified CIM instance object.
142156
143157``` powershell
144- $x = New-CimInstance -ClassName Win32_Environment -Property @{Name="testvar";UserName="domain\user"} -Key Name, UserName -ClientOnly
158+ $instance = @{
159+ ClassName = 'Win32_Environment'
160+ Property = @{
161+ Name="testvar"
162+ UserName="domain\user"
163+ }
164+ Key = 'Name', 'UserName'
165+ ClientOnly = $true
166+ }
167+ $x = New-CimInstance @instance
145168Set-CimInstance -CimInstance $x -Property @{VariableValue="somevalue"} -PassThru
146169```
147170
@@ -154,7 +177,7 @@ of a `New-CimSession` or `Get-CimSession` cmdlet.
154177
155178``` yaml
156179Type : Microsoft.Management.Infrastructure.CimSession[]
157- Parameter Sets : QuerySessionSet, CimInstanceSessionSet
180+ Parameter Sets : CimInstanceSessionSet, QuerySessionSet
158181Aliases :
159182
160183Required : True
@@ -395,7 +418,7 @@ Accept wildcard characters: False
395418This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable,
396419-InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose,
397420-WarningAction, and -WarningVariable. For more information, see
398- [about_CommonParameters](../Microsoft.PowerShell.Core/About/about_CommonParameters.md ).
421+ [about_CommonParameters](https://go.microsoft.com/fwlink/?LinkID=113216 ).
399422
400423## INPUTS
401424
0 commit comments