Task 02: Create Subscription
DOCUMENT CATEGORY: Runbook
SCOPE: Single subscription deployment — subscription provisioning
PURPOSE: Create and configure single subscription
MASTER REFERENCE: Create Azure subscriptions programmatically
Status: Active
Overview
Provision a single Azure subscription and associate it with the landing zone management group. In the single subscription deployment model, all resources reside in one subscription, with organization achieved through resource groups and tags.
How You Create Subscriptions
How you create subscriptions depends on your organization's billing arrangement:
| Billing Type | Creation Method | Programmatic Support |
|---|---|---|
| Enterprise Agreement (EA) | EA Portal, Azure CLI, or REST API | ✅ Full — az account create with enrollment account |
| Microsoft Customer Agreement (MCA) | Azure Portal, Azure CLI, or REST API | ✅ Full — az account create with billing profile + invoice section |
| Pay-As-You-Go / MOSP | Azure Portal only | ❌ Manual only — use the Portal tab |
What This Accomplishes
- Single billing boundary — all costs tracked in one subscription
- Unified resource container — all resources under one subscription
- Simplified management — one subscription to govern
Prerequisites
| Prerequisite | Detail |
|---|---|
| Management Group | Landing zone management group deployed (Task 01) |
| Billing Access | EA enrollment account owner, MCA billing profile owner, or Azure Portal access to create subscriptions |
| Permissions | Management Group Contributor on the landing zone MG (to associate the subscription after creation) |
Subscription Details
Naming Convention
Pattern: <org>-<purpose>-<environment>-<instance>
Example (IIC): iic-lz-azurelocal-001
Configuration Reference
| Attribute | Value | Config Path |
|---|---|---|
| Subscription Name | Per config | infrastructure.yml: landing_zone.subscriptions[].name |
| Subscription ID | Per config | infrastructure.yml: azure.subscription_id |
| Landing Zone MG | Per config | infrastructure.yml: landing_zone.management_groups[].name |
| Purpose | All Azure Local resources | — |
IIC Example Values
| Attribute | IIC Value |
|---|---|
| Subscription Name | iic-lz-azurelocal-001 |
| Landing Zone MG | cmp-landing-zones-iic |
Resource Organization Strategy
In the single subscription model, a single resource group provides resource organization within the subscription:
iic-lz-azurelocal-001 ← subscription
└── rg-c01-azl-eus-01 ← single resource group (Task 03)
├── Azure Local cluster resources
├── Arc-enabled servers
├── Key Vault
└── Storage accounts
The single resource group is created in Task 03: Create Resource Groups. This task only covers the subscription itself.
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
- Orchestrated Script
- Azure CLI
Azure Portal
When to use: Pay-As-You-Go billing, or you prefer the visual interface
Procedure
-
Navigate to Subscriptions:
- In Azure Portal, search for Subscriptions
- Click + Add
-
Create the subscription:
- Subscription name:
iic-lz-azurelocal-001(or your value frominfrastructure.yml) - Billing: Select your billing account / enrollment
- Management group: Select the landing zone management group (
cmp-landing-zones-iic) - Click Create
- Subscription name:
-
Verify the subscription appears under the correct management group in Management groups view
Validation
- Subscription created with name matching
infrastructure.yml - Subscription is under the landing zone management group
- You have Owner access to the subscription
PowerShell
No script of its own. The toolkit has no script folder for the single subscription route. Use the script of the full deployment:
scripts/deploy/02-azure-foundation/phase-01-landing-zones/full-deployment/task-02-create-subscriptions/powershell/Deploy-Subscriptions.ps1readslanding_zone.subscriptions[], and a file with one entry gives the same result. Or follow the steps in the other tab of this page.
Azure CLI
No script of its own. The toolkit has no script folder for the single subscription route. Use the Azure CLI script of the full deployment:
scripts/deploy/02-azure-foundation/phase-01-landing-zones/full-deployment/task-02-create-subscriptions/azurecli/Deploy-Subscriptions.azcli.ps1readslanding_zone.subscriptions[], and a file with one entry gives the same result. Or follow the steps in the other tab of this page.
./Deploy-Subscriptions.azcli.ps1 -InfrastructureFile ./infrastructure.yml -WhatIf
./Deploy-Subscriptions.azcli.ps1 -InfrastructureFile ./infrastructure.yml
Requires: PowerShell 7 and the Azure CLI, signed in with az login --tenant <azure.tenant_id>. Needs the Azure CLI extension account (az extension add --name account). You need a role that may create subscriptions on the billing scope.
Using an Existing Subscription
If your organization already has a subscription provisioned, skip creation and associate it with the landing zone management group:
az account management-group subscription add \
--name "cmp-landing-zones-iic" \
--subscription "<subscription-id-or-name>"
New-AzManagementGroupSubscription `
-GroupId "cmp-landing-zones-iic" `
-SubscriptionId "<subscription-id>"
Moving a subscription to a different management group changes which Azure Policies and RBAC role assignments it inherits. Review inherited policies before moving production subscriptions.
Target Structure
cmp-iic-root ← organization root MG (already exists)
└── cmp-landing-zones-iic ← landing zone MG (Task 01)
└── iic-lz-azurelocal-001 ← subscription (this task)
Validation
- Subscription exists with the name from
infrastructure.yml - Subscription is associated with the landing zone management group (not root)
- Subscription is visible under the landing zone MG in the Azure Portal
- You have Owner or Contributor access to the subscription
Verify via CLI
az account management-group show --name "cmp-landing-zones-iic" --expand \
--query "children[?type=='Microsoft.Management/managementGroups/subscriptions'].{Name:name, DisplayName:displayName}" \
-o table
Troubleshooting
| Symptom | Error | Resolution |
|---|---|---|
| No enrollment account found | Empty result from az billing enrollment-account list | You need EA enrollment account owner role — contact your organization's EA admin |
| Subscription creation fails | AuthorizationFailed or BillingAccountNotFound | Verify your billing access — EA enrollment owner, MCA billing profile contributor, etc. |
| Cannot associate with MG | AuthorizationFailed | Verify Management Group Contributor role on the landing zone MG |
| Subscription under wrong MG | Shows under root or Tenant Root Group | Move: az account management-group subscription add --name cmp-landing-zones-iic --subscription <sub-id> |
| Subscription not visible | Not listed in Azure Portal | Verify you're signed into the correct tenant — check with az account show |
Next Steps
Proceed to Task 03: Create Resource Groups
References
- Create Azure Subscriptions Programmatically
- Create EA Subscriptions
- Create MCA Subscriptions
- Move Subscriptions Between Management Groups
Scripts for this task are located in the azurelocal-toolkit repository under scripts/deploy/ in the appropriate task folder.
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.
Navigation
| Previous | Up | Next |
|---|---|---|
| Task 01 — Management Group | Single Subscription Deployment Overview | Task 03 — Create Resource Groups |
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
| Version | Date | Author | Changes |
|---|---|---|---|
| 1.0.0 | 2025-03-25 | Azure Local Cloud | Initial release |