Den Ausschlusstag für Wartungsfenster und besondere Sitzungshosts nutzen
Partner · Neutraler Partner: Nerdio
Von Mirko Peters ·
Um einen Azure Virtual Desktop-Sitzungshost zu patchen, ohne dass die Autoskalierung dazwischenfunkt, setzen Sie den Ausschlusstag des Skalierungsplans, aktivieren den Drainmodus, warten, bis die Sitzungen beendet sind, führen die Arbeiten durch und machen beide Schritte wieder rückgängig.
Automatisch mit KI aus dem Originalbeitrag übersetzt. Englisches Original lesen
Um einen gepoolten Azure Virtual Desktop-Sitzungshost außer Betrieb zu nehmen, ohne dass die Autoskalierung dazwischenfunkt, versehen Sie die VM zuerst mit dem Ausschlusstag des Skalierungsplans. Aktivieren Sie danach den Drainmodus, warten Sie, bis die Sitzungen beendet sind, führen Sie die Wartung durch und machen Sie beide Schritte wieder rückgängig. Die Reihenfolge ist wichtig, weil die Autoskalierung den Drainmodus auf jeder VM überschreibt, die sie verwaltet. Was der Tag ist und wo Learn Fragen offen lässt, erklärt „Exclusion tags in AVD autoscale: keeping individual VMs out of scaling“. Die Drainmodus-Seite eines Einzelhost-Patches, einschließlich Benachrichtigung und Beenden von Sitzungen, behandelt das Runbook „How to use drain mode for patching and maintenance of session hosts“. Dieser Artikel behandelt die Mechanik des Tags und die Prüfungen drumherum.
Das Wichtigste in Kürze
- Versehen Sie die VM mit dem Tag, bevor Sie den Drainmodus aktivieren. Die Autoskalierung überschreibt den Drainmodus auf jeder VM, die sie skaliert. Der Drainmodus allein schützt einen Host in einem gepoolten Hostpool also nicht.
- Setzen Sie den Tag im Portal oder mit Update-AzTag -Operation Merge und entfernen Sie ihn danach mit Delete. Die Rolle Tag Contributor kann Tags nur über PowerShell oder REST setzen, nicht im Portal.
- Prüfen Sie zuerst die Kapazität der nicht markierten Hosts. Markierte Hosts zählen weiterhin zum Mindestprozentsatz der Hosts, die Autoskalierung kann sie aber nicht starten. Der Pool kann daher sein Minimum verfehlen.
- Der Tag gilt in allen Phasen des Zeitplans, und Learn beschreibt dafür keine Zeitbegrenzung. Ihn nach den Arbeiten wieder zu entfernen, ist daher Ihre Aufgabe.
- Learn dokumentiert den Tag für Wartungsarbeiten. Die Nutzung für Test- oder Dauerbetrieb-Hosts ergibt sich aus seiner Definition, wird aber nicht als Anwendungsfall beschrieben.
Bevor Sie beginnen
Drei Voraussetzungen müssen erfüllt sein.
- Ein Name für den Ausschlusstag am Skalierungsplan. Öffnen Sie im Azure-Portal Azure Virtual Desktop, wählen Sie Skalierungspläne, öffnen Sie den Plan und prüfen Sie die Registerkarte Eigenschaften. Ist das Feld leer, tragen Sie dort einen Namen ein. Das Beispiel von Learn lautet
excludeFromScaling. Änderungen an einem zugewiesenen Plan wirken sofort. - Berechtigungen. Learn nennt für den Drainmodus die Rolle Desktop Virtualization Session Host Operator. Für Tags empfiehlt Learn, die Rolle Tag Contributor einem Benutzer zuzuweisen, dem die Berechtigung zum Hinzufügen fehlt. Die Tagging-Seite nennt jedoch eine Einschränkung: Diese Rolle kann im Azure-Portal keine Tags auf Ressourcen anwenden, unterstützt aber alle Tag-Vorgänge über Azure PowerShell und die REST-API. Mit nur dieser Rolle verwenden Sie die PowerShell-Befehle aus Schritt 1. Eine VM ein- oder auszuschalten ist eine separate Azure-Berechtigung, die diese Seiten nicht behandeln.
- Freie Kapazität. Berechnen Sie diese vor dem Taggen. Das Beispiel unten zeigt, wie.
Kapazität zuerst prüfen
Learn besagt, dass markierte Hosts weiterhin in die Berechnung des Mindestprozentsatzes der Hosts einfließen, die Autoskalierung sie aber nicht einschalten kann. Im Sechs-Host-Szenario von Learn heißt es, dass ein Pool, der VMs nicht wieder einschalten kann, seinen Mindestprozentsatz nicht erreicht. Markieren Sie zu viele Hosts, kann die Autoskalierung keine Kapazität mehr hinzufügen. Die Folgen, einschließlich des Sechs-Host-Szenarios von Learn, erläutert der Konzeptartikel. Hier folgt die Prüfung, die Sie vor einem Wartungsfenster durchführen.
Ein durchgerechnetes Beispiel mit erfundenen Zahlen: Ein Pool mit acht Hosts hat eine maximale Sitzungsgrenze von 10 und einen Kapazitätsschwellenwert von 75 %, und die Spitzenlast liegt bei 50 Sitzungen. Learn definiert die verfügbare Hostpool-Kapazität als maximale Sitzungsgrenze multipliziert mit der Anzahl der verfügbaren Sitzungshosts. Laut Learn schaltet Autoscale zusätzliche Sitzungshosts ein oder erstellt sie, wenn die genutzte Kapazität den Kapazitätsschwellenwert überschreitet.
Das Glossar von Learn definiert einen verfügbaren Sitzungshost als einen Host, der die Integritätsprüfungen des Agents bestanden hat und eingeschaltet ist. Der Drainmodus wird dort nicht erwähnt. Das Insights-Schema beschreibt ActiveSessionHostCount als die Anzahl der Sitzungshosts, die Benutzerverbindungen annehmen. Ein Host im Drainmodus würde demnach nicht mitgezählt. Learn sagt nicht, welche Definition Autoscale für die Kapazitätsberechnung verwendet. Die folgende Rechnung ist das eigene vorsichtige Modell des Artikels und kein dokumentiertes Verhalten: Hosts in der Wartung zählen als null Kapazität. Unter dieser Annahme gilt: Nehmen Sie zwei Hosts zum Patchen heraus und laufen alle sechs verbleibenden Hosts, tragen sie 6 x 10 x 0,75 = 45 Sitzungen, bevor der Schwellenwert überschritten wird und Autoscale einen weiteren Host bräuchte. Bei 50 Sitzungen bräuchte Autoscale einen weiteren Host, könnte aber keinen getaggten Host starten. Mit einem Host außer Betrieb ergibt sich 7 x 10 x 0,75 = 52,5 Sitzungen, was die Spitzenlast von 50 abdeckt. Patchen Sie in diesem Pool also während der Spitzenzeit jeweils nur einen Host oder beide außerhalb der Spitzenzeit.
Dieselbe Prüfung gilt für den Mindestprozentsatz an Hosts. Bei acht Hosts und einem Minimum von 25 % hält Autoscale zwei Hosts in Betrieb, und Learn rundet Bruchteile auf. Stellen Sie sicher, dass genügend nicht getaggte Hosts übrig bleiben, damit Autoscale starten kann. Learn sagt nicht, ob ein laufender getaggter Host zu den Hosts zählt, die das Minimum erfüllen. Planen Sie also nicht damit.
Runbook für die Wartung
- Taggen Sie die VM. Öffnen Sie im Azure-Portal die VM, wählen Sie Tags hinzufügen aus (hat die VM bereits Tags, verweist der Bearbeitungsabschnitt von Learn auf Ändern), geben Sie den Tag-Namen des Plans und einen Wert ein und wählen Sie Speichern. Die Autoscale-Seiten definieren die Übereinstimmung über den Tag-Namen und sagen nicht, ob der Wert verglichen wird. Bei mehreren VMs wählen Sie sie in einer Ressourcenliste aus und verwenden Tags zuweisen. Tags werden nicht von der Ressourcengruppe übernommen, daher braucht jede VM ihre eigenen. Learn sagt nicht, wie schnell Autoscale ein neu hinzugefügtes Tag bemerkt. Gehen Sie also nicht davon aus, dass der Schutz im Moment des Speicherns aktiv ist. Nutzen Sie die Prüfung in Schritt 7 als Plausibilitätskontrolle, bevor Sie sich darauf verlassen. In PowerShell führen Sie das Tag mit den vorhandenen Tags zusammen:
$vm = Get-AzResource -Name "avd-host-03" -ResourceGroup "rg-avd"
Update-AzTag -ResourceId $vm.Id -Tag @{ "excludeFromScaling" = "maintenance" } -Operation MergeLearn weist darauf hin, dass Update-AzTag das Modul Az.Resources in Version 1.12.0 oder höher benötigt. Die Namen avd-host-03 und rg-avd sind Beispiele. Get-AzResource kann mehrere Ressourcen mit demselben Namen zurückgeben. Prüfen Sie das Ergebnis deshalb.
- Drainmodus aktivieren. Wählen Sie im Portal Azure Virtual Desktop, dann Hostpools, den Hostpool und anschließend Sitzungshosts. Markieren Sie den Host und wählen Sie Drainmodus aktivieren. In PowerShell erledigt
Update-AzWvdSessionHostaus dem ModulAz.DesktopVirtualizationdasselbe:
Update-AzWvdSessionHost -ResourceGroupName "rg-avd" -HostPoolName "hp-pooled-01" `
-Name "avd-host-03.contoso.com" -AllowNewSession:$falseDie Namen im Beispiel sind Platzhalter. Verwenden Sie den Namen Ihres eigenen Sitzungshosts. Wenn Sie das Portal direkt nach der Änderung des Drainmodus aktualisieren, kann der Status veraltet wirken. Learn empfiehlt, mindestens 60 Sekunden zu warten.
- Lassen Sie den Host sich leeren. Laut Learn nimmt ein Host im Drainmodus keine neuen Benutzersitzungen an. Neue Verbindungen gehen an den nächsten verfügbaren Host, während bestehende Verbindungen aktiv bleiben, bis sich der Benutzer abmeldet oder ein Administrator die Sitzung beendet. Hat ein Benutzer bereits eine aktive oder getrennte Sitzung im Pool und meldet sich erneut an, leitet der Lastenausgleich ihn auf den Host mit dieser Sitzung um, auch wenn der Drainmodus aktiv ist. Getrennte Sitzungen können einen Host daher weiterhin belegen. Die Befehle zum Auflisten der Sitzungen, zum Senden einer Warnung und zum Beenden verbleibender Sitzungen finden Sie im oben verlinkten Runbook zum Drainmodus.
- Führen Sie die Wartung durch. Learn weist darauf hin, dass Administratoren weiterhin direkt auf den Server zugreifen können, ohne den Azure Virtual Desktop-Dienst zu nutzen. Starten Sie die VM selbst, falls sie ausgeschaltet ist. Autoscale tut das bei einem getaggten Host nicht.
- Drainmodus ausschalten. Wählen Sie den Host aus und klicken Sie auf Drainmodus ausschalten, oder führen Sie dasselbe Cmdlet mit
-AllowNewSession:$trueaus. Die Learn-Seite zum Drainmodus zeigt beide Richtungen mit demselben Cmdlet:AllowNewSession = $Falseschaltet den Drainmodus ein,$Trueschaltet ihn aus.
- Tag entfernen. Löschen Sie das Tag im Portal oder verwenden Sie den Delete-Vorgang mit demselben Namen-Wert-Paar, das Sie hinzugefügt haben:
Update-AzTag -ResourceId $vm.Id -Tag @{ "excludeFromScaling" = "maintenance" } -Operation DeleteNachdem das Tag entfernt wurde, kann Autoscale den Host wieder steuern. Learn gibt nicht an, wie schnell die Änderung erkannt wird. Wenn die Phase eine Konsolidierung erfordert, kann Autoscale den Host in den Drainmodus versetzen und wieder ausschalten. Entfernen Sie das Tag deshalb nicht von einem Host, der weiterlaufen soll, bevor Sie dafür bereit sind.
- Überprüfen. Die Learn-Seite zu Insights für Autoscale (nur gepoolte Hostpools) beschreibt die Log-Analytics-Tabelle
WVDAutoscaleEvaluationPooled. Deren SpalteExcludedSessionHostCountwird als Anzahl der Sitzungshosts beschrieben, die von der Autoscale-Verwaltung ausgeschlossen sind. Voraussetzung laut Learn ist eine Diagnoseeinstellung für den gepoolten Hostpool, die Autoscale logs for pooled host pools enthält und an einen Log-Analytics-Arbeitsbereich sendet. Fragen Sie diesen Arbeitsbereich ab, zum Beispiel mitWVDAutoscaleEvaluationPooled | take 10. Learn verknüpft die Spalte nicht mit dem Ausschluss-Tag. Eine übereinstimmende Anzahl ist daher eine Plausibilitätsprüfung und kein Beweis.
Planung rund um den Zeitplan
Das Tag gilt in allen Phasen des Zeitplans: Hochlauf, Spitzenlast, Herunterfahren und außerhalb der Spitzenzeit. Ein Host, den Sie am Nachmittag taggen, bleibt also auch während des abendlichen Herunterfahrens und der nächtlichen Phase außerhalb der Spitzenzeit unberührt. Ein Host, dessen Tag Sie vergessen zu entfernen, bleibt in jeder Phase außen vor. Learn beschreibt keine zeitliche Begrenzung für das Tag. Planen Sie das Zeitfenster deshalb als zwei Aktionen: Tag und Drainmodus vor dem Start setzen, beides nach dem Ende rückgängig machen. Führen Sie die oben beschriebene Kapazitätsprüfung mit den Einstellungen der Phase durch, in die Ihr Zeitfenster fällt. Das Glossar von Learn definiert den Mindestprozentsatz an Hosts für jede Phase des Zeitplans.
Besondere Sitzungshosts
Learn nennt einen Zweck für das Tag: Autoscale soll den Drainmodus während der Wartung nicht überschreiben. Weitere Einsatzzwecke ergeben sich aus der Definition, sind aber Schlussfolgerungen und entsprechend zu behandeln.
- Ein Host, den Sie testen. Ein neues Image oder eine geänderte Konfiguration auf einem Host können Sie während des Tests vor Energieänderungen schützen. Versetzen Sie ihn ebenfalls in den Drainmodus, sonst könnten normale Benutzer darauf landen.
- Ein Host, der eingeschaltet bleiben muss. Autoscale schaltet einen getaggten Host nicht aus, ein laufender Host bleibt also in Betrieb. Learn gibt nicht an, ob dieser Host den Mindestprozentsatz an Hosts erfüllt.
- Ein Host, der ausgeschaltet bleiben muss. Autoscale startet ihn nicht. Learn beschreibt nicht, was Start VM on Connect mit einem getaggten, ausgeschalteten Host macht. Testen Sie das, bevor Sie sich darauf verlassen.
Bei einem persönlichen Hostpool schützt das Tag höchstwahrscheinlich den Energiezustand, da Autoscale persönliche Desktops nicht in den Drainmodus versetzt. Das ist eine Schlussfolgerung aus den häufigen Fragen. Der Konzeptartikel behandelt dies und den Fall „No resources available“.
Zu vermeidende Fehler
- Tagging der Ressourcengruppe. Tags werden nicht vererbt, die VMs bleiben daher ungeschützt.
- Erst Drainmodus, dann Tag. In einem gepoolten Hostpool kann Autoscale den von Ihnen gesetzten Drainmodus überschreiben, unabhängig davon, wer ihn gesetzt hat.
- Das Tag danach vergessen. Ein Host, der getaggt bleibt, wird nie skaliert. Er bleibt entweder eingeschaltet und verursacht Kosten oder bleibt ausgeschaltet und reduziert die Kapazität. Ein getaggter, ausgeschalteter Host hilft dem Pool nicht, den Mindestprozentsatz einzuhalten, weil Autoscale ihn nicht starten kann.
- Personenbezogene Daten im Tag speichern. Learn empfiehlt, Benutzerprinzipalnamen und ähnliche Daten nicht in Ausschluss-Tags aufzunehmen.
- Annahme, dynamisches Autoscaling verhalte sich gleich. Microsoft hat im Juli 2026 die allgemeine Verfügbarkeit der erweiterten Hostpool-Verwaltung angekündigt, einschließlich dynamischem Autoscaling, Konfiguration und Aktualisierung von Sitzungshosts sowie kurzlebigen Betriebssystemdatenträgern (Tech Community). Einige Learn-Seiten, etwa die Szenario- und Glossarseiten sowie das Modul in Version 5.4.2-preview, enthalten noch Vorschau-Formulierungen. Prüfen Sie die aktuelle Seite, bevor Sie sich auf eine Grenze verlassen. Learn sagt nicht, ob dynamisches Autoscaling, das Sitzungshosts löschen kann, getaggte Hosts anders behandelt.
Verwandte Themen
Quellen
- Microsoft Learn: Erstellen und Zuweisen eines Autoscale-Skalierungsplans
- Microsoft Learn: Autoscale-Szenarien für Azure Virtual Desktop
- Microsoft Learn: Autoscale – häufige Fragen
- Microsoft Learn: Autoscale glossary
- Microsoft Learn: Session Hosts für Wartungsarbeiten in Azure Virtual Desktop in den Drain-Modus versetzen
- Microsoft Learn: Update-AzWvdSessionHost
- Microsoft Learn: Lastverteilung für Hostpools in Azure Virtual Desktop konfigurieren
- Microsoft Learn: Verwenden von Tags zum Organisieren Ihrer Azure-Ressourcen
- Microsoft Learn: Verwalten von Tags über das Azure-Portal
- Microsoft Learn: Verwalten von Tags mit Azure PowerShell
- Microsoft Learn: Autoscale-Vorgänge mit Insights überwachen
- Microsoft Tech Community: Erweiterte Hostpool-Verwaltung für Azure Virtual Desktop ist jetzt allgemein verfügbar
FAQ
Brauche ich den Drainmodus, wenn die VM den Ausschlusstag trägt?
Für Wartungsarbeiten ja. Der Tag verhindert nur, dass die Autoskalierung den Host verändert. Neue Sitzungen stoppt er nicht. Deshalb aktivieren Sie zusätzlich den Drainmodus, damit neue Verbindungen auf andere Sitzungshosts gehen und sich der Host leeren kann.
Was passiert, wenn ich den Drainmodus ohne Tag aktiviere?
In einem gepoolten Hostpool überschreibt die Autoskalierung laut Microsoft Learn den Drainmodus auf allen VMs, die in die Skalierung einbezogen sind, unabhängig davon, wer ihn gesetzt hat. Die Autoskalierung kann Ihren Drainmodus daher ändern oder den Host während Ihrer Arbeiten ein- bzw. ausschalten.
Welche Rollen benötige ich?
Learn nennt für den Drainmodus die Rolle Desktop Virtualization Session Host Operator. Für Tags nennt Learn die Rolle Tag Contributor. Sie unterstützt Tag-Vorgänge über Azure PowerShell und REST, nicht aber für Ressourcen im Azure-Portal. Eine VM ein- oder auszuschalten ist eine separate Azure-Berechtigung, die diese Seiten nicht behandeln.