Updated documentation

Author: erwinvanhunen

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

@@ -1,8 +1,3 @@
----
-title: PnP PowerShell overview 
-description: Introduction to PnP PowerShell cmdlets.
-ms.date: 5/12/2018
----
 # PnP PowerShell overview
 
 SharePoint Patterns and Practices (PnP) contains a library of PowerShell commands (PnP PowerShell) that allows you to perform complex provisioning and artifact management actions towards SharePoint. The commands use CSOM and can work against both SharePoint Online as SharePoint On-Premises.
@@ -104,6 +99,7 @@ Cmdlet|Description|Platform
 **[Get‑PnPAppInstance](../../sharepoint-ps/sharepoint-pnp/Get-PnPAppInstance.md)** |Returns a SharePoint AddIn Instance|SharePoint Server 2013, SharePoint Server 2016, SharePoint Online
 **[Uninstall‑PnPAppInstance](../../sharepoint-ps/sharepoint-pnp/Uninstall-PnPAppInstance.md)** |Removes an app from a site|SharePoint Server 2013, SharePoint Server 2016, SharePoint Online
 **[Import‑PnPAppPackage](../../sharepoint-ps/sharepoint-pnp/Import-PnPAppPackage.md)** |Adds a SharePoint Addin to a site|SharePoint Server 2013, SharePoint Server 2016, SharePoint Online
+**[Grant‑PnPTenantServicePrincipalPermission](../../sharepoint-ps/sharepoint-pnp/Grant-PnPTenantServicePrincipalPermission.md)** |Explicitely grants a specified permission to the "SharePoint Online Client" service principal|SharePoint Online
 
 
 ### Base Cmdlets 
@@ -358,6 +354,7 @@ Cmdlet|Description|Platform
 :-----|:----------|:-------
 **[Get‑PnPSearchConfiguration](../../sharepoint-ps/sharepoint-pnp/Get-PnPSearchConfiguration.md)** |Returns the search configuration|SharePoint Server 2013, SharePoint Server 2016, SharePoint Online
 **[Set‑PnPSearchConfiguration](../../sharepoint-ps/sharepoint-pnp/Set-PnPSearchConfiguration.md)** |Sets the search configuration|SharePoint Server 2013, SharePoint Server 2016, SharePoint Online
+**[Get‑PnPSearchCrawlLog](../../sharepoint-ps/sharepoint-pnp/Get-PnPSearchCrawlLog.md)** |Returns entries from the SharePoint search crawl log|SharePoint Online
 **[Submit‑PnPSearchQuery](../../sharepoint-ps/sharepoint-pnp/Submit-PnPSearchQuery.md)** |Executes an arbitrary search query against the SharePoint search index|SharePoint Server 2013, SharePoint Server 2016, SharePoint Online
 **[Get‑PnPSiteSearchQueryResults](../../sharepoint-ps/sharepoint-pnp/Get-PnPSiteSearchQueryResults.md)** |Executes a search query to retrieve indexed site collections|SharePoint Server 2013, SharePoint Server 2016, SharePoint Online
 
@@ -434,7 +431,7 @@ Cmdlet|Description|Platform
 **[Unregister‑PnPHubSite](../../sharepoint-ps/sharepoint-pnp/Unregister-PnPHubSite.md)** |Unregisters a site as a hubsite|SharePoint Online
 **[Add‑PnPHubSiteAssociation](../../sharepoint-ps/sharepoint-pnp/Add-PnPHubSiteAssociation.md)** |Connects a site to a hubsite.|SharePoint Online
 **[Remove‑PnPHubSiteAssociation](../../sharepoint-ps/sharepoint-pnp/Remove-PnPHubSiteAssociation.md)** |Disconnects a site from a hubsite.|SharePoint Online
