Task 01: Register Resource Providers
DOCUMENT CATEGORY: Runbook
SCOPE: Azure resource provider registration
PURPOSE: Register all required Azure resource providers before cluster deployment
MASTER REFERENCE: Microsoft Learn — Register Resource Provider
Status: Active
Overview
Azure Local requires specific resource providers to be registered before deployment can proceed. This task checks each provider's registration status and registers any that are not already registered.
Resource provider registration typically takes 1–3 minutes per provider. Some providers may take longer during high-demand periods.
Prerequisites
| Prerequisite | Detail |
|---|---|
| Landing Zones | Phase 01 completed |
| Permissions | Contributor or Owner role at subscription level |
| Authenticated Azure session | See Authentication |
infrastructure.yml | Configured with target subscription ID |
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.
Required Providers
Register these 13 resource providers in your Azure Local subscription:
| # | Provider Namespace | Purpose |
|---|---|---|
| 1 | Microsoft.HybridCompute | Azure Arc-enabled servers |
| 2 | Microsoft.GuestConfiguration | Azure Policy guest configuration |
| 3 | Microsoft.HybridConnectivity | Azure Arc connectivity |
| 4 | Microsoft.AzureStackHCI | Azure Local cluster management (core) |
| 5 | Microsoft.Kubernetes | Azure Arc-enabled Kubernetes |
| 6 | Microsoft.KubernetesConfiguration | Kubernetes configuration |
| 7 | Microsoft.ExtendedLocation | Custom locations for Arc |
| 8 | Microsoft.ResourceConnector | Azure Arc Resource Bridge |
| 9 | Microsoft.HybridContainerService | Hybrid container workloads |
| 10 | Microsoft.Attestation | Security attestation |
| 11 | Microsoft.Storage | Storage accounts for deployment |
| 12 | Microsoft.Insights | Monitoring and logging |
| 13 | Microsoft.KeyVault | Key Vault for deployment secrets, local administrator credentials and BitLocker recovery keys |
Execution Options
- Azure Portal
- Orchestrated Script
- Azure CLI
Azure Portal
When to use: Single deployment, prefer visual interface
Procedure
- Navigate to Resource Providers:
- In Azure Portal, search for Subscriptions
- Select your target subscription (
infrastructure.yml:azure.subscription_id) - In the left menu under Settings, click Resource providers
- Register each provider:
For each provider in the required list:
a. Search for the provider name (e.g., Microsoft.HybridCompute)
b. Check the Status column:
- "Registered" → skip to next provider
- "NotRegistered" or "Unregistered" → select the row and click Register
c. Wait for status to change to "Registered" (1–3 minutes)
- Complete all 13 providers:
- Microsoft.HybridCompute
- Microsoft.GuestConfiguration
- Microsoft.HybridConnectivity
- Microsoft.AzureStackHCI
- Microsoft.Kubernetes
- Microsoft.KubernetesConfiguration
- Microsoft.ExtendedLocation
- Microsoft.ResourceConnector
- Microsoft.HybridContainerService
- Microsoft.Attestation
- Microsoft.Storage
- Microsoft.Insights
- Microsoft.KeyVault
- Verify: Refresh the page and confirm all 13 show "Registered" status.
Links
PowerShell
When to use: Run the task with the script below, from the place its help names (a management workstation, or the node itself).
Script
| Script | What it does |
|---|---|
scripts/deploy/02-azure-foundation/phase-02-resource-providers/task-01-register-resource-providers/powershell/Register-ResourceProviders.ps1 | Registers the Azure resource providers that Azure Local needs in the subscription of infrastructure.yml. |
The script takes the subscription from azure.subscription_id and the one provider list of the toolkit (13 providers). -Wait waits until each provider is registered (-MaxWaitMinutes, -PollSeconds).
Requires: modules Az.Resources.
Run
.\Register-ResourceProviders.ps1 -InfrastructureFile .\infrastructure.yml -Wait
Azure CLI
When to use: Run the task from a host that has the Azure CLI and not the Az PowerShell modules. The script is PowerShell 7 that calls
az; it readsinfrastructure.ymland carries no values of its own.
Script
| Script | What it does |
|---|---|
scripts/deploy/02-azure-foundation/phase-02-resource-providers/task-01-register-resource-providers/azurecli/Register-ResourceProviders.azcli.ps1 | Registers the Azure resource providers that Azure Local needs, with the Azure CLI, in the subscription of infrastructure.yml. Supports -WhatIf. |
Requires: PowerShell 7 and the Azure CLI, signed in with az login --tenant <azure.tenant_id>.
The script takes the subscription from azure.subscription_id and the one provider list of the toolkit (13 providers). -Wait waits until each provider it registered is registered (-MaxWaitMinutes, -PollSeconds). It selects azure.subscription_id with az account set and puts the earlier subscription back at the end.
Run
./Register-ResourceProviders.azcli.ps1 -InfrastructureFile ./infrastructure.yml -WhatIf
./Register-ResourceProviders.azcli.ps1 -InfrastructureFile ./infrastructure.yml -Wait
Troubleshooting
| Symptom | Error | Resolution |
|---|---|---|
| Permission denied | AuthorizationFailed | Verify Contributor or Owner role at subscription level — resource group-level permissions are insufficient |
| Provider stuck registering | Status remains "Registering" for 10+ minutes | Unregister then re-register: Unregister-AzResourceProvider -ProviderNamespace "Microsoft.X", wait 2 min, then Register-AzResourceProvider |
| Provider not found | Namespace not recognized | Verify spelling; check Azure status page for regional availability |
Next Steps
Proceed to Task 02: Verify Provider Registration to validate all providers are fully registered.
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.
Navigation
| Previous | Up | Next |
|---|---|---|
| Phase 02 — Resource Providers | Phase 02 — Resource Providers | Task 02 — Verify Provider Registration |
Version Control
- Created: 2026-01-15 by Azure Local Cloud
- Last Updated: 2026-03-02 by Azure Local Cloud
- Version: 2.0.0
- Tags: azure-local, phase-02, resource-providers, registration
- Keywords: register resource providers, provider registration, Azure Local prerequisites
- Author: Azure Local Cloud
Version Control
| Version | Date | Author | Changes |
|---|---|---|---|
| 1.0.0 | 2025-03-25 | Azure Local Cloud | Initial release |