Merge branch 'staging' into pipeline-chain-operators

Author: sdwheeler

reference/3.0/CimCmdlets/Invoke-CimMethod.md

@@ -110,7 +110,7 @@ If the InputObject parameter is specified, the cmdlet works in one of the follow
 ### Example 1: Invoke a method
 
 ```powershell
-PS C:\>Invoke-CimMethod -Query 'select * from Win32_Process where name like "notepad%"' -MethodName "Terminate"
+Invoke-CimMethod -Query 'select * from Win32_Process where name like "notepad%"' -MethodName "Terminate"
 ```
 
 This command invokes the method named Terminate on the CIM class named Win32_Process. The CIM class
@@ -119,8 +119,8 @@ is retrieved by the query "Select * from Win32_Process where name like 'notepad%
 ### Example 2: Invoke a method using CIM instance object
 
 ```powershell
-PS C:\>$x = Get-CimInstance -Query 'Select * from Win32_Process where name like "notepad%"'
-PS C:\>Invoke-CimMethod -InputObject $x -MethodName GetOwner
+$x = Get-CimInstance -Query 'Select * from Win32_Process where name like "notepad%"'
+Invoke-CimMethod -InputObject $x -MethodName GetOwner
 ```
 
 This set of commands retrieves the CIM instance object and stores it in a variable named $x using
@@ -130,24 +130,24 @@ Invoke-CimMethod cmdlet, and the GetOwner method is invoked for the CimInstance.
 ### Example 3: Invoke a static method
 
 ```powershell
-PS C:\>Invoke-CimMethod -ClassName Win32_Process -MethodName "Create" -Arguments @{ Path = "notepad.exe" }
+Invoke-CimMethod -ClassName Win32_Process -MethodName "Create" -Arguments @{ Path = "notepad.exe" }
 ```
 
 This command invokes the static method Create on the class named Win32_Process, with the arguments specified by the Arguments parameter.
 
 ### Example 4: Invoke a method using arguments
 
 ```powershell
-PS C:\>Invoke-CimMethod -ClassName Win32_Process -MethodName "Create" -Arguments @{ CommandLine = 'notepad.exe'; CurrentDirectory = "C:\windows\system32" }
+Invoke-CimMethod -ClassName Win32_Process -MethodName "Create" -Arguments @{ CommandLine = 'notepad.exe'; CurrentDirectory = "C:\windows\system32" }
 ```
 
 This command invokes the method named Create by using the Arguments parameter.
 
 ### Example 5: Client-side validation
 
 ```powershell
-PS C:\>$c = Get-CimClass -ClassName Win32_Process
-PS C:\>Invoke-CimMethod -CimClass $c -MethodName "xyz" -Arguments @{ CommandLine = 'notepad.exe' }
+$c = Get-CimClass -ClassName Win32_Process
+Invoke-CimMethod -CimClass $c -MethodName "xyz" -Arguments @{ CommandLine = 'notepad.exe' }
 ```
 
 This set of commands performs client-side validation for the method named xyz by passing a CimClass
@@ -166,7 +166,7 @@ Parameter Sets: (All)
 Aliases:
 
 Required: False
-Position: 2
+Position: 1
 Default value: None
 Accept pipeline input: True (ByPropertyName)
 Accept wildcard characters: False
@@ -187,7 +187,7 @@ Parameter Sets: CimClassSessionSet, CimClassComputerSet
 Aliases:
 
 Required: True
-Position: 1
+Position: 0
 Default value: None
 Accept pipeline input: True (ByValue)
 Accept wildcard characters: False
@@ -223,7 +223,7 @@ Parameter Sets: ClassNameComputerSet, ClassNameSessionSet
 Aliases: Class
 
 Required: True
-Position: 1
+Position: 0
 Default value: None
 Accept pipeline input: True (ByPropertyName)
 Accept wildcard characters: False
@@ -268,7 +268,7 @@ Parameter Sets: CimInstanceComputerSet, CimInstanceSessionSet
 Aliases: CimInstance
 
 Required: True
-Position: 1
+Position: 0
 Default value: None
 Accept pipeline input: True (ByValue)
 Accept wildcard characters: False
@@ -287,7 +287,7 @@ Parameter Sets: (All)
 Aliases: Name
 
 Required: True
-Position: 3
+Position: 2
 Default value: None
 Accept pipeline input: True (ByPropertyName)
 Accept wildcard characters: False
