Skip to main content

Get-ExMailboxPermission

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