Microsoft Entra ID Governance
Governance

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.

  1. Sign in to the Microsoft Entra admin center as at least a Privileged Role Administrator.
  2. Browse to ID Governance > Privileged Identity Management > Microsoft Entra roles.
  3. Open Assignments, and then select Active assignments.
  4. Select the role assignments you want to convert, and then select Manage Assignments.
  5. Change the assignment type to Eligible, and save your changes.
  6. 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"

  1. Sign in to the Microsoft Entra admin center as at least a Privileged Role Administrator.

  2. 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

Daily Entra.News

Get daily email updates

Get a concise summary of the latest Microsoft Entra updates delivered straight to your inbox.

Loading the secure signup form…