A Microsoft desktop and app virtualization service that runs on Azure. Previously known as Windows Virtual Desktop.
The error shows a generic DeploymentFailed / ResourceDeploymentFailure during the linked template vmCreation-linkedTemplate-... for adding VMs to an Azure Virtual Desktop (AVD) host pool. To identify and fix the root cause, the deployment and activity logs must be checked, then the specific error resolved.
Follow these steps:
- Inspect the failed deployment operations
- In the Azure portal, go to Resource groups → select
AzureRG. - Select Deployments → open the failed deployment
AddVMsToHostPool-3e9e7...-deployment. - Select Operation details for the failed operation
vmCreation-linkedTemplate-3e9e7.... - Note the inner error code and message (for example:
VmSkuNotAvailableInRegion,InvalidResourceReference,VMExtensionProvisioningError, domain join errors, etc.). This inner error determines the fix.
- In the Azure portal, go to Resource groups → select
- If the error is about VM SKU / region / quota (for example
VmSkuNotAvailableInRegion,VmSkuNotAvailableInRegionDueToRestriction,AvailabilityZoneNotAvailable):- Verify that the selected VM size, region, and availability zone are supported and that subscription quota is sufficient.
- Use
Get-AzComputeResourceSkuto check restrictions for the chosen VM SKU and region. - Adjust the session host configuration (VM size, region, availability zone) to a supported combination and redeploy.
- If the error is about parameter compatibility (for example
ComputeSkuIncompatibleWithImageHyperVGeneration,ImageDiskTypeIncompatible,VnetLocationIncompatible):- Confirm that the VM SKU, OS image, disk type, and virtual network location meet Azure Virtual Desktop prerequisites.
- Correct any incompatible combination (for example, align VNet region with VM location, choose a compatible image/disk type) and redeploy.
- If the error is an ARM template–specific deployment error (for example
InvalidResourceReference,VMExtensionProvisioningError, domain join or DSC errors):- In the failed deployment’s Operation details, capture the exact error text.
- Use the guidance in Troubleshoot host pool creation:
-
InvalidResourceReferencedue to name collision (NIC or other resource): change the host name prefix so that NIC and related resource names are unique, then redeploy. -
VMExtensionProvisioningErroror DSC errors: verify that the admin username/password used in the template have local admin rights on the VM, then rerun the deployment. - Domain join failures (
.../joindomain):- Check that domain join credentials are correct.
- Ensure the domain name resolves from the VNet.
- Ensure the VNet DNS settings are set to Custom and point to the domain controller/DNS server, not the default Azure DNS.
-
- If the session host configuration itself failed to create
- If the host pool’s session host configuration failed during creation (for example due to invalid VM SKU/region/image/network combination), the portal may not allow creating a new configuration for that host pool.
- Options:
- Create the session host configuration via PowerShell using
New-AzWvdSessionHostConfigurationwith corrected parameters, then redeploy session hosts. - Or delete the problematic host pool and recreate it with valid session host configuration parameters.
- Create the session host configuration via PowerShell using
- If no clear error appears in the deployment blade
- In the Azure portal, go to Monitor → Activity log.
- Filter by resource group
AzureRGand the time of the failed deployment. - Open the error entry and use the detailed error message and code together with the ARM troubleshooting guidance to resolve the issue.
- After fixing the root cause, delete any partially created resources from the failed deployment and rerun the deployment.
Once the underlying cause (SKU/region/quota, parameter incompatibility, domain join, NIC name collision, DSC/extension failure, etc.) is corrected, rerun the AddVMsToHostPool-... deployment or re-add VMs to the host pool.
References:
- Troubleshoot session host configuration and session host update in Azure Virtual Desktop
- Deploy Azure Virtual Desktop (host-pool-session-host-configuration)
- Troubleshoot host pool creation
- Troubleshoot deployment issues when creating a new Windows VM in Azure
- Troubleshoot virtual machine deployment failures in Azure DevTest Labs