-**[Grant‑PnPHubSiteRights](../../sharepoint-ps/sharepoint-pnp/Grant-PnPHubSiteRights.md)** |Retrieve all or a specific hubsite.|SharePoint Online
+**[Grant‑PnPHubSiteRights](../../sharepoint-ps/sharepoint-pnp/Grant-PnPHubSiteRights.md)** |Grant Permissions to associate sites to Hub Sites.|SharePoint Online
 **[Add‑PnPOffice365GroupToSite](../../sharepoint-ps/sharepoint-pnp/Add-PnPOffice365GroupToSite.md)** |Groupifies a classic team site by creating an Office 365 group for it and connecting the site with the newly created group|SharePoint Online
 **[Disable‑PnPPowerShellTelemetry](../../sharepoint-ps/sharepoint-pnp/Disable-PnPPowerShellTelemetry.md)** |Disables PnP PowerShell telemetry tracking|SharePoint Server 2013, SharePoint Server 2016, SharePoint Online
 **[Enable‑PnPPowerShellTelemetry](../../sharepoint-ps/sharepoint-pnp/Enable-PnPPowerShellTelemetry.md)** |Enables PnP PowerShell telemetry tracking.|SharePoint Server 2013, SharePoint Server 2016, SharePoint Online

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

@@ -15,6 +15,7 @@ Add/uploads an available app to the app catalog
 Add-PnPApp -Path <String>
            [-Scope <AppCatalogScope>]
            [-Overwrite [<SwitchParameter>]]
+           [-Timeout <Int>]
            [-Connection <SPOnlineConnection>]
 ```
 
@@ -25,6 +26,7 @@ Add-PnPApp -Path <String>
            [-SkipFeatureDeployment [<SwitchParameter>]]
            [-Scope <AppCatalogScope>]
            [-Overwrite [<SwitchParameter>]]
+           [-Timeout <Int>]
            [-Connection <SPOnlineConnection>]
 ```
 
@@ -113,6 +115,18 @@ Position: Named
 Accept pipeline input: False
 ```
 
+### -Timeout
+Specifies the timeout in seconds. Defaults to 200.
+
+```yaml
+Type: Int
+Parameter Sets: (All)
+
+Required: False
+Position: Named
+Accept pipeline input: False
+```
+
 ### -Connection
 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.
 

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

@@ -57,6 +57,13 @@ Add-PnPCustomAction -Name 'GetItemsCount' -Title 'Invoke GetItemsCount Action' -
 
 Adds a new custom action to the custom list template, and sets the Title, Name and other fields with the specified values. On click it shows the number of items in that list. Notice: escape quotes in CommandUIExtension.
 
+### ------------------EXAMPLE 2------------------
+```powershell
+Add-PnPCustomAction -Title "CollabFooter" -Name "CollabFooter" -Location "ClientSideExtension.ApplicationCustomizer" -ClientSideComponentId c0ab3b94-8609-40cf-861e-2a1759170b43 -ClientSideComponentProperties "{`"sourceTermSet`":`"PnP-CollabFooter-SharedLinks`",`"personalItemsStorageProperty`":`"PnP-CollabFooter-MyLinks`"}
+```
+
+Adds a new application customizer to the site. This requires that an SPFX solution has been deployed containing the application customizer specified.
+
 ## PARAMETERS
 
 ### -ClientSideComponentId

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

@@ -25,7 +25,7 @@ You must be a SharePoint Online global administrator and a site collection admin
 
 ### ------------------EXAMPLE 1------------------
 ```powershell
-Add-PnPTenantCdnOrigin -Url /sites/site/subfolder -CdnType Public
+Add-PnPTenantCdnOrigin -OriginUrl /sites/site/subfolder -CdnType Public
 ```
 
 This example configures a public CDN on site level.

sharepoint/sharepoint-ps/sharepoint-pnp/Apply-PnPProvisioningTemplate.md

@@ -226,7 +226,7 @@ Accept pipeline input: False
 ```
 
 ### -Parameters
-Allows you to specify parameters that can be referred to in the template by means of the {parameter:<Key>} token. See examples on how to use this parameter.
+Allows you to specify parameters that can be referred to in the template by means of the {parameter:&lt;Key&gt;} token. See examples on how to use this parameter.
 
 ```yaml
 Type: Hashtable

sharepoint/sharepoint-ps/sharepoint-pnp/Connect-PnPOnline.md

