Important: Following cmdlet will be discontinued at some point in near future. Please be advised to use the new cmdlet Revoke-RecipientPermission.

Revoke-ExchangeMailboxPermission cmdlet revokes the access permission of the recipient (mailbox or distribution group) for the Exchange mailbox.

This cmdlet supports risk-mitigation parameters .

Input parameters

#
Parameter
Type

Mandatory (R/O)
Description
Valid Values
1 Authentication Information (all parameters)  
2

Identity

(aliases: GUID, DistinguishedName)

 ADObjectIDParameter R A property, that is used for managing the Exchange mailbox 

Value of one of these parameters can be used as Identity:

#ParameterDescription
1 GUID Globally Unique Identifier (ObjectGuid)
2 DistinguishedName Unique name of the object in Active Directory
3

Recipient

(alias: Recipients)

 ADObjectIDParameter[] R

List of the recipients (Exchange mailboxes or distribution lists), whose permissions are revoked

Value of one of these parameters can be used as recipient's identity:

  • GUID
  • DistinguishedName

Output parameters

No parameters

Example of using Revoke-ExchangeMailboxPermission cmdlet

Revoke-ExchangeMailboxPermission -Identity "D5B784A7-F8A9-432A-924F-CD96552C04BD" -Recipient "CN=test@accountname,OU=accountname,OU=Hosting,DC=exchXXX,DC=domain,DC=local"