@@ -298,7 +298,7 @@ Accept wildcard characters: False
 Specifies the namespace for the CIM operation.
 
 The default namespace is root/cimv2. You can use tab completion to browse the list of namespaces,
-because Windows PowerShell gets a list of namespaces from the local WMI server to provide the list
+because PowerShell gets a list of namespaces from the local WMI server to provide the list
 of namespaces.
 
 ```yaml
@@ -388,10 +388,9 @@ The URI is used to identify a specific type of resource, such as disks or proces
 A URI consists of a prefix and a path to a resource.
 For example:
 
-```
-http://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_LogicalDisk
-http://intel.com/wbem/wscim/1/amt-schema/1/AMT_GeneralSettings
-```
+`http://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_LogicalDisk`
+
+`http://intel.com/wbem/wscim/1/amt-schema/1/AMT_GeneralSettings`
 
 By default, if you do not specify this parameter, the DMTF standard resource URI `http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/` is used and the class name is appended to it.
 

reference/3.0/CimCmdlets/New-CimInstance.md

@@ -41,16 +41,16 @@ New-CimInstance -ResourceUri <Uri> [-Key <String[]>] [[-Property] <IDictionary>]
  [-OperationTimeoutSec <UInt32>] [-ComputerName <String[]>] [-WhatIf] [-Confirm] [<CommonParameters>]
 ```
 
-### CimClassComputerSet
+### CimClassSessionSet
 ```
 New-CimInstance [-CimClass] <CimClass> [[-Property] <IDictionary>] [-OperationTimeoutSec <UInt32>]
- [-ComputerName <String[]>] [-ClientOnly] [-WhatIf] [-Confirm] [<CommonParameters>]
+ -CimSession <CimSession[]> [-ClientOnly] [-WhatIf] [-Confirm] [<CommonParameters>]
 ```
 
-### CimClassSessionSet
+### CimClassComputerSet
 ```
 New-CimInstance [-CimClass] <CimClass> [[-Property] <IDictionary>] [-OperationTimeoutSec <UInt32>]
- -CimSession <CimSession[]> [-ClientOnly] [-WhatIf] [-Confirm] [<CommonParameters>]
+ [-ComputerName <String[]>] [-ClientOnly] [-WhatIf] [-Confirm] [<CommonParameters>]
 ```
 
 ## DESCRIPTION
@@ -63,8 +63,8 @@ By default, the New-CimInstance cmdlet creates an instance on the local computer
 ## EXAMPLES
 
 ### Example 1: Create an instance of a CIM class
-```
-PS C:\>New-CimInstance -ClassName Win32_Environment -Property @{Name="testvar";VariableValue="testvalue";UserName="domain\user"}
+```powershell
+New-CimInstance -ClassName Win32_Environment -Property @{Name="testvar";VariableValue="testvalue";UserName="domain\user"}
 ```
 
 This command creates an instance of a CIM Class named win32_environment in the root/cimv2 namespace on the computer.
@@ -74,26 +74,26 @@ No client side validation is performed if the class does not exist, the properti
 If the instance is created successfully, then the New-CimInstance cmdlet outputs the newly created instance.
 
 ### Example 2: Create an instance of a CIM class using a class schema
-```
-PS C:\>$class = Get-CimClass -ClassName Win32_Environment
+```powershell
+$class = Get-CimClass -ClassName Win32_Environment
 
 
 
-PS C:\>New-CimInstance -CimClass $class -Property @{Name="testvar";VariableValue="testvalue";UserName="Contoso\User1"}
+New-CimInstance -CimClass $class -Property @{Name="testvar";VariableValue="testvalue";UserName="Contoso\User1"}
 ```
 
 This set of commands retrieves a CIM class object and stores it in a variable named $class using the Get-CimClass cmdlet.
 The contents of the variable are then passed to the New-CimInstance cmdlet.
 
 ### Example 3: Create a dynamic instance on the client
-```
-PS C:\>$a = New-CimInstance -ClassName Win32_Process -Property @{Handle=0} -Key Handle -ClientOnly
+```powershell
+$a = New-CimInstance -ClassName Win32_Process -Property @{Handle=0} -Key Handle -ClientOnly
 
 
-PS C:\>Get-CimInstance -CimInstance $a
+Get-CimInstance -CimInstance $a
 
 
-PS C:\>Invoke-CimMethod -CimInstance $a -MethodName GetOwner
+Invoke-CimMethod -CimInstance $a -MethodName GetOwner
 ```
 
 This set of commands creates a dynamic instance of a CIM class named win32_Process on the client computer without getting the instance from the server.
