Wie Sie den Drainmodus für das Patchen und die Wartung von Sitzungshosts verwenden
Partner · Neutraler Partner: Nerdio
Von Mirko Peters ·
Runbook für das Herausnehmen eines einzelnen Azure Virtual Desktop-Sitzungshosts aus dem Betrieb: Schützen Sie ihn vor der Autoskalierung, aktivieren Sie den Drainmodus, warnen Sie Benutzer und beenden Sie verbleibende Sitzungen, führen Sie die Arbeiten durch und deaktivieren Sie anschließend den Drainmodus.
Automatisch mit KI aus dem Originalbeitrag übersetzt. Englisches Original lesen
Um einen Sitzungshost zu patchen, ohne Benutzer abzuschneiden, versehen Sie die VM mit einem Tag, damit die Autoskalierung sie unberührt lässt. Aktivieren Sie den Drainmodus, informieren Sie die verbleibenden Benutzer mit einer Nachricht und einer Frist, beenden Sie noch offene Sitzungen, patchen und starten Sie neu. Deaktivieren Sie anschließend den Drainmodus.
Das Wichtigste in Kürze
- Der Drainmodus verhindert neue Sitzungen auf einem Host. Bestehende Sitzungen bleiben erhalten, bis sich der Benutzer abmeldet oder ein Administrator sie beendet.
- Ein Benutzer, der bereits eine aktive oder getrennte Sitzung im Hostpool hat, wird auch im Drainmodus wieder auf diesen Host geleitet. Listen Sie die Sitzungen deshalb auf und beenden Sie sie, bevor Sie patchen.
- In gepoolten Hostpools überschreibt die Autoskalierung den Drainmodus auf jeder VM im Geltungsbereich. Legen Sie daher zuerst das Ausschluss-Tag des Skalierungsplans fest. In persönlichen Hostpools setzt die Autoskalierung den Drainmodus nicht.
- Für den Drainmodus benötigen Sie die Rolle Desktopvirtualisierung-Sitzungshostoperator. Für Nachrichten und das Abmelden von Benutzern benötigen Sie die Rolle Desktopvirtualisierung-Benutzersitzungsoperator. Prüfen Sie die effektiven Berechtigungen des Runbook-Kontos.
- Bei imagebasierten Updates von Hosts, die eine Sitzungshostkonfiguration verwenden, übernimmt das Sitzungshost-Update den Drainmodus selbst. Laut Learn sollten Sie ihn während eines Updates nicht manuell ändern.
Dieser Artikel ist das Runbook für einen einzelnen Host. Was der Drainmodus ist, behandelt „Drain mode in Azure Virtual Desktop explained“. Die Planung von Wellen über einen gesamten Hostpool hinweg, mit Wellengrößen und Kapazität, ist Thema von „Patching AVD without downtime: rolling updates with drain mode“. Die Mechanik des Ausschluss-Tags, einschließlich der Anwendung, finden Sie in „How to use the exclusion tag for maintenance windows and special session hosts“.
Was Sie vor dem Start benötigen
- Rollen. Laut Learn ist für das Ein- und Ausschalten des Drainmodus die Rolle Desktopvirtualisierung-Sitzungshostoperator erforderlich. Ihre Beschreibung auf der RBAC-Seite ergänzt, dass die Rolle Sitzungshosts anzeigen und entfernen sowie den Drainmodus ändern kann. Nachrichten senden, Sitzungen trennen und Benutzer abmelden gehört zur Rolle Desktopvirtualisierung-Benutzersitzungsoperator. Laut RBAC-Seite darf diese Rolle den Drainmodus nicht ändern. Die integrierte Definition der Rolle Sitzungshostoperator enthält
Microsoft.DesktopVirtualization/hostpools/sessionhosts/, während die Definition des Benutzersitzungsoperators.../sessionhosts/usersessions/explizit aufführt. Ob ein Konto beide Schritte ausführen kann, hängt also von den tatsächlich zugewiesenen Rollen ab. Testen Sie daher mit dem Konto, das das Runbook ausführen wird. - Azure PowerShell mit dem Modul Az.DesktopVirtualization oder Azure Cloud Shell, wenn Sie den Vorgang skripten möchten.
- Kapazität. Laut Learn gehen neue Verbindungen an den nächsten verfügbaren Sitzungshost. Prüfen Sie daher, ob die verbleibenden Hosts die Last aufnehmen können. Bei einem Depth-First-Hostpool prüfen Sie außerdem das maximale Sitzungslimit. Laut Learn müssen Sie es erhöhen oder Hosts hinzufügen, sobald alle Hosts das Limit erreicht haben.
Schritt für Schritt
- Autoscale vom Host fernhalten (Pooled-Hostpools). Die Szenarien-Seite von Learn sagt, dass Autoscale bei Pooled-Hostpools den Drain-Modus überschreibt. Laut FAQ zu Autoscale schaltet Autoscale abgeriegelte VMs weiterhin ein oder aus, unabhängig davon, wer den Drain-Modus gesetzt hat, weil er den Drain-Modus auf allen VMs überschreibt, die in die Skalierung einbezogen sind. Das Ausschlusstag ist ein Tagname, den Sie auf der Registerkarte Grundlagen des Skalierungsplans eingeben (auf der Registerkarte Eigenschaften eines vorhandenen Plans). Das Beispiel von Learn lautet
excludeFromScaling. Das Feld gibt es für Energieverwaltungspläne und für dynamische Pläne, die nur für Pooled-Hostpools mit Sitzungshostkonfiguration gelten. Mit diesem Tag auf einem Sitzungshost startet, stoppt oder ändert Autoscale den Drain-Modus dieses Hosts nicht. Fügen Sie der VM ein Tag mit diesem Namen hinzu. Berechtigungen für Tags und weitere Details finden Sie im oben genannten Artikel zum Ausschlusstag. Für persönliche Hostpools lesen Sie den Abschnitt weiter unten. - Drain-Modus aktivieren. Öffnen Sie im Azure-Portal Azure Virtual Desktop, dann Hostpools, wählen Sie den Hostpool aus, wählen Sie Sitzungshosts aus, markieren Sie den Host und wählen Sie Drain-Modus aktivieren. Mit Azure PowerShell setzt die Drain-Modus-Seite von Learn den Drain-Modus mit dem Parameter
AllowNewSessionvonUpdate-AzWvdSessionHost, und zwar einmal für jeden Sitzungshost. Die Seite verwendet eine Hashtabelle$paramsmitAllowNewSession = $Falseund übergibt sie per Splatting an das Cmdlet. Derselbe Aufruf in einem Block, in Form des Beispiels aus der Cmdlet-Referenz, lautet:
Update-AzWvdSessionHost -ResourceGroupName <ResourceGroupName> `
-HostPoolName <HostPoolName> `
-Name <SessionHostName> `
-AllowNewSession:$falseLearn warnt, dass der Portalstatus veraltet wirken kann, wenn Sie sofort aktualisieren. Warten Sie daher zuerst mindestens 60 Sekunden.
- Verbleibende Sitzungen auflisten.
Get-AzWvdUserSession -ResourceGroupName <ResourceGroupName> `
-HostPoolName <HostPoolName> -SessionHostName <SessionHostName>Das Ausgabebeispiel von Learn benennt jede Sitzung als HostPoolName/SessionHostName/2, und die Referenz zu Remove-AzWvdUserSession nimmt die Sitzungsnummer als -Id entgegen (Alias UserSessionId). Verwenden Sie daher den letzten Teil des Namens als Sitzungs-ID.
- Benutzer warnen. Die Referenz von Learn zeigt diese Form, wobei Nachrichtentitel und Nachrichtentext als Freitext eingegeben werden:
Send-AzWvdUserSessionMessage -ResourceGroupName <ResourceGroupName> `
-HostPoolName <HostPoolName> -SessionHostName <SessionHostName> `
-UserSessionId <id> -MessageTitle 'Maintenance' `
-MessageBody 'Please save your work and sign out. This host is patched at 18:30.'Legen Sie eine Frist fest, die Sie einhalten können.
- Restliche Sitzungen beenden. Entfernen Sie nach Ablauf der Frist die verbleibenden Sitzungen:
Remove-AzWvdUserSession -ResourceGroupName <ResourceGroupName> `
-HostPoolName <HostPoolName> -SessionHostName <SessionHostName> -Id <id>Die Referenzseite nennt außerdem einen Parameter -Force („Specify to force userSession deletion“), zeigt aber kein Beispiel dafür. Das Entfernen einer Sitzung beendet sie, daher gehen alle nicht gespeicherten Daten des Benutzers verloren. Deshalb kommt Schritt 4 zuerst.
- Wartung durchführen. Learn zufolge können Sie, sobald keine Sitzungen mehr vorhanden sind, die notwendige Wartung durchführen. Administratoren können sich außerdem weiterhin direkt mit dem Server verbinden, ohne den Dienst Azure Virtual Desktop zu nutzen. Das Patchen selbst, etwa über Windows Update, Intune, WSUS oder ein anderes Tool, ist nicht Gegenstand dieses Artikels. Prüfen Sie vorher jedoch, wie Learn das Patchen in-place für Ihr Betriebssystem bewertet (siehe letzter Abschnitt). Wenn der Host danach nicht wieder als verfügbar angezeigt wird, verwenden Sie die Checkliste im verwandten Artikel „Azure Virtual Desktop Session Host Shows Unavailable: A Step-by-Step Checklist“.
- Drain-Modus deaktivieren. Wählen Sie im Portal den Host aus und wählen Sie Drain-Modus deaktivieren. In PowerShell führen Sie dasselbe Cmdlet mit
-AllowNewSession:$trueaus. Die Drain-Modus-Seite von Learn zeigt beide Richtungen:$Falseaktiviert den Drain-Modus,$Truedeaktiviert ihn. Warten Sie mindestens 60 Sekunden, bevor Sie den Status im Portal prüfen. Entfernen Sie anschließend das Ausschlusstag, damit Autoscale den Host wieder verwaltet.
Verhalten, das überrascht
- Getrennte Sitzungen kehren zurück. Die Seite zum Lastausgleich von Learn besagt, dass ein Benutzer mit einer aktiven oder getrennten Sitzung, der sich erneut anmeldet, auch im Drain-Modus zu dem Host mit dieser Sitzung geleitet wird. Ein Benutzer ohne Sitzung wird nie an einen abgeriegelten Host geleitet. Deshalb ist Schritt 3 wichtig: Ein Host, der leer wirkt, kann dennoch getrennte Sitzungen enthalten.
- Ein nicht getaggter Pooled-Host bleibt im Geltungsbereich. Wenn Sie einen Host in einem Pooled-Hostpool manuell in den Drain-Modus versetzen und ihn nicht taggen, kann Autoscale laut FAQ dennoch dessen Start, Stopp oder Drain-Modus ändern. Das Tag nimmt den Host aus der Skalierung heraus, nicht der Drain-Modus.
- Nicht gespeicherte Arbeit geht verloren.
Remove-AzWvdUserSessionbeendet die Sitzung. Die Referenz auf Microsoft Learn beschreibt keine Möglichkeit, die Sitzung wiederherzustellen. Senden Sie deshalb zuerst die Nachricht aus Schritt 4. - Ein verbleibendes Tag hält den Host von der Skalierung fern. Laut Microsoft Learn zählen markierte Hosts weiterhin zur Berechnung des minimalen Prozentsatzes an Hosts, die Autoskalierung startet sie jedoch nicht. Entfernen Sie das Tag in Schritt 7. Solange es vorhanden ist, startet die Autoskalierung den Host nicht, auch wenn der Pool die Kapazität benötigt. Szenario 4 auf Microsoft Learn beschreibt, dass Benutzer die Meldung „Keine Ressourcen verfügbar“ sehen, wenn alle Hosts im Pool markiert und ausgeschaltet sind.
Ein Beispielzeitplan für einen Host
Diese Zeiten sind frei erfunden und stellen keine Empfehlung von Microsoft dar. Ein gepoolter Host, avd-host-03, wird an einem Wochentagabend gepatcht.
| Zeit | Aktion |
|---|---|
| 17:30 | Taggen Sie die VM, aktivieren Sie den Drainmodus und listen Sie die Sitzungen auf (Schritte 1 bis 3). |
| 17:35 | Senden Sie an jede verbleibende Sitzung eine Nachricht: Arbeit speichern, abmelden, der Host wird um 18:30 Uhr gepatcht (Schritt 4). |
| 18:30 | Entfernen Sie die verbleibenden Sitzungen, einschließlich getrennter Sitzungen (Schritt 5). |
| 18:35 | Installieren Sie die Updates und starten Sie neu (Schritt 6). |
| 19:15 | Bestätigen Sie, dass der Host als verfügbar gemeldet wird, deaktivieren Sie den Drainmodus und entfernen Sie das Tag (Schritt 7). |
Prüfen Sie vorab, ob die übrigen Hosts die abendliche Last tragen können. Der verwandte Artikel zu rollierenden Updates erklärt, wie viele Hosts Sie gleichzeitig herausnehmen sollten.
Persönliche Hostpools
Die Häufigen Fragen auf Microsoft Learn besagen, dass die Autoskalierung einen persönlichen Desktop nicht in den Drainmodus versetzt, bevor sie ihn deallokiert, und dass ein Benutzer, der sich während der Deallokierung verbindet, die Meldung „Keine Ressourcen verfügbar“ sieht. Außerdem heißt es dort: Wird ein Sitzungshost durch die Autoskalierung, Start VM on Connect oder einen Administrator eingeschaltet und meldet sich niemand an, deallokiert die Autoskalierung ihn nach einer nicht näher definierten Inaktivitätsdauer. Das betrifft Sie, wenn der Pool einen Skalierungsplan hat: Ein persönlicher Host, den Sie zum Patchen starten und an dem sich kein Benutzer anmeldet, kann unter Umständen deallokiert werden. Microsoft Learn beschreibt das Ausschlusstag für Energieverwaltungspläne, ohne es auf gepoolte Hostpools zu beschränken, erläutert aber nicht, welche Wirkung es bei persönlichen Hostpools hat. Das Taggen des persönlichen Hosts, bevor Sie die VM starten, ist daher eine Vorsichtsmaßnahme, die dieser Artikel empfiehlt, keine dokumentierte Garantie. Prüfen Sie das auf einem Testhost. Informieren Sie außerdem den zugewiesenen Benutzer, da ein persönlicher Sitzungshost genau einem Benutzer zugewiesen ist.
Wann der Drainmodus das falsche Werkzeug ist
Die Microsoft-Learn-Seite zu Aktualisierungsmethoden für Sitzungshosts bewertet das Patchen auf dem bestehenden System nach Betriebssystem. Für Windows-Client-Hosts mit mehreren Sitzungen markiert sie Windows Update bei monatlichen und Feature-Updates als „Nicht empfohlen“ und WSUS bei Feature-Updates ebenfalls als „Nicht empfohlen“. Aktualisierungen von Sitzungshosts und die Azure Compute Gallery markiert sie als „Empfohlen“. Für Windows Server markiert sie Windows Update als „Unterstützt“, Azure Update Manager und automatisches Gast-Patching als „Empfohlen“. Für Windows-Client Enterprise (Einzelsitzung) markiert sie Windows Update als „Empfohlen“, Hostpools dieses Typs mit gepoolten Hosts jedoch als „Nicht empfohlen“. Der Absatz zum Patchen auf dem bestehenden System auf derselben Seite nennt Windows Update unter gängigen Technologien. Lesen Sie daher die Tabellen je System und nicht nur diesen Satz. Unsere Einschätzung: Dieses Runbook passt zu Windows-Server-Hosts, persönlichen Hosts und Wartungsarbeiten, die kein Patchen sind, etwa Konfigurationsänderungen, Neustarts, Fehlerbehebung oder das Außerbetriebnehmen eines Hosts. Für gepoolte Windows-Client-Hostpools mit mehreren Sitzungen empfiehlt Microsoft Learn image-basierte Wartung (Image-based Servicing).
Wenn Sie aktualisieren, indem Sie das Image ersetzen, statt es direkt zu patchen, übernimmt die Funktion zum Aktualisieren von Session Hosts in Learn's Session-Host-Konfiguration die Arbeit für Hosts, die eine Session-Host-Konfiguration verwenden. Laut Learn versetzt die Funktion die ausgewählten Hosts selbst in den Drain-Modus. Während eines Updates dürfen Sie den Drain-Modus nicht manuell ändern. Die Seite empfiehlt außerdem, Autoscale für den Hostpool vor dem Update zu deaktivieren, da ein aktiver Skalierungsplan dazu führen kann, dass das Update mit einem Laufzeitfehler fehlschlägt. Manuelle Anpassungen wie Dateien, Registrierungsschlüssel und Zertifikate sind nach dem Update nicht mehr vorhanden. Microsoft hat im Juli 2026 die allgemeine Verfügbarkeit (GA) des erweiterten Hostpool-Managements angekündigt, zu dem auch die Konfiguration und Aktualisierung von Session Hosts gehört (Tech Community). Einige Learn-Seiten enthalten noch Preview-Formulierungen. So markiert die Konfigurationsseite beispielsweise die Azure-PowerShell-Cmdlets für solche Hostpools als Preview und verlangt die Preview-Version des Az.DesktopVirtualization-Moduls. Prüfen Sie die aktuelle Seite, bevor Sie sich auf ein Limit verlassen. Vergleichen Sie diesen Ansatz mit dem rollierenden Drain-Verfahren in „Patching AVD without downtime: rolling updates with drain mode“.
Quellen
Abgerufen am 17. November 2026.
- Microsoft Learn: Session Hosts für Wartungsarbeiten in Azure Virtual Desktop in den Drain-Modus versetzen
- Microsoft Learn: Azure-RBAC-Rollen für Azure Virtual Desktop (rbac-Seite)
- Microsoft Learn: Update-AzWvdSessionHost
- Microsoft Learn: Get-AzWvdUserSession
- Microsoft Learn: Send-AzWvdUserSessionMessage
- Microsoft Learn: Remove-AzWvdUserSession
- Microsoft Learn: Lastenausgleich für Hostpools konfigurieren
- Microsoft Learn: Azure Virtual Desktop autoscale FAQ
- Microsoft Learn: Erstellen und Zuweisen eines Autoscale-Skalierungsplans
- Microsoft Learn: Autoscale-Skalierungspläne und Beispielszenarien
- Microsoft Learn: Methoden der Windows-Update-Verwaltung für Session Hosts
- Microsoft Learn: Session-Host-Update
- Microsoft Learn: Session Hosts mit einer Session-Host-Konfiguration aktualisieren
- Microsoft Tech Community: Erweiterte Hostpool-Verwaltung für Azure Virtual Desktop ist jetzt allgemein verfügbar
FAQ
Was passiert mit Benutzern, die verbunden sind, wenn ich den Drainmodus aktiviere?
Für sie ändert sich zunächst nichts. Laut Microsoft Learn bleiben bestehende Verbindungen aktiv, bis sich der Benutzer abmeldet oder ein Administrator die Sitzung beendet. Der Drainmodus verhindert nur neue Sitzungen. Sie müssen die Benutzer selbst benachrichtigen und die Sitzungen beenden, zum Beispiel mit Send-AzWvdUserSessionMessage und Remove-AzWvdUserSession.
Warum wird ein Benutzer immer noch auf dem Host verbunden, den ich in den Drainmodus versetzt habe?
Die Learn-Seite zum Lastausgleich besagt, dass ein Benutzer, der bereits eine aktive oder getrennte Sitzung im Hostpool hat, auf den Host umgeleitet wird, der diese Sitzung hält, auch wenn der Drainmodus aktiviert ist. Benutzer ohne Sitzung werden nicht an einen Host im Drainmodus geleitet. Prüfen Sie getrennte Sitzungen mit Get-AzWvdUserSession.
Schaltet die Autoskalierung meinen Host während der Wartung wieder ein?
In einem gepoolten Hostpool kann das passieren. Die FAQ zur Autoskalierung in Learn besagt, dass die Autoskalierung den Drainmodus auf allen einbezogenen VMs überschreibt. Um eine VM von Skalierungsaktionen auszuschließen, verwenden Sie das Ausschluss-Tag, das im Skalierungsplan festgelegt wird. Laut Learn startet, stoppt und ändert die Autoskalierung den Drainmodus getaggter Hosts dann nicht. Für persönliche Hostpools besagt die FAQ, dass die Autoskalierung den Sitzungshost nicht in den Drainmodus versetzt. Sie kann einen Host, an dem sich niemand anmeldet, trotzdem deallokieren.