Merge pull request MicrosoftDocs#218 from erwinvanhunen/master

March 2018 Release documentation updates

Author: VesaJuvonen

sharepoint/docs-conceptual/sharepoint-pnp/sharepoint-pnp-cmdlets.md

@@ -19,8 +19,8 @@ Add-PnPApp -Path <String>
 
 ### Add and Publish
 ```powershell
-Add-PnPApp -Publish [<SwitchParameter>]
-           -Path <String>
+Add-PnPApp -Path <String>
+           -Publish [<SwitchParameter>]
            [-SkipFeatureDeployment [<SwitchParameter>]]
            [-Overwrite [<SwitchParameter>]]
            [-Connection <SPOnlineConnection>]
@@ -30,14 +30,14 @@ Add-PnPApp -Publish [<SwitchParameter>]
 
 ### ------------------EXAMPLE 1------------------
 ```powershell
-PS:> Add-PnPApp -Path ./myapp.sppkg
+Add-PnPApp -Path ./myapp.sppkg
 ```
 
 This will upload the specified app package to the app catalog
 
 ### ------------------EXAMPLE 2------------------
 ```powershell
-PS:> Add-PnPApp -Path ./myapp.sppkg -Publish
+Add-PnPApp -Path ./myapp.sppkg -Publish
 ```
 
 This will upload the specified app package to the app catalog and deploy/trust it at the same time.
@@ -61,7 +61,7 @@ Specifies the Id or an actual app metadata instance
 
 ```yaml
 Type: String
-Parameter Sets: Add only
+Parameter Sets: Add only, Add and Publish
 
 Required: True
 Position: 0
@@ -93,7 +93,7 @@ Accept pipeline input: False
 ```
 
 ### -Connection
-Optional connection to be used by cmdlet. Retrieve the value for this parameter by eiter specifying -ReturnConnection on Connect-PnPOnline or by executing Get-PnPConnection.
+Optional connection to be used by the cmdlet. Retrieve the value for this parameter by either specifying -ReturnConnection on Connect-PnPOnline or by executing Get-PnPConnection.
 
 ```yaml
 Type: SPOnlineConnection

sharepoint/sharepoint-ps/sharepoint-pnp/Add-PnPApp.md

@@ -16,7 +16,6 @@ Add-PnPClientSidePage -Name <String>
                       [-PromoteAs <ClientSidePagePromoteType>]
                       [-CommentsEnabled [<SwitchParameter>]]
                       [-Publish [<SwitchParameter>]]
-                      [-PublishMessage <String>]
                       [-Web <WebPipeBind>]
                       [-Connection <SPOnlineConnection>]
 ```
@@ -25,14 +24,14 @@ Add-PnPClientSidePage -Name <String>
 
 ### ------------------EXAMPLE 1------------------
 ```powershell
-PS:> Add-PnPClientSidePage -Name "NewPage"
+Add-PnPClientSidePage -Name "NewPage"
 ```
 
 Creates a new Client-Side page named 'NewPage'
 
 ### ------------------EXAMPLE 2------------------
 ```powershell
-PS:> Add-PnPClientSidePage "NewPage"
+Add-PnPClientSidePage "NewPage"
 ```
 
 Creates a new Client-Side page named 'NewPage'
@@ -99,20 +98,8 @@ Position: Named
 Accept pipeline input: False
 ```
 
-### -PublishMessage
-Sets the message for publishing the page.
-
-```yaml
-Type: String
-Parameter Sets: (All)
-
-Required: False
-Position: Named
-Accept pipeline input: False
-```
-
 ### -Connection
-Optional connection to be used by cmdlet. Retrieve the value for this parameter by eiter specifying -ReturnConnection on Connect-PnPOnline or by executing Get-PnPConnection.
+Optional connection to be used by the cmdlet. Retrieve the value for this parameter by either specifying -ReturnConnection on Connect-PnPOnline or by executing Get-PnPConnection.
 
 ```yaml
 Type: SPOnlineConnection

sharepoint/sharepoint-ps/sharepoint-pnp/Add-PnPClientSidePage.md

@@ -11,8 +11,8 @@ Adds a new section to a Client-Side page
 ## SYNTAX 
 
 ```powershell
-Add-PnPClientSidePageSection -SectionTemplate <CanvasSectionTemplate>
-                             -Page <ClientSidePagePipeBind>
+Add-PnPClientSidePageSection -Page <ClientSidePagePipeBind>
+                             -SectionTemplate <CanvasSectionTemplate>
                              [-Order <Int>]
                              [-Web <WebPipeBind>]
                              [-Connection <SPOnlineConnection>]
@@ -22,21 +22,21 @@ Add-PnPClientSidePageSection -SectionTemplate <CanvasSectionTemplate>
 
 ### ------------------EXAMPLE 1------------------
 ```powershell
-PS:> Add-PnPClientSidePageSection -Page "MyPage" -SectionTemplate OneColumn
+Add-PnPClientSidePageSection -Page "MyPage" -SectionTemplate OneColumn
 ```
 
 Adds a new one-column section to the Client-Side page 'MyPage'
 
 ### ------------------EXAMPLE 2------------------
 ```powershell
-PS:> Add-PnPClientSidePageSection -Page "MyPage" -SectionTemplate ThreeColumn -Order 10
+Add-PnPClientSidePageSection -Page "MyPage" -SectionTemplate ThreeColumn -Order 10
 ```
 
 Adds a new Three columns section to the Client-Side page 'MyPage' with an order index of 10
 
 ### ------------------EXAMPLE 3------------------
 ```powershell
-PS:> $page = Add-PnPClientSidePage -Name "MyPage"
+$page = Add-PnPClientSidePage -Name "MyPage"
 PS> Add-PnPClientSidePageSection -Page $page -SectionTemplate OneColumn
 ```
 
@@ -81,7 +81,7 @@ Accept pipeline input: False
 ```
 
 ### -Connection
-Optional connection to be used by cmdlet. Retrieve the value for this parameter by eiter specifying -ReturnConnection on Connect-PnPOnline or by executing Get-PnPConnection.
+Optional connection to be used by the cmdlet. Retrieve the value for this parameter by either specifying -ReturnConnection on Connect-PnPOnline or by executing Get-PnPConnection.
 
 ```yaml
 Type: SPOnlineConnection

sharepoint/sharepoint-ps/sharepoint-pnp/Add-PnPClientSidePageSection.md

@@ -12,19 +12,19 @@ Adds a text element to a client-side page.
 
 ### Default
 ```powershell
-Add-PnPClientSideText -Text <String>
-                      -Page <ClientSidePagePipeBind>
+Add-PnPClientSideText -Page <ClientSidePagePipeBind>
+                      -Text <String>
                       [-Order <Int>]
                       [-Web <WebPipeBind>]
                       [-Connection <SPOnlineConnection>]
 ```
 
 ### Positioned
 ```powershell
-Add-PnPClientSideText -Text <String>
+Add-PnPClientSideText -Page <ClientSidePagePipeBind>
+                      -Text <String>
                       -Section <Int>
                       -Column <Int>
-                      -Page <ClientSidePagePipeBind>
                       [-Order <Int>]
                       [-Web <WebPipeBind>]
                       [-Connection <SPOnlineConnection>]
@@ -37,7 +37,7 @@ Adds a new text element to a section on a client-side page.
 
 ### ------------------EXAMPLE 1------------------
 ```powershell
-PS:> Add-PnPClientSideText -Page "MyPage" -Text "Hello World!"
+Add-PnPClientSideText -Page "MyPage" -Text "Hello World!"
 ```
 
 Adds the text 'Hello World!' to the Client-Side Page 'MyPage'
@@ -61,7 +61,7 @@ Sets the order of the text control. (Default = 1)
 
 ```yaml
 Type: Int
-Parameter Sets: Default
+Parameter Sets: Default, Positioned
 
 Required: False
 Position: Named
@@ -73,7 +73,7 @@ The name of the page.
 
 ```yaml
 Type: ClientSidePagePipeBind
-Parameter Sets: Default
+Parameter Sets: Default, Positioned
 
 Required: True
 Position: 0
@@ -97,15 +97,15 @@ Specifies the text to display in the text area.
 
 ```yaml
 Type: String
