Quick answer: Get-MailboxPermission lists who can open an Exchange mailbox. Connect to Exchange Online PowerShell, then run Get-MailboxPermission -Identity user@contoso.com. Add Where-Object { $_.IsInherited -eq $false -and $_.User -notlike "NT AUTHORITY\SELF" } to hide the default entries and see only the permissions someone granted.
It works in Exchange Online and in on-premises Exchange Server 2010 through Exchange Server SE. It only reads permissions. To change them, use Add-MailboxPermission or Remove-MailboxPermission.
What does Get-MailboxPermission show?
Each row is one permission entry on the mailbox:
| Column | Meaning |
|---|---|
Identity |
The mailbox. |
User |
Who holds the permission: a user, security group or role group. |
AccessRights |
The permission itself (see the next table). |
IsInherited |
True if it comes from the mailbox database or Active Directory, False if it was assigned to this mailbox directly. |
Deny |
True if the permission is denied. Deny entries usually win over allow entries. |
The AccessRights values:
| Value | What it allows |
|---|---|
FullAccess |
Open the mailbox and read its contents. It does not allow sending mail. |
ReadPermission |
Read the permissions on the mailbox. |
ChangePermission |
Change the permissions on the mailbox. |
ChangeOwner |
Change the owner of the mailbox. |
DeleteItem |
Delete the mailbox. |
ExternalAccount |
Marks an account that isn't in the same domain. |
Which entries are there by default?
A new mailbox already has several entries, so the raw output looks busy. Microsoft lists these defaults:
NT AUTHORITY\SELFhas FullAccess and ReadPermission. That is the user's access to their own mailbox.- Administrator, Domain Admins, Enterprise Admins and Organization Management are denied FullAccess. Admins can't open other people's mailboxes unless someone grants it.
- The same admin groups are allowed ChangeOwner, ChangePermission, DeleteItem and ReadPermission.
- System accounts such as
NT AUTHORITY\SYSTEM, Exchange Servers and Exchange Trusted Subsystem inherit their own entries.
Granted permissions show IsInherited as False. That is why the filter in the quick answer works.
How do I connect before running it?
Install the Exchange Online PowerShell module, then sign in:
Connect-ExchangeOnline -UserPrincipalName admin@contoso.com
You also need an Exchange role that includes the cmdlet. To see which roles do:
Get-ManagementRole -Cmdlet Get-MailboxPermission
In Exchange Online, Microsoft recommends Get-EXOMailboxPermission, the module's faster REST-based version. Get-MailboxPermission still works, and every example below runs in both Exchange Online and Exchange Server.
How do I check permissions on one mailbox?
List every entry on a mailbox:
Get-MailboxPermission -Identity john@contoso.com | Format-List
Show only the permissions someone granted:
Get-MailboxPermission -Identity john@contoso.com |
Where-Object { $_.IsInherited -eq $false -and $_.User -notlike "NT AUTHORITY\SELF" } |
Select-Object Identity, User, AccessRights
Check what one person has on that mailbox:
Get-MailboxPermission -Identity john@contoso.com -User ayla@contoso.com
Show the owner of a room mailbox:
Get-MailboxPermission -Identity Room222 -Owner
-Owner and -User can't be used together.
How do I check shared mailbox permissions?
Shared mailboxes are where Full Access gets granted most. Run the filtered command against one shared mailbox:
Get-MailboxPermission -Identity support@contoso.com |
Where-Object { $_.IsInherited -eq $false -and $_.User -notlike "NT AUTHORITY\SELF" } |
Select-Object User, AccessRights
Or report on every shared mailbox and save it as a CSV file:
Get-Mailbox -RecipientTypeDetails SharedMailbox -ResultSize Unlimited |
Get-MailboxPermission |
Where-Object { $_.IsInherited -eq $false -and $_.User -notlike "NT AUTHORITY\SELF" } |
Select-Object Identity, User, @{Name="AccessRights";Expression={$_.AccessRights -join ","}} |
Export-Csv C:\Reports\shared-mailbox-permissions.csv -NoTypeInformation
For room mailboxes, swap in -RecipientTypeDetails RoomMailbox.
Which mailboxes can one user open?
Check the user against every mailbox:
Get-Mailbox -ResultSize Unlimited |
Get-MailboxPermission -User ayla@contoso.com |
Select-Object Identity, AccessRights
This reads every mailbox in the organisation, so it can take a while in a large tenant.
How do I see Send As, Send on Behalf and folder permissions?
Get-MailboxPermission doesn't show these. Each has its own cmdlet:
| Permission | Command |
|---|---|
| Send As | Get-RecipientPermission -Identity john@contoso.com |
| Send on Behalf | Get-Mailbox john@contoso.com | Select-Object GrantSendOnBehalfTo |
| Calendar or other folders | Get-MailboxFolderPermission -Identity john@contoso.com:\Calendar |
To grant folder access, see Add-MailboxFolderPermission. For Send As, see Add-RecipientPermission.
Why isn't Get-MailboxPermission working?
- "The term isn't recognized": you aren't connected. Run
Connect-ExchangeOnlinefirst. - Access denied, or the cmdlet is missing: your account lacks a role that includes it. Run
Get-ManagementRole -Cmdlet Get-MailboxPermissionand ask an Exchange admin for one of those roles. - An admin shows Deny on FullAccess: that is the default. It doesn't block what you granted directly.
- A report stops early: some cmdlets return 1,000 results by default. Add
-ResultSize Unlimitedto Get-Mailbox. - Microsoft 365 Groups are missing: add the
-GroupMailboxswitch (Exchange Online only).
Summary
Get-MailboxPermission -Identity <mailbox>lists who can open a mailbox.- Filter on
IsInherited -eq $falseand dropNT AUTHORITY\SELFto see only granted access. - Pipe
Get-Mailbox -RecipientTypeDetails SharedMailboxinto it to report on every shared mailbox. - Send As, Send on Behalf and folder permissions need their own cmdlets.
- To change permissions, use Add-MailboxPermission or Remove-MailboxPermission.
The same permissions decide who can book and manage room mailboxes. Meeting Room 365 puts a booking display outside each room that reads those mailboxes, for $9 a display a month.