Session host configuration (Azure Virtual Desktop)
Concept
A session host configuration defines properties such as disk type and OS image for all session hosts in a host pool. Changes are applied to existing hosts through session host update, which replaces VMs in batches. Introduced in preview in November 2024.
Relationships
Session host configuration (Azure Virtual Desktop) falls under the broader topic Host pool (Azure Virtual Desktop). Session host configuration (Azure Virtual Desktop) is closely related to Azure Virtual Desktop.
Description
A session host configuration defines the VM disk type, the operating system image and other properties for all session hosts of a pooled host pool, and it is chosen when the host pool is created. Microsoft introduced session host configuration and update in preview in November 2024. In July 2026 Microsoft announced general availability of enhanced host pool management, including dynamic autoscaling, session host configuration and update, and ephemeral OS disks (Tech Community). Some Learn pages still carry preview wording; check the current page before relying on a limit. Dynamic autoscaling and ephemeral OS disks require a host pool with a session host configuration.
Session host update applies a changed configuration to the existing hosts. It can change the image, VM size, disk type, security type (standard, Trusted launch or confidential), domain join and local administrator credentials, Intune enrollment and a custom configuration PowerShell script. One session host is updated first as a test, then the rest follow in batches of an administrator-defined size. Hosts are notified, placed in drain mode, removed and replaced by new VMs named with the old name and a date-time suffix, and the original VMs are deleted. Only one update can run per host pool at a time.
Limits listed by Learn: customizations added manually to hosts are lost, so they belong in the image, in Intune or Group Policy, or in the custom script. The OS disk size and the directory cannot be changed, and the feature is available only in the global Azure cloud, not in Azure US Government or Azure operated by 21Vianet. Autoscale should be disabled during an update, otherwise the update can fail. Learn adds that a managed identity can be assigned when such a host pool is created, and that host pools with a session host configuration will require one in a future service update in order to add session hosts.
| Type | Concept |
|---|---|
| Kind | Feature |
| Documentation | Session host configuration (Azure Virtual Desktop) – Microsoft Learn learn.microsoft.com |
Related topics in brief
Topics linked to Session host configuration (Azure Virtual Desktop), each briefly explained:
- Host pool (Azure Virtual Desktop) – Narrower topic of Azure Virtual Desktop · Broader topic
A host pool in Azure Virtual Desktop is a collection of Azure virtual machines registered as session hosts; host pools are either pooled, shared by multiple users, or personal, with a dedicated machine per user. - Azure Virtual Desktop – Cloud platform by Microsoft · Related to
Cloud-hosted desktop and app virtualisation service on Azure, extendable to hybrid and other hypervisors.
All relationships of Session host configuration (Azure Virtual Desktop), grouped by type of relationship:
Broader topic
Broader topics of Session host configuration (Azure Virtual Desktop):
Related to
Topics related to Session host configuration (Azure Virtual Desktop):
Community wiki
Short info above, community knowledge below: add practical tips, examples or corrections. New contributions are reviewed first; trusted members publish directly.
Experts and companies for this topic
Nobody has listed this topic yet. Add it to your profile.
Experts on related topics
Experts on topics related to Session host configuration (Azure Virtual Desktop), each with the topic that connects them:
- Mirko Peters · via Host pool (Azure Virtual Desktop)
Sources
- Session host configuration (Azure Virtual Desktop) – Microsoft Learn learn.microsoft.com
Maintained by Mirko Peters (Microsoft MVP) · Last updated: