M365Con 2027 – die kostenlose Online-Konferenz · 11–22 Jan 2027 · 120 sessions m365con.net

Blog · Mirko Peters

Drain-Modus in Azure Virtual Desktop erklärt

Partner · Neutraler Partner: Nerdio

Von ·

Der Drain-Modus verhindert, dass ein Session Host neue Sitzungen neuer Benutzer annimmt. Bestehende Sitzungen laufen weiter, bis sie enden. Dieser Artikel erklärt, was sich dadurch ändert und was nicht, wie Load Balancer und Autoscale damit umgehen und wie Sie den Modus im Portal setzen sowie mit PowerShell setzen und auslesen.

Automatisch mit KI aus dem Originalbeitrag übersetzt. Englisches Original lesen

Der Drain-Modus ist eine Einstellung pro Host, die verhindert, dass ein Session Host neue Benutzersitzungen annimmt. Bereits bestehende Sitzungen bleiben unberührt. Dieser Artikel erklärt, was die Einstellung ändert und was nicht, wie Load Balancer und Autoscale damit umgehen und wie Sie sie im Portal sowie mit PowerShell setzen und auslesen. Das schrittweise Wartungs-Runbook ist ein eigener Artikel: „How to use drain mode for patching and maintenance of session hosts“. Die Planung von Wellen über einen Pool hinweg behandelt „Patching AVD without downtime: rolling updates with drain mode“.

Das Wichtigste in Kürze

  • Ein im Drain-Modus befindlicher Session Host nimmt keine neuen Sitzungen an. Bestehende Sitzungen bleiben verbunden, bis sich der Benutzer abmeldet oder ein Administrator sie beendet. Administratoren können sich weiterhin direkt mit dem Server verbinden.
  • Der Drain-Modus ist keine Abmeldung, kein Herunterfahren und kein Integritätsstatus. Er ändert nur, ob der Host für neue Verbindungen ausgewählt werden kann.
  • Ein Benutzer, der bereits eine aktive oder getrennte Sitzung auf einem Host im Drain-Modus hat, wird beim erneuten Anmelden weiterhin zu diesem Host geleitet. Neue Benutzer werden dort nicht platziert.
  • In gepoolten Hostpools schaltet Autoscale den Drain-Modus unabhängig davon ein und aus, wer ihn gesetzt hat. Um einen Host zu schützen, verwenden Sie das Ausschluss-Tag. In persönlichen Hostpools verwendet Autoscale den Drain-Modus nicht.
  • In PowerShell aktiviert Update-AzWvdSessionHost mit AllowNewSession $False den Drain-Modus, und $True deaktiviert ihn. Learn nennt die Rolle Desktop Virtualization Session Host Operator als Voraussetzung.

Was der Drain-Modus bewirkt

Microsoft Learn beschreibt Drain-Modus als Möglichkeit, einen Session Host zu isolieren, damit Wartungsarbeiten ohne Dienstunterbrechung durchgeführt werden können. Die dokumentierten Auswirkungen sind:

  • Neue Sitzungen. Ein Host im Drain-Modus nimmt keine neuen Sitzungen an. Neue Verbindungen werden zum nächsten verfügbaren Session Host umgeleitet.
  • Bestehende Sitzungen. Sie bleiben aktiv, bis sich der Benutzer abmeldet oder ein Administrator die Sitzung beendet.
  • Wartung. Sobald auf dem Host keine Sitzungen mehr vorhanden sind, können Sie die Wartungsarbeiten durchführen.
  • Administratorzugriff. Administratoren können sich weiterhin direkt mit dem Server verbinden, ohne den Azure Virtual Desktop-Dienst zu nutzen.

