azureblog.co.uk
← cd ~/roles
// roles/entra

Exchange Recipient AdministratorMicrosoft Entra built-in role

Can create or update Exchange Online recipients within the Exchange Online organization.

Role ID31392ffb-586c-42d1-9346-e59415a2cc4e
PrivilegedNo
Permissions2

What it can do

PermissionWhat it allows
microsoft.office365.exchange/migration/allProperties/allTasksManage all tasks related to migration of recipients in Exchange Online
microsoft.office365.exchange/recipients/allProperties/allTasksCreate and delete all recipients, and read and update all properties of recipients in Exchange Online

Assign it

The role ID is the same in every tenant, so these work as they are. Make it eligible through PIM:

powershell13 lines
Connect-MgGraph -Scopes "RoleEligibilitySchedule.ReadWrite.Directory"
$user = Get-MgUser -UserId "jane.doe@contoso.com"
New-MgRoleManagementDirectoryRoleEligibilityScheduleRequest -BodyParameter @{
    Action           = "AdminAssign"
    Justification    = "Needs Exchange Recipient Administrator for <reason>"
    RoleDefinitionId = "31392ffb-586c-42d1-9346-e59415a2cc4e"
    DirectoryScopeId = "/"
    PrincipalId      = $user.Id
    ScheduleInfo     = @{
        StartDateTime = (Get-Date).ToUniversalTime().ToString("o")
        Expiration    = @{ Type = "afterDuration"; Duration = "P180D" }
    }
}

Who already has it?

powershell3 lines
Connect-MgGraph -Scopes "RoleManagement.Read.Directory"
Get-MgRoleManagementDirectoryRoleAssignment -Filter "roleDefinitionId eq '31392ffb-586c-42d1-9346-e59415a2cc4e'" -ExpandProperty Principal |
    ForEach-Object { $_.Principal.AdditionalProperties.displayName }

Related roles

Find the smallest role for a task →