Edit

Share via


Get-FeatureConfiguration

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

Note

This cmdlet is currently available in Public Preview, isn't available in all organizations, and is subject to change.

Use the Get-FeatureConfiguration cmdlet to view Microsoft Purview feature configurations within your organization, including:

  • Collection policies.
  • Advanced label based protection.

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

Syntax

Get-FeatureConfiguration
   [[-Identity] <PolicyIdParameter>]
   [-FeatureScenario] <PolicyScenario>
   [-Confirm]
   [-WhatIf]
   [<CommonParameters>]

Description

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

Examples

Example 1

Get-FeatureConfiguration -FeatureScenario KnowYourData | Format-Table Name,Mode

This example returns a summary list of all collection policies in the organization.

Example 2

Get-FeatureConfiguration -FeatureScenario KnowYourData -Identity "Engineering Group"

This example returns detailed information about the specified collection policy.

Parameters

-Confirm

This parameter is reserved for internal Microsoft use.

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

-FeatureScenario

The FeatureScenario parameter specifies the scenario for the feature configuration. Currently, the only valid values are:

  • KnowYourData for collection policies
  • TrustContainer for Endpoint DLP trust container
Type:PolicyScenario
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-Identity

The Identity policy specifies the feature configuration that you want to view. You can use any value that uniquely identifies the configuration. For example:

  • Name
  • Distinguished name (DN)
  • GUID
Type:PolicyIdParameter
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Security & Compliance

-WhatIf

This parameter is reserved for internal Microsoft use.

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