Assign Microsoft Entra roles in PIM
In brief
The documentation now describes an enhanced Assignments experience for converting selected active Microsoft Entra role assignments to eligible assignments. It includes required permissions, licensing requirements, conversion steps, and user activation guidance.
What Entra admins need to know
Privileged Role Administrators can use this workflow; converted users must activate their eligible assignments when needed.
This editorial summary was generated by AI from the documentation changes. Verify important details in the full Microsoft Learn article.
Documentation change
The comparison below shows only the changed extract. Use the full-page view for complete context.
Assign Microsoft Entra roles in Privileged Identity Management
Overview
With Microsoft Entra ID, a Global Administrator can make permanent Microsoft Entra admin role assignments. These role assignments can be created using the Microsoft Entra admin centerMicrosoft Entra admin center or using PowerShell commands.
The Microsoft Entra Privileged Identity Management (PIM) service also allows Privileged Role Administrators to make permanent admin role assignments. Additionally, Privileged Role Administrators can make users eligible for Microsoft Entra admin roles. An eligible administrator can activate the role when they need it, and then their permissions expire once they're done.
- Can't be assigned for a duration of less than five minutes
- Can't be removed within five minutes of it being assigned
::: zone pivot="portal"
Assign a role
Follow these steps to make a user eligible for a Microsoft Entra admin role.
:::image type="content" source="./media/pim-how-to-add-role-to-user/assignment-notification.png" alt-text="Screenshot showing a new assignment notification.":::
Convert active role assignments to eligible role assignments (preview)
Use the enhanced Assignments experience to change selected active Microsoft Entra role assignments to eligible role assignments. This experience is in preview and is rolling out.
Existing PIM licensing requirements apply. For more information, see License requirements to use Privileged Identity Management.
Before converting Global Administrator assignments, review the Global Administrator safeguards and emergency access account guidance.
- Sign in to the Microsoft Entra admin center as at least a Privileged Role Administrator.
- Browse to ID Governance > Privileged Identity Management > Microsoft Entra roles.
- Open Assignments, and then select Active assignments.
- Select the role assignments you want to convert, and then select Manage Assignments.
- Change the assignment type to Eligible, and save your changes.
- Review Eligible assignments to confirm that the selected assignments are eligible.
Users must activate their eligible Microsoft Entra role assignments when they need to use the roles.
::: zone-end
Assign a role with restricted scope
For certain roles, the scope of the granted permissions can be restricted to a single admin unit, service principal, or application. This procedure is an example of assigning a role that has the scope of an administrative unit. For a list of roles that support scope via administrative unit, see Assign roles with administrative unit scope. This feature is currently being rolled out to Microsoft Entra organizations.
::: zone pivot="portal"
Sign in to the Microsoft Entra admin center as at least a Privileged Role Administrator.
Browse to Entra ID > Roles & admins.
If you try to assign a custom role that is compatible with administrative units, you aren't able to assign the role with administrative unit scope by starting from the Roles & admins page. To assign the custom role with administrative unit scope, you must first open the administrative unit and then assign the role. For more information, see Assign roles with administrative unit scope. For information about creating administrative units, see Create or delete administrative units.
::: zone-end
::: zone pivot="api"
Assign a role using Microsoft Graph API
For more information about Microsoft Graph APIs for PIM, see Overview of role management through the privileged identity management (PIM) API. }
::: zone-end
## Update or remove an existing role assignment
::: zone pivot="portal"
Follow these steps to update or remove an existing role assignment.
::: zone-end
You can't remove the last active role assignment for Global Administrators. Consider having an emergency access account with active permanent role assignment for Global Administrator role. For more information, see [emergency access accounts](~/identity/role-based-access-control/security-emergency-access.md).
You can't remove the eligible role assignment for Global Administrators if there would be no assigned role assignments for the Global Administrator role left.
This is done to minimize risks of administrators locking themselves out of the tenant inadvertently.
::: zone pivot="portal"
1. Sign in to the [Microsoft Entra admin center](https://entra.microsoft.com) as at least a [Privileged Role Administrator](~/identity/role-based-access-control/permissions-reference.md#privileged-role-administrator).
1. Browse to **ID Governance** > **Privileged Identity Management** > **Microsoft Entra roles**.
1. Select **Update** or **Remove** to update or remove the role assignment.
::: zone-end
::: zone pivot="api"
## Remove eligible assignment via Microsoft Graph API
This example shows an HTTP request to revoke an eligible assignment to a role from a principal. For details on the API commands including request samples in languages such as C# and JavaScript, see [Create roleEligibilityScheduleRequests](/graph/api/rbacapplication-post-roleeligibilityschedulerequests).
}
::: zone-end
Next steps
@@ -2,16 +2,19 @@ title: Assign Microsoft Entra roles in PIM description: Learn how to assign Microsoft Entra roles in Privileged Identity Management (PIM). ms.topic: how-to-ms.date: 04/23/2026-ms.reviewer: shaunliu-ms.custom: subject-rbac-steps, sfi-ga-nochange, sfi-image-nochange+ms.date: 11/17/2026+ms.reviewer: ilyal+ms.custom: subject-rbac-steps, sfi-ga-nochange, sfi-image-nochange, msecd-doc-authoring-1032 #Customer Intent: As an administrator, I want to assign Microsoft Entra roles to users with time-bound or eligible assignments to implement just-in-time privileged access.+ms.author: tamimsangrar+ai-usage: ai-assisted+zone_pivot_groups: pim-role-assignment-methods --- # Assign Microsoft Entra roles in Privileged Identity Management ## Overview -With Microsoft Entra ID, a Global Administrator can make **permanent** Microsoft Entra admin role assignments. These role assignments can be created using the [Microsoft Entra admin center](~/identity/role-based-access-control/permissions-reference.md) or using [PowerShell commands](/powershell/module/azuread/#directory_roles).+With Microsoft Entra ID, a Global Administrator can make **permanent** Microsoft Entra admin role assignments. These role assignments can be created using the [Microsoft Entra admin center](https://entra.microsoft.com) or using [PowerShell commands](/powershell/module/azuread/#directory_roles). The Microsoft Entra Privileged Identity Management (PIM) service also allows Privileged Role Administrators to make permanent admin role assignments. Additionally, Privileged Role Administrators can make users **eligible** for Microsoft Entra admin roles. An eligible administrator can activate the role when they need it, and then their permissions expire once they're done. @@ -22,6 +25,8 @@ Privileged Identity Management supports both built-in and custom Microsoft Entra > - Can't be assigned for a duration of less than five minutes > - Can't be removed within five minutes of it being assigned +::: zone pivot="portal"+ ## Assign a role Follow these steps to make a user eligible for a Microsoft Entra admin role.@@ -68,10 +73,31 @@ Follow these steps to make a user eligible for a Microsoft Entra admin role. :::image type="content" source="./media/pim-how-to-add-role-to-user/assignment-notification.png" alt-text="Screenshot showing a new assignment notification."::: +## Convert active role assignments to eligible role assignments (preview)++Use the enhanced **Assignments** experience to change selected active Microsoft Entra role assignments to eligible role assignments. This experience is in preview and is rolling out.++Existing PIM licensing requirements apply. For more information, see [License requirements to use Privileged Identity Management](~/id-governance/licensing-fundamentals.md#privileged-identity-management).++Before converting Global Administrator assignments, review the [Global Administrator safeguards](#update-or-remove-an-existing-role-assignment) and [emergency access account guidance](~/identity/role-based-access-control/security-emergency-access.md).++1. Sign in to the [Microsoft Entra admin center](https://entra.microsoft.com) as at least a [Privileged Role Administrator](~/identity/role-based-access-control/permissions-reference.md#privileged-role-administrator).+1. Browse to **ID Governance** > **Privileged Identity Management** > **Microsoft Entra roles**.+1. Open **Assignments**, and then select **Active assignments**.+1. Select the role assignments you want to convert, and then select **Manage Assignments**.+1. Change the assignment type to **Eligible**, and save your changes.+1. Review **Eligible assignments** to confirm that the selected assignments are eligible.++Users must [activate their eligible Microsoft Entra role assignments](pim-how-to-activate-role.md) when they need to use the roles.++::: zone-end+ ## Assign a role with restricted scope For certain roles, the scope of the granted permissions can be restricted to a single admin unit, service principal, or application. This procedure is an example of assigning a role that has the scope of an administrative unit. For a list of roles that support scope via administrative unit, see [Assign roles with administrative unit scope](../../identity/role-based-access-control/manage-roles-portal.md). This feature is currently being rolled out to Microsoft Entra organizations. +::: zone pivot="portal"+ 1. Sign in to the [Microsoft Entra admin center](https://entra.microsoft.com) as at least a [Privileged Role Administrator](~/identity/role-based-access-control/permissions-reference.md#privileged-role-administrator). 1. Browse to **Entra ID** > **Roles & admins**.@@ -92,6 +118,10 @@ For certain roles, the scope of the granted permissions can be restricted to a s If you try to assign a custom role that is compatible with administrative units, you aren't able to assign the role with administrative unit scope by starting from the **Roles & admins** page. To assign the custom role with administrative unit scope, you must first open the administrative unit and then assign the role. For more information, see [Assign roles with administrative unit scope](../../identity/role-based-access-control/manage-roles-portal.md). For information about creating administrative units, see [Create or delete administrative units](../../identity/role-based-access-control/admin-units-manage.md). +::: zone-end++::: zone pivot="api"+ ## Assign a role using Microsoft Graph API For more information about Microsoft Graph APIs for PIM, see [Overview of role management through the privileged identity management (PIM) API](/graph/api/resources/privilegedidentitymanagementv3-overview).@@ -241,13 +271,22 @@ This example shows the response. The response object shown here might be shorten } ```` +::: zone-end+ ## Update or remove an existing role assignment +::: zone pivot="portal"+ Follow these steps to update or remove an existing role assignment. ++::: zone-end+ You can't remove the last active role assignment for Global Administrators. Consider having an emergency access account with active permanent role assignment for Global Administrator role. For more information, see [emergency access accounts](~/identity/role-based-access-control/security-emergency-access.md). You can't remove the eligible role assignment for Global Administrators if there would be no assigned role assignments for the Global Administrator role left. This is done to minimize risks of administrators locking themselves out of the tenant inadvertently. +::: zone pivot="portal"+ 1. Sign in to the [Microsoft Entra admin center](https://entra.microsoft.com) as at least a [Privileged Role Administrator](~/identity/role-based-access-control/permissions-reference.md#privileged-role-administrator). 1. Browse to **ID Governance** > **Privileged Identity Management** > **Microsoft Entra roles**. @@ -262,6 +301,10 @@ This is done to minimize risks of administrators locking themselves out of the t 1. Select **Update** or **Remove** to update or remove the role assignment. +::: zone-end++::: zone pivot="api"+ ## Remove eligible assignment via Microsoft Graph API This example shows an HTTP request to revoke an eligible assignment to a role from a principal. For details on the API commands including request samples in languages such as C# and JavaScript, see [Create roleEligibilityScheduleRequests](/graph/api/rbacapplication-post-roleeligibilityschedulerequests).@@ -315,6 +358,8 @@ POST https://graph.microsoft.com/v1.0/roleManagement/directory/roleEligibilitySc } ```` +::: zone-end+ ## Next steps - [Configure Microsoft Entra admin role settings in Privileged Identity Management](pim-how-to-change-default-settings.md) 