In der Azure-PowerShell-Referenz entspricht derselbe Zustand dem Parameter -AllowNewSession von Update-AzWvdSessionHost. Das Ausgabeobjekt von Get-AzWvdSessionHost enthält die Eigenschaft AllowNewSession, beschrieben als „Allow a new session.“. Der Learn-Text verwendet an manchen Stellen die Pluralform AllowNewSessions, und die Autoscale-FAQ besagt, dass Autoscale beim Deaktivieren des Drain-Modus nach dem Deallocate einer VM AllowNewSessions auf true setzt. Drain-Modus aktiv bedeutet also, dass keine neuen Sitzungen erlaubt sind, und Drain-Modus inaktiv bedeutet, dass sie erlaubt sind.

Was der Drain-Modus nicht ist

  • Er ist keine Abmeldung. Durch das Einschalten wird nichts beendet.
  • Er ist kein Herunterfahren. Learn beschreibt kein Herunterfahren. Die VM läuft daher weiter, und die Kosten fallen weiterhin an. Dies ist eine Schlussfolgerung aus der Beschreibung und keine Aussage von Learn.
  • Er ist kein Integritätsstatus. Learn führt die Einstellung für neue Sitzungen und den Status als getrennte Eigenschaften auf. Integritätsprüfungen und Statusmeldungen sind ein eigenes Thema; siehe „Azure Virtual Desktop Session Host Shows Unavailable: A Step-by-Step Checklist“.
  • Das ist nicht dasselbe wie das maximale Sitzungslimit. Bei Load Balancing mit Depth-First hat ein Host, der das maximale Sitzungslimit erreicht hat, keine neuen Sitzungen mehr zugewiesen. Das gilt allerdings nur, bis Sitzungen enden und wieder Kapazität frei ist. Ein per Drain-Modus gesperrter Host bleibt ausgeschlossen, bis der Drain-Modus wieder ausgeschaltet wird. Das erledigen Sie selbst oder, bei gepoolten Hostpools mit Skalierungsplan, Autoscale – es sei denn, der Host trägt das Ausschlusstag (siehe unten).

So behandelt der Load Balancer einen gesperrten Host

Die Learn-Seite zum Load Balancing nennt zwei Regeln, die erklären, was Benutzer erleben:

  1. Bei neuen Benutzern berücksichtigt der Load Balancer keine Sitzungshosts im Drain-Modus.
  2. Ein Benutzer, der eine aktive oder getrennte Sitzung hat und sich erneut anmeldet, wird auf diesen Sitzungshost umgeleitet, auch wenn der Drain-Modus aktiviert ist.

Die zweite Regel ist für die Planung wichtig. Ein Benutzer mit einer getrennten Sitzung auf einem gesperrten Host kehrt auf diesen Host zurück. Der Host leert sich daher nicht von selbst, solange solche Sitzungen existieren. Der Host ist erst leer, wenn sich die Benutzer abgemeldet haben oder Sie deren Sitzungen beendet haben. Learn führt beide Regeln als Verhalten auf, das sowohl für Breadth-First als auch für Depth-First Load Balancing gilt. Ergänzend heißt es, dass das Load Balancing auf persönlichen Hostpools nicht angewendet wird.

Wer kann ihn setzen, und wie?

Die Learn-Seite zum Drain-Modus nennt die Voraussetzungen für den gesamten Ablauf, sowohl im Portal als auch in PowerShell: ein Hostpool mit mindestens einem Sitzungshost und die Rolle Desktopvirtualisierung-Sitzungshost-Operator. Für lokales Azure PowerShell benötigen Sie außerdem das Modul Az.DesktopVirtualization, alternativ können Sie Azure Cloud Shell verwenden.

Öffnen Sie im Azure-Portal den Hostpool, wählen Sie Sitzungshosts aus, markieren Sie den Host und wählen Sie Drain-Modus aktivieren. Wählen Sie Drain-Modus deaktivieren, um wieder Verbindungen zuzulassen.

In Azure PowerShell bietet die Learn-Seite zum Drain-Modus für jede Richtung einen Befehl. Er wirkt jeweils auf einen Sitzungshost, wiederholen Sie ihn daher für jeden Host, den Sie ändern möchten:

