ESC
Type to search...

TenantGovernance-PolicyTemplate.ReadWrite.All

Export JSON
Export CSV
Copy URL
Print
Delegated Read/Write All Resources

Allows the application to list, read, create, update, and delete Tenant Governance policy templates on behalf of the signed-in user.

In short

TenantGovernance-PolicyTemplate.ReadWrite.All is a delegated permission in the Microsoft Graph API, grouped under the TenantGovernance-PolicyTemplate category. Allows the application to list, read, create, update, and delete Tenant Governance policy templates on behalf of the signed-in user. It grants read and write access to resources. This delegated permission requires admin consent.

Permission data: November 17, 2026 at 3:06 AM UTC
Delegated Access App-Only Access

Permission Details

Delegated Permission Admin consent required

Read and write Tenant Governance policy templates

Allows the application to list, read, create, update, and delete Tenant Governance policy templates on behalf of the signed-in user.

Properties

Microsoft Graph v1.0 exact-category

Properties is shown from stable Microsoft Graph v1.0 metadata.

Property Type Description
createdDateTime date-time The date and time when the template was created. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. Supports $filter (lt, le, gt, ge, eq, ne) and $orderBy.
delegatedAdministrationRoleAssignments delegatedAdministrationRoleAssignment collection A collection of delegated administration role assignments to be applied in the governed tenant when the governance relationship is established.
description string A description of the policy template. Supports $filter (eq, ne) and $orderBy.
displayName string The display name of the policy template. Supports $filter (eq, ne) and $orderBy.
governedTenantCanTerminate boolean Not implemented.
id string The unique identifier for an entity. Read-only.
lastModifiedDateTime date-time The date and time when the template was last modified. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. Supports $filter (lt, le, gt, ge, eq, ne) and $orderBy.
multiTenantApplicationsToProvision multiTenantApplicationsToProvision collection A collection of multi-tenant applications to be provisioned in the governed tenant when the governance relationship is established.
version string The version of the policy template. Version count increased by 1 when updated. Supports $filter (lt, le, gt, ge, eq, ne) and $orderBy.

JSON Representation

Microsoft Graph v1.0 exact-category

JSON representation is shown from stable Microsoft Graph v1.0 metadata.

JSON representation
{
  "createdDateTime": "2026-01-01T00:00:00Z",
  "delegatedAdministrationRoleAssignments": [
    {
      "@type": "delegatedAdministrationRoleAssignment",
      "id": "00000000-0000-0000-0000-000000000000"
    }
  ],
  "description": "String",
  "displayName": "String",
  "governedTenantCanTerminate": true,
  "id": "String",
  "lastModifiedDateTime": "2026-01-01T00:00:00Z",
  "multiTenantApplicationsToProvision": [
    {
      "@type": "multiTenantApplicationsToProvision",
      "id": "00000000-0000-0000-0000-000000000000"
    }
  ],
  "version": "String"
}

Relationships

Microsoft Graph v1.0 schema-derived

Relationships is shown from stable Microsoft Graph v1.0 metadata.

Relationship Type Description
delegatedAdministrationRoleAssignments delegatedAdministrationRoleAssignment collection A collection of delegated administration role assignments to be applied in the governed tenant when the governance relationship is established.
multiTenantApplicationsToProvision multiTenantApplicationsToProvision collection A collection of multi-tenant applications to be provisioned in the governed tenant when the governance relationship is established.

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.

Methods
GET /directory/tenantGovernance/governancePolicyTemplates
GET /directory/tenantGovernance/governancePolicyTemplates/{governancePolicyTemplateId}
GET /directory/tenantGovernance/governancePolicyTemplates/default
POST /directory/tenantGovernance/governancePolicyTemplates
PATCH /directory/tenantGovernance/governancePolicyTemplates/{governancePolicyTemplateId}
PATCH /directory/tenantGovernance/governancePolicyTemplates/default
DELETE /directory/tenantGovernance/governancePolicyTemplates/{governancePolicyTemplateId}
Exact Microsoft Learn match

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

Methods
GET /directory/tenantGovernance/governancePolicyTemplates
GET /directory/tenantGovernance/governancePolicyTemplates/{governancePolicyTemplateId}
GET /directory/tenantGovernance/governancePolicyTemplates/default
POST /directory/tenantGovernance/governancePolicyTemplates
PATCH /directory/tenantGovernance/governancePolicyTemplates/{governancePolicyTemplateId}
PATCH /directory/tenantGovernance/governancePolicyTemplates/default
DELETE /directory/tenantGovernance/governancePolicyTemplates/{governancePolicyTemplateId}
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-MgBetaDirectoryTenantGovernancePolicyTemplate /directory/tenantGovernance/governancePolicyTemplates
List tenantGovernancePolicyTemplates
Get-MgBetaDirectoryTenantGovernancePolicyTemplate /directory/tenantGovernance/governancePolicyTemplates/{governancePolicyTemplateId}
Get tenantGovernancePolicyTemplate
New-MgBetaDirectoryTenantGovernancePolicyTemplate /directory/tenantGovernance/governancePolicyTemplates
Create tenantGovernancePolicyTemplate
Remove-MgBetaDirectoryTenantGovernancePolicyTemplate /directory/tenantGovernance/governancePolicyTemplates/{governancePolicyTemplateId}
Delete tenantGovernancePolicyTemplate
Update-MgBetaDirectoryTenantGovernancePolicyTemplate /directory/tenantGovernance/governancePolicyTemplates/{governancePolicyTemplateId}
Update tenantGovernancePolicyTemplate

