Zo gebruik je drainmodus voor patchen en onderhoud van sessiehosts
Partner · Neutrale partner: Nerdio
By Mirko Peters ·
Runbook om één Azure Virtual Desktop-sessiehost buiten gebruik te nemen: beveilig hem tegen autoscale, zet drainmodus aan, waarschuw en beëindig de resterende sessies, voer het werk uit en zet daarna drainmodus weer uit.
Automatically translated with AI from the original post. Read the English original
Om één sessiehost te patchen zonder gebruikers af te sluiten, tag je de VM zodat autoscale hem met rust laat, zet je drainmodus aan, stuur je de resterende gebruikers een bericht met een deadline, beëindig je de sessies die overblijven, patch en herstart je, en zet je daarna drainmodus weer uit.
Belangrijkste punten
- Drainmodus stopt nieuwe sessies op een host. Bestaande sessies blijven actief totdat de gebruiker zich afmeldt of een beheerder ze beëindigt.
- Een gebruiker die al een actieve of losgekoppelde sessie in de pool heeft, wordt ook in drainmodus nog naar die host doorgestuurd. Maak daarom eerst een lijst van de sessies en beëindig ze voordat je gaat patchen.
- In gepoolde hostpools overschrijft autoscale drainmodus op elke VM binnen scope, dus stel eerst de uitsluitingstag in het schaalplan in. In persoonlijke pools zet autoscale de drainmodus niet.
- Drainmodus vereist de rol Desktop Virtualization Session Host Operator; berichten sturen en gebruikers afmelden vereist User Session Operator. Controleer de effectieve machtigingen van het runbook-account.
- Voor image-gebaseerde updates van hosts die een sessiehostconfiguratie gebruiken, regelt session host update de drainmodus zelf. Learn raadt aan die tijdens een update niet handmatig te wijzigen.
Dit artikel is het runbook voor één host. Wat drainmodus is, staat in "Drain mode in Azure Virtual Desktop explained". Het plannen van golven over een hele hostpool, met groottes en capaciteit, is het onderwerp van "Patching AVD without downtime: rolling updates with drain mode". De werking van de uitsluitingstag, inclusief hoe je die toepast, staat in "How to use the exclusion tag for maintenance windows and special session hosts".
Wat je nodig hebt voordat je begint
- Rollen. Learn zegt dat het aan- of uitzetten van drainmodus de rol Desktop Virtualization Session Host Operator vereist. In de beschrijving op de RBAC-pagina staat dat de rol sessiehosts kan bekijken en verwijderen en drainmodus kan wijzigen. Berichten sturen, sessies loskoppelen en gebruikers afmelden valt onder de rol Desktop Virtualization User Session Operator, waarvan de RBAC-pagina zegt dat die drainmodus niet kan wijzigen. De ingebouwde definitie van de rol Session Host Operator bevat
Microsoft.DesktopVirtualization/hostpools/sessionhosts/, terwijl de definitie van User Session Operator.../sessionhosts/usersessions/expliciet bevat. Of één account beide stappen kan uitvoeren, hangt dus af van de rollen die daadwerkelijk zijn toegewezen. Test dit daarom met het account dat het runbook gaat uitvoeren. - Azure PowerShell met de Az.DesktopVirtualization-module, of Azure Cloud Shell, als je het wilt scripten.
- Capaciteit. Learn zegt dat nieuwe verbindingen naar de eerstvolgende beschikbare sessiehost gaan, dus controleer of de overige hosts de belasting aankunnen. Controleer bij een depth-first pool ook de maximale sessielimiet, want Learn zegt dat je die moet verhogen of hosts moet toevoegen zodra alle hosts die limiet hebben bereikt.
Stap voor stap
- Houd autoscale weg van de host (gepoolde hostpools). De scenariopagina van Learn zegt dat autoscale bij gepoolde hostpools de drain-modus overschrijft. De FAQ over autoscale zegt dat autoscale VM's die in drain-modus staan toch aan of uit zet, ongeacht wie de drain-modus heeft ingesteld, omdat het de drain-modus overschrijft op alle VM's die in het schalen zijn opgenomen. De uitsluitingstag is een tagnaam die je invoert op het tabblad Basics van het schaalplan (op het tabblad Eigenschappen van een bestaand plan). Het voorbeeld van Learn is
excludeFromScaling. Het veld bestaat voor energiebeheerplannen en voor dynamische plannen, die alleen gelden voor gepoolde hostpools met een sessiehostconfiguratie. Met de tag op een sessiehost start, stopt of wijzigt autoscale de drain-modus van die host niet. Voeg een tag met die naam toe aan de VM. Machtigingen voor tags en verdere details staan in het hierboven genoemde artikel over de uitsluitingstag. Voor persoonlijke hostpools zie de sectie verderop. - Zet de drain-modus aan. Open in de Azure-portal Azure Virtual Desktop, daarna Hostpools, selecteer de hostpool, selecteer Sessiehosts, vink de host aan en selecteer Drainmodus inschakelen. Met Azure PowerShell stelt de drain-modus-pagina van Learn de drain-modus in met de parameter
AllowNewSessionvanUpdate-AzWvdSessionHost, één keer per sessiehost. De pagina gebruikt een hashtabel$paramsmetAllowNewSession = $Falseen splatt die in de cmdlet. Dezelfde aanroep in één blok, in de vorm van het cmdlet-referentievoorbeeld, is:
Update-AzWvdSessionHost -ResourceGroupName <ResourceGroupName> `
-HostPoolName <HostPoolName> `
-Name <SessionHostName> `
-AllowNewSession:$falseLearn waarschuwt dat de portalstatus niet synchroon kan lijken als je meteen ververst. Wacht daarom eerst minstens 60 seconden.
- Lijst de sessies die nog op de host staan.
Get-AzWvdUserSession -ResourceGroupName <ResourceGroupName> `
-HostPoolName <HostPoolName> -SessionHostName <SessionHostName>Het voorbeelduitvoer van Learn noemt elke sessie als HostPoolName/SessionHostName/2, en de referentie van Remove-AzWvdUserSession neemt het sessienummer als -Id (alias UserSessionId). Gebruik daarom het laatste deel van de naam als sessie-ID.
- Waarschuw de gebruikers. De referentie van Learn toont deze vorm, met de titel en de tekst van het bericht als vrije tekst:
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.'Geef een deadline die je kunt halen.
- Beëindig wat er nog over is. Verwijder na de deadline de resterende sessies:
Remove-AzWvdUserSession -ResourceGroupName <ResourceGroupName> `
-HostPoolName <HostPoolName> -SessionHostName <SessionHostName> -Id <id>De referentiepagina noemt ook een parameter -Force ("Specify to force userSession deletion"), maar toont er geen voorbeeld mee. Een sessie verwijderen beëindigt die, dus alles wat de gebruiker niet heeft opgeslagen gaat verloren. Daarom komt stap 4 eerst.
- Voer het onderhoud uit. Learn zegt dat je, zodra er geen sessies meer zijn, het nodige onderhoud kunt uitvoeren, en dat beheerders nog steeds rechtstreeks verbinding kunnen maken met de server zonder via de Azure Virtual Desktop-service te gaan. De patching zelf, via Windows Update, Intune, WSUS of een ander hulpmiddel, valt buiten dit artikel. Controleer wel eerst hoe Learn in-place patching beoordeelt voor je besturingssysteem (zie de laatste sectie). Als de host daarna niet weer als beschikbaar wordt getoond, gebruik dan de checklist in het zusterartikel "Azure Virtual Desktop Session Host Shows Unavailable: A Step-by-Step Checklist".
- Zet de drain-modus weer uit. Vink in de portal de host aan en selecteer Drainmodus uitschakelen. In PowerShell voer je dezelfde cmdlet uit met
-AllowNewSession:$true. De drain-modus-pagina van Learn toont beide richtingen:$Falseom de drain-modus aan te zetten en$Trueom hem uit te zetten. Wacht minstens 60 seconden voordat je de status in de portal controleert. Verwijder daarna de uitsluitingstag, zodat autoscale de host weer beheert.
Gedrag dat mensen verrast
- Losgekoppelde sessies komen terug. De pagina over load balancing van Learn zegt dat een gebruiker met een actieve of losgekoppelde sessie die opnieuw aanmeldt, naar de host met die sessie wordt gestuurd, zelfs in drain-modus. Een gebruiker zonder sessie wordt nooit naar een gedraineerde host gestuurd. Daarom is stap 3 belangrijk: een host die leeg lijkt, kan nog losgekoppelde sessies hebben.
- Een niet-getagde gepoolde host valt nog steeds onder schaling. Als je een host in een gepoolde hostpool handmatig in drain-modus zet en je die host niet taggt, dan kan autoscale volgens de FAQ de host nog steeds starten, stoppen of de drain-modus wijzigen. De tag haalt de host uit de schaling, niet de drain-modus.
- Niet-opgeslagen werk gaat verloren.
Remove-AzWvdUserSessionbeëindigt de sessie. De referentie van Learn beschrijft geen manier om de sessie te herstellen, dus stuur eerst het bericht uit stap 4. - Een achtergebleven tag houdt de host buiten het schalen. Volgens Learn tellen getagde hosts nog mee in de berekening van het minimale percentage hosts, maar autoscale start ze niet. Verwijder de tag in stap 7. Zolang die er staat, start autoscale de host niet, ook niet als de pool de capaciteit nodig heeft. Scenario 4 op Learn beschrijft dat gebruikers de melding "No resources available" zien wanneer elke host in de pool getagd en uitgeschakeld is.
Een voorbeeldtijdlijn voor één host
Deze tijden zijn verzonnen ter illustratie en vormen geen aanbeveling van Microsoft. Eén gepoolde host, avd-host-03, wordt op een doordeweekse avond gepatcht.
| Tijd | Actie |
|---|---|
| 17:30 | Tag de VM, zet drain mode aan en haal de sessies op (stap 1 tot en met 3). |
| 17:35 | Stuur elke resterende sessie een bericht: sla je werk op, meld je af, de host wordt om 18:30 gepatcht (stap 4). |
| 18:30 | Verwijder de sessies die nog over zijn, inclusief de verbroken sessies (stap 5). |
| 18:35 | Installeer de updates en start opnieuw op (stap 6). |
| 19:15 | Controleer of de host als beschikbaar wordt gemeld, zet drain mode uit en verwijder de tag (stap 7). |
Controleer voordat je begint of de overige hosts de avondbelasting aankunnen. Het zusterartikel over rolling updates beschrijft hoeveel hosts je tegelijk uit de pool haalt.
Persoonlijke hostpools
In de FAQ van Learn staat dat autoscale een persoonlijke desktop niet in drain mode zet voordat hij wordt gedealloceerd. Een gebruiker die tijdens het dealloceren verbinding maakt, ziet dan "No resources available". De FAQ meldt verder dat wanneer een sessiehost door autoscale, Start VM on Connect of een beheerder wordt ingeschakeld en niemand zich aanmeldt, autoscale die host deallocateert na een periode van inactiviteit die de pagina niet definieert. Dit is relevant als de pool een schaalplan heeft: een persoonlijke host die je voor patching start zonder dat een gebruiker zich aanmeldt, kan onder je handen gedealloceerd worden. Learn beschrijft het uitsluitingstag-veld voor energiebeheerplannen zonder het te beperken tot gepoolde hostpools, maar licht niet toe wat het effect ervan is op persoonlijke hostpools. Het taggen van de persoonlijke host voordat je de VM start is daarom een voorzorgsmaatregel die dit artikel voorstelt, geen gedocumenteerde garantie; controleer dit op een testhost. Informeer ook de toegewezen gebruiker, want een persoonlijke sessiehost is aan één gebruiker toegewezen.
Wanneer drain mode het verkeerde hulpmiddel is
De pagina van Learn over updatemethoden voor sessiehosts beoordeelt in-place patchen per besturingssysteem. Voor Windows client multi-session hosts markeert die Windows Update als "Not recommended" voor maandelijkse en functie-updates en WSUS als "Not recommended" voor functie-updates, en session host update en Azure Compute Gallery als "Recommended". Voor Windows Server markeert de pagina Windows Update als "Supported" en Azure Update Manager en automatische gastpatching als "Recommended". Voor Windows client Enterprise (single-session) markeert de pagina Windows Update als "Recommended", maar gepoolde hostpools van dat type als "Not recommended". De alinea over in-place patchen op dezelfde pagina noemt Windows Update tussen de gangbare technologieën, dus lees de tabellen per systeem en niet alleen die zin. Onze lezing: dit runbook past bij Windows Server-hosts, persoonlijke hosts en onderhoud dat geen patching is, zoals configuratiewijzigingen, herstarts, probleemoplossing of het uitfaseren van een host. Voor gepoolde Windows client multi-session pools adviseert Learn image-based servicing.
Als je updatet door de image te vervangen in plaats van ter plaatse te patchen, doet de functie voor sessiehost-updates van Learn het werk voor hosts die een sessiehostconfiguratie gebruiken. Volgens Learn zet die functie de geselecteerde hosts zelf in drainmodus, en je mag de drainmodus tijdens een update niet handmatig wijzigen. Op de pagina staat ook dat je autoscale op de hostpool moet uitschakelen vóór de update, omdat een ingeschakeld schaalplan de update met een runtimefout kan laten mislukken. Verder staat er dat handmatige aanpassingen, zoals bestanden, registersleutels en certificaten, na de update niet meer aanwezig zijn. Microsoft heeft in juli 2026 de algemene beschikbaarheid aangekondigd van verbeterd hostpoolbeheer, waaronder sessiehostconfiguratie en -update (Tech Community). Sommige Learn-pagina's bevatten nog preview-tekst. De configuratiepagina markeert bijvoorbeeld de Azure PowerShell-cmdlets voor dit soort hostpools als preview en vraagt om de previewversie van de Az.DesktopVirtualization-module. Controleer de actuele pagina voordat je op een limiet vertrouwt. Vergelijk deze aanpak met rolling drain in ‘Patching AVD without downtime: rolling updates with drain mode’.
Bronnen
Geraadpleegd op 17 november 2026.
- Microsoft Learn: Sessiehosts in drainmodus zetten voor onderhoud in Azure Virtual Desktop
- Microsoft Learn: Azure RBAC-rollen voor Azure Virtual Desktop (pagina rbac)
- Microsoft Learn: Update-AzWvdSessionHost
- Microsoft Learn: Get-AzWvdUserSession
- Microsoft Learn: Send-AzWvdUserSessionMessage
- Microsoft Learn: Remove-AzWvdUserSession
- Microsoft Learn: Load balancing voor hostpools configureren
- Microsoft Learn: Azure Virtual Desktop autoscale FAQ
- Microsoft Learn: Een autoscale-schaalplan maken en toewijzen
- Microsoft Learn: Autoscale-schaalplannen en voorbeeldscenario's
- Microsoft Learn: Windows-updatebeheermethoden voor sessiehosts
- Microsoft Learn: Sessiehost-updates
- Microsoft Learn: Sessiehosts bijwerken met een sessiehostconfiguratie
- Microsoft Tech Community: Verbeterd hostpoolbeheer voor Azure Virtual Desktop is nu algemeen beschikbaar
Veelgestelde vragen
Wat gebeurt er met gebruikers die verbonden zijn als ik drainmodus aanzet?
Er gebeurt niets met hen. Microsoft Learn meldt dat bestaande verbindingen actief blijven totdat de gebruiker zich afmeldt of een beheerder de sessie beëindigt. Drainmodus stopt alleen nieuwe sessies. Je moet de gebruikers zelf een bericht sturen en de sessies beëindigen, bijvoorbeeld met Send-AzWvdUserSessionMessage en Remove-AzWvdUserSession.
Waarom belandt een gebruiker nog steeds op de host die ik in drainmodus heb gezet?
De Learn-pagina over load balancing zegt dat een gebruiker die al een actieve of losgekoppelde sessie in de hostpool heeft, wordt doorgestuurd naar de host waarop die sessie draait, ook als drainmodus aan staat. Gebruikers zonder sessie worden niet naar een host in drainmodus gestuurd. Controleer losgekoppelde sessies met Get-AzWvdUserSession.
Zet autoscale mijn host tijdens onderhoud weer aan?
In een gepoolde hostpool kan dat. De FAQ over autoscale van Learn zegt dat autoscale drainmodus overschrijft op alle VM's die in de schaling zijn opgenomen. Om een VM buiten schaalacties te houden, gebruik je de uitsluitingstag die je in het schaalplan instelt: volgens Learn start, stopt of wijzigt autoscale de drainmodus van getagde hosts dan niet. Voor persoonlijke hostpools zegt de FAQ dat autoscale de sessiehost niet in drainmodus zet, maar dat het wel een host kan deallocaten waar niemand zich op aanmeldt.