Skip to content

Commit 92a94e1

Browse files
ArieHeinmichaeltlombardi
ArieHein
authored and
michaeltlombardi
committed
Markdown and PS Styles
1 parent fb4eda7 commit 92a94e1

File tree

12 files changed

+241
-121
lines changed

12 files changed

+241
-121
lines changed

‎reference/5.1/CimCmdlets/New-CimInstance.md‎

Lines changed: 37 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -19,46 +19,48 @@ Creates a CIM instance.
1919

2020
```
2121
New-CimInstance [-ClassName] <String> [-Key <String[]>] [[-Property] <IDictionary>]
22-
[-Namespace <String>] [-OperationTimeoutSec <UInt32>] [-ComputerName <String[]>] [-ClientOnly]
23-
[-WhatIf] [-Confirm] [<CommonParameters>]
22+
[-Namespace <String>] [-OperationTimeoutSec <UInt32>] [-ComputerName <String[]>]
23+
[-ClientOnly] [-WhatIf] [-Confirm] [<CommonParameters>]
2424
```
2525

2626
### ClassNameSessionSet
2727

2828
```
2929
New-CimInstance [-ClassName] <String> [-Key <String[]>] [[-Property] <IDictionary>]
30-
[-Namespace <String>] [-OperationTimeoutSec <UInt32>] -CimSession <CimSession[]> [-ClientOnly]
31-
[-WhatIf] [-Confirm] [<CommonParameters>]
30+
[-Namespace <String>] [-OperationTimeoutSec <UInt32>] -CimSession <CimSession[]>
31+
[-ClientOnly] [-WhatIf] [-Confirm] [<CommonParameters>]
3232
```
3333

3434
### ResourceUriSessionSet
3535

3636
```
3737
New-CimInstance -ResourceUri <Uri> [-Key <String[]>] [[-Property] <IDictionary>]
38-
[-Namespace <String>] [-OperationTimeoutSec <UInt32>] -CimSession <CimSession[]> [-WhatIf]
39-
[-Confirm] [<CommonParameters>]
38+
[-Namespace <String>] [-OperationTimeoutSec <UInt32>] -CimSession <CimSession[]>
39+
[-WhatIf] [-Confirm] [<CommonParameters>]
4040
```
4141

4242
### ResourceUriComputerSet
4343

4444
```
4545
New-CimInstance -ResourceUri <Uri> [-Key <String[]>] [[-Property] <IDictionary>]
46-
[-Namespace <String>] [-OperationTimeoutSec <UInt32>] [-ComputerName <String[]>] [-WhatIf]
47-
[-Confirm] [<CommonParameters>]
46+
[-Namespace <String>] [-OperationTimeoutSec <UInt32>] [-ComputerName <String[]>]
47+
[-WhatIf] [-Confirm] [<CommonParameters>]
4848
```
4949

5050
### CimClassSessionSet
5151

5252
```
53-
New-CimInstance [-CimClass] <CimClass> [[-Property] <IDictionary>] [-OperationTimeoutSec <UInt32>]
54-
-CimSession <CimSession[]> [-ClientOnly] [-WhatIf] [-Confirm] [<CommonParameters>]
53+
New-CimInstance [-CimClass] <CimClass> [[-Property] <IDictionary>]
54+
[-OperationTimeoutSec <UInt32>] -CimSession <CimSession[]> [-ClientOnly] [-WhatIf]
55+
[-Confirm] [<CommonParameters>]
5556
```
5657

5758
### CimClassComputerSet
5859

5960
```
60-
New-CimInstance [-CimClass] <CimClass> [[-Property] <IDictionary>] [-OperationTimeoutSec <UInt32>]
61-
[-ComputerName <String[]>] [-ClientOnly] [-WhatIf] [-Confirm] [<CommonParameters>]
61+
New-CimInstance [-CimClass] <CimClass> [[-Property] <IDictionary>]
62+
[-OperationTimeoutSec <UInt32>] [-ComputerName <String[]>] [-ClientOnly] [-WhatIf]
63+
[-Confirm] [<CommonParameters>]
6264
```
6365

6466
## DESCRIPTION
@@ -75,7 +77,12 @@ This example creates an instance of a CIM Class named win32_environment in the r
7577
on the computer.
7678

7779
```powershell
78-
New-CimInstance -ClassName Win32_Environment -Property @{Name="testvar";VariableValue="testvalue";UserName="domain\user"}
80+
$prop = @{
81+
Name = "testvar"
82+
VariableValue = "testvalue"
83+
UserName = "domain\user"
84+
}
85+
New-CimInstance -ClassName Win32_Environment -Property $prop
7986
```
8087

8188
No client side validation is performed if the class does not exist, the properties are wrong, or if
@@ -89,7 +96,12 @@ of the variable are then passed to the `New-CimInstance` cmdlet.
8996

9097
```powershell
9198
$class = Get-CimClass -ClassName Win32_Environment
92-
New-CimInstance -CimClass $class -Property @{Name="testvar";VariableValue="testvalue";UserName="Contoso\User1"}
99+
$prop = @{
100+
Name = "testvar"
101+
VariableValue = "testvalue"
102+
UserName = "Contoso\User1"
103+
}
104+
New-CimInstance -CimClass $class -Property $prop
93105
```
94106

95107
### Example 3: Create a dynamic instance on the client
@@ -100,7 +112,16 @@ computer without getting the instance from the server. The new instance is store
100112
on the server.
101113

102114
```powershell
103-
$a = New-CimInstance -ClassName Win32_Process -Property @{Handle=0} -Key Handle -ClientOnly
115+
$instance = @{
116+
ClassName = 'Win32_Process'
117+
Property = @{
118+
Handle = 0
119+
}
120+
Key = 'Handle'
121+
ClientOnly = $true
122+
}
123+
$a = New-CimInstance @instance
124+
104125
Get-CimInstance -CimInstance $a
105126
Invoke-CimMethod -CimInstance $a -MethodName GetOwner
106127
```
@@ -385,7 +406,7 @@ Accept wildcard characters: False
385406
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable,
386407
-InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose,
387408
-WarningAction, and -WarningVariable. For more information, see
388-
[about_CommonParameters](../Microsoft.PowerShell.Core/About/about_CommonParameters.md).
409+
[about_CommonParameters](https://go.microsoft.com/fwlink/?LinkID=113216).
389410

390411
## INPUTS
391412

‎reference/5.1/CimCmdlets/New-CimSession.md‎

Lines changed: 11 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -17,16 +17,17 @@ Creates a CIM session.
1717
### CredentialParameterSet (Default)
1818

1919
```
20-
New-CimSession [-Authentication <PasswordAuthenticationMechanism>] [[-Credential] <PSCredential>]
21-
[[-ComputerName] <String[]>] [-Name <String>] [-OperationTimeoutSec <UInt32>] [-SkipTestConnection]
22-
[-Port <UInt32>] [-SessionOption <CimSessionOptions>] [<CommonParameters>]
20+
New-CimSession [-Authentication <PasswordAuthenticationMechanism>]
21+
[[-Credential] <PSCredential>] [[-ComputerName] <String[]>] [-Name <String>]
22+
[-OperationTimeoutSec <UInt32>] [-SkipTestConnection] [-Port <UInt32>]
23+
[-SessionOption <CimSessionOptions>] [<CommonParameters>]
2324
```
2425

2526
### CertificateParameterSet
2627

2728
```
28-
New-CimSession [-CertificateThumbprint <String>] [[-ComputerName] <String[]>] [-Name <String>]
29-
[-OperationTimeoutSec <UInt32>] [-SkipTestConnection] [-Port <UInt32>]
29+
New-CimSession [-CertificateThumbprint <String>] [[-ComputerName] <String[]>]
30+
[-Name <String>] [-OperationTimeoutSec <UInt32>] [-SkipTestConnection] [-Port <UInt32>]
3031
[-SessionOption <CimSessionOptions>] [<CommonParameters>]
3132
```
3233

@@ -65,7 +66,7 @@ This example creates a CIM session to each of the computers specified by **Compu
6566
comma separated list.
6667

6768
```powershell
68-
New-CimSession -ComputerName Server01,Server02,Server03
69+
New-CimSession -ComputerName Server01, Server02, Server03
6970
```
7071

7172
### Example 4: Create a CIM session with a friendly name
@@ -74,7 +75,7 @@ This example creates a remote CIM session to each of the computers specified by
7475
the comma separated list, and assigns a friendly name to the new sessions, by specifying **Name**.
7576

7677
```powershell
77-
New-CimSession -ComputerName Server01,Server02 -Name FileServers
78+
New-CimSession -ComputerName Server01, Server02 -Name FileServers
7879
Get-CimSession -Name File*
7980
```
8081

@@ -237,8 +238,8 @@ Accept wildcard characters: False
237238
Specifies a friendly name for the CIM session.
238239

239240
You can use the name to refer to the CIM session when using other cmdlets, such as the
240-
[`Get-CimSession`](Get-CimSession.md) cmdlet.
241-
The name is not required to be unique to the computer or the current session.
241+
[Get-CimSession](Get-CimSession.md) cmdlet. The name is not required to be unique to the computer
242+
or the current session.
242243

243244
```yaml
244245
Type: System.String
@@ -348,7 +349,7 @@ Accept wildcard characters: False
348349
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable,
349350
-InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose,
350351
-WarningAction, and -WarningVariable. For more information, see
351-
[about_CommonParameters](../Microsoft.PowerShell.Core/About/about_CommonParameters.md).
352+
[about_CommonParameters](https://go.microsoft.com/fwlink/?LinkID=113216).
352353

353354
## INPUTS
354355

‎reference/5.1/CimCmdlets/New-CimSessionOption.md‎

Lines changed: 15 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -18,8 +18,8 @@ Specifies advanced options for the New-CimSession cmdlet.
1818
### ProtocolTypeSet (Default)
1919

2020
```
21-
New-CimSessionOption [-Protocol] <ProtocolType> [-UICulture <CultureInfo>] [-Culture <CultureInfo>]
22-
[<CommonParameters>]
21+
New-CimSessionOption [-Protocol] <ProtocolType> [-UICulture <CultureInfo>]
22+
[-Culture <CultureInfo>] [<CommonParameters>]
2323
```
2424

2525
### WSManParameterSet
@@ -28,15 +28,16 @@ New-CimSessionOption [-Protocol] <ProtocolType> [-UICulture <CultureInfo>] [-Cul
2828
New-CimSessionOption [-NoEncryption] [-SkipCACheck] [-SkipCNCheck] [-SkipRevocationCheck]
2929
[-EncodePortInServicePrincipalName] [-Encoding <PacketEncoding>] [-HttpPrefix <Uri>]
3030
[-MaxEnvelopeSizeKB <UInt32>] [-ProxyAuthentication <PasswordAuthenticationMechanism>]
31-
[-ProxyCertificateThumbprint <String>] [-ProxyCredential <PSCredential>] [-ProxyType <ProxyType>]
32-
[-UseSsl] [-UICulture <CultureInfo>] [-Culture <CultureInfo>] [<CommonParameters>]
31+
[-ProxyCertificateThumbprint <String>] [-ProxyCredential <PSCredential>]
32+
[-ProxyType <ProxyType>] [-UseSsl] [-UICulture <CultureInfo>] [-Culture <CultureInfo>]
33+
[<CommonParameters>]
3334
```
3435

3536
### DcomParameterSet
3637

3738
```
38-
New-CimSessionOption [-Impersonation <ImpersonationType>] [-PacketIntegrity] [-PacketPrivacy]
39-
[-UICulture <CultureInfo>] [-Culture <CultureInfo>] [<CommonParameters>]
39+
New-CimSessionOption [-Impersonation <ImpersonationType>] [-PacketIntegrity]
40+
[-PacketPrivacy] [-UICulture <CultureInfo>] [-Culture <CultureInfo>] [<CommonParameters>]
4041
```
4142

4243
## DESCRIPTION
@@ -71,7 +72,14 @@ parameter, the credentials specified by the **ProxyCredential** parameter, and s
7172
command is to skip the CA check, skip the CN check, and use SSL.
7273

7374
```powershell
74-
New-CimSessionOption -ProxyAuthentication Kerberos -ProxyCredential $cred -SkipCACheck -SkipCNCheck -UseSsl
75+
$option = @{
76+
ProxyAuthentication = 'Kerberos'
77+
ProxyCredential = $cred
78+
SkipCACheck = $true
79+
SkipCNCheck = $true
80+
UseSsl = $true
81+
}
82+
New-CimSessionOption @option
7583
```
7684

7785
### Example 3: Create a CIM session options object with the culture specified

‎reference/7.4/CimCmdlets/New-CimInstance.md‎

Lines changed: 37 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -19,46 +19,48 @@ Creates a CIM instance.
1919

2020
```
2121
New-CimInstance [-ClassName] <String> [-Key <String[]>] [[-Property] <IDictionary>]
22-
[-Namespace <String>] [-OperationTimeoutSec <UInt32>] [-ComputerName <String[]>] [-ClientOnly]
23-
[-WhatIf] [-Confirm] [<CommonParameters>]
22+
[-Namespace <String>] [-OperationTimeoutSec <UInt32>] [-ComputerName <String[]>]
23+
[-ClientOnly] [-WhatIf] [-Confirm] [<CommonParameters>]
2424
```
2525

2626
### ClassNameSessionSet
2727

2828
```
2929
New-CimInstance [-ClassName] <String> [-Key <String[]>] [[-Property] <IDictionary>]
30-
[-Namespace <String>] [-OperationTimeoutSec <UInt32>] -CimSession <CimSession[]> [-ClientOnly]
31-
[-WhatIf] [-Confirm] [<CommonParameters>]
30+
[-Namespace <String>] [-OperationTimeoutSec <UInt32>] -CimSession <CimSession[]>
31+
[-ClientOnly] [-WhatIf] [-Confirm] [<CommonParameters>]
3232
```
3333

3434
### ResourceUriSessionSet
3535

3636
```
3737
New-CimInstance -ResourceUri <Uri> [-Key <String[]>] [[-Property] <IDictionary>]
38-
[-Namespace <String>] [-OperationTimeoutSec <UInt32>] -CimSession <CimSession[]> [-WhatIf]
39-
[-Confirm] [<CommonParameters>]
38+
[-Namespace <String>] [-OperationTimeoutSec <UInt32>] -CimSession <CimSession[]>
39+
[-WhatIf] [-Confirm] [<CommonParameters>]
4040
```
4141

4242
### ResourceUriComputerSet
4343

4444
```
4545
New-CimInstance -ResourceUri <Uri> [-Key <String[]>] [[-Property] <IDictionary>]
46-
[-Namespace <String>] [-OperationTimeoutSec <UInt32>] [-ComputerName <String[]>] [-WhatIf]
47-
[-Confirm] [<CommonParameters>]
46+
[-Namespace <String>] [-OperationTimeoutSec <UInt32>] [-ComputerName <String[]>]
47+
[-WhatIf] [-Confirm] [<CommonParameters>]
4848
```
4949

5050
### CimClassSessionSet
5151

5252
```
53-
New-CimInstance [-CimClass] <CimClass> [[-Property] <IDictionary>] [-OperationTimeoutSec <UInt32>]
54-
-CimSession <CimSession[]> [-ClientOnly] [-WhatIf] [-Confirm] [<CommonParameters>]
53+
New-CimInstance [-CimClass] <CimClass> [[-Property] <IDictionary>]
54+
[-OperationTimeoutSec <UInt32>] -CimSession <CimSession[]> [-ClientOnly] [-WhatIf]
55+
[-Confirm] [<CommonParameters>]
5556
```
5657

5758
### CimClassComputerSet
5859

5960
```
60-
New-CimInstance [-CimClass] <CimClass> [[-Property] <IDictionary>] [-OperationTimeoutSec <UInt32>]
61-
[-ComputerName <String[]>] [-ClientOnly] [-WhatIf] [-Confirm] [<CommonParameters>]
61+
New-CimInstance [-CimClass] <CimClass> [[-Property] <IDictionary>]
62+
[-OperationTimeoutSec <UInt32>] [-ComputerName <String[]>] [-ClientOnly] [-WhatIf]
63+
[-Confirm] [<CommonParameters>]
6264
```
6365

6466
## DESCRIPTION
@@ -77,7 +79,12 @@ This example creates an instance of a CIM Class named win32_environment in the r
7779
on the computer.
7880

7981
```powershell
80-
New-CimInstance -ClassName Win32_Environment -Property @{Name="testvar";VariableValue="testvalue";UserName="domain\user"}
82+
$prop = @{
83+
Name = "testvar"
84+
VariableValue = "testvalue"
85+
UserName = "domain\user"
86+
}
87+
New-CimInstance -ClassName Win32_Environment -Property $prop
8188
```
8289

8390
No client side validation is performed if the class does not exist, the properties are wrong, or if
@@ -91,7 +98,12 @@ of the variable are then passed to the `New-CimInstance` cmdlet.
9198

9299
```powershell
93100
$class = Get-CimClass -ClassName Win32_Environment
94-
New-CimInstance -CimClass $class -Property @{Name="testvar";VariableValue="testvalue";UserName="Contoso\User1"}
101+
$prop = @{
102+
Name = "testvar"
103+
VariableValue = "testvalue"
104+
UserName = "Contoso\User1"
105+
}
106+
New-CimInstance -CimClass $class -Property $prop
95107
```
96108

97109
### Example 3: Create a dynamic instance on the client
@@ -102,7 +114,16 @@ computer without getting the instance from the server. The new instance is store
102114
on the server.
103115

104116
```powershell
105-
$a = New-CimInstance -ClassName Win32_Process -Property @{Handle=0} -Key Handle -ClientOnly
117+
$instance = @{
118+
ClassName = 'Win32_Process'
119+
Property = @{
120+
Handle = 0
121+
}
122+
Key = 'Handle'
123+
ClientOnly = $true
124+
}
125+
$a = New-CimInstance @instance
126+
106127
Get-CimInstance -CimInstance $a
107128
Invoke-CimMethod -CimInstance $a -MethodName GetOwner
108129
```
@@ -387,7 +408,7 @@ Accept wildcard characters: False
387408
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable,
388409
-InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose,
389410
-WarningAction, and -WarningVariable. For more information, see
390-
[about_CommonParameters](../Microsoft.PowerShell.Core/About/about_CommonParameters.md).
411+
[about_CommonParameters](https://go.microsoft.com/fwlink/?LinkID=113216).
391412

392413
## INPUTS
393414

‎reference/7.4/CimCmdlets/New-CimSession.md‎

Lines changed: 7 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -17,16 +17,17 @@ Creates a CIM session.
1717
### CredentialParameterSet (Default)
1818

1919
```
20-
New-CimSession [-Authentication <PasswordAuthenticationMechanism>] [[-Credential] <PSCredential>]
21-
[[-ComputerName] <String[]>] [-Name <String>] [-OperationTimeoutSec <UInt32>] [-SkipTestConnection]
22-
[-Port <UInt32>] [-SessionOption <CimSessionOptions>] [<CommonParameters>]
20+
New-CimSession [-Authentication <PasswordAuthenticationMechanism>]
21+
[[-Credential] <PSCredential>] [[-ComputerName] <String[]>] [-Name <String>]
22+
[-OperationTimeoutSec <UInt32>] [-SkipTestConnection] [-Port <UInt32>]
23+
[-SessionOption <CimSessionOptions>] [<CommonParameters>]
2324
```
2425

2526
### CertificateParameterSet
2627

2728
```
28-
New-CimSession [-CertificateThumbprint <String>] [[-ComputerName] <String[]>] [-Name <String>]
29-
[-OperationTimeoutSec <UInt32>] [-SkipTestConnection] [-Port <UInt32>]
29+
New-CimSession [-CertificateThumbprint <String>] [[-ComputerName] <String[]>]
30+
[-Name <String>] [-OperationTimeoutSec <UInt32>] [-SkipTestConnection] [-Port <UInt32>]
3031
[-SessionOption <CimSessionOptions>] [<CommonParameters>]
3132
```
3233

@@ -350,7 +351,7 @@ Accept wildcard characters: False
350351
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable,
351352
-InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose,
352353
-WarningAction, and -WarningVariable. For more information, see
353-
[about_CommonParameters](../Microsoft.PowerShell.Core/About/about_CommonParameters.md).
354+
[about_CommonParameters](https://go.microsoft.com/fwlink/?LinkID=113216).
354355

355356
## INPUTS
356357

0 commit comments

Comments
 (0)