Microsoft.Management managementGroups template reference

Template format

To create a Microsoft.Management/managementGroups resource, add the following JSON to the resources section of your template.

  "name": "string",
  "type": "Microsoft.Management/managementGroups",
  "apiVersion": "2020-05-01",
  "properties": {
    "displayName": "string",
    "details": {
      "parent": {
        "id": "string"
  "resources": []

Property values

The following tables describe the values you need to set in the schema.

Microsoft.Management/managementGroups object

Name Type Required Value
name string Yes Management Group ID.
type enum Yes Microsoft.Management/managementGroups
apiVersion enum Yes 2020-05-01
properties object Yes CreateManagementGroupProperties object
resources array No subscriptions

CreateManagementGroupProperties object

Name Type Required Value
displayName string No The friendly name of the management group. If no value is passed then this field will be set to the groupId.
details object No CreateManagementGroupDetails object

CreateManagementGroupDetails object

Name Type Required Value
parent object No CreateParentGroupInfo object

CreateParentGroupInfo object

Name Type Required Value
id string No The fully qualified ID for the parent management group. For example, /providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-000000000000

Quickstart templates

The following quickstart templates deploy this resource type.

Template Description
Create a New Management Group

Deploy to Azure
This template is a tenant level template that will create a new management group.