Merge branch 'master' into patch-1

Author: chrisda

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

@@ -14,7 +14,7 @@ ms.reviewer:
 
 ## SYNOPSIS
 
-.
+Validates the encryption of a Group Site, Team Site, or OneDrive for Business site if a Customer Key has been registered for the site.
 
 ## SYNTAX
 
@@ -24,7 +24,9 @@ Get-SPOSiteDataEncryptionPolicy [-Identity] <SpoSitePipeBind> [<CommonParameters
 
 ## DESCRIPTION
 
-.
+When a Customer Key has been configured in the Azure tenant, it is possible to set and subsequently verify the encryption status of a SharePoint Online or OneDrive for Business site. This cmdlet verifies the encryption status of the particular site.
+
+This cmdlet will return an error if the Azure tenant has not been configured with a Customer Key. See the Related Links section for more information on how to configure the Customer Key.
 
 ## EXAMPLES
 
@@ -34,13 +36,13 @@ Get-SPOSiteDataEncryptionPolicy [-Identity] <SpoSitePipeBind> [<CommonParameters
 Get-SPOSiteDataEncryptionPolicy https://contoso.sharepoint.com/sites/Research
 ```
 
-.
+Verifies the encryption of the site https://contoso.sharepoint.com/sites/Research.
 
 ## PARAMETERS
 
 ### -Identity
 
-.
+The URL of the Site Collection.
 
 ```yaml
 Type: SpoSitePipeBind
@@ -58,4 +60,28 @@ Accept wildcard characters: False
 
 This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](https://go.microsoft.com/fwlink/p/?LinkID=113216).
 
-## NOTES
+## OUTPUTS
+### System.String
+
+The URI of the primary key.
+
+### System.String
+
+The URI of the secondary key.
+
+### System.Object
+
+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.
+
+## RELATED LINKS
+
+[Register-SPODataEncryptionPolicy](https://docs.microsoft.com/powershell/module/sharepoint-online/register-spodataencryptionpolicy)
+
+[Controlling your data in Office 365 using Customer Key](https://docs.microsoft.com/microsoft-365/compliance/controlling-your-data-using-customer-key)
+
+[Office 365: Setting up Customer Key for SharePoint Online and OneDrive for Business](https://docs.microsoft.com/microsoft-365/compliance/controlling-your-data-using-customer-key#office-365-setting-up-customer-key-for-sharepoint-online-and-onedrive-for-business)