@@ -103,12 +103,12 @@ The Get-CimInstance cmdlet then retrieves a particular single instance, and invo
 This dynamic instance can be used to perform operations if the instance with this key exists on the server.
 
 ### Example 4: Create an instance for a CIM class of a specific namespace
-```
-PS C:\>$class = Get-CimClass -ClassName MSFT_Something -Namespace root/somewhere
+```powershell
+$class = Get-CimClass -ClassName MSFT_Something -Namespace root/somewhere
 
 
 
-PS C:\>New-CimInstance -CimClass $class -Property @{"Prop1"=1;"Prop2"="value"} -ClientOnly
+New-CimInstance -CimClass $class -Property @{"Prop1"=1;"Prop2"="value"} -ClientOnly
 ```
 
 This set of commands gets an instance of a CIM class named MSFT_Something in the namespace root/somewhere and stores it in a variable named $class using the Get-CimClass cmdlet.
@@ -129,11 +129,11 @@ Using this parameter results in better client side schema validations.
 
 ```yaml
 Type: CimClass
-Parameter Sets: CimClassComputerSet, CimClassSessionSet
+Parameter Sets: CimClassSessionSet, CimClassComputerSet
 Aliases:
 
 Required: True
-Position: 1
+Position: 0
 Default value: None
 Accept pipeline input: True (ByValue)
 Accept wildcard characters: False
@@ -158,27 +158,27 @@ Accept wildcard characters: False
 
 ### -ClassName
 Specifies the name of the CIM class of which the operation creates an instance.
-NOTE: You can use tab completion to browse the list of classes, because Windows PowerShell gets a list of classes from the local WMI server to provide a list of class names.
+NOTE: You can use tab completion to browse the list of classes, because PowerShell gets a list of classes from the local WMI server to provide a list of class names.
 
 ```yaml
 Type: String
 Parameter Sets: ClassNameComputerSet, ClassNameSessionSet
 Aliases:
 
 Required: True
-Position: 1
+Position: 0
 Default value: None
 Accept pipeline input: True (ByPropertyName)
 Accept wildcard characters: False
 ```
 
 ### -ClientOnly
 Indicates that the instance is only created in PowerShell without going to the CIM server.
-You can use this parameter to create an in-memory CIM instance for use in subsequent Windows PowerShell operations.
+You can use this parameter to create an in-memory CIM instance for use in subsequent PowerShell operations.
 
 ```yaml
 Type: SwitchParameter
-Parameter Sets: ClassNameComputerSet, ClassNameSessionSet, CimClassComputerSet, CimClassSessionSet
+Parameter Sets: ClassNameComputerSet, ClassNameSessionSet, CimClassSessionSet, CimClassComputerSet
 Aliases: Local
 
 Required: False
@@ -275,7 +275,7 @@ Parameter Sets: (All)
 Aliases: Arguments
 
 Required: False
-Position: 2
+Position: 1
 Default value: None
 Accept pipeline input: True (ByPropertyName)
 Accept wildcard characters: False
@@ -292,8 +292,6 @@ For example:
 
 `http://intel.com/wbem/wscim/1/amt-schema/1/AMT_GeneralSettings`
 
-
-
 By default, if you do not specify this parameter, the DMTF standard resource URI `http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/` is used and the class name is appended to it.
 
 ResourceURI can only be used with CIM sessions created using the WSMan protocol, or when specifying the ComputerName parameter, which creates a CIM session using WSMan.

reference/3.0/CimCmdlets/Set-CimInstance.md

@@ -70,7 +70,7 @@ If the InputObject parameter is specified, the cmdlet works in one of the follow
 ### Example 1: Set the CIM instance
 
 ```powershell
-PS C:\>Set-CimInstance -Query 'Select * from Win32_Environment where name LIKE "testvar%"' -Property @{VariableValue="abcd"}
+Set-CimInstance -Query 'Select * from Win32_Environment where name LIKE "testvar%"' -Property @{VariableValue="abcd"}
 ```
 
 This command sets the value of the VariableValue property to abcd using the Query parameter.
