Get-InformationBarrierRecipientStatus

This cmdlet is available only in Security & Compliance Center PowerShell. For more information, see Security & Compliance Center PowerShell (https://docs.microsoft.com/powershell/exchange/scc-powershell).

Use the Get-InformationBarrierRecipientStatus cmdlet to return information about recipients and their relationship to information barrier policies.

For information about the parameter sets in the Syntax section below, see Exchange cmdlet syntax (https://docs.microsoft.com/powershell/exchange/exchange-cmdlet-syntax).

Syntax

Get-InformationBarrierRecipientStatus
   [-Identity] <RecipientIdParameter>
   [[-Identity2] <RecipientIdParameter>]
   [<CommonParameters>]

Description

The following information is returned in the output of this cmdlet:

  • A warning message that indicates whether or not the recipient is included in an information barrier policy.

  • If present, the GUID part in the ExOPolicyId property value identifies the information barrier policy that the recipient is included in. You can run the command Get-InformationBarrierPolicy -ExOPolicyId <GUID> to identify and view the details of the policy.

  • Basic information about the recipient (display name, alias, and last name).

  • Recipient properties that can be used in organization segments (Department, CustomAttributeN, etc.) and the current property values for the recipient.

You need to be assigned permissions in the Security & Compliance Center before you can use this cmdlet. For more information, see Permissions in the Security & Compliance Center.

Examples

Example 1

Get-InformationBarrierRecipientStatus -Identity meganb

This example returns the information barrier policy information for the user meganb.

Example 2

Get-InformationBarrierRecipientStatus -Identity meganb -Identity2 alexw

This example returns the information barrier policy relationship for the users meganb and alexw.

Parameters

-Identity

The Identity parameter specifies the recipient that you want to view the segment and policy assignment information for. You can use any value that uniquely identifies the recipient. For example:

  • Name

  • Alias

  • Distinguished name (DN)

  • Canonical DN

  • Email address

  • GUID

Type:RecipientIdParameter
Position:0
Default value:None
Accept pipeline input:True (ByPropertyName, ByValue)
Accept wildcard characters:False
Applies to:Office 365 Security & Compliance Center
-Identity2

The Identity2 parameter specifies an optional second recipient when you want to view the information barrier policy relationship to the first recipient specified by the Identity parameter. You can use any value that uniquely identifies the second recipient. For example:

  • Name

  • Alias

  • Distinguished name (DN)

  • Canonical DN

  • Email address

  • GUID

When you include this parameter in a command, you get output for each recipient.

You can only use this parameter with the Identity parameter; you can't use it by itself.

Type:RecipientIdParameter
Position:1
Default value:None
Accept pipeline input:True (ByPropertyName, ByValue)
Accept wildcard characters:False
Applies to:Office 365 Security & Compliance Center

Inputs

Outputs