← cd ~/graph-permissions
// graph-permissions · CopilotPolicySettings
CopilotPolicySettings.ReadWriteMicrosoft Graph permission · Medium risk
Allows the app to read and write Copilot policy settings for the organization, without a signed-in user.
Application permission
Medium riskRead and write Copilot policy settings. Allows the app to read and write Copilot policy settings for the organization, without a signed-in user.
| ID | cc147c17-b8e8-4d3f-9f94-aa9e279a079a |
|---|---|
| Consent | Always needs admin consent |
| Risk | Can make changes. Check the scope is as narrow as possible. |
Delegated permission
Medium riskRead and write Copilot policy settings. Allows the app to read and write Copilot policy settings for the organization, on behalf of the signed-in user.
| ID | e2edbde8-4448-4e49-8ebb-d53ba72df0f3 |
|---|---|
| Consent | 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 "cc147c17-b8e8-4d3f-9f94-aa9e279a079a"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 "CopilotPolicySettings.ReadWrite"Which apps already have it?
# Apps that hold CopilotPolicySettings.ReadWrite 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 "cc147c17-b8e8-4d3f-9f94-aa9e279a079a" |
Select-Object PrincipalDisplayName, PrincipalId, CreatedDateTime# Apps with delegated consent for CopilotPolicySettings.ReadWrite
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 "CopilotPolicySettings.ReadWrite" } |
Select-Object ClientId, ConsentType, PrincipalId