Install-UnifiedCompliancePrerequisite

This cmdlet is available only in Security & Compliance PowerShell. For more information, see Security & Compliance PowerShell.

Use the Install-UnifiedCompliancePrerequisite cmdlet to view, create, or configure the Compliance Policy Center in Microsoft SharePoint Online. The Compliance Policy Center is a site collection that's used by the Microsoft Purview compliance portal to store preservation policies that act on content in SharePoint Online sites.

Typically, you don't need to run this cmdlet. You use this cmdlet for troubleshooting and diagnostics.

For information about the parameter sets in the Syntax section below, see Exchange cmdlet syntax.

Syntax

Install-UnifiedCompliancePrerequisite
       [-ForceInitialize]
       [-PolicyCenterSiteOwner <SmtpAddress>]
       [<CommonParameters>]
Install-UnifiedCompliancePrerequisite
       [-LoadOnly]
       [<CommonParameters>]

Description

This cmdlet returns the following information about the Compliance Policy Center:

  • SharepointRootSiteUrl: This value is typically https://<domain>.sharepoint.com/.
  • SharepointTenantAdminUrl: This value uses the format https://<domain>-admin.sharepoint.com/.
  • SharepointSuccessInitializedUtc: The time that the Compliance Policy Center was last initialized in coordinated universal time (UTC).
  • SharepointPolicyCenterSiteUrl: This value is typically https://<domain>.sharepoint.com/sites/compliancepolicycenter.

To use this cmdlet in Security & Compliance PowerShell, you need to be assigned permissions. For more information, see Permissions in the Microsoft Purview compliance portal.

Examples

Example 1

Install-UnifiedCompliancePrerequisite

This example creates the Compliance Policy Center in SharePoint Online. If it has already been created, the command displays the current configuration information.

Example 2

Install-UnifiedCompliancePrerequisite -LoadOnly

This example loads the Compliance Policy Center using the current settings.

Example 3

Install-UnifiedCompliancePrerequisite -ForceInitialize

This example recreates the Compliance Policy Center, even if the site has already been created.

Parameters

-ForceInitialize

The ForceInitialize switch recreates the Compliance Policy Center, even if it has already been created. You don't specify a value with this switch.

You can't use this switch with the LoadOnly switch.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-LoadOnly

The LoadOnly switch loads the current settings of the Compliance Policy Center. You don't specify a value with this switch.

You can't use this switch with the ForceInitialize switch.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-PolicyCenterSiteOwner

The PolicyCenterSiteOwner parameter specifies the email address of the owner of the Compliance Policy Center. You can use this parameter by itself or with the ForceInitialize switch.

Type:SmtpAddress
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance