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

Privileged Role AdministratorMicrosoft Entra built-in role

Can manage role assignments in Microsoft Entra ID, and all aspects of Privileged Identity Management.

Role IDe8611ab8-c189-46e8-94e1-60213ab1f814
PrivilegedYes. Microsoft marks this role as privileged.
Permissions28

Before you assign it

Microsoft labels this a privileged role, so make it eligible through PIM rather than permanent, require phishing-resistant MFA to activate it, and review who has it regularly.

What it can do

PermissionWhat it allows
microsoft.directory/accessReviews/definitions.applications/allProperties/readRead all properties of access reviews of application role assignments in Microsoft Entra ID
microsoft.directory/accessReviews/definitions.directoryRoles/allProperties/allTasksManage access reviews for Microsoft Entra role assignments
microsoft.directory/accessReviews/definitions.groups/allProperties/readRead all properties of access reviews for membership in Security and Microsoft 365 groups, including role-assignable groups.
microsoft.directory/accessReviews/definitions.groupsAssignableToRoles/allProperties/updateUpdate all properties of access reviews for membership in groups that are assignable to Microsoft Entra roles
microsoft.directory/accessReviews/definitions.groupsAssignableToRoles/createCreate access reviews for membership in groups that are assignable to Microsoft Entra roles
microsoft.directory/accessReviews/definitions.groupsAssignableToRoles/deleteDelete access reviews for membership in groups that are assignable to Microsoft Entra roles
microsoft.directory/administrativeUnits/allProperties/allTasksCreate and manage administrative units (including members)
microsoft.directory/authorizationPolicy/allProperties/allTasksManage all aspects of authorization policy
microsoft.directory/directoryRoles/allProperties/allTasksCreate and delete directory roles, and read and update all properties
microsoft.directory/groupsAssignableToRoles/allProperties/updateUpdate role-assignable groups
microsoft.directory/groupsAssignableToRoles/assignLicenseAssign a license to role-assignable groups
microsoft.directory/groupsAssignableToRoles/createCreate role-assignable groups
microsoft.directory/groupsAssignableToRoles/deleteDelete role-assignable groups
microsoft.directory/groupsAssignableToRoles/reprocessLicenseAssignmentReprocess license assignments to role-assignable groups
microsoft.directory/groupsAssignableToRoles/restoreRestore role-assignable groups
microsoft.directory/oAuth2PermissionGrants/allProperties/allTasksCreate and delete OAuth 2.0 permission grants, and read and update all properties
microsoft.directory/permissionGrantPolicies/allProperties/readRead all properties of permission grant policies
microsoft.directory/permissionGrantPolicies/allProperties/updateUpdate all properties of permission grant policies
microsoft.directory/permissionGrantPolicies/createCreate permission grant policies
microsoft.directory/permissionGrantPolicies/deleteDelete permission grant policies
microsoft.directory/privilegedIdentityManagement/allProperties/allTasksCreate and delete all resources, and read and update standard properties in Privileged Identity Management
microsoft.directory/roleAssignments/allProperties/allTasksCreate and delete role assignments, and read and update all role assignment properties
microsoft.directory/roleDefinitions/allProperties/allTasksCreate and delete role definitions, and read and update all properties
microsoft.directory/scopedRoleMemberships/allProperties/allTasksCreate and delete scopedRoleMemberships, and read and update all properties
microsoft.directory/servicePrincipals/appRoleAssignedTo/updateUpdate service principal role assignments
microsoft.directory/servicePrincipals/managePermissionGrantsForAll.microsoft-company-adminGrant consent for any permission to any application
microsoft.directory/servicePrincipals/permissions/updateUpdate permissions of service principals
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 Privileged Role Administrator for <reason>"
    RoleDefinitionId = "e8611ab8-c189-46e8-94e1-60213ab1f814"
    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 'e8611ab8-c189-46e8-94e1-60213ab1f814'" -ExpandProperty Principal |
    ForEach-Object { $_.Principal.AdditionalProperties.displayName }

Related roles

Find the smallest role for a task →