Code Examples

C# / .NET SDK
Create tenantGovernancePolicyTemplate
// Code snippets are only available for the latest version. Current version is 5.x

// Dependencies
using Microsoft.Graph.Beta.Models;

var requestBody = new TenantGovernancePolicyTemplate
{
	DisplayName = "Monitor Entra resource configurations",
	Description = "Grants Global reader and provisions a custom multi-tenant application to monitor conditional access policies",
	MultiTenantApplicationsToProvision = new List<MultiTenantApplicationsToProvision>
	{
		new MultiTenantApplicationsToProvision
		{
			AppId = "66667777-aaaa-8888-bbbb-9999cccc0000",
			ObjectId = "cccccccc-2222-3333-4444-dddddddddddd",
			DisplayName = "Mega Monitor",
			RequiredResourceAccesses = new List<ApplicationsRequiredResourceAccess>
			{
				new ApplicationsRequiredResourceAccess
				{
					ResourceAppId = "00000003-0000-0000-c000-000000000000",
					Permissions = new List<ApplicationResourcePermission>
					{
						new ApplicationResourcePermission
						{
							Id = "633e0fce-8c58-4cfb-9495-12bbd5a24f7c",
							Name = "Policy.Read.ConditionalAccess",
							Type = ApplicationPermissionType.Scope,
						},
						new ApplicationResourcePermission
						{
							Id = "e1fe6dd8-ba31-4d61-89e7-88639da4683d",
							Name = "User.Read",
							Type = ApplicationPermissionType.Scope,
						},
					},
				},
			},
		},
	},
	DelegatedAdministrationRoleAssignments = new List<DelegatedAdministrationRoleAssignment>
	{
		new DelegatedAdministrationRoleAssignment
		{
			RoleTemplates = new List<RoleTemplate>
			{
				new RoleTemplate
				{
					Id = "f2ef992c-3afb-46b9-b7cf-a126ee74c451",
					Name = "Global Reader",
				},
			},
			Group = new Group
			{
				Id = "ffffffff-5555-6666-7777-aaaaaaaaaaaa",
			},
		},
	},
};

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Directory.TenantGovernance.GovernancePolicyTemplates.PostAsync(requestBody);
JavaScript
Create tenantGovernancePolicyTemplate
const options = {
	authProvider,
};

const client = Client.init(options);

const tenantGovernancePolicyTemplate = {
  displayName: 'Monitor Entra resource configurations',
  description: 'Grants Global reader and provisions a custom multi-tenant application to monitor conditional access policies',
  multiTenantApplicationsToProvision: [
      {
          appId: '66667777-aaaa-8888-bbbb-9999cccc0000',
          objectId: 'cccccccc-2222-3333-4444-dddddddddddd',
          displayName: 'Mega Monitor',
          requiredResourceAccesses: [
              {
                resourceAppId: '00000003-0000-0000-c000-000000000000',
                permissions: [
                {
                  id: '633e0fce-8c58-4cfb-9495-12bbd5a24f7c',
                  name: 'Policy.Read.ConditionalAccess',
                  type: 'scope'
                },
                {
                  id: 'e1fe6dd8-ba31-4d61-89e7-88639da4683d',
                  name: 'User.Read',
                  type: 'scope'
                }
                ]
              }
          ]
      }
    ],
    delegatedAdministrationRoleAssignments: [
      {
          roleTemplates: [
              {
                  id: 'f2ef992c-3afb-46b9-b7cf-a126ee74c451',
                  name: 'Global Reader'
              }
          ],
          group: {
              id: 'ffffffff-5555-6666-7777-aaaaaaaaaaaa'
          }
      }
    ]
  };

await client.api('/directory/tenantGovernance/governancePolicyTemplates')
	.version('beta')
	.post(tenantGovernancePolicyTemplate);
PowerShell
Create tenantGovernancePolicyTemplate
Import-Module Microsoft.Graph.Beta.Identity.DirectoryManagement

