← cd ~/graph-permissions
// graph-permissions · AgentCollection
AgentCollection.ReadWrite.ManagedByMicrosoft Graph permission · Medium risk
Allows the app to create, read, update, and delete collections that designate the calling app as their manager and manage their membership in your organization's Agent Registry without a signed-in user.
Application permission
Medium riskRead and write managed-by collections in Agent Registry. Allows the app to create, read, update, and delete collections that designate the calling app as their manager and manage their membership in your organization's Agent Registry without a signed-in user.
| ID | 2e0fb698-9996-479f-926b-ce63f4397829 |
|---|---|
| Consent | Always needs admin consent |
| Risk | Can make changes. Check the scope is as narrow as possible. |
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 "2e0fb698-9996-479f-926b-ce63f4397829"Which apps already have it?
# Apps that hold AgentCollection.ReadWrite.ManagedBy 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 "2e0fb698-9996-479f-926b-ce63f4397829" |
Select-Object PrincipalDisplayName, PrincipalId, CreatedDateTime