A Microsoft desktop and app virtualization service that runs on Azure. Previously known as Windows Virtual Desktop.
Hello Admin Oscar Catana,
this behavior is known with the session host virtual machines being created successfully but failing to register with the Azure Virtual Desktop service. When a session host does not complete agent registration, it will not appear under Host pool -> Session hosts, and the host pool will continue to show 0 session hosts, even though the VM exists and is running. The Azure Virtual Desktop control plane only lists session hosts after the Azure Virtual Desktop Agent successfully registers the machine to the host pool. If that registration step fails, the VM remains invisible to the host pool.
Common Causes for failure:
- Registration token issues: If the registration token is expired, invalid, or never successfully applied by the agent, registration does not complete.
On the session host VM, review: Event Viewer -> Windows Logs -> Application. Look for events from RDAgentBootLoader, WVD-Agent, or WVD-Agent-Updater
A common failure is Event ID 3277, with messages such as:
INVALID_REGISTRATION_TOKEN
EXPIRED_MACHINE_TOKEN
If these appear, generate a new registration key from the host pool and reapply it to the session host using supported re-registration steps.
- Azure Virtual Desktop Agent or bootloader not running: The VM will not register if either of the following services is not running:
Remote Desktop Agent Boot Loader (RDAgentBootLoader)Remote Desktop Services Infrastructure AgentIf these services fail to start or crash during startup, the session host will not be registered with the host pool. Service startup failures are typically visible in the Application or System logs. - Outbound network connectivity to required endpoints: AVD requires outbound HTTPS connectivity from the session host to specific service endpoints. If required endpoints are blocked by an NSG, firewall, or proxy, the agent may install successfully but fail registration. Azure Virtual Desktop is not supported if required FQDNs are blocked.
The supported way to validate this is by running the Azure Virtual Desktop Agent URL Tool (WVDAgentUrlTool.exe) from the session host VM. - Session host identity join issues (Microsoft Entra ID join):
For Microsoft Entra ID–joined session hosts created through the Azure Virtual Desktop portal, theAADLoginForWindowsextension being present indicates the join process ran, but it does not guarantee successful agent registration. If registration fails, the root cause is typically visible in: Azure Virtual Desktop agent logs AADLoginForWindows logs Agent health checks once registration partially succeeds - Duplicate or previously registered session host names: If a session host name was previously registered and not fully cleaned up, the agent may reject re-registration. This is known as a
NAME_ALREADY_REGISTEREDfailure in agent logs. In this scenario, removing old session host records and ensuring new, unique VM names is required before redeployment.
Recommended diagnostic approach is:
- Verify the Azure Virtual Desktop Agent and Boot Loader services are running.
- Review Event Viewer application logs for Azure Virtual Desktop agent errors (especially Event ID 3277).
- Confirm the registration key is valid at deployment and not expired.
- Run the Azure Virtual Desktop Agent URL Tool to validate required endpoint access.
- Confirm the session host image and OS are supported (Windows 11 Enterprise multi-session is supported).
- Confirm agent installation completed without error and was not blocked by policy or network restrictions.
References:
- https://learn.microsoft.com/troubleshoot/azure/virtual-desktop/troubleshoot-agent
- https://learn.microsoft.com/azure/virtual-desktop/session-host-status-health-checks
- https://learn.microsoft.com/troubleshoot/azure/virtual-desktop/troubleshoot-vm-configuration
- https://learn.microsoft.com/azure/virtual-desktop/required-fqdn-endpoint
- https://learn.microsoft.com/azure/virtual-desktop/check-access-validate-required-fqdn-endpoint
- https://learn.microsoft.com/azure/virtual-desktop/add-session-hosts-host-pool