AgentCollection.Read.AllMicrosoft Graph permission · Medium risk
Allows the app to read all collections and their membership in your organization's Agent Registry without a signed-in user.
Application permission
Medium riskRead all collections in Agent Registry, except quarantined and global. Allows the app to read all collections and their membership in your organization's Agent Registry without a signed-in user.
| ID | e65ee1da-d1d5-467b-bdd0-3e9bb94e6e0c |
|---|---|
| Consent | Always needs admin consent |
| Risk | Reads data across the tenant without a signed-in user. |
Delegated permission
Low riskRead all collections in Agent Registry, except quarantined and global. Allows the app to read collections and their membership in your organization's Agent Registry on behalf of the signed-in user.
| ID | fa50be38-fdff-469c-96dc-ef5fce3c64bf |
|---|---|
| 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 "e65ee1da-d1d5-467b-bdd0-3e9bb94e6e0c"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 "AgentCollection.Read.All"Which apps already have it?
# Apps that hold AgentCollection.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 "e65ee1da-d1d5-467b-bdd0-3e9bb94e6e0c" |
Select-Object PrincipalDisplayName, PrincipalId, CreatedDateTime# Apps with delegated consent for AgentCollection.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 "AgentCollection.Read.All" } |
Select-Object ClientId, ConsentType, PrincipalId