Skip to main content

​
SYNOPSIS

Gets all permissions on an Exchange Online mailbox (Full Access, Send As, Send on Behalf)

​
SYNTAX

Get-ExMailboxPermission [[-Identity] <String>] [-ByDomain <String>] [-UserPermission <String>] [-ExportToExcel]
 [-ProgressAction <ActionPreference>] [<CommonParameters>]

​
DESCRIPTION

This function retrieves and displays all permissions granted on a specific mailbox:
  • Full Access: Full access permissions to the mailbox
  • Send As: Permissions to send emails as the mailbox
  • Send on Behalf: Permissions to send emails on behalf of the mailbox

​
EXAMPLES

​
EXAMPLE 1

Get-ExMailboxPermission -Identity "john.doe@contoso.com"
Gets all permissions for the mailbox john.doe@contoso.com

​
EXAMPLE 2

Get-ExMailboxPermission -Identity "john.doe@contoso.com" -ExportToExcel
Gets all permissions for the mailbox and exports them to an Excel file

​
EXAMPLE 3

Get-ExMailboxPermission -ByDomain "contoso.com"
Gets all permissions for all mailboxes in the contoso.com domain

​
EXAMPLE 4

Get-ExMailboxPermission -UserPermission "john.doe@contoso.com"
Finds all mailbox permissions that john.doe@contoso.com has across all mailboxes

​
PARAMETERS

​
-Identity

The identity of the mailbox (email address, username, or display name) 
Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: 1
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

​
-ByDomain

Filter mailboxes by domain name 
Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

​
-UserPermission

Find all permissions that a specific user has across all mailboxes (reverse lookup) 
Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

​
-ExportToExcel

Export the mailbox permissions to an Excel file 
Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

​
-ProgressAction

{{ Fill ProgressAction Description }} 
Type: ActionPreference
Parameter Sets: (All)
Aliases: proga

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

​
CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

​
INPUTS

​
OUTPUTS

​
NOTES

Requires the ExchangeOnlineManagement module and an active connection to Exchange Online For Excel export functionality, requires the ImportExcel module