Drain mode (Azure Virtual Desktop)
Concept
Drain mode isolates an Azure Virtual Desktop session host for maintenance. It accepts no new user sessions, while existing sessions stay active until users sign out or an administrator ends them.
Relationships
Drain mode (Azure Virtual Desktop) falls under the broader topic Session host (Azure Virtual Desktop). Drain mode (Azure Virtual Desktop) is closely related to Host pool (Azure Virtual Desktop).
Description
Drain mode isolates an Azure Virtual Desktop session host so that maintenance can be done without disrupting the service. A session host in drain mode accepts no new user sessions, and new connections are redirected to the next available session host. Existing connections stay active until the user signs out or an administrator ends the session. Once no sessions remain, maintenance can start. Administrators can still connect to the server directly, without going through the Azure Virtual Desktop service.
Drain mode is set per session host. In the Azure portal, select the host pool, open Session hosts and choose Turn drain mode on or Turn drain mode off. In Azure PowerShell, Update-AzWvdSessionHost is called with the AllowNewSession parameter, set to false to drain and to true to accept new sessions again. Learn lists a host pool with at least one session host and the Desktop Virtualization Session Host Operator role as prerequisites, and advises waiting at least 60 seconds before refreshing the portal, because the displayed status can otherwise appear out of sync.
Drain mode interacts with scaling. On pooled host pools, Azure Virtual Desktop autoscale puts a session host into drain mode before it turns the host off and overwrites existing drain mode settings, so Learn advises exclusion tags when updating VMs. A VM that carries the exclusion tag is left alone: autoscale does not turn it on or off or change its drain mode. Nerdio Manager describes a rolling drain mode among its dynamic host pool auto-scaling settings.
| Type | Concept |
|---|---|
| Kind | Feature |
| Documentation | Drain mode (Azure Virtual Desktop) – Microsoft Learn learn.microsoft.com |
Related topics in brief
Topics linked to Drain mode (Azure Virtual Desktop), each briefly explained:
- Session host (Azure Virtual Desktop) – Part of Azure Virtual Desktop · Broader topic
A session host is a virtual machine registered to Azure Virtual Desktop that users connect to for their sessions. A host pool is a collection of session hosts, which should come from the same image. - Host pool (Azure Virtual Desktop) – Narrower topic of Azure Virtual Desktop · Related to
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.
All relationships of Drain mode (Azure Virtual Desktop), grouped by type of relationship:
Broader topic
Broader topics of Drain mode (Azure Virtual Desktop):
Related to
Topics related to Drain mode (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 Drain mode (Azure Virtual Desktop), each with the topic that connects them:
- Mirko Peters · via Host pool (Azure Virtual Desktop)
Sources
- Drain mode (Azure Virtual Desktop) – Microsoft Learn learn.microsoft.com
Maintained by Mirko Peters (Microsoft MVP) · Last updated: