Skip to main content

Task 01: Configure Management Group

Runbook Azure

DOCUMENT CATEGORY: Runbook
SCOPE: Simplified deployment — landing zone management group
PURPOSE: Create the landing zone management group under the existing root
MASTER REFERENCE: Microsoft Learn — Management Groups

Status: Active

Overview​

Create the landing zone management group under the existing root management group. The subscription created in Task 02 will be placed under this landing zone MG.

What This Accomplishes​

  • Landing zone governance boundary — scoped policies and RBAC inheritance for Azure Local resources
  • Subscription organization — the landing zone MG is the parent for the Azure Local subscription
Organization Root Management Group

Every Entra ID tenant has a built-in Tenant Root Group. Your organization root management group (e.g., cmp-iic-root) is created beneath it as a custom MG that serves as the top of your governance hierarchy. If the organization root MG does not exist yet, create it first — see the Full CAF/WAF Task 01 for the procedure. This task creates the landing zone management group beneath it.

Management Group Naming​

Management groups have two identifiers:

PropertyDescriptionCan Change?
ID (GroupName)Used in ARM/Bicep, CLI, and policy assignmentsNo — immutable once created
Display NameShown in Azure PortalYes — editable anytime

Example (IIC)​

AttributeValueSource
Parent MG IDcmp-iic-rootinfrastructure.yml → landing_zone.management_groups[].parent
Landing Zone MG IDcmp-landing-zones-iicinfrastructure.yml → landing_zone.management_groups[].name
Display NameIIC Landing Zone Management Groupinfrastructure.yml → landing_zone.management_groups[].display_name

Target Structure​

Tenant Root Group
└── cmp-iic-root # already exists
└── cmp-landing-zones-iic # ← created in this task

Prerequisites​

  • Organization root management group exists in the tenant (or you will create it — see note above)
  • Permissions: Management Group Contributor (or Owner) on the root management group. You may need to elevate access first.
  • Authenticated Azure session — see Authentication
  • infrastructure.yml configured with management group values

Values from infrastructure.yml​

The values for this task come from infrastructure.yml (schema 5). Every key, with its type, default and example, is in the variables reference.


Execution Options​

Azure Portal​

When to use: Single deployment, prefer visual interface

Procedure​

  1. Navigate to Management Groups:
  • In Azure Portal, search for Management groups
  • Locate the root management group (landing_zone.management_groups[].parent)
  1. Create the Landing Zone Management Group:
  • Click + Add management group
FieldValueSource
Management group ID<landing-zone-mg-id>infrastructure.yml → landing_zone.management_groups[].name
Management group display name<display-name>infrastructure.yml → landing_zone.management_groups[].display_name
ParentRoot MG from configinfrastructure.yml → landing_zone.management_groups[].parent
  1. Save and wait for creation to complete.

Validation​

  • Landing zone MG appears under the root MG in the portal
  • MG ID matches the value in infrastructure.yml
  • Display name is correct

Troubleshooting​

IssueSymptomResolution
Permission deniedAuthorizationFailedVerify Management Group Contributor or Owner role on the root MG
Duplicate IDManagementGroupAlreadyExistsThe MG already exists — verify it's under the correct parent and move on
Parent not foundParentManagementGroupNotFoundConfirm the root MG ID in infrastructure.yml matches what exists in the tenant

Next Steps​

Proceed to Task 02: Create Subscription

References​



Alternatives​

The procedures in this task use the methods shown in the tabs above. The toolkit is PowerShell 7 only and has no Bash scripts. A few tasks that act on Azure also have an Azure CLI script written in PowerShell. The script status page of the toolkit lists which task has which script.

PreviousUpNext
Simplified Deployment OverviewSimplified Deployment OverviewTask 02 — Create Subscription

Version Control

  • Created: 2026-01-15 by Hybrid Cloud Solutions
  • Last Updated: 2026-03-19 by Hybrid Cloud Solutions
  • Version: 3.0.0

Version Control​

VersionDateAuthorChanges
1.0.02025-03-25Azure Local CloudInitial release