@@ -79,7 +79,7 @@ You can modify instances matching a Windows Management Instrumentation Query Lan
 ### Example 2: Set the CIM instance property using pipeline
 
 ```powershell
-PS C:\>Get-CimInstance -Query 'Select * from Win32_Environment where name LIKE "testvar%"' | Set-CimInstance -Property @{VariableValue="abcd"}
+Get-CimInstance -Query 'Select * from Win32_Environment where name LIKE "testvar%"' | Set-CimInstance -Property @{VariableValue="abcd"}
 ```
 
 This command retrieves the CIM instance object filtered by the Query parameter using the
@@ -89,8 +89,8 @@ the value of VariableValue property to abcd.
 ### Example 3: Set the CIM instance property using input object
 
 ```powershell
-PS C:\>$x = Get-CimInstance -Query 'Select * from Win32_Environment where Name="testvar"'
-PS C:\>Set-CimInstance -InputObject $x -Property @{VariableValue="somevalue"} -PassThru
+$x = Get-CimInstance -Query 'Select * from Win32_Environment where Name="testvar"'
+Set-CimInstance -InputObject $x -Property @{VariableValue="somevalue"} -PassThru
 ```
 
 This set of commands retrieves the CIM instance objects filtered by the Query parameter in to a
@@ -102,9 +102,9 @@ object.
 ### Example 4: Set the CIM instance property
 
 ```powershell
-PS C:\>$x = Get-CimInstance -Query 'Select * from Win32_Environment where name="testvar"'
-PS C:\>$x.VariableValue = "Change"
-PS C:\>Set-CimInstance -CimInstance $x -PassThru
+$x = Get-CimInstance -Query 'Select * from Win32_Environment where name="testvar"'
+$x.VariableValue = "Change"
+Set-CimInstance -CimInstance $x -PassThru
 ```
 
 This set of commands retrieves the CIM instance object that is specified in the Query parameter
@@ -116,7 +116,7 @@ object.
 ### Example 5: Show the list of CIM instances to modify using WhatIf
 
 ```powershell
-PS C:\>Set-CimInstance -Query 'Select * from Win32_Environment where name LIKE "testvar%"' -Property @{VariableValue="abcd"} -WhatIf
+Set-CimInstance -Query 'Select * from Win32_Environment where name LIKE "testvar%"' -Property @{VariableValue="abcd"} -WhatIf
 ```
 
 This command uses the common parameter WhatIf to specify that the modification should not be done,
@@ -125,7 +125,7 @@ but only output what would happen if it were done.
 ### Example 6: Set the CIM instance after confirmation from the user
 
 ```powershell
-PS C:\>Set-CimInstance -Query 'Select * from Win32_Environment where name LIKE "testvar%"' -Property @{VariableValue="abcd"} -Confirm
+Set-CimInstance -Query 'Select * from Win32_Environment where name LIKE "testvar%"' -Property @{VariableValue="abcd"} -Confirm
 ```
 
 This command uses the common parameter Confirm to specify that the modification should be done only
@@ -134,8 +134,8 @@ after confirmation from the user.
 ### Example 7: Set the created CIM instance
 
 ```powershell
-PS C:\>$x = New-CimInstance -ClassName Win32_Environment -Property @{Name="testvar";UserName="domain\user"} -Keys Name,UserName -ClientOnly
-PS C:\>Set-CimInstance -CimInstance $x -Property @{VariableValue="somevalue"} -PassThru
+$x = New-CimInstance -ClassName Win32_Environment -Property @{Name="testvar";UserName="domain\user"} -Keys Name,UserName -ClientOnly
+Set-CimInstance -CimInstance $x -Property @{VariableValue="somevalue"} -PassThru
 ```
 
 This set of commands creates a CIM instance with the specified properties using the New-CimInstance
@@ -198,7 +198,7 @@ Parameter Sets: CimInstanceComputerSet, CimInstanceSessionSet
 Aliases: CimInstance
 
 Required: True
-Position: 1
+Position: 0
 Default value: None
 Accept pipeline input: True (ByValue)
 Accept wildcard characters: False
@@ -298,7 +298,7 @@ Parameter Sets: QuerySessionSet, QueryComputerSet
 Aliases:
 
 Required: True
-Position: 1
+Position: 0
 Default value: None
 Accept pipeline input: True (ByPropertyName)
 Accept wildcard characters: False