Skip to content

Latest commit

 

History

History
87 lines (58 loc) · 3.24 KB

Get-SPOSiteDataEncryptionPolicy.md

File metadata and controls

87 lines (58 loc) · 3.24 KB
external help file Module Name online version applicable title schema author ms.author ms.reviewer
sharepointonline.xml
Microsoft.Online.SharePoint.PowerShell
SharePoint Online
Get-SPOSiteDataEncryptionPolicy
2.0.0
techwriter40
kirks

Get-SPOSiteDataEncryptionPolicy

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

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

Example 1

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.

Type: SpoSitePipeBind
Parameter Sets: (All)
Aliases:
Applicable: SharePoint Online
Required: False
Position: 1
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.

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

Controlling your data in Office 365 using Customer Key

Office 365: Setting up Customer Key for SharePoint Online and OneDrive for Business