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

Microsoft 365 Migration AdministratorMicrosoft Entra built-in role

Perform all migration functionality to migrate content to Microsoft 365 using Migration Manager.

Role ID8c8b803f-96e1-4129-9349-20738d9f9652
PrivilegedNo
Permissions3

What it can do

PermissionWhat it allows
microsoft.office365.migrations/allEntities/allProperties/allTasksManage all aspects of Microsoft 365 migrations
microsoft.office365.supportTickets/allEntities/allTasksCreate and manage Microsoft 365 service requests
microsoft.office365.webPortal/allEntities/standard/readRead basic properties on all resources in the Microsoft 365 admin center

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 Microsoft 365 Migration Administrator for <reason>"
    RoleDefinitionId = "8c8b803f-96e1-4129-9349-20738d9f9652"
    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 '8c8b803f-96e1-4129-9349-20738d9f9652'" -ExpandProperty Principal |
    ForEach-Object { $_.Principal.AdditionalProperties.displayName }

Related roles

Find the smallest role for a task →