M365Con 2027 – gratis online conferentie · 11–22 Jan 2027 · 120 sessions m365con.net

Blog · Mirko Peters

Hoe je de uitsluitingstag gebruikt voor onderhoudsvensters en speciale sessiehosts

Partner · Neutrale partner: Nerdio

By ·

Om een Azure Virtual Desktop-sessiehost te patchen zonder dat autoscale ertussen komt, stel je de uitsluitingstag van het schaalplan in, zet je de drain-modus aan, wacht je tot de sessies zijn beëindigd, voer je het werk uit en maak je beide stappen weer ongedaan.

Automatically translated with AI from the original post. Read the English original

Om een gepoolde Azure Virtual Desktop-sessiehost buiten dienst te stellen zonder dat autoscale ertussen komt, tag je eerst de vm met de uitsluitingstag van het schaalplan, zet je daarna de drain-modus aan, wacht je tot de sessies zijn beëindigd, voer je het onderhoud uit en maak je beide stappen weer ongedaan. De volgorde is belangrijk, want autoscale overschrijft de drain-modus op elke vm die het beheert. Wat de tag is en welke vragen Learn open laat, staat in "Exclusion tags in AVD autoscale: keeping individual VMs out of scaling". De drain-modus-kant van het patchen van één host, inclusief hoe je sessies aankondigt en beëindigt, staat in het runbook "How to use drain mode for patching and maintenance of session hosts". Dit artikel gaat over de werking van de tag en de controles eromheen.

Belangrijkste punten

  • Tag de vm voordat je de drain-modus aanzet. Autoscale overschrijft de drain-modus op elke vm die het schaalt, dus de drain-modus alleen beschermt een host in een gepoolde hostpool niet.
  • Tag in de portal of met Update-AzTag -Operation Merge, en verwijder de tag daarna met Delete. De rol Tag Contributor kan alleen via PowerShell of REST taggen, niet via de portal.
  • Controleer eerst de capaciteit van de hosts zonder tag. Getagde hosts tellen nog mee voor het minimumpercentage hosts, maar autoscale kan ze niet starten, dus de pool haalt mogelijk zijn minimum niet.
  • De tag geldt in alle fasen van het schema en Learn beschrijft geen tijdslimiet ervoor. Het verwijderen na het werk is dus jouw stap.
  • Learn documenteert de tag voor onderhoud. Gebruik voor test- of altijd-aan-hosts volgt uit de definitie, maar wordt niet als gebruikssituatie beschreven.

Voordat je begint

Je hebt drie zaken nodig.

  • Een naam voor de uitsluitingstag op het schaalplan. Open in de Azure-portal Azure Virtual Desktop, selecteer Schaalplannen, open het plan en controleer het tabblad Eigenschappen. Als het veld leeg is, vul je daar een naam in. Het voorbeeld van Learn is excludeFromScaling. Wijzigingen aan een toegewezen plan worden direct doorgevoerd.
  • Machtigingen. Learn noemt de rol Desktop Virtualization Session Host Operator voor de drain-modus. Voor tags zegt Learn dat je de rol Tag Contributor toewijst aan een gebruiker die geen recht heeft om tags toe te voegen. De pagina over tagging voegt een beperking toe: die rol kan geen tags toepassen op resources via de Azure-portal, maar ondersteunt wel alle tagbewerkingen via Azure PowerShell en de REST API. Met alleen die rol gebruik je de PowerShell-commando's uit stap 1. Een vm aan- of uitzetten is een aparte Azure-machtiging die deze pagina's niet behandelen.
  • Reservecapaciteit. Reken dit uit vóór het taggen; het voorbeeld hieronder laat zien hoe.

Controleer eerst de capaciteit

Learn zegt dat getagde hosts nog steeds meetellen voor de berekening van het minimumpercentage hosts, maar dat autoscale ze niet kan aanzetten. Het scenario met zes hosts van Learn stelt dat als vm's niet weer aangezet kunnen worden, de pool het minimumpercentage niet haalt. Als je te veel taggt, kan autoscale geen capaciteit meer toevoegen. De gevolgen, inclusief het scenario met zes hosts van Learn, worden in het conceptartikel uitgelegd; hier is de controle die je vóór een venster uitvoert.

Een uitgewerkt voorbeeld met verzonnen getallen: een pool van acht hosts heeft een maximale sessielimiet van 10 en een capaciteitsdrempel van 75 procent, en de piekbelasting is 50 sessies. Learn definieert de beschikbare capaciteit van de hostpool als de maximale sessielimiet maal het aantal beschikbare sessiehosts, en zegt dat autoscale meer sessiehosts inschakelt of aanmaakt zodra de gebruikte capaciteit boven de capaciteitsdrempel uitkomt. De woordenlijst van Learn definieert een beschikbare sessiehost als een host die de agent-healthchecks heeft doorstaan en is ingeschakeld, en vermeldt drain mode niet. Het Insights-schema beschrijft ActiveSessionHostCount als het aantal sessiehosts dat gebruikersverbindingen accepteert, wat een host in drain mode zou uitsluiten. Learn vermeldt niet welke definitie autoscale gebruikt voor de capaciteitsberekening. De berekening hieronder is het voorzichtige model van het artikel zelf, geen gedocumenteerd gedrag: het telt hosts in onderhoud als nul capaciteit. Met die aanname geldt: als je twee hosts uit de pool haalt voor patching en de overige zes hosts draaien allemaal, dan dragen ze 6 x 10 x 0,75 = 45 sessies voordat de drempel wordt overschreden en autoscale een extra host nodig heeft. Bij 50 sessies is er een extra host nodig, maar die kan niet worden gestart als gemarkeerde host. Met één host uit de pool is het 7 x 10 x 0,75 = 52,5 sessies, wat de piek van 50 dekt. Patch in deze pool dus één host tegelijk tijdens de piek, of beide buiten de piek.

Dezelfde controle geldt voor het minimumpercentage hosts. Bij acht hosts en een minimum van 25 procent houdt autoscale er twee draaiend, en Learn rondt breuken naar boven af. Zorg dat er genoeg niet-gemarkeerde hosts overblijven zodat autoscale een host kan starten. Learn vermeldt niet of een draaiende gemarkeerde host meetelt voor het minimum, dus reken daar niet op.

Runbook onderhoud

  1. Markeer de VM. Open in de Azure-portal de VM, selecteer Tags toevoegen (als de VM al tags heeft, zegt de bewerksectie van Learn dat je wijzigen moet selecteren), voer de tagnaam van het plan en een waarde in, en selecteer Opslaan. De autoscale-pagina's definiëren de overeenkomst op basis van de tagnaam en vermelden niet of de waarde wordt vergeleken. Voor meerdere VM's selecteer je ze in een resourcelijst en gebruik je Tags toewijzen. Tags worden niet overgenomen van de resourcegroep, dus elke VM heeft zijn eigen tag nodig. Learn vermeldt niet hoe snel autoscale een nieuw toegevoegde tag opmerkt, dus ga er niet van uit dat de bescherming actief is op het moment dat je opslaat; gebruik de controle in stap 7 als plausibiliteitscheck voordat je erop vertrouwt. In PowerShell voeg je de tag samen met de bestaande tags:
$vm = Get-AzResource -Name "avd-host-03" -ResourceGroup "rg-avd"
Update-AzTag -ResourceId $vm.Id -Tag @{ "excludeFromScaling" = "maintenance" } -Operation Merge

Learn vermeldt dat Update-AzTag de module Az.Resources versie 1.12.0 of later nodig heeft. De namen avd-host-03 en rg-avd zijn voorbeelden; Get-AzResource kan meerdere resources met dezelfde naam teruggeven, dus controleer het resultaat.

  1. Schakel drain mode in. Selecteer in de portal Azure Virtual Desktop, vervolgens Hostpools, de hostpool en daarna Sessiehosts. Vink de host aan en selecteer Drain mode inschakelen. In PowerShell doet Update-AzWvdSessionHost uit de module Az.DesktopVirtualization hetzelfde:
Update-AzWvdSessionHost -ResourceGroupName "rg-avd" -HostPoolName "hp-pooled-01" `
    -Name "avd-host-03.contoso.com" -AllowNewSession:$false

De namen in het voorbeeld zijn tijdelijke aanduidingen; gebruik de naam van je eigen sessiehost. Als je de portal direct na het wijzigen van drain mode ververst, kan de status er niet actueel uitzien. Learn adviseert minimaal 60 seconden te wachten.

  1. Laat de host leeglopen. Learn zegt dat een host in drain mode geen nieuwe gebruikerssessies meer accepteert en nieuwe verbindingen naar de volgende beschikbare host gaan, terwijl bestaande verbindingen actief blijven totdat de gebruiker afmeldt of een beheerder de sessie beëindigt. Als een gebruiker al een actieve of losgekoppelde sessie in de pool heeft en opnieuw inlogt, stuurt de load balancer die gebruiker naar de host met die sessie, ook als drain mode aan staat. Losgekoppelde sessies kunnen een host dus bezet houden. De commando's om sessies weer te geven, een waarschuwing te sturen en de resterende sessies te beëindigen staan in het runbook voor drain mode dat hierboven is gekoppeld.
  1. Voer het onderhoud uit. Learn vermeldt dat beheerders nog steeds rechtstreeks verbinding kunnen maken met de server, zonder via de Azure Virtual Desktop-service te gaan. Start de VM zelf als hij uit staat; autoscale doet dat niet voor een gemarkeerde host.
  1. Zet drain mode uit. Selecteer de host en kies Turn drain mode off, of voer dezelfde cmdlet uit met -AllowNewSession:$true. De drain-modepagina van Learn toont beide richtingen met dezelfde cmdlet: AllowNewSession = $False zet drain mode aan en $True zet het weer uit.
  1. Verwijder de tag. Verwijder de tag in de portal, of gebruik de Delete-bewerking met dezelfde naam- en waardecombinatie die je hebt toegevoegd:
Update-AzTag -ResourceId $vm.Id -Tag @{ "excludeFromScaling" = "maintenance" } -Operation Delete

Nadat de tag is verwijderd, kan autoscale de host weer aansturen; Learn zegt niet hoe snel het die wijziging opmerkt. Als de fase om consolidatie vraagt, kan autoscale de host in drain mode zetten en weer uitschakelen. Verwijder de tag daarom niet van een host die je aan het draaien wilt houden, totdat je daar klaar voor bent.

  1. Controleer het resultaat. De pagina Insights voor autoscale (alleen voor gepoolde hostpools) beschrijft de Log Analytics-tabel WVDAutoscaleEvaluationPooled. Volgens Learn is de kolom ExcludedSessionHostCount het aantal sessiehosts dat is uitgesloten van autoscalebeheer. De voorwaarde van Learn is een diagnostische instelling op de gepoolde hostpool die Autoscale logs for pooled host pools bevat en naar een Log Analytics-werkruimte verzendt. Bevraag die werkruimte, bijvoorbeeld met WVDAutoscaleEvaluationPooled | take 10. Learn koppelt de kolom niet aan de uitsluitingstag, dus een overeenkomend aantal is een plausibiliteitscontrole en geen bewijs.

Plannen rond het schema

De tag geldt in alle fasen van het schema: ramp-up, piek, ramp-down en off-peak. Een host die je 's middags taggt, blijft dus ook tijdens de avondelijke ramp-down en de off-peak-fase 's nachts ongemoeid, en een host waarvan je de tag vergeet te verwijderen, valt in elke fase buiten autoscale. Learn beschrijft geen tijdslimiet voor de tag, dus plan het venster als twee acties: tag en drain vóór de start, en maak beide ongedaan na afloop. Voer de capaciteitscontrole hierboven uit met de instellingen van de fase waarin je venster valt; de glossary van Learn definieert het minimale percentage hosts voor elke fase van het schema.

Speciale sessiehosts

Learn beschrijft één doel voor de tag: voorkomen dat autoscale drain mode overschrijft tijdens onderhoud. Andere toepassingen volgen uit de definitie ervan, en die moet je als afleiding beschouwen.

  • Een host die je test. Een nieuwe image of een gewijzigde configuratie op één host kan buiten de stroomwijzigingen worden gehouden terwijl je test. Zet die host ook in drain mode, anders kunnen gewone gebruikers erop terechtkomen.
  • Een host die aan moet blijven. Autoscale schakelt een getagde host niet uit, dus een draaiende host blijft draaien. Learn zegt niet of dit voldoet aan het minimale percentage hosts.
  • Een host die uit moet blijven. Autoscale start hem niet. Learn beschrijft niet wat Start VM on Connect doet met een getagde host die uit staat, dus test dat voordat je erop vertrouwt.

Bij een persoonlijke hostpool beschermt de tag hoogstwaarschijnlijk de energiestatus, omdat autoscale persoonlijke desktops niet in drain mode zet. Dat is een afleiding uit de FAQ; het conceptartikel behandelt dit en het geval "No resources available".

Fouten om te vermijden

  • De resourcegroep taggen. Tags worden niet overgeërfd, dus de VM's blijven onbeschermd.
  • Eerst draineren, dan taggen. In een gepoolde pool kan autoscale de drain mode overschrijven die je hebt ingesteld, ongeacht wie die heeft ingesteld.
  • De tag vergeten te verwijderen. Een host die getagd blijft, wordt nooit geschaald. Hij blijft ofwel aan en kost geld, ofwel uit en verliest capaciteit. Een getagde host die uit staat, helpt de pool niet aan het minimale percentage, omdat autoscale hem niet kan starten.
  • Persoonsgegevens in de tag zetten. Learn vraagt je om user principal names en vergelijkbare gegevens buiten uitsluitingstags te houden.
  • Aannemen dat dynamische autoscaling hetzelfde werkt. Microsoft heeft in juli 2026 de algemene beschikbaarheid aangekondigd van verbeterd hostpoolbeheer, inclusief dynamische autoscaling, configuratie en update van sessiehosts en tijdelijke besturingssysteemschijven (Tech Community). Sommige Learn-pagina's, bijvoorbeeld de scenario- en glossary-pagina's en moduleversie 5.4.2-preview, bevatten nog previewtekst. Controleer de actuele pagina voordat je op een limiet vertrouwt. Learn zegt niet of dynamische autoscaling, dat sessiehosts kan verwijderen, getagde hosts anders behandelt.

Gerelateerd

Bronnen

Veelgestelde vragen

Heb ik de drain-modus nodig als de vm de uitsluitingstag heeft?

Voor onderhoud wel. De tag zorgt er alleen voor dat autoscale de host niet wijzigt. Nieuwe sessies worden er niet door tegengehouden, dus zet je toch de drain-modus aan, zodat nieuwe verbindingen naar andere sessiehosts gaan en de host leeg kan lopen.

Wat gebeurt er als ik de drain-modus aanzet zonder de tag?

In een gepoolde hostpool schrijft Microsoft Learn dat autoscale de drain-modus overschrijft op alle vm's die in het schalen zijn opgenomen, ongeacht wie die heeft ingesteld. Autoscale kan de drain-modus die jij instelt dus wijzigen, of de host tijdens je werk aan- of uitzetten.

Welke rollen heb ik nodig?

Learn noemt de rol Desktop Virtualization Session Host Operator voor de drain-modus. Voor tags noemt Learn de rol Tag Contributor, die tagbewerkingen ondersteunt via Azure PowerShell en REST, maar niet voor resources in de Azure-portal. Een vm aan- of uitzetten is een aparte Azure-machtiging die deze pagina's niet behandelen.

Entities in this article

Onderwerpen van dit artikel:

Scaling plan exclusion tag (Azure Virtual Desktop) – Subonderwerp van AVD scaling plan AVD scaling plan – Onderdeel van Azure Virtual Desktop

Related articles

Meer artikelen over AVD scaling plan:

RSS