-Parameter Sets: Default
+Parameter Sets: Default, Positioned
 
 Required: True
 Position: Named
 Accept pipeline input: False
 ```
 
 ### -Connection
-Optional connection to be used by cmdlet. Retrieve the value for this parameter by eiter specifying -ReturnConnection on Connect-PnPOnline or by executing Get-PnPConnection.
+Optional connection to be used by the cmdlet. Retrieve the value for this parameter by either specifying -ReturnConnection on Connect-PnPOnline or by executing Get-PnPConnection.
 
 ```yaml
 Type: SPOnlineConnection

sharepoint/sharepoint-ps/sharepoint-pnp/Add-PnPClientSideText.md

@@ -12,8 +12,8 @@ Adds a Client-Side Web Part to a client-side page
 
 ### Default with built-in webpart
 ```powershell
-Add-PnPClientSideWebPart -DefaultWebPartType <DefaultClientSideWebParts>
-                         -Page <ClientSidePagePipeBind>
+Add-PnPClientSideWebPart -Page <ClientSidePagePipeBind>
+                         -DefaultWebPartType <DefaultClientSideWebParts>
                          [-WebPartProperties <PropertyBagPipeBind>]
                          [-Order <Int>]
                          [-Web <WebPipeBind>]
@@ -22,8 +22,8 @@ Add-PnPClientSideWebPart -DefaultWebPartType <DefaultClientSideWebParts>
 
 ### Default with 3rd party webpart
 ```powershell
-Add-PnPClientSideWebPart -Component <ClientSideComponentPipeBind>
-                         -Page <ClientSidePagePipeBind>
+Add-PnPClientSideWebPart -Page <ClientSidePagePipeBind>
+                         -Component <ClientSideComponentPipeBind>
                          [-WebPartProperties <PropertyBagPipeBind>]
                          [-Order <Int>]
                          [-Web <WebPipeBind>]
@@ -32,10 +32,10 @@ Add-PnPClientSideWebPart -Component <ClientSideComponentPipeBind>
 
 ### Positioned with built-in webpart
 ```powershell
-Add-PnPClientSideWebPart -DefaultWebPartType <DefaultClientSideWebParts>
+Add-PnPClientSideWebPart -Page <ClientSidePagePipeBind>
+                         -DefaultWebPartType <DefaultClientSideWebParts>
                          -Section <Int>
                          -Column <Int>
-                         -Page <ClientSidePagePipeBind>
                          [-WebPartProperties <PropertyBagPipeBind>]
                          [-Order <Int>]
                          [-Web <WebPipeBind>]
@@ -44,10 +44,10 @@ Add-PnPClientSideWebPart -DefaultWebPartType <DefaultClientSideWebParts>
 
 ### Positioned with 3rd party webpart
 ```powershell
-Add-PnPClientSideWebPart -Component <ClientSideComponentPipeBind>
+Add-PnPClientSideWebPart -Page <ClientSidePagePipeBind>
+                         -Component <ClientSideComponentPipeBind>
                          -Section <Int>
                          -Column <Int>
-                         -Page <ClientSidePagePipeBind>
                          [-WebPartProperties <PropertyBagPipeBind>]
                          [-Order <Int>]
                          [-Web <WebPipeBind>]
@@ -61,21 +61,21 @@ Adds a client-side web part to an existing client-side page.
 
 ### ------------------EXAMPLE 1------------------
 ```powershell
-PS:> Add-PnPClientSideWebPart -Page "MyPage" -DefaultWebPartType BingMap
+Add-PnPClientSideWebPart -Page "MyPage" -DefaultWebPartType BingMap
 ```
 
 Adds a built-in Client-Side component 'BingMap' to the page called 'MyPage'
 
 ### ------------------EXAMPLE 2------------------
 ```powershell
-PS:> Add-PnPClientSideWebPart -Page "MyPage" -Component "HelloWorld"
+Add-PnPClientSideWebPart -Page "MyPage" -Component "HelloWorld"
 ```
 
 Adds a Client-Side component 'HelloWorld' to the page called 'MyPage'
 
 ### ------------------EXAMPLE 3------------------
 ```powershell
-PS:> Add-PnPClientSideWebPart  -Page "MyPage" -Component "HelloWorld" -Section 1 -Column 2
+Add-PnPClientSideWebPart  -Page "MyPage" -Component "HelloWorld" -Section 1 -Column 2
 ```
 
 Adds a Client-Side component 'HelloWorld' to the page called 'MyPage' in section 1 and column 2
