azureblog.co.uk
← cd ~/graph-permissions
// graph-permissions · RoleEligibilitySchedule

RoleEligibilitySchedule.Read.DirectoryMicrosoft Graph permission · Low risk

Allows the app to read the eligible role-based access control (RBAC) assignments and schedules for your company's directory, without a signed-in user. This includes reading directory role templates, and directory roles.

Application permission

Low risk

Read all eligible role assignments and role schedules for your company's directory. Allows the app to read the eligible role-based access control (RBAC) assignments and schedules for your company's directory, without a signed-in user. This includes reading directory role templates, and directory roles.

IDff278e11-4a33-4d0c-83d2-d01dc58929a5
ConsentAlways needs admin consent
RiskRead access, limited to what the signed-in user can see.

Delegated permission

Low risk

Read all eligible role assignments for your company's directory. Allows the app to read the eligible role-based access control (RBAC) assignments for your company's directory, on behalf of the signed-in user. This includes reading directory role templates, and directory roles.

IDeb0788c2-6d4e-4658-8c9e-c0fb8053f03d
ConsentNeeds admin consent
RiskRead access, limited to what the signed-in user can see.

Grant it to an app

In the portal: App registrations › your app › API permissions › Add a permission › Microsoft Graph › Application permissions, then grant admin consent. Or with Graph PowerShell:

powershell5 lines
Connect-MgGraph -Scopes "Application.Read.All", "AppRoleAssignment.ReadWrite.All"
$graph = Get-MgServicePrincipal -Filter "appId eq '00000003-0000-0000-c000-000000000000'"
$app   = Get-MgServicePrincipal -Filter "appId eq '<your app's client id>'"
New-MgServicePrincipalAppRoleAssignment -ServicePrincipalId $app.Id `
    -PrincipalId $app.Id -ResourceId $graph.Id -AppRoleId "ff278e11-4a33-4d0c-83d2-d01dc58929a5"

Ask for it when signing in

Delegated permissions act as the signed-in user, so the app can never do more than that user can.

powershell1 line
Connect-MgGraph -Scopes "RoleEligibilitySchedule.Read.Directory"

Which apps already have it?

powershell6 lines
# Apps that hold RoleEligibilitySchedule.Read.Directory as an application permission
Connect-MgGraph -Scopes "Application.Read.All"
$graph = Get-MgServicePrincipal -Filter "appId eq '00000003-0000-0000-c000-000000000000'"
Get-MgServicePrincipalAppRoleAssignedTo -ServicePrincipalId $graph.Id -All |
    Where-Object AppRoleId -eq "ff278e11-4a33-4d0c-83d2-d01dc58929a5" |
    Select-Object PrincipalDisplayName, PrincipalId, CreatedDateTime
powershell6 lines
# Apps with delegated consent for RoleEligibilitySchedule.Read.Directory
Connect-MgGraph -Scopes "Application.Read.All", "Directory.Read.All"
$graph = Get-MgServicePrincipal -Filter "appId eq '00000003-0000-0000-c000-000000000000'"
Get-MgOauth2PermissionGrant -All |
    Where-Object { $_.ResourceId -eq $graph.Id -and ($_.Scope -split " ") -contains "RoleEligibilitySchedule.Read.Directory" } |
    Select-Object ClientId, ConsentType, PrincipalId

Other RoleEligibilitySchedule permissions

Check every app in your tenant → Permission explainer