Merge pull request MicrosoftDocs#143 from erwinvanhunen/master

SharePoint PnP PowerShell Documentation updates

Author: VesaJuvonen

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

@@ -10,8 +10,19 @@ Add/uploads an available app to the app catalog
 
 ## SYNTAX 
 
+### Add only
 ```powershell
 Add-PnPApp -Path <String>
+           [-Overwrite [<SwitchParameter>]]
+           [-Connection <SPOnlineConnection>]
+```
+
+### Add and Publish
+```powershell
+Add-PnPApp -Publish [<SwitchParameter>]
+           -Path <String>
+           [-SkipFeatureDeployment [<SwitchParameter>]]
+           [-Overwrite [<SwitchParameter>]]
            [-Connection <SPOnlineConnection>]
 ```
 
@@ -24,20 +35,63 @@ PS:> 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
+```
+
+This will upload the specified app package to the app catalog and deploy/trust it at the same time.
+
 ## PARAMETERS
 
+### -Overwrite
+Overwrites the existing app package if it already exists
+
+```yaml
+Type: SwitchParameter
+Parameter Sets: (All)
+
+Required: False
+Position: Named
+Accept pipeline input: False
+```
+
 ### -Path
 Specifies the Id or an actual app metadata instance
 
 ```yaml
 Type: String
-Parameter Sets: (All)
+Parameter Sets: Add only
 
 Required: True
 Position: 0
 Accept pipeline input: True
 ```
 
+### -Publish
+This will deploy/trust an app into the app catalog
+
+```yaml
+Type: SwitchParameter
+Parameter Sets: Add and Publish
+
+Required: True
+Position: Named
+Accept pipeline input: False
+```
+
+### -SkipFeatureDeployment
+
+
+```yaml
+Type: SwitchParameter
+Parameter Sets: Add and Publish
+
+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.
 

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

@@ -124,7 +124,7 @@ Accept pipeline input: False
 ```
 
 ### -Web
-The GUID, server relative url (i.e. /sites/team1) or web instance of the web to apply the command to. Omit this parameter to use the current web.
+This parameter allows you to optionally apply the cmdlet action to a subweb within the current web. In most situations this parameter is not required and you can connect to the subweb using Connect-PnPOnline instead. Specify the GUID, server relative url (i.e. /sites/team1) or web instance of the web to apply the command to. Omit this parameter to use the current web.
 
 ```yaml
 Type: WebPipeBind

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

@@ -93,7 +93,7 @@ Accept pipeline input: False
 ```
 
 ### -Web
-The GUID, server relative url (i.e. /sites/team1) or web instance of the web to apply the command to. Omit this parameter to use the current web.
+This parameter allows you to optionally apply the cmdlet action to a subweb within the current web. In most situations this parameter is not required and you can connect to the subweb using Connect-PnPOnline instead. Specify the GUID, server relative url (i.e. /sites/team1) or web instance of the web to apply the command to. Omit this parameter to use the current web.
 
 ```yaml
 Type: WebPipeBind

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

@@ -117,7 +117,7 @@ Accept pipeline input: False
 ```
 
 ### -Web
-The GUID, server relative url (i.e. /sites/team1) or web instance of the web to apply the command to. Omit this parameter to use the current web.
+This parameter allows you to optionally apply the cmdlet action to a subweb within the current web. In most situations this parameter is not required and you can connect to the subweb using Connect-PnPOnline instead. Specify the GUID, server relative url (i.e. /sites/team1) or web instance of the web to apply the command to. Omit this parameter to use the current web.
 
 ```yaml
 Type: WebPipeBind

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

@@ -179,7 +179,7 @@ Accept pipeline input: False
 ```
 
 ### -Web
-The GUID, server relative url (i.e. /sites/team1) or web instance of the web to apply the command to. Omit this parameter to use the current web.
+This parameter allows you to optionally apply the cmdlet action to a subweb within the current web. In most situations this parameter is not required and you can connect to the subweb using Connect-PnPOnline instead. Specify the GUID, server relative url (i.e. /sites/team1) or web instance of the web to apply the command to. Omit this parameter to use the current web.
 
 ```yaml
 Type: WebPipeBind

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

@@ -104,7 +104,7 @@ Accept pipeline input: False
 ```
 
 ### -Web
-The GUID, server relative url (i.e. /sites/team1) or web instance of the web to apply the command to. Omit this parameter to use the current web.
+This parameter allows you to optionally apply the cmdlet action to a subweb within the current web. In most situations this parameter is not required and you can connect to the subweb using Connect-PnPOnline instead. Specify the GUID, server relative url (i.e. /sites/team1) or web instance of the web to apply the command to. Omit this parameter to use the current web.
 
 ```yaml
 Type: WebPipeBind

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

@@ -29,7 +29,7 @@ This will add the content type called 'Test CT' to the document set called ''Tes
 ### ------------------EXAMPLE 2------------------
 ```powershell
 PS:> $docset = Get-PnPDocumentSetTemplate -Identity "Test Document Set"
-PS:> $ct = Get-SPOContentType -Identity "Test CT"
+PS:> $ct = Get-PnPContentType -Identity "Test CT"
 PS:> Add-PnPContentTypeToDocumentSet -ContentType $ct -DocumentSet $docset
 ```
 
@@ -81,7 +81,7 @@ Accept pipeline input: False
 ```
 
 ### -Web
-The GUID, server relative url (i.e. /sites/team1) or web instance of the web to apply the command to. Omit this parameter to use the current web.
+This parameter allows you to optionally apply the cmdlet action to a subweb within the current web. In most situations this parameter is not required and you can connect to the subweb using Connect-PnPOnline instead. Specify the GUID, server relative url (i.e. /sites/team1) or web instance of the web to apply the command to. Omit this parameter to use the current web.
 
 ```yaml
 Type: WebPipeBind

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

@@ -78,7 +78,7 @@ Accept pipeline input: False
 ```
 
 ### -Web
-The GUID, server relative url (i.e. /sites/team1) or web instance of the web to apply the command to. Omit this parameter to use the current web.
+This parameter allows you to optionally apply the cmdlet action to a subweb within the current web. In most situations this parameter is not required and you can connect to the subweb using Connect-PnPOnline instead. Specify the GUID, server relative url (i.e. /sites/team1) or web instance of the web to apply the command to. Omit this parameter to use the current web.
 
 ```yaml
 Type: WebPipeBind

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

@@ -252,7 +252,7 @@ Accept pipeline input: False
 ```
 
 ### -Web
-The GUID, server relative url (i.e. /sites/team1) or web instance of the web to apply the command to. Omit this parameter to use the current web.
+This parameter allows you to optionally apply the cmdlet action to a subweb within the current web. In most situations this parameter is not required and you can connect to the subweb using Connect-PnPOnline instead. Specify the GUID, server relative url (i.e. /sites/team1) or web instance of the web to apply the command to. Omit this parameter to use the current web.
 
 ```yaml
 Type: WebPipeBind