Get-MailboxPermission

 

Applies to: Exchange Server 2007 SP1, Exchange Server 2007 SP2, Exchange Server 2007 SP3

Use the Get-MailboxPermission cmdlet to get permissions on a mailbox.

Syntax

Get-MailboxPermission -Identity <MailboxIdParameter> [-DomainController <Fqdn>] [-User <SecurityPrincipalIdParameter>]

Get-MailboxPermission -Identity <MailboxIdParameter> [-DomainController <Fqdn>] [-Owner <SwitchParameter>]

Detailed Description

This cmdlet allows you to retrieve the permissions set for a user's mailbox.

To run the Get-MailboxPermission cmdlet, the account you use must be delegated the following:

• Exchange View-Only Administrator role

For more information about permissions, delegating roles, and the rights that are required to administer Exchange Server 2007, see Permission Considerations.

Parameters

Parameter	Required	Type	Description
Identity	Required	Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter	The Identity parameter specifies the identity of the mailbox for which permission is required.
Owner	Optional	System.Management.Automation.SwitchParameter	The Owner parameter specifies the owner of that mailbox.
User	Optional	Microsoft.Exchange.Configuration.Tasks.SecurityPrincipalIdParameter	The User parameter specifies the user principal name (UPN), domain\user, or the alias of the user.
DomainController	Optional	Microsoft.Exchange.Data.Fqdn	To specify the fully qualified domain name (FQDN) of the domain controller that retrieves data from the Active Directory directory service, include the DomainController parameter in the command.

Input Types

Return Types

Errors

Error	Description

Exceptions

Exceptions	Description

Example

This example will get permissions on user Test1's mailbox.

Get-MailboxPermission -Identity Test1 | Format-List