@@ -87,7 +87,7 @@ Sets the column where to insert the WebPart control.
 
 ```yaml
 Type: Int
-Parameter Sets: Positioned with built-in webpart
+Parameter Sets: Positioned with built-in webpart, Positioned with 3rd party webpart
 
 Required: True
 Position: Named
@@ -99,7 +99,7 @@ Specifies the component instance or Id to add.
 
 ```yaml
 Type: ClientSideComponentPipeBind
-Parameter Sets: Default with 3rd party webpart
+Parameter Sets: Default with 3rd party webpart, Positioned with 3rd party webpart
 
 Required: True
 Position: Named
@@ -111,7 +111,7 @@ Defines a default WebPart type to insert.
 
 ```yaml
 Type: DefaultClientSideWebParts
-Parameter Sets: Default with built-in webpart
+Parameter Sets: Default with built-in webpart, Positioned with built-in webpart
 
 Required: True
 Position: Named
@@ -123,7 +123,7 @@ Sets the order of the WebPart control. (Default = 1)
 
 ```yaml
 Type: Int
-Parameter Sets: Default with built-in webpart
+Parameter Sets: Default with built-in webpart, Default with 3rd party webpart, Positioned with built-in webpart, Positioned with 3rd party webpart
 
 Required: False
 Position: Named
@@ -135,7 +135,7 @@ The name of the page.
 
 ```yaml
 Type: ClientSidePagePipeBind
-Parameter Sets: Default with built-in webpart
+Parameter Sets: Default with built-in webpart, Default with 3rd party webpart, Positioned with built-in webpart, Positioned with 3rd party webpart
 
 Required: True
 Position: 0
@@ -147,7 +147,7 @@ Sets the section where to insert the WebPart control.
 
 ```yaml
 Type: Int
-Parameter Sets: Positioned with built-in webpart
+Parameter Sets: Positioned with built-in webpart, Positioned with 3rd party webpart
 
 Required: True
 Position: Named
@@ -159,15 +159,15 @@ The properties of the WebPart
 
 ```yaml
 Type: PropertyBagPipeBind
-Parameter Sets: Default with built-in webpart
+Parameter Sets: Default with built-in webpart, Default with 3rd party webpart, Positioned with built-in webpart, Positioned with 3rd party webpart
 
 Required: False
 Position: Named
 Accept pipeline input: False
 ```
 
 ### -Connection
-Optional connection to be used by cmdlet. Retrieve the value for this parameter by eiter specifying -ReturnConnection on Connect-PnPOnline or by executing Get-PnPConnection.
+Optional connection to be used by the cmdlet. Retrieve the value for this parameter by either specifying -ReturnConnection on Connect-PnPOnline or by executing Get-PnPConnection.
 
 ```yaml
 Type: SPOnlineConnection

sharepoint/sharepoint-ps/sharepoint-pnp/Add-PnPClientSideWebPart.md

@@ -24,7 +24,7 @@ Add-PnPContentType -Name <String>
 
 ### ------------------EXAMPLE 1------------------
 ```powershell
-PS:> Add-PnPContentType -Name "Project Document" -Description "Use for Contoso projects" -Group "Contoso Content Types" -ParentContentType $ct
+Add-PnPContentType -Name "Project Document" -Description "Use for Contoso projects" -Group "Contoso Content Types" -ParentContentType $ct
 ```
 
 This will add a new content type based on the parent content type stored in the $ct variable.
@@ -92,7 +92,7 @@ Accept pipeline input: False
 ```
 
 ### -Connection
-Optional connection to be used by cmdlet. Retrieve the value for this parameter by eiter specifying -ReturnConnection on Connect-PnPOnline or by executing Get-PnPConnection.
+Optional connection to be used by the cmdlet. Retrieve the value for this parameter by either specifying -ReturnConnection on Connect-PnPOnline or by executing Get-PnPConnection.
 
 ```yaml
 Type: SPOnlineConnection
@@ -117,7 +117,7 @@ Accept pipeline input: False
 
 ## OUTPUTS
 
-### [Microsoft.SharePoint.Client.ContentType](https://msdn.microsoft.com/en-us/library/microsoft.sharepoint.client.contenttype.aspx)
+### Microsoft.SharePoint.Client.ContentType
 
 ## RELATED LINKS