RoleAssignmentSchedule.Read.DirectoryMicrosoft Graph permission · Low risk
Allows the app to read the active 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 riskRead all active role assignments and role schedules for your company's directory. Allows the app to read the active 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.
| ID | d5fe8ce8-684c-4c83-a52c-46e882ce4be1 |
|---|---|
| Consent | Always needs admin consent |
| Risk | Read access, limited to what the signed-in user can see. |
Delegated permission
Low riskRead all active role assignments for your company's directory. Allows the app to read the active 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.
| ID | 344a729c-0285-42c6-9014-f12b9b8d6129 |
|---|---|
| Consent | Needs admin consent |
| Risk | Read 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:
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 "d5fe8ce8-684c-4c83-a52c-46e882ce4be1"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.
Connect-MgGraph -Scopes "RoleAssignmentSchedule.Read.Directory"Which apps already have it?
# Apps that hold RoleAssignmentSchedule.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 "d5fe8ce8-684c-4c83-a52c-46e882ce4be1" |
Select-Object PrincipalDisplayName, PrincipalId, CreatedDateTime# Apps with delegated consent for RoleAssignmentSchedule.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 "RoleAssignmentSchedule.Read.Directory" } |
Select-Object ClientId, ConsentType, PrincipalId