@@ -871,7 +871,7 @@ Accept pipeline input: False
 ```
 
 ### -TenantAdminUrl
-The url to the Tenant Admin site. If not specified, the cmdlets will assume to connect automatically to https://<tenantname>-admin.sharepoint.com where appropriate.
+The url to the Tenant Admin site. If not specified, the cmdlets will assume to connect automatically to https://&lt;tenantname&gt;-admin.sharepoint.com where appropriate.
 
 ```yaml
 Type: String
@@ -907,7 +907,7 @@ Accept pipeline input: False
 ```
 
 ### -UseWebLogin
-If you want to connect to SharePoint with browser based login
+If you want to connect to SharePoint with browser based login. This is required when you have multi-factor authentication (MFA) enabled.
 
 ```yaml
 Type: SwitchParameter

sharepoint/sharepoint-ps/sharepoint-pnp/Export-PnPTaxonomy.md

@@ -84,7 +84,7 @@ Accept pipeline input: False
 ```
 
 ### -IncludeID
-If specified will include the ids of the taxonomy items in the output. Format: <label>;#<guid>
+If specified will include the ids of the taxonomy items in the output. Format: &lt;label&gt;;#&lt;guid&gt;
 
 ```yaml
 Type: SwitchParameter

sharepoint/sharepoint-ps/sharepoint-pnp/Get-PnPClientSideComponent.md

@@ -28,7 +28,7 @@ Returns all controls defined on the given page.
 
 ### ------------------EXAMPLE 2------------------
 ```powershell
-Get-PnPClientSideComponent -Page Home -Identity a2875399-d6ff-43a0-96da-be6ae5875f82
+Get-PnPClientSideComponent -Page Home -InstanceId a2875399-d6ff-43a0-96da-be6ae5875f82
 ```
 
 Returns a specific control defined on the given page.

sharepoint/sharepoint-ps/sharepoint-pnp/Get-PnPField.md

@@ -16,6 +16,7 @@ Get-PnPField [-Includes <String[]>]
              [-List <ListPipeBind>]
              [-Identity <FieldPipeBind>]
              [-Group <String>]
+             [-InSiteHierarchy [<SwitchParameter>]]
              [-Web <WebPipeBind>]
              [-Connection <SPOnlineConnection>]
 ```
@@ -74,6 +75,20 @@ Position: 0
 Accept pipeline input: False
 ```
 
+### -InSiteHierarchy
+Search site hierarchy for fields
+
+Only applicable to: SharePoint Online
+
+```yaml
+Type: SwitchParameter
+Parameter Sets: (All)
+
+Required: False
+Position: Named
+Accept pipeline input: False
+```
+
 ### -List
 The list object or name where to get the field from
 

sharepoint/sharepoint-ps/sharepoint-pnp/Get-PnPProvisioningTemplate.md

@@ -359,7 +359,7 @@ Accept pipeline input: False
 ```
 
 ### -ResourceFilePrefix
-If specified, resource files will be saved with the specified prefix instead of using the template name specified. If no template name is specified the files will be called PnP-Resources.<language>.resx. See examples for more info.
+If specified, resource files will be saved with the specified prefix instead of using the template name specified. If no template name is specified the files will be called PnP-Resources.&lt;language&gt;.resx. See examples for more info.
 
 Only applicable to: SharePoint Online, SharePoint Server 2016
 

sharepoint/sharepoint-ps/sharepoint-pnp/Get-PnPSearchCrawlLog.md

@@ -0,0 +1,168 @@
+---
+external help file:
+applicable: SharePoint Online
+schema: 2.0.0
+---
+# Get-PnPSearchCrawlLog
+
+## SYNOPSIS
+Returns entries from the SharePoint search crawl log
+
+## SYNTAX 
+
+```powershell
+Get-PnPSearchCrawlLog [-LogLevel <LogLevel>]
+                      [-RowLimit <Int>]
+                      [-Filter <String>]
+                      [-ContentSource <ContentSource>]
+                      [-StartDate <DateTime>]
+                      [-EndDate <DateTime>]
+                      [-Web <WebPipeBind>]
+                      [-Connection <SPOnlineConnection>]
+```
+
+## EXAMPLES
+
+### ------------------EXAMPLE 1------------------
+```powershell
+Get-PnPSearchCrawlLog
+```
+
+Returns the last 100 crawl log entries for site content.
+
+### ------------------EXAMPLE 2------------------
+```powershell
+Get-PnPSearchCrawlLog "https://<tenant>-my.sharepoint.com/personal"
+```
+
+Returns the last 100 crawl log entries for OneDrive content.
+
+### ------------------EXAMPLE 3------------------
+```powershell
+Get-PnPSearchCrawlLog -ContentSource UserProfiles 
+```
+
+Returns the last 100 crawl log entries for user profiles.
+
+### ------------------EXAMPLE 4------------------
+```powershell
+Get-PnPSearchCrawlLog -ContentSource UserProfiles -Filter "mikael"
+```
+
+Returns the last 100 crawl log entries for user profiles with the term "mikael" in the user principal name.
+
+### ------------------EXAMPLE 5------------------
+```powershell
+Get-PnPSearchCrawlLog -ContentSource Sites LogLevel Error -RowLimit 10
+```
+
+Returns the last 10 crawl log entries with a state of Error for site content.
+
+### ------------------EXAMPLE 6------------------
+```powershell
+Get-PnPSearchCrawlLog -EndDate (Get-Date).AddDays(-100)
+```
+
+Returns the last 100 crawl log entries for site content up until 100 days ago.
+
+## PARAMETERS
+
+### -ContentSource
+Content to retrieve (Sites, User Profiles). Defaults to Sites.
+
+```yaml
+Type: ContentSource
+Parameter Sets: (All)
+
+Required: False
+Position: Named
+Accept pipeline input: False
+```
+
+### -EndDate
+End date to stop getting entries from. Default to current time.
+
+```yaml
+Type: DateTime
+Parameter Sets: (All)
+
+Required: False
+Position: Named
+Accept pipeline input: False
+```
+
+### -Filter
+Filter to limit what is being returned. Has to be a URL prefix for SharePoint content, and part of a user principal name for user profiles. Wildcard characters are not supported.
+
+```yaml
+Type: String
+Parameter Sets: (All)
+
+Required: False
+Position: Named
+Accept pipeline input: False
+```
+
+### -LogLevel
+Filter what log entries to return (All, Success, Warning, Error). Defaults to All
+
+```yaml
+Type: LogLevel
+Parameter Sets: (All)
+
+Required: False
+Position: Named
+Accept pipeline input: False
+```
+
+### -RowLimit
+Number of entries to return. Defaults to 100.
+
+```yaml
+Type: Int
+Parameter Sets: (All)
+
+Required: False
+Position: Named
+Accept pipeline input: False
+```
+
+### -StartDate
+Start date to start getting entries from. Defaults to start of time.
+
+```yaml
+Type: DateTime
+Parameter Sets: (All)
+
+Required: False
+Position: Named
+Accept pipeline input: False
+```
+
+### -Connection
+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
+Parameter Sets: (All)
+
+Required: False
+Position: Named
+Accept pipeline input: False
+```
+
+### -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
+Parameter Sets: (All)
+
+Required: False
+Position: Named
+Accept pipeline input: False
+```
+
+## RELATED LINKS
+
+[SharePoint Developer Patterns and Practices](http://aka.ms/sppnp)

sharepoint/sharepoint-ps/sharepoint-pnp/Grant-PnPHubSiteRights.md

@@ -6,7 +6,7 @@ schema: 2.0.0
 # Grant-PnPHubSiteRights
 
 ## SYNOPSIS
-Retrieve all or a specific hubsite.
+Grant Permissions to associate sites to Hub Sites.
 
 ## SYNTAX 
 
@@ -18,17 +18,10 @@ Grant-PnPHubSiteRights [-Connection <SPOnlineConnection>]
 
 ### ------------------EXAMPLE 1------------------
 ```powershell
-Get-PnPStorageEntity
+Grant-PnPHubSiteRights -Identity https://contoso.sharepoint.com/sites/hubsite -Principals "[email protected]","[email protected]" -Rights Join
 ```
 
-Returns all site storage entities/farm properties
-
-### ------------------EXAMPLE 2------------------
-```powershell
-Get-PnPTenantSite -Key MyKey
-```
-
-Returns the storage entity/farm property with the given key.
+This example shows how to grant right to myuser and myotheruser to associate their sites with hubsite
 
 ## PARAMETERS