Applies to: Exchange Server 2007 SP3, Exchange Server
2007 SP2, Exchange Server 2007 SP1
Topic Last Modified: 2008-06-23
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>]
|
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. |
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.
Input Types
Return Types
Errors
| Error | Description |
|---|---|
Exceptions
| Exceptions | Description |
|---|---|
Example
This example will get permissions on user Test1's mailbox.
 Copy Code |
|
|---|---|
Get-MailboxPermission -Identity Test1 | Format-List |
|