Drain mode in Azure Virtual Desktop uitgelegd
Partner · Neutrale partner: Nerdio
By Mirko Peters ·
Drain mode zorgt ervoor dat een session host geen nieuwe sessies meer accepteert van nieuwe gebruikers, terwijl bestaande sessies doorlopen tot ze eindigen. Dit artikel legt uit wat het wel en niet verandert, hoe de load balancer en autoscale ermee omgaan, en hoe je het instelt in de portal en hoe je het instelt en uitleest met PowerShell.
Automatically translated with AI from the original post. Read the English original
Drain mode is een instelling per host die voorkomt dat een session host nieuwe gebruikerssessies accepteert. Sessies die al bestaan, worden niet aangepast. Dit artikel legt uit wat de instelling wel en niet verandert, hoe de load balancer en autoscale ermee omgaan, en hoe je de instelling instelt in de portal en uitleest en instelt in PowerShell. Het stap-voor-stap onderhoudsrunbook staat in een apart artikel, "How to use drain mode for patching and maintenance of session hosts", en het plannen van golven over een pool wordt behandeld in "Patching AVD without downtime: rolling updates with drain mode".
Belangrijkste punten
- Een session host in drain mode accepteert geen nieuwe sessies. Bestaande sessies blijven verbonden totdat de gebruiker zich afmeldt of een beheerder ze beëindigt, en beheerders kunnen nog steeds rechtstreeks verbinding maken met de server.
- Drain mode is geen afmelding, geen afsluiting en geen gezondheidsstatus. Het verandert alleen of de host kan worden gekozen voor nieuwe verbindingen.
- Een gebruiker die al een actieve of losgekoppelde sessie op een host in drain mode heeft, wordt bij opnieuw aanmelden nog steeds naar die host doorgestuurd. Nieuwe gebruikers worden daar niet geplaatst.
- In pooled host pools zet autoscale drain mode aan en uit, ongeacht wie het heeft ingesteld. Gebruik de uitsluitingstag om een host te beschermen. In personal host pools gebruikt autoscale drain mode niet.
- In PowerShell zet Update-AzWvdSessionHost met AllowNewSession $False drain mode aan en met $True uit. Learn noemt de rol Desktop Virtualization Session Host Operator als vereiste.
Wat drain mode doet
Microsoft Learn beschrijft drain mode als een manier om een session host te isoleren, zodat je onderhoud kunt uitvoeren zonder de service te verstoren. De gedocumenteerde effecten zijn:
- Nieuwe sessies. Een host in drain mode accepteert geen nieuwe sessies. Nieuwe verbindingen worden doorgestuurd naar de volgende beschikbare session host.
- Bestaande sessies. Die blijven actief totdat de gebruiker zich afmeldt of een beheerder de sessie beëindigt.
- Onderhoud. Zodra er geen sessies meer op de host staan, kun je het onderhoud uitvoeren.
- Beheerderstoegang. Beheerders kunnen nog steeds rechtstreeks verbinding maken met de server, zonder via de Azure Virtual Desktop-service te gaan.
In de Azure PowerShell-referentie wordt dezelfde status bepaald door de parameter -AllowNewSession van Update-AzWvdSessionHost, en het uitvoerobject van Get-AzWvdSessionHost heeft een eigenschap AllowNewSession die omschreven wordt als "Allow a new session." De tekst van Learn gebruikt op sommige plaatsen de meervoudsvorm AllowNewSessions, en de veelgestelde vragen over autoscale zeggen dat autoscale, wanneer het drain mode uitzet nadat een VM is gedeallokeerd, AllowNewSessions op true zet. Drain mode aan betekent dus dat nieuwe sessies niet zijn toegestaan, en drain mode uit betekent dat ze wel zijn toegestaan.
Wat drain mode niet is
- Het is geen afmelding. Er wordt niets beëindigd doordat je het aanzet.
- Het is geen afsluiting. Learn beschrijft geen afsluiting, dus de VM blijft draaien en de kosten lopen door. Dat is een conclusie uit de beschrijving en geen uitspraak van Learn.
- Het is geen gezondheidsstatus. Learn noemt de instelling voor nieuwe sessies en de status als afzonderlijke eigenschappen. Gezondheidscontroles en statussen vormen een apart onderwerp; zie "Azure Virtual Desktop Session Host Shows Unavailable: A Step-by-Step Checklist".
- Het is niet hetzelfde als de maximale sessielimiet. Bij depth-first load balancing wordt een host die zijn maximale sessielimiet heeft bereikt, niet meegenomen in de zoekopdracht voor nieuwe sessies, maar alleen totdat sessies zijn beëindigd en er weer ruimte is. Een gedraineerde host blijft uitgesloten totdat drain mode wordt uitgeschakeld, door jou of, bij gepoolde hostpools met een schaalplan, door autoscale, tenzij de host de uitsluitingstag heeft (zie hieronder).
Hoe de load balancer met een gedraineerde host omgaat
De pagina over load balancing van Learn beschrijft twee regels die verklaren wat gebruikers ervaren:
- Voor nieuwe gebruikers houdt de load balancer geen rekening met sessiehosts in drain mode.
- Een gebruiker die een actieve of verbroken sessie heeft en opnieuw aanmeldt, wordt doorgestuurd naar die sessiehost, ook als drain mode is ingeschakeld.
De tweede regel is belangrijk voor je planning. Een gebruiker met een verbroken sessie op een gedraineerde host keert terug naar die host, dus de host loopt niet vanzelf leeg zolang zulke sessies bestaan. De host is pas leeg wanneer de gebruikers zich hebben afgemeld of jij hun sessies hebt beëindigd. Learn noemt beide regels als gedrag dat geldt voor zowel breadth-first als depth-first load balancing. Daarnaast staat erbij dat load balancing niet van toepassing is op persoonlijke hostpools.
Wie het kan instellen, en hoe
De draina-pagina van Learn somt de voorwaarden voor de hele procedure op, zowel via de portal als via PowerShell: een hostpool met minstens één sessiehost en de rol Desktop Virtualization Session Host Operator. Voor lokale Azure PowerShell heb je ook de module Az.DesktopVirtualization nodig, of je gebruikt Azure Cloud Shell.
Open in de Azure-portal de hostpool, selecteer Sessiehosts, vink de host aan en kies Drain mode inschakelen. Kies Drain mode uitschakelen om verbindingen weer toe te staan.
In Azure PowerShell geeft de draina-pagina van Learn voor elke richting één opdracht. Die werkt op één sessiehost per keer, dus herhaal hem voor elke host die je wilt wijzigen:
# 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 @paramsDe pagina toont de twee blokken afzonderlijk; de enkele hashtabel hierboven is een verkorte versie van dit artikel.
Om de status te lezen, geeft Get-AzWvdSessionHost een ISessionHost-object terug. De eigenschap AllowNewSession bevat de instelling, en de REST-referentie vermeldt dezelfde waarde als properties.allowNewSession. Een regel zoals Get-AzWvdSessionHost -ResourceGroupName <ResourceGroupName> -HostPoolName <HostPoolName> | Select-Object Name, AllowNewSession, Session, Status toont elke host in een pool met zijn instelling en sessieaantal. Het filter Select-Object is een suggestie van dit artikel, geen voorbeeld van Learn. Wacht na een wijziging in de portal minstens 60 seconden voordat je vernieuwt, want Learn waarschuwt dat een直接 vernieuwen een niet-synchrone status kan tonen.
Hoe autoscale drain mode gebruikt en overschrijft
Autoscale gebruikt drain mode zelf, en dat wordt snel over het hoofd gezien. Bij gepoolde hostpools zet het een host in drain mode voordat het die deallokeert, zet het AllowNewSessions daarna weer op true, en schakelt het drain mode in of uit op elke VM binnen het bereik, ongeacht wie het daar heeft ingesteld. Alleen een host met de uitsluitingstag wordt met rust gelaten. Bij persoonlijke hostpools gebruikt autoscale geen drain mode, en een gebruiker die tijdens het deallokeren verbinding maakt, krijgt de melding "No resources available". Het runbook-artikel laat zien hoe je een host taggt voordat je hem drained, en het artikel over geforceerd afmelden beschrijft de afbouwvolgorde.
Een kort voorbeeld
Neem een gepoolde host met drie sessies: gebruiker A is actief, gebruiker B is verbroken en gebruiker C is actief. Je zet drainmodus aan. Gebruiker D meldt zich voor het eerst aan en wordt naar een andere host gestuurd, omdat de load balancer gedraineerde hosts niet meeneemt voor nieuwe gebruikers. Gebruiker A meldt zich af. Gebruiker B maakt opnieuw verbinding en keert, omdat B een verbroken sessie op deze host heeft, naar die host terug, ook al staat die in drainmodus. Gebruiker C blijft verbonden. De host is pas vrij voor onderhoud nadat B en C zich hebben afgemeld of een beheerder hun sessies heeft beëindigd. Als je niets doet, blijft de host in deze staat, tenzij autoscale de drainmodus wijzigt op een gepoolde host die niet is getagd. Deze doorloop past de gedocumenteerde regels toe en is geen Learn-scenario.
Drainmodus vergeleken met verwante instellingen
| Beheersmaatregel | Wat er verandert | Bestaande sessies |
|---|---|---|
| Drainmodus | De host ontvangt geen nieuwe sessies van nieuwe gebruikers | Blijven verbonden |
| Lagere maximale sessielimiet | Hoeveel sessies de host accepteert | Learn zegt dat verlagen op een host met actieve sessies die sessies niet beïnvloedt |
| Uitsluitingstag | Autoscale start, stopt of wijzigt de drainmodus op de host niet | Onaangetast |
| Afmelding afdwingen bij ramp-down | Autoscale beëindigt resterende sessies na de wachttijd | Beëindigd |
Alleen de laatste rij beëindigt sessies. Drainmodus heeft daarom een tweede stap nodig, wachten of sessies beëindigen, voordat een host vrij is voor werk. De tabel is een samenvatting van de Learn-uitspraken hierboven.
Het resultaat lezen
- Sessies. Controleer het aantal sessies op de host voordat je begint. Bestaande sessies worden door drainmodus niet beëindigd. In de Insights-woordenlijst staat dat het item Sessions verbonden en verbroken sessies toont, terwijl Idle sessions alleen verbroken sessies toont.
- Directe toegang. Dit is een conclusie op basis van de gedocumenteerde beheerderstoegang, geen Learn-uitspraak: omdat beheerders de vm kunnen bereiken zonder de service, zegt je eigen test op een gedraineerde host niet zeker wat gebruikers zullen zien.
Veelvoorkomende misverstanden
- "Ik heb drainmodus aangezet en gebruikers werden verbroken." De pagina over drainmodus beschrijft dat niet. Controleer op autoscale, een beleid of een patchproces dat sessies beëindigt.
- "De host staat in drainmodus maar heeft nog gebruikers." Dat is verwacht: sessies blijven bestaan en terugkerende gebruikers gaan terug naar hun host.
- "Drainmodus staat weer uit." Controleer bij gepoolde pools eerst het schaalplan en de uitsluitingstag.
- "Nieuwe gebruikers kunnen helemaal niet verbinden." Als elke host in een pool in drainmodus staat, kan geen enkele host een nieuwe gebruiker ontvangen. De pagina over drainmodus documenteert voor dit geval geen foutmelding.
Bronnen
Geraadpleegd op 17 november 2026.
- Microsoft Learn: Sessiehosts leegtrekken voor onderhoud in Azure Virtual Desktop
- Microsoft Learn: Taakverdeling van hostpools configureren in Azure Virtual Desktop
- Microsoft Learn: Autoscale-faq
- Microsoft Learn: Autoscale-scenario's voor Azure Virtual Desktop
- Microsoft Learn: Update-AzWvdSessionHost
- Microsoft Learn: Get-AzWvdSessionHost
- Microsoft Learn: ISessionHost-model
- Microsoft Learn: Session Hosts - Get (REST API)
- Microsoft Learn: Azure Virtual Desktop Insights-woordenlijst
Veelgestelde vragen
Meldt drain mode gebruikers af?
Nee. Microsoft Learn zegt dat bestaande verbindingen actief blijven totdat de gebruiker zich afmeldt of een beheerder de sessie beëindigt. Drain mode heeft alleen invloed op waar nieuwe sessies worden geplaatst.
Waarom is mijn host zelf uit drain mode gegaan?
Als de host zich in een pooled host pool bevindt met een autoscale-schema, overschrijft autoscale drain mode op VM's die in het schalen zijn opgenomen, ongeacht wie het heeft ingesteld. De veelgestelde vragen adviseren om uitsluitingstags te gebruiken om een VM buiten schaalacties te houden.
Hoe lang duurt het voordat de portal de wijziging toont?
Learn zegt dat de status out of sync kan lijken te zijn als je de portal direct na het wijzigen van drain mode vernieuwt, en adviseert om minstens 60 seconden te wachten voordat je vernieuwt.