Merge branch 'master' into chrisda

Author: chrisda

exchange/exchange-ps/exchange/mailboxes/Get-MailboxLocation.md

@@ -208,4 +208,4 @@ To see the return types, which are also known as output types, that this cmdlet
 
 ## RELATED LINKS
 
-[Online Version](https://technet.microsoft.com/library/b6393122-1556-4b0b-b80d-c7737b09eb9c.aspx)
+[Online Version](https://docs.microsoft.com/powershell/module/exchange/mailboxes/get-mailboxlocation)

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

@@ -1,6 +1,6 @@
 # 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.
+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 and SharePoint On-Premises.
 
 ![SharePoint Patterns and Practices](https://devofficecdn.azureedge.net/media/Default/PnP/sppnp.png)
 

sharepoint/sharepoint-ps/sharepoint-online/Add-SPOHubSiteAssociation.md

@@ -13,7 +13,7 @@ Associates a site with a hub site.
 ## SYNTAX
 
 ```
-Add-SPOHubSiteAssociation [-Site] <SpoSitePipeBind> `
+Add-SPOHubSiteAssociation [-Site] <SpoSitePipeBind> 
 -HubSite <SpoHubSitePipeBind> `
 [<CommonParameters>]
 ```
@@ -26,7 +26,7 @@ Use this cmdlet to associate a site with a hub site.
 ### Example 1
 
 ```
-Add-SPOHubSiteAssociation https://contoso.sharepoint.com/sites/Research `
+Add-SPOHubSiteAssociation https://contoso.sharepoint.com/sites/Research 
 -HubSite https://contoso.sharepoint.com/sites/Marketing 
 ```
 

sharepoint/sharepoint-ps/sharepoint-online/Add-SPOSiteDesignTask.md

@@ -0,0 +1,80 @@
+---
+applicable: SharePoint Online
+title: Add-SPOSiteDesignTask
+schema: 2.0.0
+---
+
+# Add-SPOSiteDesignTask
+
+## SYNOPSIS
+
+Similar to Invoke-SPOSiteDesign, this command is used to apply a published site design to a specified site collection target. It schedules the operation, allowing for the application of larger site scripts (Invoke-SPOSiteDesign is limited to 30 actions and subactions). 
+
+The supported site templates you can apply a site design to include: “modern” team site (with O365 group), “modern” team site (without an O365 group); communication site; classic team site; and classic publishing site. 
+
+## SYNTAX
+
+```powershell
+Add-SPOSiteDesignTask
+  -SiteDesignId <guid>
+  -WebUrl <string>
+  [<CommonParameters>]
+```
+
+## DESCRIPTION
+
+This command is used to apply a published site design to a specified site collection target. It schedules the operation, allowing for the application of larger site scripts (Invoke-SPOSiteDesign is limited to 30 actions and subactions).  
+
+This command is intended to replace Invoke-SPOSiteDesign and is useful when you need to apply a large number of actions or multiple site scripts.
+
+> [!NOTE]
+> This command only creates the request. To check on the job status or to view details of the scheduled run, use the commands in the related section below.
+
+## EXAMPLES
+
+### Example 1
+
+This example applies a site design that includes two site scripts - totaling over 30 site script actions. Executing the commands will schedule the site design to be queued and run against the designated site collection.
+
+```powershell
+Add-SPOSiteDesignTask -SiteDesignId 501z8c32-4147-44d4-8607-26c2f67cae82 -WebUrl "https://contoso.sharepoint.com/sites/projectawesome”
+```
+
+## PARAMETERS
+
+### -SiteDesignId
+The ID of the site design to apply.
+
+```yaml
+Type: SPOSiteDesignPipeBind
+Parameter Sets: (All)
+Aliases: 
+Applicable: SharePoint Online
+Required: True 
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False  
+```
+
+### -WebUrl
+The URL of the site collection where the site design will be applied.
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases: 
+Applicable: SharePoint Online
+Required: True 
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False  
+```
+## RELATED COMMANDS
+
+- [Get-SPOSiteDesignTask](https://docs.microsoft.com/en-us/powershell/module/sharepoint-online/get-spositedesigntask?view=sharepoint-ps)
+
+- [Invoke-SPOSiteDesign](https://docs.microsoft.com/en-us/powershell/module/sharepoint-online/invoke-spositedesign?view=sharepoint-ps)
+
+

sharepoint/sharepoint-ps/sharepoint-online/Get-SPOSiteScriptFromList.md

@@ -0,0 +1,58 @@
+---
+external help file: 
+applicable: SharePoint Online
+title: Get-SPOSiteScriptFromList
+schema: 2.0.0
+---
+
+# Get-SPOSiteScriptFromList
+
+## SYNOPSIS
+
+Creates site script syntax from an existing SharePoint list.
+
+## SYNTAX
+
+```powershell
+Get-SPOSiteScriptFromList
+  -ListUrl <string>
+  [<CommonParameters>]
+```
+
+## DESCRIPTION
+
+Uses an existing SharePoint list to output a JSON blob that can be used to create a site script for use in a site design. 
+
+[!NOTE]
+Most column data types and list configurations - including view formatting - are supported. Managed metadata fields cannot be extracted at this time. 
+
+## EXAMPLES
+
+### Example 1
+
+This example creates the site script output from an existing list - and writes it to a variable. This variable is then referenced to create a site script.
+
+```powershell
+C:\> $extracted = Get-SPOSiteScriptFromList -ListUrl "https://contoso.sharepoint.com/sites/strategy/customer-contacts"
+C:\> Add-SPOSiteScript `
+    -Title "Contoso Customer Tracker"
+    -Description "This creates a customer contact list"
+    -Content $extracted
+```
+
+## PARAMETERS
+
+### -ListUrl
+The url of the list to be referenced for the JSON output.
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases: 
+Applicable: SharePoint Online
+Required: True
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False 
+```

sharepoint/sharepoint-ps/sharepoint-online/Remove-SPOSiteDesignTask.md

@@ -0,0 +1,62 @@
+---
+external help file: Microsoft.Online.SharePoint.PowerShell.dll-Help.xml
+applicable: SharePoint Online
+title: Remove-SPOSiteDesignTask
+schema: 2.0.0
+---
+
+# Remove-SPOSiteDesignTask
+
+## SYNOPSIS
+
+Command to remove a scheduled site design script. 
+
+## SYNTAX
+
+```powershell
+Remove-SPOSiteDesignTask
+  -Identity <guid>
+  [<CommonParameters>]
+```
+
+## DESCRIPTION
+
+Removes a scheduled site design by providing the site design ID. If the execution of the associated site script has already started the execution will not be terminated.
+
+> [!NOTE]
+> This command only removes a scheduled request. To check on the job status or to view details of the scheduled run, use the commands in the related section below.
+
+## EXAMPLES
+
+### Example 1
+
+This example removes a previously scheduled site design.
+
+```powershell
+Remove-SPOSiteDesignTask -Identity 501z8c32-4147-44d4-8607-26c2f67cae82 
+```
+
+## PARAMETERS
+
+### -Identity
+The ID of the site design to apply.
+
+```yaml
+Type: SPOSiteDesignPipeBind
+Parameter Sets: (All)
+Aliases: 
+Applicable: SharePoint Online
+Required: True 
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False  
+```
+
+## RELATED LINKS
+
+[Get-SPOSiteDesignTask](Get-SPOSiteDesignTask.md)
+
+[Get-SPOSiteDesignRun](Get-SPOSiteDesignRun.md)
+
+[Get-SPOSiteDesignRunStatus](Get-SPOSiteDesignRunStatus.md)

sharepoint/sharepoint-ps/sharepoint-online/sharepoint-online.md

@@ -22,6 +22,9 @@ The following cmdlet references are for SharePoint Online.
 ### [Add-SPOSiteDesign](Add-SPOSiteDesign.md)
 {{Manually Enter Add-SPOSiteDesign Description Here}}
 
+### [Add-SPOSiteDesign](Add-SPOSiteDesignTask.md)
+{{Manually Enter Add-SPOSiteDesignTask Description Here}}
+
 ### [Add-SPOSiteScript](Add-SPOSiteScript.md)
 {{Manually Enter Add-SPOSiteScript Description Here}}
 
@@ -118,15 +121,27 @@ The following cmdlet references are for SharePoint Online.
 ### [Get-SPOSiteDesign](Get-SPOSiteDesign.md)
 {{Manually Enter Get-SPOSiteDesign Description Here}}
 
+### [Get-SPOSiteDesignRun](Get-SPOSiteDesignRun.md)
+{{Manually Enter Get-SPOSiteDesignRights Description Here}}
+
+### [Get-SPOSiteDesignRunStatus](Get-SPOSiteDesignRunStatus.md)
+{{Manually Enter Get-SPOSiteDesignRights Description Here}}
+
 ### [Get-SPOSiteDesignRights](Get-SPOSiteDesignRights.md)
 {{Manually Enter Get-SPOSiteDesignRights Description Here}}
 
+### [Get-SPOSiteDesignTask](Get-SPOSiteDesignTask.md)
+{{Manually Enter Add-SPOSiteDesign Description Here}}
+
 ### [Get-SPOSiteGroup](Get-SPOSiteGroup.md)
 {{Manually Enter Get-SPOSiteGroup Description Here}}
 
 ### [Get-SPOSiteScript](Get-SPOSiteScript.md)
 {{Manually Enter Get-SPOSiteScript Description Here}}
 
+### [Get-SPOSiteScriptFromList](Get-SPOSiteScriptFromList.md)
+{{Manually Enter Get-SPOSiteScript Description Here}}
+
 ### [Get-SPOTenant](Get-SPOTenant.md)
 {{Manually Enter Get-SPOTenant Description Here}}
 
@@ -244,6 +259,9 @@ The following cmdlet references are for SharePoint Online.
 ### [Remove-SPOSiteDesign](Remove-SPOSiteDesign.md)
 {{Manually Enter Remove-SPOSiteDesign Description Here}}
 
+### [Remove-SPOSiteDesignTask](Remove-SPOSiteDesignTask.md)
+{{Manually Enter Remove-SPOSiteDesign Description Here}}
+
 ### [Remove-SPOSiteGroup](Remove-SPOSiteGroup.md)
 {{Manually Enter Remove-SPOSiteGroup Description Here}}
 
@@ -368,4 +386,4 @@ The following cmdlet references are for SharePoint Online.
 {{Manually Enter Upgrade-SPOSite Description Here}}
 
 
-<!--updated March 6, 2018; moved cmdlets from https://docs.microsoft.com/en-us/sharepoint/dev/declarative-customization/site-design-powershell; added items from TOC that were missing on this page-->
+<!--updated March 6, 2018; moved cmdlets from https://docs.microsoft.com/en-us/sharepoint/dev/declarative-customization/site-design-powershell; added items from TOC that were missing on this page-->