Merge branch 'master' into patch-51

Author: chrisda

exchange/exchange-ps/exchange/advanced-threat-protection/Get-MailDetailATPReport.md

@@ -44,10 +44,10 @@ You need to be assigned permissions before you can run this cmdlet. Although thi
 
 ### Example 1
 ```powershell
-Get-MailDetailATPReport -StartDate 7/1/2018 -EndDate 7/31/2018
+Get-MailDetailATPReport -StartDate 7/22/2018 -EndDate 7/31/2018
 ```
 
-This example returns the Advanced Threat Protection actions for July, 2018.
+This example returns the Advanced Threat Protection actions for the last 10 days in July, 2018. (Note: Customers with Advanced Threat Protection subscription will be able to get up to 30 days of data.)
 
 ## PARAMETERS
 

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

@@ -45,7 +45,7 @@ You need to be assigned permissions before you can run this cmdlet. Although thi
 
 ### Example 1
 ```powershell
-Get-Mailbox | Get-MailboxAutoReplyConfiguration
+Get-Mailbox -ResultSize unlimited | Get-MailboxAutoReplyConfiguration
 ```
 
 This example returns Automatic Replies settings for all mailboxes in the Exchange organization.
@@ -57,13 +57,6 @@ Get-MailboxAutoReplyConfiguration -Identity 'contoso.com/Users/Tony Smith'
 
 This example retrieves Automatic Replies settings for Tony's mailbox at contoso.com.
 
-### Example 3
-```powershell
-Get-Mailbox | Get-MailboxAutoReplyConfiguration -ResultSize unlimited
-```
-
-This example retrieves all Automatic Replies settings for all mailboxes in the Exchange organization.
-
 ## PARAMETERS
 
 ### -Identity

exchange/exchange-ps/exchange/policy-and-compliance/New-Label.md

