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

Agent Registry AdministratorMicrosoft Entra built-in role

Manage all aspects of the Agent Registry service in Microsoft Entra ID

Role ID6b942400-691f-4bf0-9d12-d8a254a2baf5
PrivilegedNo
Permissions1

What it can do

PermissionWhat it allows
microsoft.agentRegistry/allEntities/allProperties/allTasksManage all aspects of Agent Registry in Microsoft Entra ID

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 Agent Registry Administrator for <reason>"
    RoleDefinitionId = "6b942400-691f-4bf0-9d12-d8a254a2baf5"
    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 '6b942400-691f-4bf0-9d12-d8a254a2baf5'" -ExpandProperty Principal |
    ForEach-Object { $_.Principal.AdditionalProperties.displayName }

Related roles

Find the smallest role for a task →