ESC
Type to search...

ProgramControl.Read.All

Export JSON
Export CSV
Copy URL
Print
ApplicationDelegated Full Control All Resources

Allows the app to read programs and program controls in the organization, without a signed-in user.

Permission data: April 6, 2026 at 4:06 AM UTC
Delegated Access App-Only Access

Permission Details

Application Permission

Read all programs

Allows the app to read programs and program controls in the organization, without a signed-in user.

Delegated Permission Admin consent required

Read all programs that user can access

Allows the app to read programs and program controls that the signed-in user has access to in the organization.

Properties

Microsoft Graph beta exact-category-docs

Properties is shown from beta metadata because a stable v1.0 schema is not available for this resource mapping.

Property Type Description
id String The feature-assigned identifier of the link between program and control.
programId String The programId of the program this control is a part of. Required on create.
controlId String The controlId of the control, in particular the identifier of an access review. Required on create.
controlTypeId String The programControlType identifies the type of program control - for example, a control linking to guest access reviews. Required on create.
displayName StringNullable The name of the control.
status StringNullable The life cycle status of the control.
createdDateTime DateTimeOffset The creation date and time of the program control.
owner userIdentity The user who created the program control.
resource programResource The resource, a group or an app, targeted by this program control's access review.
program object The program this control is part of.

JSON Representation

Microsoft Graph beta exact-category-docs

JSON representation is shown from beta metadata because a stable v1.0 schema is not available for this resource mapping.

JSON representation
{
  "id": "string (identifier)",
  "programId": "string (identifier)",
  "controlId": "string (identifier)",
  "controlTypeId": "string (identifier)",
  "displayName": "string",
  "status": "string",
  "createdDateTime": "string (timestamp)",
  "owner": {
    "@odata.type": "microsoft.graph.userIdentity"
  },
  "resource": {
    "@odata.type": "microsoft.graph.programResource"
  }
}

Relationships

Microsoft Graph beta exact-category-docs

Relationships is shown from beta metadata because a stable v1.0 schema is not available for this resource mapping.

Relationship Type Description
program program The program this control is part of.
owner object The user who created the program control.

Graph Methods

Delegated access App-only access
Exact Microsoft Learn match

Microsoft Graph v1.0 endpoints are mapped directly from refreshed Microsoft Learn permissions tables.

No API methods available for this version.

Exact Microsoft Learn match

Microsoft Graph beta endpoints are mapped directly from refreshed Microsoft Learn permissions tables.

Methods
GET /programControls
GET /programControlTypes
GET /programs
GET /programs/{programId}/controls
Exact Microsoft Learn PowerShell match

Microsoft Graph PowerShell v1.0 commands are mapped directly from refreshed Microsoft Learn PowerShell snippets.

No deterministic PowerShell command map is available for this permission.

Browse PowerShell docs
Exact Microsoft Learn PowerShell match

Microsoft Graph PowerShell beta commands are mapped directly from refreshed Microsoft Learn PowerShell snippets.

Commands
Get-MgBetaProgram /programs
List programs (deprecated)
Get-MgBetaProgramControl /programControls
List programControls (deprecated)
Get-MgBetaProgramControlType /programControlTypes
List programControlTypes (deprecated)

Code Examples

C# / .NET SDK
List programControls (deprecated)
// Code snippets are only available for the latest version. Current version is 5.x

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.ProgramControls.GetAsync();
JavaScript
List programControls (deprecated)
const options = {
	authProvider,
};

const client = Client.init(options);

let programControls = await client.api('/programControls')
	.version('beta')
	.get();
PowerShell
List programControls (deprecated)
Import-Module Microsoft.Graph.Beta.Identity.Governance

Get-MgBetaProgramControl
Python
List programControls (deprecated)
# Code snippets are only available for the latest version. Current version is 1.x
from msgraph_beta import GraphServiceClient
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python

result = await graph_client.program_controls.get()

App Registration

1

Navigate to Azure Portal

Go to App registrations in Microsoft Entra admin center

2

Add API Permission

Select your app → API permissions → Add a permission → Microsoft Graph

3

Select Permission Type

Choose Application permissions or delegated permissions and search for ProgramControl.Read.All

4

Grant Admin Consent

Application permissions always require admin consent.