RecordsManagement.Read.AllMicrosoft Graph permission · High risk
Allows the application to read any data from Records Management, such as configuration, labels, and policies without the signed in user.
Application permission
High riskRead Records Management configuration, labels and policies. Allows the application to read any data from Records Management, such as configuration, labels, and policies without the signed in user.
| ID | ac3a2b8e-03a3-4da9-9ce0-cbe28bf1accd |
|---|---|
| Consent | Always needs admin consent |
| Risk | Can change data across the whole tenant. |
Delegated permission
High riskRead Records Management configuration, labels, and policies. Allows the application to read any data from Records Management, such as configuration, labels, and policies on behalf of the signed-in user.
| ID | 07f995eb-fc67-4522-ad66-2b8ca8ea3efd |
|---|---|
| Consent | Needs admin consent |
| Risk | Can change data across the whole tenant. |
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 "ac3a2b8e-03a3-4da9-9ce0-cbe28bf1accd"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 "RecordsManagement.Read.All"Which apps already have it?
# Apps that hold RecordsManagement.Read.All 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 "ac3a2b8e-03a3-4da9-9ce0-cbe28bf1accd" |
Select-Object PrincipalDisplayName, PrincipalId, CreatedDateTime# Apps with delegated consent for RecordsManagement.Read.All
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 "RecordsManagement.Read.All" } |
Select-Object ClientId, ConsentType, PrincipalId