$params = @{
	displayName = "Monitor Entra resource configurations"
	description = "Grants Global reader and provisions a custom multi-tenant application to monitor conditional access policies"
	multiTenantApplicationsToProvision = @(
		@{
			appId = "66667777-aaaa-8888-bbbb-9999cccc0000"
			objectId = "cccccccc-2222-3333-4444-dddddddddddd"
			displayName = "Mega Monitor"
			requiredResourceAccesses = @(
				@{
					resourceAppId = "00000003-0000-0000-c000-000000000000"
					permissions = @(
						@{
							id = "633e0fce-8c58-4cfb-9495-12bbd5a24f7c"
							name = "Policy.Read.ConditionalAccess"
							type = "scope"
						}
						@{
							id = "e1fe6dd8-ba31-4d61-89e7-88639da4683d"
							name = "User.Read"
							type = "scope"
						}
					)
				}
			)
		}
	)
	delegatedAdministrationRoleAssignments = @(
		@{
			roleTemplates = @(
				@{
					id = "f2ef992c-3afb-46b9-b7cf-a126ee74c451"
					name = "Global Reader"
				}
			)
			group = @{
				id = "ffffffff-5555-6666-7777-aaaaaaaaaaaa"
			}
		}
	)
}

New-MgBetaDirectoryTenantGovernancePolicyTemplate -BodyParameter $params
Python
Create tenantGovernancePolicyTemplate
# Code snippets are only available for the latest version. Current version is 1.x
from msgraph_beta import GraphServiceClient
from msgraph_beta.generated.models.tenant_governance_policy_template import TenantGovernancePolicyTemplate
from msgraph_beta.generated.models.multi_tenant_applications_to_provision import MultiTenantApplicationsToProvision
from msgraph_beta.generated.models.applications_required_resource_access import ApplicationsRequiredResourceAccess
from msgraph_beta.generated.models.application_resource_permission import ApplicationResourcePermission
from msgraph_beta.generated.models.application_permission_type import ApplicationPermissionType
from msgraph_beta.generated.models.delegated_administration_role_assignment import DelegatedAdministrationRoleAssignment
from msgraph_beta.generated.models.role_template import RoleTemplate
from msgraph_beta.generated.models.group import Group
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = TenantGovernancePolicyTemplate(
	display_name = "Monitor Entra resource configurations",
	description = "Grants Global reader and provisions a custom multi-tenant application to monitor conditional access policies",
	multi_tenant_applications_to_provision = [
		MultiTenantApplicationsToProvision(
			app_id = "66667777-aaaa-8888-bbbb-9999cccc0000",
			object_id = "cccccccc-2222-3333-4444-dddddddddddd",
			display_name = "Mega Monitor",
			required_resource_accesses = [
				ApplicationsRequiredResourceAccess(
					resource_app_id = "00000003-0000-0000-c000-000000000000",
					permissions = [
						ApplicationResourcePermission(
							id = "633e0fce-8c58-4cfb-9495-12bbd5a24f7c",
							name = "Policy.Read.ConditionalAccess",
							type = ApplicationPermissionType.Scope,
						),
						ApplicationResourcePermission(
							id = "e1fe6dd8-ba31-4d61-89e7-88639da4683d",
							name = "User.Read",
							type = ApplicationPermissionType.Scope,
						),
					],
				),
			],
		),
	],
	delegated_administration_role_assignments = [
		DelegatedAdministrationRoleAssignment(
			role_templates = [
				RoleTemplate(
					id = "f2ef992c-3afb-46b9-b7cf-a126ee74c451",
					name = "Global Reader",
				),
			],
			group = Group(
				id = "ffffffff-5555-6666-7777-aaaaaaaaaaaa",
			),
		),
	],
)

result = await graph_client.directory.tenant_governance.governance_policy_templates.post(request_body)

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 Delegated permissions and search for TenantGovernance-PolicyTemplate.ReadWrite.All

4

Grant Admin Consent

This delegated permission requires admin consent.

Frequently asked questions

What is the TenantGovernance-PolicyTemplate.ReadWrite.All Microsoft Graph permission?

TenantGovernance-PolicyTemplate.ReadWrite.All is a delegated permission in the Microsoft Graph API, grouped under the TenantGovernance-PolicyTemplate category. Allows the application to list, read, create, update, and delete Tenant Governance policy templates on behalf of the signed-in user. It grants read and write access to resources. This delegated permission requires admin consent. It is mapped to the Microsoft Graph tenantGovernancePolicyTemplate resource type. 14 documented Microsoft Graph REST methods require it. 5 Microsoft Graph PowerShell commands are documented for it.

Is TenantGovernance-PolicyTemplate.ReadWrite.All an application or a delegated permission?

TenantGovernance-PolicyTemplate.ReadWrite.All is a delegated permission only. It grants access on behalf of a signed-in user and cannot be used for app-only access.

Does TenantGovernance-PolicyTemplate.ReadWrite.All require admin consent?

This delegated permission requires admin consent.

What is the permission ID (GUID) for TenantGovernance-PolicyTemplate.ReadWrite.All?

For TenantGovernance-PolicyTemplate.ReadWrite.All, the delegated (OAuth2 scope) ID is 7cd0bd21-45fe-4c8e-a549-3c95bd27d185. These are the real Microsoft Graph identifiers and can be used directly in an app registration manifest.