Skip to main content

Task 01: Enable Azure Hybrid Benefit

DOCUMENT CATEGORY: Runbook SCOPE: Enable Azure Hybrid Benefit on Azure Local cluster to reduce Windows VM compu... PURPOSE: Enable Azure Hybrid Benefit on Azure Local cluster to reduce Windows VM compute costs MASTER REFERENCE: Azure Hybrid Benefit for Azure Local

Status: Active

⚠️ LICENSING REQUIREMENT - NOT A DEFAULT ENTITLEMENT

Azure Hybrid Benefit is NOT included by default. This benefit requires the customer to have:

  1. Windows Server Datacenter licenses with active Software Assurance (SA), obtained through:
  • Enterprise Agreement (EA) with active Software Assurance
  • Cloud Solution Provider (CSP) subscription
  • Microsoft Customer Agreement (MCA) with qualifying subscription
  1. Sufficient core licenses - Each Windows Server core license entitles use on one physical core of Azure Local. You must allocate enough core licenses to cover all physical cores on all servers in the Azure Local cluster.

  2. Ongoing compliance - Workloads using Azure Hybrid Benefit can run only during the Software Assurance or subscription license term. When the term approaches expiration, you must:

  • Renew your agreement with Software Assurance or subscription license, OR
  • Disable the Azure Hybrid Benefit functionality, OR
  • Deprovision workloads using Azure Hybrid Benefit

⚠️ Microsoft reserves the right to audit customers at any time to verify eligibility for Azure Hybrid Benefit utilization.

Reference: Azure Hybrid Benefit for Windows Server | Azure Hybrid Benefit for Azure Local

Azure Hybrid Benefit allows you to use existing Windows Server licenses with Software Assurance to reduce costs for Windows VMs running on Azure Local.

Scope of the benefit (verified October 2026)

Azure Hybrid Benefit for Azure Local waives the Azure Local host service fee and the Windows Server guest subscription fee. It applies only to hyperconverged deployments with cloud-connected management and no external storage. Disaggregated deployments, hyperconverged deployments with external storage, and disconnected operations are not eligible for the Azure Local benefit. You can't deactivate the benefit after activation. Source: Azure Hybrid Benefit for Azure Local.

Overview​

Azure Hybrid Benefit provides:

  • Up to 40% savings on Windows VM compute costs
  • License mobility from on-premises to Azure Local
  • Compliance with Microsoft licensing requirements

Prerequisites​

  • Windows Server licenses with active Software Assurance
  • Azure Local cluster registered with Azure Arc
  • Owner or Contributor role on the cluster resource

Values from infrastructure.yml​

The script reads these keys from infrastructure.yml (schema 5). Each key, with its type, default and example, is in the variables reference.

azure.tenant_id, azure.subscription_id, azure.resource_group, cluster.name
scenario.storage_architecture, scenario.connectivity
operations.licensing.azure_hybrid_benefit

Execution Options​

Steps​

  1. Navigate to the Azure portal → Azure Arc → Azure Local
  2. Select your cluster resource
  3. Go to Settings → Configuration
  4. Locate Azure Hybrid Benefit section
  5. Toggle Enable Azure Hybrid Benefit to On
  6. Review the licensing attestation
  7. Click Save

Verification​

  1. Return to the cluster Overview page
  2. Confirm Azure Hybrid Benefit shows as Enabled

Verification​

After enabling Azure Hybrid Benefit, verify the configuration:

# On the cluster node
Get-AzStackHCI | Select-Object ClusterName, AzureHybridBenefit

# From management server
$cluster = Get-AzResource -ResourceId $ClusterResourceId
$cluster.Properties.softwareAssuranceProperties

Troubleshooting​

IssueResolution
"Cluster not connected"Verify Arc connection with Get-AzStackHCI
Permission deniedEnsure Owner or Contributor role on cluster resource
License attestation requiredReview and accept the licensing terms in Azure Portal

Toolkit Reference

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.

PreviousUpNext
← Phase 04: Security & GovernancePhase 05: Licensing & TelemetryTask 02: Windows Server Subscription →

VersionDateAuthorChanges
1.0.02026-03-24Azure Local CloudInitial release

Version Control​

VersionDateAuthorChanges
1.0.02025-03-25Azure Local CloudInitial release