Merge branch 'master' into chrisda

Author: chrisda

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

@@ -5,8 +5,8 @@ online version: https://docs.microsoft.com/powershell/module/sharepoint-online/g
 applicable: SharePoint Online
 title: Get-SPOBrowserIdleSignOut
 schema: 2.0.0
-author:
-ms.author:
+author: trent-green
+ms.author: trgreen
 ms.reviewer:
 ---
 
@@ -24,17 +24,17 @@ Get-SPOBrowserIdleSignOut [<CommonParameters>]
 
 ## DESCRIPTION
 
-.
+Use this cmdlet to retrieve the current configuration values for Idle session sign-out policy, the time at which users are warned and subsequently signed out of Office 365 after a period of browser inactivity in SharePoint and OneDrive.
 
 ## EXAMPLES
 
 ### Example 1
 
 ```powershell
-
+Get-SPOBrowserIdleSignOut
 ```
 
-.
+This example retrieves the current configuration values for Idle session sign-out
 
 ## PARAMETERS
 

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

@@ -14,7 +14,7 @@ ms.reviewer:
 
 ## SYNOPSIS
 
-.
+Gets the visibility of the available built-in Design Packages.
 
 ## SYNTAX
 
@@ -24,23 +24,35 @@ Get-SPOBuiltInDesignPackageVisibility [-DesignPackage <DesignPackageType>] [<Com
 
 ## DESCRIPTION
 
-.
+Use this cmdlet to retrieve the current visibility state of each built-in design package.
 
 ## EXAMPLES
 
 ### Example 1
 
 ```powershell
+Get-SPOBuiltInDesignPackageVisibility -DesignPackage Showcase
+```
+
+This example retrieves the current visibility state of Showcase built-in design package.
 
+### Example 2
+
+```powershell
+Get-SPOBuiltInDesignPackageVisibility
 ```
 
-.
+This example retrieves the current visibility state of each built-in design package.
 
 ## PARAMETERS
 
 ### -DesignPackage
 
-.
+Name of the design package, available names are
+- Topic
+- Showcase
+- Blank
+- TeamSite
 
 ```yaml
 Type: DesignPackageType

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

@@ -14,7 +14,7 @@ ms.reviewer:
 
 ## SYNOPSIS
 
-Use the Get-DataEncryptionPolicy cmdlet to view data encryption policies in SharePoint Online..
+.
 
 ## SYNTAX
 
@@ -24,23 +24,39 @@ Get-SPODataEncryptionPolicy [-Identity] <SpoSitePipeBind> [<CommonParameters>]
 
 ## DESCRIPTION
 
-.
+Use the Get-DataEncryptionPolicy cmdlet to view customer encryption status for your geo tenant.
+
+For more information, see [Controlling your data in Office 365 using Customer Key](https://docs.microsoft.com/en-us/microsoft-365/compliance/controlling-your-data-using-customer-key)
 
 ## EXAMPLES
 
 ### Example 1
 
 ```powershell
-
+Get-SPODataEncryptionPolicy -Identity https://contoso-admin.sharepoint.com
 ```
 
-.
+The output from this cmdlet includes:
+  
+- The URI of the primary key.
+
+- The URI of the secondary key.
+
+- The encryption status for the geo. Possible states include:
+
+  - **Unregistered:** Customer Key encryption has not yet been applied.
+
+  - **Registering:** Customer Key encryption has been applied and your files are in the process of being encrypted. If your geo is in this state, you'll also be shown information on what percentage of sites in the geo are complete so that you can monitor encryption progress.
+
+  - **Registered:** Customer Key encryption has been applied, and all files in all sites have been encrypted.
+
+  - **Rolling:** A key roll is in progress. If your geo is in this state, you'll also be shown information on what percentage of sites have completed the key roll operation so that you can monitor progress.
 
 ## PARAMETERS
 
 ### -Identity
 
-.
+Specifies the URL of the admin site collection.
 
 ```yaml
 Type: SpoSitePipeBind

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

@@ -24,7 +24,7 @@ Get-SPOMultiGeoExperience [<CommonParameters>]
 
 ## DESCRIPTION
 
-Use this cmdlet to get the multi geo experience.
+Use this cmdlet to get the multi geo experience mode.  For more information see [Enabling SharePoint Multi-Geo in your satellite geo location](https://docs.microsoft.com/office365/enterprise/enabling-sp-multigeo-satellite-geolocation)
 
 ## EXAMPLES
 
@@ -34,7 +34,7 @@ Use this cmdlet to get the multi geo experience.
 Get-SPOMultiGeoExperience
 ```
 
-This example .
+This example will show you whether the geo location is in SPO or ODB mode.
 
 ## PARAMETERS
 

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

@@ -14,7 +14,7 @@ ms.reviewer:
 
 ## SYNOPSIS
 
-.
+Use this cmdlet to get the Site Collection App Catalog.
 
 ## SYNTAX
 
@@ -24,7 +24,7 @@ ms.reviewer:
 
 ## DESCRIPTION
 
-Use this cmdlet to get the Site Collection App Catalogs.
+Use this cmdlet to get the Site Collection App Catalog. For more information, see [Use the App Catalog to make custom business apps available for your SharePoint environment](https://docs.microsoft.com/sharepoint/use-app-catalog)
 
 ## EXAMPLES
 
@@ -36,26 +36,18 @@ Use this cmdlet to get the Site Collection App Catalogs.
 
 This example returns the Site Collection App Catalog for the site <https://contoso.sharepoint.com/sites/Research.>
 
-### Example 2
-
-```powershell
- Get-SPOSiteCollectionAppCatalogs
-```
-
-This example returns all Site Collection App Catalogs.
-
 ## PARAMETERS
 
 ### -Site
 
-.
+Url of the site
 
 ```yaml
 Type: SpoSitePipeBind
 Parameter Sets: (All)
 Aliases:
 Applicable: SharePoint Online
-Required: False
+Required: True
 Position: 1
 Default value: None
 Accept pipeline input: False

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

@@ -14,7 +14,7 @@ ms.reviewer:
 
 ## SYNOPSIS
 
-.
+Returns the current rename job state of a SharePoint Online Site.
 
 ## SYNTAX
 
@@ -32,17 +32,25 @@ Get-SPOSiteRenameState [-State <RenameState>] [-WhatIf] [-Confirm] [<CommonParam
 
 ## DESCRIPTION
 
-Use this cmdlet to .
+Use this cmdlet to return the current rename job state of a SharePoint Online Site.
 
 ## EXAMPLES
 
 ### Example 1
 
 ```powershell
-Get-SPOSiteRenameState -Identity
+Get-SPOSiteRenameState -Identity https://contoso.sharepoint.com/sites/ContosoWeb1
 ```
 
-This example .
+This example returns the rename job state of ContosoWeb1 Site.
+
+### Example 2
+
+```powershell
+Get-SPOSiteRenameState -State InProgress
+```
+
+This example returns rename jobs that are in InProgress state.
 
 ## PARAMETERS
 
@@ -64,7 +72,13 @@ Accept wildcard characters: False
 
 ### -State
 
-The urls of the site to be renamed.
+The state of the rename job, possible values are
+
+- Success
+
+- InProgress
+
+- Fail
 
 ```yaml
 Type: RenameState

sharepoint/sharepoint-ps/sharepoint-online/Register-SPODataEncryptionPolicy.md

@@ -14,7 +14,8 @@ ms.reviewer:
 
 ## SYNOPSIS
 
-.
+Cmdlet to register customer encryption status for your geo tenant.
+For more information, see [Controlling your data in Office 365 using Customer Key](https://docs.microsoft.com/en-us/microsoft-365/compliance/controlling-your-data-using-customer-key)
 
 ## SYNTAX
 
@@ -24,23 +25,24 @@ Register-SPODataEncryptionPolicy [-Identity] <SpoSitePipeBind> -PrimaryKeyVaultN
 
 ## DESCRIPTION
 
-.
+Use the Update-DataEncryptionPolicy cmdlet to register customer encryption status for your geo tenant.
+For more information, see [Controlling your data in Office 365 using Customer Key](https://docs.microsoft.com/en-us/microsoft-365/compliance/controlling-your-data-using-customer-key)
 
 ## EXAMPLES
 
 ### Example 1
 
 ```powershell
-
+Register-SPODataEncryptionPolicy -Identity https://contoso.sharepoint.com -PrimaryKeyVaultName <string> -PrimaryKeyName <string> -PrimaryKeyVersion <KeyVersion>
 ```
 
-.
+This example registers the DEP used with SharePoint Online and OneDrive for Business to start using the given primary key
 
 ## PARAMETERS
 
 ### -Identity
 
-.
+Specifies the URL of the admin site collection.
 
 ```yaml
 Type: SpoSitePipeBind
@@ -56,7 +58,7 @@ Accept wildcard characters: False
 
 ### -PrimaryKeyVaultName
 
-.
+The name of the primary key vault
 
 ```yaml
 Type: String
@@ -72,7 +74,7 @@ Accept wildcard characters: False
 
 ### -PrimaryKeyName
 
-.
+The name of the primary key
 
 ```yaml
 Type: String
@@ -88,7 +90,7 @@ Accept wildcard characters: False
 
 ### -PrimaryKeyVersion
 
-.
+The version of the primary key
 
 ```yaml
 Type: Guid
@@ -104,7 +106,7 @@ Accept wildcard characters: False
 
 ### -SecondaryKeyVaultName
 
-.
+The name of the secondary key vault
 
 ```yaml
 Type: String
@@ -120,7 +122,7 @@ Accept wildcard characters: False
 
 ### -SecondaryKeyName
 
-.
+The name of the secondary key
 
 ```yaml
 Type: String
@@ -136,7 +138,7 @@ Accept wildcard characters: False
 
 ### -SecondaryKeyVersion
 
-.
+The version of the secondary key
 
 ```yaml
 Type: Guid