More IB cmdlet updates

Author: chrisda

exchange/exchange-ps/exchange/policy-and-compliance/Get-InformationBarrierPolicy.md

@@ -57,6 +57,8 @@ The Identity parameter specifies the information barrier policy that you want to
 
 - GUID
 
+You can't use this parameter with the ExOPolicyId parameter.
+
 ```yaml
 Type: PolicyIdParameter
 Parameter Sets: Identity
@@ -70,7 +72,13 @@ Accept wildcard characters: False
 ```
 
 ### -ExoPolicyId
-This parameter is reserved for internal Microsoft use.
+The ExOPolicyId parameter specifies the information barrier policy that you want to view, but using an alternative GUID value:
+
+- The identity of the information barrier policy from the audit logs in Exchange Online.
+
+- The GUID part of the ExoPolicyId property value in the Get-InformationBarrierRecipientStatus cmdlet results.
+
+You can't use this parameter with the Identity parameter.
 
 ```yaml
 Type: Guid

exchange/exchange-ps/exchange/policy-and-compliance/Get-InformationBarrierRecipientStatus.md

@@ -11,7 +11,7 @@ monikerRange: "o365scc-ps"
 ## SYNOPSIS
 This cmdlet is available only in the Office 365 Security & Compliance Center. For more information, see Office 365 Security & Compliance Center PowerShell (https://technet.microsoft.com/library/mt587091.aspx).
 
-Use the Get-InformationBarrierRecipientStatus cmdlet to see whether specific user accounts are subject to information barrier policies and segments. You create segments by using the New-OrganizationSegment cmdlet.
+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://technet.microsoft.com/library/bb123552.aspx).
 
@@ -22,6 +22,16 @@ Get-InformationBarrierRecipientStatus [-Identity] <RecipientIdParameter> [[-Iden
 ```
 
 ## 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 Office 365 Security & Compliance Center before you can use this cmdlet. For more information, see Permissions in Office 365 Security & Compliance Center (https://go.microsoft.com/fwlink/p/?LinkId=511920).
 
 ## EXAMPLES
@@ -31,16 +41,14 @@ You need to be assigned permissions in the Office 365 Security & Compliance Cent
 Get-InformationBarrierRecipientStatus -Identity meganb
 ```
 
-This example returns the segment and policy assignment information for the user 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 information
-
-In this example, we refer to two user accounts in Office 365: *meganb* for *Megan*, and *alexw* for *Alex*.
+This example returns the information barrier policy relationship for the users meganb and alexw.
 
 ## PARAMETERS
 
@@ -72,7 +80,7 @@ Accept wildcard characters: False
 ```
 
 ### -Identity2
-The Identity2 parameter specifies an optional second recipient that you want to view in relation to the first recipient specified by the Identity parameter. You can use any value that uniquely identifies the second recipient. For example:
+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
 
@@ -86,12 +94,16 @@ The Identity2 parameter specifies an optional second recipient that you want to
 
 - 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.
+
 ```yaml
 Type: RecipientIdParameter
 Parameter Sets: (All)
 Aliases:
 Applicable: Office 365 Security & Compliance Center
-Required: True
+Required: False
 Position: 1
 Default value: None
 Accept pipeline input: True (ByPropertyName, ByValue)