# Drain mode on: block new sessions
$params = @{
    ResourceGroupName = '<ResourceGroupName>'
    HostPoolName = '<HostPoolName>'
    Name = '<SessionHostName>'
    AllowNewSession = $False
}
Update-AzWvdSessionHost @params

# Drain mode off: allow new sessions
$params.AllowNewSession = $True
Update-AzWvdSessionHost @params

Die Seite zeigt die beiden Blöcke getrennt; die einzelne Hashtable oben ist eine Kurzfassung dieses Artikels.

Um den Status abzufragen, gibt Get-AzWvdSessionHost ein Objekt vom Typ ISessionHost zurück. Dessen Eigenschaft AllowNewSession enthält die Einstellung, und die REST-Referenz führt denselben Wert als properties.allowNewSession auf. Eine Zeile wie Get-AzWvdSessionHost -ResourceGroupName <ResourceGroupName> -HostPoolName <HostPoolName> | Select-Object Name, AllowNewSession, Session, Status listet jeden Host eines Pools mit seiner Einstellung und Sitzungsanzahl auf. Der Filter Select-Object ist ein Vorschlag dieses Artikels und kein Beispiel von Learn. Warten Sie nach einer Änderung im Portal mindestens 60 Sekunden, bevor Sie aktualisieren, denn Learn warnt, dass eine sofortige Aktualisierung einen nicht synchronisierten Status anzeigen kann.

Wie Autoscale den Drain-Modus nutzt und überschreibt

Autoscale verwendet den Drain-Modus selbst, was leicht übersehen wird. Auf gepoolten Hostpools versetzt es einen Host vor dessen Deallokation in den Drain-Modus, setzt AllowNewSessions danach wieder auf true und aktiviert oder deaktiviert den Drain-Modus auf jeder VM im Geltungsbereich, unabhängig davon, wer ihn gesetzt hat. Nur ein Host mit dem Ausschlusstag bleibt unberührt. Auf persönlichen Hostpools verwendet Autoscale den Drain-Modus nicht, und ein Benutzer, der sich während der Deallokation verbindet, erhält die Meldung „No resources available“. Der Runbook-Artikel zeigt, wie Sie einen Host vor dem Drain taggen, und der Artikel zur erzwungenen Abmeldung beschreibt die Abfolge beim Herunterskalieren.

Ein kurzes Beispiel

Stellen Sie sich einen Pooled-Host mit drei Sitzungen vor: Benutzer A ist aktiv, Benutzer B ist getrennt und Benutzer C ist aktiv. Sie aktivieren den Drainmodus. Benutzer D meldet sich zum ersten Mal an und wird auf einen anderen Host geleitet, weil der Lastenausgleich Drain-Hosts für neue Benutzer nicht berücksichtigt. Benutzer A meldet sich ab. Benutzer B stellt die Verbindung wieder her, und da B auf diesem Host eine getrennte Sitzung hat, kehrt B trotz Drainmodus dorthin zurück. Benutzer C bleibt verbunden. Der Host steht erst für Wartungsarbeiten zur Verfügung, wenn sich B und C abgemeldet haben oder ein Administrator ihre Sitzungen beendet hat. Wenn Sie nichts unternehmen, bleibt der Host in diesem Zustand, es sei denn, die Autoskalierung ändert den Drainmodus auf einem Pooled-Host, der nicht getaggt ist. Diese Schritt-für-Schritt-Anleitung wendet die dokumentierten Regeln an und ist kein Learn-Szenario.

Drainmodus im Vergleich zu verwandten Steuerelementen

