Azure Virtual Desktop-sessiehost wordt als niet beschikbaar weergegeven: een stappenchecklist
By Mirko Peters ·
Een sessiehost die draait maar in de hostpool als Unavailable staat, kan geen gebruikers opnemen. Lees eerst de mislukte statuscontrole en controleer daarna de domeinkoppeling, de services, de URL's, autoscale en de agentregistratie.
Automatically translated with AI from the original post. Read the English original
Je opent de hostpool in de Azure-portal. De VM's draaien. De sessiehosts tonen Unavailable. Gebruikers kunnen niet verbinden, of ze verbinden met de enige host die nog gezond is.
Belangrijkste punten
- Een VM in de status Running zegt niets over de AVD-agent. De hoststatus komt uit de statuscontroles van de agent.
- Een mislukte domeinkoppeling of een kapotte listener van de side-by-side stack is een fatale controle. Een mislukte controle van de monitoringagent, de metadataservice of de URL's wordt als niet-fatale controle vermeld en leidt tot Needs Assistance.
- Nadat een autoscale-plan hosts heeft gestart en gestopt, controleer je de rollen op abonnementsniveau, de drain-modus en de agentservices voordat je iets opnieuw installeert.
- Installeer de agent en de boot loader pas opnieuw met een nieuwe registratiesleutel als de eenvoudigere controles niet hebben geholpen.
Microsoft Q&A bevat meerdere draadjes uit 2025 en 2026 hierover. Eén vrager met een nieuwe omgeving loste het op door de VM handmatig aan het domein toe te voegen. Een andere zag hosts één voor één Unavailable worden nadat een schaalplan was ingeschakeld, en dat draadje eindigde zonder bevestigde oplossing. Dit artikel volgt de volgorde die Microsoft Learn aanbeveelt en voegt de punten uit de draadjes toe. Het is geen officiële Microsoft-procedure. Controleer elke stap tegen de actuele Learn-pagina's, want het artikel over probleemoplossing van de agent en het artikel over de configuratie van sessiehosts zijn ouder dan sommige andere pagina's.
Wat je ziet
- Hostpool, dan Sessiehosts: status Unavailable, soms Needs Assistance of Upgrading.
- De VM zelf heeft de status Running.
- Na een herstart draait de VM weer, maar blijft de host Unavailable.
- Bij het scenario met het schaalplan worden hosts geleidelijk Unavailable, niet allemaal tegelijk.
Stap 1: Lees de mislukte statuscontrole
Open in de portal de hostpool, selecteer Sessiehosts en bekijk de details van één getroffen host. Learn beschrijft de statussen als volgt:
- Available: alle controles zijn geslaagd.
- Needs Assistance: een niet-fatale controle is mislukt. Dit betreft de monitoringagent, de Azure Instance Metadata Service en de URL-controle. Gebruikers kunnen nog steeds verbinden.
- Unavailable: de host is uitgeschakeld of heeft een fatale controle niet doorstaan.
- Upgrading of Upgrade Failed: de agentupdate is bezig of is mislukt.
De fatale controles op de Learn-pagina zijn de controle op domeinlidmaatschap, de controle op domeinvertrouwen en de controle op de listener van de side-by-side stack. Het eerste punt is waar het draadje uit 2025 eindigde.
Stap 2: Controleer de domeinkoppeling
De thread met een bevestigde oplossing begon met een gebruiker die geen verbinding kon maken met een gloednieuwe omgeving. Een vrijwillige moderator stelde de standaard implementatiegids en AVD Insights voor. Een onafhankelijke adviseur somde generieke controles op: gebeurtenislogboeken, domein- of Azure AD-join, open poorten, aangepaste image-agent en servicestatus. De vraagsteller schreef later dat de VM zichzelf niet bij het domein had gevoegd, en dat handmatig toevoegen en opnieuw opstarten het probleem oploste.
Controleer dit op de VM:
- Meld je aan bij de VM met een lokaal beheerdersaccount en controleer of de machine lid is van je domein.
- Voer vanaf een opdrachtregel op de VM een ping uit naar de domeinnaam om te controleren of die wordt omgezet naar een IP-adres. Learn noemt dit de basistest.
Microsoft Learn somt in het artikel over de sessiehostconfiguratie typische redenen op waarom een join mislukt: verkeerde referenties in de implementatiesjabloon, MFA op het join-account, ontbrekende machtigingen en DNS-problemen. Voor DNS geldt het volgende: het virtuele netwerk van de VM's moet het netwerk van het domein kunnen bereiken (bijvoorbeeld via peering), de DNS van het netwerk moet verwijzen naar de domeincontrollers, en de NIC moet dezelfde DNS-servers overnemen of gebruiken.
Controleer ook het punt over het opnieuw gebruiken van een computeraccountnaam. Volgens Learn kan hergebruik worden geblokkeerd wanneer Windows-updates die op of na 11 oktober 2022 zijn uitgebracht, zijn geïnstalleerd en het account waarmee wordt toegevoegd niet de rechten heeft om computeraccounts opnieuw te gebruiken. Learn noemt drie uitwegen: gebruik het account dat het computeraccount heeft aangemaakt, gebruik een lid van Domeinbeheerders, of gebruik een account dat valt onder de groepsbeleidsinstelling die hergebruik van computeraccounts tijdens het toevoegen aan het domein toestaat.
Stap 3: controleer de agentservices
Maak verbinding met de VM. Werkt RDP niet, dan is Run Command in de Azure-portal een optie, zoals een antwoord voorstelde.
- Open
services.mscen controleer of Remote Desktop Agent Loader (de bootloader, servicenaamRDAgentBootLoader) actief is. Start de service als die is gestopt. Een antwoord in de thread over het schaalplan noemde ook een serviceRDAgentom te controleren. De Learn-pagina over agentproblemen noemt in deze stap alleen de service Remote Desktop Agent Loader. Behandel de RDAgent-service dus als iets dat in een communitythread is gemeld, niet als iets dat in Microsoft Learn is bevestigd. - Open Gebeurtenisweergave en ga naar Windows-logboeken en daarna naar Toepassing. Learn noemt de bronnen WVD-Agent, WVD-Agent-Updater, RDAgentBootLoader en MsiInstaller. De meeste fouten hebben gebeurtenis-ID 3277 met een trefwoord in het bericht.
- Als de loader opnieuw stopt nadat je hem hebt gestart, vermoed dan een registratieprobleem (stap 6).
Start de VM traag op, dan beschrijft de Learn-pagina ook een geval met een time-out bij het opstarten: stel het opstarttype van de loader in op Automatisch (vertraagd starten) en verhoog zo nodig de waarde van ServicesPipeTimeout, te beginnen bij 60000 milliseconden.
Stap 4: controleer de verbinding met de service
Sessiehosts hebben alleen uitgaande toegang nodig. De lijst met vereiste eindpunten van Learn bevat .wvd.microsoft.com op TCP 443, login.microsoftonline.com, de monitoringeindpunten gcs.prod.monitoring.core.windows.net en .prod.warm.ingest.monitor.core.windows.net, en de Azure-fabric-adressen 169.254.169.254 (metadata) en 168.63.129.16 (WireServer). Volgens Learn mag verkeer naar die twee adressen niet worden onderschept, via een proxy geleid of omgeleid. Learn adviseert servicetags en FQDN-tags te gebruiken, omdat er geen lijst met IP-adresbereiken wordt gepubliceerd om in plaats van de FQDN's toe te staan.
Test in deze volgorde:
- Voer de Azure Virtual Desktop Agent URL Tool uit op de sessiehost. Die controleert elk vereist eindpunt.
- Bij een
INVALID_FORM-gebeurtenis zegt Learn dat je de waardenBrokerResourceIdURIenBrokerResourceIdURIGlobalonderHKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\RDInfraAgentmoet opzoeken,/api/healthaan elk adres moet toevoegen en het in een browser moet openen. Een gezond resultaat meldt dat de broker in orde is. - Let op TLS-inspectie, een proxy of aangepaste DNS in het pad.
Een thread over het schaalplan stelde voor een ander health-adres op rdweb.wvd.microsoft.com te testen. Ik kon dat adres niet terugvinden op de Learn-pagina's, dus ik raad het niet aan. Gebruik de brokerwaarden uit het register.
Die thread beweerde ook dat ontbrekende monitoring-endpoints heartbeat-fouten veroorzaken. Learn noemt de controle op de monitoringagent onder de niet-fatale controles die Needs Assistance geven, niet Unavailable (in de tabel met gezondheidscontroles wordt die controle semi-fataal genoemd). Open die endpoints toch, maar blijf zoeken als de host Unavailable blijft.
Stap 5: Als het is gestart nadat je een schaalplan hebt ingeschakeld
De thread over schaalplannen is geplaatst in juni 2026. Hosts gingen na het inschakelen van het plan één voor één naar Unavailable. De firewallnamen openen en de VM's opnieuw opstarten loste de meeste niet op. Twee antwoorden noemden controles, maar geen enkel antwoord is als oplossing gemarkeerd.
Microsoft Learn legt uit hoe autoscale werkt, en het loont om de twee te vergelijken:
- Rollen op abonnementsniveau. De service principal of de beheerde identiteit van de hostpool heeft Desktop Virtualization Power On Off Contributor nodig, toegewezen op abonnementsniveau. Learn waarschuwt dat een lager bereik ervoor kan zorgen dat autoscale niet goed werkt.
- Drain-modus. Bij ramp-down zet autoscale de host met de minste sessies in de drain-modus, meldt gebruikers na de wachttijd af en deallocate de VM. Een antwoord in de thread over schaalplannen adviseerde om na een herstart in de portal de kolom Allow New Sessions te controleren, omdat de drain-modus kan blijven bestaan. De Learn-pagina over autoscale beschrijft dit niet, dus beschouw het als iets dat in een communitythread is gemeld.
- Uitsluitingstag. Hosts met de uitsluitingstag laat autoscale met rust. Gebruik deze op een testhost om te zien of het plan de oorzaak is.
- Minimumpercentage hosts. Autoscale houdt daar rekening mee en schakelt een host alleen uit als de overgebleven hosts de sessies kunnen overnemen. Ik vond geen Learn-tekst over een host die door autoscale wordt gestart maar daarna niet aan de service rapporteert. Herhaal daarom na een power-on de stappen 2 tot en met 4 op die host.
- Geen gemengde schaling. Learn zegt dat je autoscale en de oudere schaling via Azure Automation of Logic Apps niet op dezelfde hostpool kunt gebruiken.
Voor diagnose heeft Learn een pagina over het instellen van diagnostische gegevens voor autoscale (Set up diagnostics for Autoscale), die linkt naar een veelgestelde vragenlijst over autoscale.
Stap 6: De agent opnieuw registreren of opnieuw installeren
Doe dit als de controles hierboven geen oorzaak aantonen, of als het logboek INVALID_REGISTRATION_TOKEN of EXPIRED_MACHINE_TOKEN toont. Bij NAME_ALREADY_REGISTERED zegt Learn dat de VM-naam waarschijnlijk dubbel is: verwijder de sessiehost uit de pool, maak een VM met een unieke naam aan en voeg deze opnieuw toe. De volledige procedure voor opnieuw installeren volgens Learn is:
- Verwijder deze onderdelen via Programma's en onderdelen en start daarna opnieuw op: Remote Desktop Agent Boot Loader, Remote Desktop Services Infrastructure Agent, Remote Desktop Services Infrastructure Geneva Agent en Remote Desktop Services SxS Network Stack. Als je via RDP verbonden bent, kies dan om toepassingen niet te sluiten bij het verwijderen van de SxS-stack.
- Verwijder de sessiehost uit de hostpool: Azure Virtual Desktop, Hostpools, je pool, Sessiehosts, selecteer de host en kies Verwijderen.
- Genereer een nieuwe registratiesleutel op de pagina Registratiesleutel van de hostpool. De sleutel moet minimaal één uur en maximaal 27 dagen geldig zijn.
- Installeer de huidige agent en boot loader. Plak de sleutel in het installatieprogramma van de agent, voer daarna het installatieprogramma van de boot loader uit en start opnieuw op.
- Wacht tot de host Beschikbaar wordt weergegeven.
In een antwoord in de thread stond een lichtere variant. Learn toont registerwaarden onder HKLM:\SOFTWARE\Microsoft\RDInfraAgent: zet IsRegistered op 0, plaats de nieuwe sleutel in RegistrationToken, start de boot loader opnieuw en controleer daarna of IsRegistered op 1 staat en het tokenveld leeg is. Gebruik dit alleen bij de fouten INVALID_REGISTRATION_TOKEN en EXPIRED_MACHINE_TOKEN.
Koppel een VM op basis van een golden image niet aan een hostpool door de agent erop te installeren. De Learn-pagina over golden images zegt dat sessiehosts die uit zo'n image zijn gemaakt later niet aan de hostpool kunnen koppelen omdat het registratietoken is verlopen, en dat het implementatieproces van de hostpool de sessiehosts tijdens de inrichting koppelt.
Verificatie
- De host toont binnen enkele minuten Beschikbaar. Na de volledige herinstallatie adviseert Learn 5 tot 10 minuten te wachten.
- In de portal tonen de details geen mislukte controle.
- Een testgebruiker kan verbinding maken en de sessie komt op die host terecht.
- Event Viewer toont geen nieuwe 3277-gebeurtenissen.
Beperkingen
- Slechts één van de threads heeft een bevestigde oorzaak: een ontbrekende domeintoevoeging.
- De thread over het schaalplan eindigde zonder oplossing, dus de stappen in stap 5 zijn een vergelijking met Learn en geen bewezen remedie.
- Als de host na een schone herinstallatie nog steeds Unavailable is, verzamel dan de naam van de mislukte controle, de event-ID's met UTC-tijden en de naam van de host pool, en open een supportcase.
Gerelateerd
Bronnen
- Microsoft Learn: Problemen met de Azure Virtual Desktop-agent oplossen
- Microsoft Learn: Configuratieproblemen van de Azure Virtual Desktop-sessiehost oplossen
- Microsoft Learn: Statussen van sessiehosts en statuscontroles
- Microsoft Learn: Vereiste FQDN's en eindpunten
- Microsoft Learn: Een golden image instellen
- Microsoft Learn: Een autoscale-schaalplan maken en toewijzen
- Microsoft Q&A: Azure Virtual Desktop-sessiehost is niet beschikbaar (september 2025)
- Microsoft Q&A: AVD-sessiehosts worden onbeschikbaar na inschakelen van schaalplan (juni 2026)