Get-AdaptiveScope

This cmdlet is available only in the cloud-based service.

Use the Get-AdaptiveScope cmdlet to view adaptive scopes in your organization. Adaptive scopes (or static scopes) are used in retention policies and retention label policies.

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

Syntax

Get-AdaptiveScope
   [[-Identity] <ComplianceRuleIdParameter>]
   [-AdministrativeUnits <MultiValuedProperty>]
   [-LocationTypes <MultiValuedProperty>]
   [<CommonParameters>]

Description

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

Get-AdaptiveScope | Format-Table Name,Priority

This example returns a summary list of all adaptive scopes.

Example 2

Get-AdaptiveScope -Identity "Project X"

This example returns detailed information about the adaptive scope named Project X.

Parameters

-AdministrativeUnits

{{ Fill AdministrativeUnits Description }}

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Security & Compliance

-Identity

The Identity parameter specifies the adaptive scope that you want to view. You can use any value that uniquely identifies the adaptive scope. For example:

  • Name
  • Distinguished name (DN)
  • GUID
Type:ComplianceRuleIdParameter
Position:0
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Online, Security & Compliance

-LocationTypes

{{ Fill LocationTypes Description }}

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Security & Compliance