@@ -137,6 +137,8 @@ The LocaleSettings parameter specifies one or more localized label name or label
 
 - Label Tooltips: {"localeKey":"Tooltip","Settings":[{"Key":"en-us","Value":"English Tooltip"},{"Key":"de-de",Value":"Deutscher Tooltip"},{"Key":"es-es","Value":"Tooltip Español"}]}
 
+The languages you use in the display name and Tooltip must mach. For example, you can't have a German display name without a corresponding German ToolTip.
+
 ```yaml
 Type: MultiValuedProperty
 Parameter Sets: (All)

exchange/exchange-ps/exchange/powershell-v2-module/Connect-ExchangeOnline.md

@@ -266,7 +266,11 @@ Accept wildcard characters: False
 
 
 ### -PSSessionOption
-The PSSessionOption parameter specifies the PowerShell session options to use in your connection to Exchange Online. You store the output of the [New-PSSessionOption](https://docs.microsoft.com/powershell/module/microsoft.powershell.core/new-pssessionoption) command in a variable (for example, `$Options = New-PSSessionOption <Settings>`), and you use the variable name as the value for this parameter (for example, $Options).
+The PSSessionOption parameter specifies the PowerShell session options to use in your connection to Exchange Online. You store the output of the [New-PSSessionOption](https://docs.microsoft.com/powershell/module/microsoft.powershell.core/new-pssessionoption) command in a variable, for example:
+
+`$Options = New-PSSessionOption <Settings>`
+
+And you use the variable name as the value for this parameter (for example, $Options).
 
 ```yaml
 Type: PSSessionOption

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

@@ -15,7 +15,7 @@ _**Applies to:** SharePoint Online | SharePoint 2016 | SharePoint 2013_
 There are 3 ways to install the cmdlets. We recommend, where possible, to install them from the [PowerShell Gallery](https://www.powershellgallery.com). Alternatively you can download the setup files or run a PowerShell script to download the PowerShellGet module and install the cmdlets subsequently.
 
 ### PowerShell Gallery ###
-If you main OS is Windows 10, or if you have [PowerShellGet](https://github.com/powershell/powershellget) installed, you can run the following commands to install the PowerShell cmdlets:
+If your main OS is Windows 10, or if you have [PowerShellGet](https://github.com/powershell/powershellget) installed, you can run the following commands to install the PowerShell cmdlets:
 
 |**SharePoint Version**|**Command to install**|
 |------------------|------------------|

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

@@ -81,6 +81,8 @@ Add-SPOTheme -Identity "Custom Cyan" -Palette $themepalette -IsInverted $false -
 
 ### -Identity
 
+Specifies the name of the theme. This must uniquely identify the theme. 
+
 ```yaml
 Type: SpoThemePalettePipeBind
 Parameter Sets: (All)
@@ -95,6 +97,8 @@ Accept wildcard characters: False
 
 ### -IsInverted
 
+Specifies whether the theme is inverted, with a dark background and a light foreground. 
+
 ```yaml
 Type: Boolean
 Parameter Sets: (All)
@@ -109,6 +113,8 @@ Accept wildcard characters: False
 
 ### -Overwrite
 
+Overwrites a theme of the same name in case it exists.
+
 ```yaml
 Type: SwitchParameter
 Parameter Sets: (All)
@@ -123,6 +129,8 @@ Accept wildcard characters: False
 
 ### -Palette
 
+Specifies the palette of colors in the theme, as a dictionary of theme slot values. 
+
 ```yaml
 Type: SpoThemePalettePipeBind
 Parameter Sets: (All)

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

@@ -26,7 +26,7 @@ Add-SPOUser -Group <String> -LoginName <String> -Site <SpoSitePipeBind> [<Common
 
 Along with the group memberships that are normally required to run Windows PowerShell, you must have the SharePoint Admin role or Global Administrator role and be a site collection administrator to use the `Add-SPOUser` cmdlet.
 
-For permissions and the most current information about Windows PowerShell for SharePoint Online, see the online documentation at <https://go.microsoft.com/fwlink/p/?LinkId=251832> (<https://go.microsoft.com/fwlink/p/?LinkId=251832).>
+For permissions and the most current information about Windows PowerShell for SharePoint Online, see the online documentation at [Intro to SharePoint Online Management Shell](https://docs.microsoft.com/powershell/sharepoint/sharepoint-online/introduction-sharepoint-online-management-shell?view=sharepoint-ps).
 
 ## EXAMPLES
 

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

@@ -0,0 +1,79 @@
+---
+external help file: Microsoft.Online.SharePoint.PowerShell.dll-Help.xml
+Module Name: Microsoft.Online.SharePoint.PowerShell
+online version:
+schema: 2.0.0
+applicable: SharePoint Online
+title: Get-SPOStructuralNavigationCacheSiteState
+author: paramveersisodia
+ms.author: paramsis
+manager: suyog
+ms.reviewer:
+---
+
+# Get-SPOStructuralNavigationCacheSiteState
+
+## SYNOPSIS
+Get the structural navigation caching state for a site collection.
+
+## SYNTAX
+
+```
+Get-SPOStructuralNavigationCacheSiteState -SiteUrl <String> [<CommonParameters>]
+```
+
+## DESCRIPTION
+The Get-SPOStructuralNavigationCacheSiteState cmdlet can be used to determine if structural navigation caching is enabled or disabled for a site collection. [Learn more](https://support.office.com/article/structural-navigation-and-performance-f163053f-8eca-4b9c-b973-36b395093b43). 
+
+## EXAMPLES
+
+### Example 1
+```powershell
+PS C:\> Get-SPOStructuralNavigationCacheSiteState -weburl "https://contoso.sharepoint.com/sites/product/" 
+```
+
+This example checks if structural navigation caching is enabled for the entire site collection https://contoso.sharepoint.com/sites/product/. If caching is enabled, then it will return True. If caching is disabled, then it will return False. 
+
+## PARAMETERS
+
+### -SiteUrl
+Specifies the absolute URL for the site collection's root web being checked for its caching state. 
+
+```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
+```
+
+### CommonParameters
+This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
+
+## INPUTS
+
+### None
+
+## OUTPUTS
+
+### System.Object
+## NOTES
+    To see the examples, type: "get-help Get-SPOStructuralNavigationCacheSiteState -examples". 
+
+    For more information, type: "get-help Get-SPOStructuralNavigationCacheSiteState -detailed". 
+
+    For technical information, type: "get-help Get-SPOStructuralNavigationCacheSiteState -full". 
+
+    For online help, type: "get-help Get-SPOStructuralNavigationCacheSiteState -online" 
+
+ 
+## RELATED LINKS
+[Get-SPOStructuralNavigationCacheWebState](Get-SPOStructuralNavigationCacheWebState.md)
+
+[Set-SPOStructuralNavigationCacheWebState](Set-SPOStructuralNavigationCacheWebState.md)
+
+[Set-SPOStructuralNavigationCacheSiteState](Set-SPOStructuralNavigationCacheSiteState.md)

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

@@ -0,0 +1,77 @@
+---
+external help file: Microsoft.Online.SharePoint.PowerShell.dll-Help.xml
+Module Name: Microsoft.Online.SharePoint.PowerShell
+online version:
+schema: 2.0.0
+applicable: SharePoint Online
+title: Get-SPOStructuralNavigationCacheWebState
+author: paramveersisodia
+ms.author: paramsis
+manager: suyog
+ms.reviewer:
+---
+
+# Get-SPOStructuralNavigationCacheWebState
+
+## SYNOPSIS
+Get the structural navigation caching state for a web. 
+
+## SYNTAX
+
+```
+Get-SPOStructuralNavigationCacheWebState -WebUrl <String> [<CommonParameters>]
+```
+
+## DESCRIPTION
+The Get-SPOStructuralNavigationCacheWebState cmdlet can be used to determine if structural navigation caching is enabled or disabled for a web in a site collection. [Learn more](https://support.office.com/article/structural-navigation-and-performance-f163053f-8eca-4b9c-b973-36b395093b43). 
+
+## EXAMPLES
+
+### Example 1
+```powershell
+PS C:\> Get-SPOStructuralNavigationCacheWebState -weburl "https://contoso.sharepoint.com/sites/product/electronics" 
+```
+
+This example checks if structural navigation caching is enabled for the web https://contoso.sharepoint.com/sites/product/electronics. If caching is enabled, then it will return True. If caching is disabled, then it will return False.
+
+## PARAMETERS
+
+### -WebUrl
+Specifies the absolute URL for the web being checked for its caching state.
+
+```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
+```
+
+### CommonParameters
+This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
+
+## INPUTS
+
+### None
+
+## OUTPUTS
+
+### System.Object
+## NOTES
+    To see the examples, type: "get-help Get-SPOStructuralNavigationCacheWebState -examples". 
+
+    For more information, type: "get-help Get-SPOStructuralNavigationCacheWebState -detailed". 
+
+    For technical information, type: "get-help Get-SPOStructuralNavigationCacheWebState -full". 
+
+    For online help, type: "get-help Get-SPOStructuralNavigationCacheWebState -online" 
+## RELATED LINKS
+[Set-SPOStructuralNavigationCacheWebState](Set-SPOStructuralNavigationCacheWebState.md)
+
+[Get-SPOStructuralNavigationCacheSiteState](Get-SPOStructuralNavigationCacheSiteState.md)
+
+[Set-SPOStructuralNavigationCacheSiteState](Set-SPOStructuralNavigationCacheSiteState.md)

sharepoint/sharepoint-ps/sharepoint-online/Invoke-SPOSiteSwap.md

@@ -160,6 +160,9 @@ Accept wildcard characters: False
 ### -Force
 
 Overrides and ignores any warnings that have been identified by the Page Diagnostic Tool that are preventing a swap from being initiated.
+
+For example, if you receive the warning "Invoke-SPOSiteSwap : Errors: 0; Warnings: 1; Details: The site is not a communications site or it has the classic publishing feature enabled." then this warning can be overriden and ignored using this parameter.
+
 Any errors identified by the Page Diagnostic Tool will still always prevent a swap from being initiated regardless of this parameter.
 
 ```yaml

sharepoint/sharepoint-ps/sharepoint-online/New-SPOSite.md

@@ -185,7 +185,7 @@ Accept wildcard characters: False
 
 ### -TimeZoneId
 
-Specifies the time zone of the site collection. For more information, see SPRegionalSettings.TimeZones Property (<https://go.microsoft.com/fwlink/p/?LinkId=242912).>
+Specifies the time zone of the site collection. For more information, see [SPRegionalSettings.TimeZones Property](https://docs.microsoft.com/dotnet/api/microsoft.sharepoint.spregionalsettings.timezones).
 
 ```yaml
 Type: Int32

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

@@ -26,7 +26,7 @@ Remove-SPOGeoAdministrator [-LoginName] <String> [<CommonParameters>]
 
 This cmdlet contains a single parameter set.
 You may only use parameters from one parameter set and you may not combine parameters from different parameter sets.
-For more information about how to use parameter sets, see Cmdlet Parameter Sets (<https://go.microsoft.com/fwlink/?LinkID=187810).>
+For more information about how to use parameter sets, see [Cmdlet parameter sets](https://docs.microsoft.com/powershell/scripting/developer/cmdlet/cmdlet-parameter-sets).
 
 The `Remove-SPOGeoAdministrator` cmdlet matches a user or a security group and remove the GeoAdministrator privileges in the SharePoint Organization.
 

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

@@ -26,7 +26,7 @@ Remove-SPOUserInfo -LoginName <String> -Site <SpoSitePipeBind> [<CommonParameter
 
 Can be used to remove user from user information lists of the specific site collections.
 
-For permissions and the most current information about Windows PowerShell for SharePoint Online, see the online documentation at <https://go.microsoft.com/fwlink/p/?LinkId=251832> (<https://go.microsoft.com/fwlink/p/?LinkId=251832).>
+For permissions and the most current information about Windows PowerShell for SharePoint Online, see the online documentation at [Intro to SharePoint Online Management Shell](https://docs.microsoft.com/powershell/sharepoint/sharepoint-online/introduction-sharepoint-online-management-shell?view=sharepoint-ps).
 
 ## EXAMPLES
 

sharepoint/sharepoint-ps/sharepoint-online/Restore-SPODeletedSite.md

@@ -26,7 +26,7 @@ Restore-SPODeletedSite -Identity <SpoSitePipeBind> [-NoWait] [<CommonParameters>
 
 You must be a SharePoint Online administrator or Global Administrator and be a site collection administrator to run the cmdlet.
 
-For permissions and the most current information about Windows PowerShell for SharePoint Online, see the online documentation at <https://go.microsoft.com/fwlink/p/?LinkId=251832> (<https://go.microsoft.com/fwlink/p/?LinkId=251832).>
+For permissions and the most current information about Windows PowerShell for SharePoint Online, see the online documentation at [Intro to SharePoint Online Management Shell](https://docs.microsoft.com/powershell/sharepoint/sharepoint-online/introduction-sharepoint-online-management-shell?view=sharepoint-ps).
 
 ## EXAMPLES