KontrolleWas sich ändertBestehende Sitzungen
DrainmodusDer Host nimmt keine neuen Sitzungen von neuen Benutzern anBleiben verbunden
Niedrigere maximale SitzungsanzahlWie viele Sitzungen der Host annimmtLaut Learn wirkt sich eine Senkung auf einem Host mit aktiven Sitzungen nicht auf diese aus
AusschlusstagDie Autoskalierung startet, stoppt oder ändert den Drainmodus auf dem Host nichtNicht betroffen
Abmeldung erzwingen bei Ramp-downDie Autoskalierung beendet verbleibende Sitzungen nach der WartezeitBeendet

Nur die letzte Zeile beendet Sitzungen. Der Drainmodus braucht daher einen zweiten Schritt, nämlich Warten oder Beenden von Sitzungen, bevor ein Host wieder frei für die Arbeit ist. Die Tabelle fasst die oben genannten Aussagen von Learn zusammen.

Das Ergebnis richtig lesen

  • Sitzungen. Prüfen Sie die Sitzungsanzahl auf dem Host, bevor Sie mit der Arbeit beginnen. Bestehende Sitzungen werden durch den Drainmodus nicht beendet. Das Insights-Glossar beschreibt, dass der Eintrag „Sitzungen“ verbundene und getrennte Sitzungen anzeigt, während „Idle sessions“ nur getrennte Sitzungen anzeigt.
  • Direkter Zugriff. Dies ist eine Schlussfolgerung aus dem dokumentierten Administratorzugriff, keine Aussage von Learn: Da Administratoren die VM unabhängig vom Dienst erreichen können, belegen eigene Tests auf einem Drain-Host nicht, was Benutzer sehen werden.

Häufige Missverständnisse

  • „Ich habe den Drainmodus aktiviert, und Benutzer wurden getrennt.“ Die Seite zum Drainmodus beschreibt das nicht. Prüfen Sie auf Autoskalierung, eine Richtlinie oder einen Patchprozess, der Sitzungen beendet.
  • „Der Host ist im Drainmodus, hat aber noch Benutzer.“ Das ist erwartet: Sitzungen bleiben bestehen, und zurückkehrende Benutzer gehen zu ihrem Host zurück.
  • „Der Drainmodus ist wieder aus.“ Bei Pooled-Pools prüfen Sie zuerst den Skalierungsplan und den Ausschlusstag.
  • „Neue Benutzer können gar keine Verbindung herstellen.“ Wenn sich jeder Host eines Pools im Drainmodus befindet, kann kein Host einen neuen Benutzer aufnehmen. Die Seite zum Drainmodus dokumentiert für diesen Fall keine Fehlermeldung.

Quellen

Abgerufen am 17. November 2026.

FAQ

Meldet der Drain-Modus Benutzer ab?

Nein. Laut Microsoft Learn bleiben bestehende Verbindungen aktiv, bis sich der Benutzer abmeldet oder ein Administrator die Sitzung beendet. Der Drain-Modus wirkt sich nur darauf aus, wohin neue Sitzungen verteilt werden.

Warum hat mein Host den Drain-Modus von selbst verlassen?

Befindet sich der Host in einem gepoolten Hostpool mit einem Autoscale-Skalierungsplan, überschreibt Autoscale den Drain-Modus bei VMs, die in die Skalierung einbezogen sind, unabhängig davon, wer ihn gesetzt hat. Die FAQ empfiehlt Ausschluss-Tags, um eine VM von Skalierungsaktionen auszunehmen.

Wie lange braucht das Portal, bis die Änderung angezeigt wird?

Laut Learn kann der Status nach einer Änderung des Drain-Modus nicht synchron angezeigt werden, wenn Sie das Portal sofort aktualisieren. Learn empfiehlt, mindestens 60 Sekunden zu warten, bevor Sie aktualisieren.

Entitäten in diesem Artikel

Themen dieses Artikels:

Drain mode (Azure Virtual Desktop) – Unterbegriff von Session host (Azure Virtual Desktop) Session host (Azure Virtual Desktop) – Teil von Azure Virtual Desktop

Verwandte Artikel

Weitere Artikel zu Session host (Azure Virtual Desktop):

RSS