Azure Virtual Desktop: host sesji pokazuje stan Unavailable – lista kontrolna krok po kroku
By Mirko Peters ·
Host sesji, który działa, ale w puli hostów ma stan Unavailable, nie może obsłużyć użytkowników. Najpierw przeczytaj nieudane sprawdzenie stanu, a następnie sprawdź przyłączenie do domeny, usługi, adresy URL, automatyczne skalowanie i rejestrację agenta.
Automatically translated with AI from the original post. Read the English original
Otwierasz pulę hostów w portalu Azure. Maszyny wirtualne są uruchomione. Hosty sesji pokazują Unavailable. Użytkownicy nie mogą się połączyć albo łączą się tylko z jednym hostem, który jest jeszcze sprawny.
Najważniejsze wnioski
- Maszyna wirtualna w stanie Running nic nie mówi o agencie AVD. Stan hosta pochodzi z sprawdzeń stanu wykonywanych przez agenta.
- Nieudane przyłączenie do domeny albo uszkodzony nasłuchiwacz stosu side-by-side to krytyczne sprawdzenie. Nieudane sprawdzenie agenta monitorowania, usługi metadanych lub adresów URL jest wymienione jako niekrytyczne i prowadzi do stanu Needs Assistance.
- Po tym, jak plan automatycznego skalowania uruchomi i zatrzyma hosty, sprawdź role na poziomie subskrypcji, tryb opróżniania (drain mode) i usługi agenta, zanim cokolwiek zainstalujesz ponownie.
- Ponowną instalację agenta i modułu rozruchowego z nowym kluczem rejestracji wykonaj dopiero wtedy, gdy tańsze sprawdzenia nie dały rezultatu.
Wątki w Microsoft Q&A z lat 2025 i 2026 poruszają ten temat. Jeden z pytających w nowym środowisku naprawił problem, ręcznie przyłączając maszynę wirtualną do domeny. Inny zauważył, że hosty przechodziły w stan Unavailable jeden po drugim po włączeniu planu skalowania, a wątek nie zakończył się potwierdzonym rozwiązaniem. Ten artykuł postępuje zgodnie z kolejnością zalecaną przez Microsoft Learn i dodaje uwagi z tych wątków. Nie jest to oficjalna procedura firmy Microsoft. Sprawdź każdy krok na aktualnych stronach Learn, ponieważ artykuł o rozwiązywaniu problemów z agentem oraz artykuł o konfiguracji hosta sesji są starsze niż niektóre pozostałe strony.
Co widzisz
- Pula hostów, a następnie Session hosts: stan Unavailable, czasami Needs Assistance lub Upgrading.
- Sama maszyna wirtualna jest w stanie Running.
- Po ponownym uruchomieniu maszyna wirtualna działa ponownie, ale host pozostaje w stanie Unavailable.
- W przypadku planu skalowania hosty przechodzą w stan Unavailable stopniowo, a nie wszystkie naraz.
Krok 1: Odczytaj nieudane sprawdzenie stanu
W portalu otwórz pulę hostów, wybierz Session hosts i sprawdź szczegóły jednego z dotkniętych hostów. Learn opisuje stany w następujący sposób:
- Available: wszystkie sprawdzenia zakończyły się powodzeniem.
- Needs Assistance: nie powiodło się niekrytyczne sprawdzenie. Dotyczy to agenta monitorowania, usługi Azure Instance Metadata Service oraz sprawdzenia adresów URL. Użytkownicy nadal mogą się połączyć.
- Unavailable: host jest wyłączony albo nie przeszedł krytycznego sprawdzenia.
- Upgrading lub Upgrade Failed: aktualizacja agenta trwa albo się nie powiodła.
Krytyczne sprawdzenia na stronie Learn to: sprawdzenie przyłączenia do domeny, sprawdzenie zaufania domeny oraz sprawdzenie nasłuchiwania stosu side-by-side. Pierwsze z nich jest tym, na czym zakończył się wątek z 2025 roku.
Krok 2: Sprawdź przyłączenie do domeny
Wątek z potwierdzonym rozwiązaniem zaczął się od użytkownika, który nie mógł połączyć się z nowym środowiskiem. Wolontariusz-moderator zasugerował standardowy przewodnik wdrażania oraz AVD Insights. Niezależny doradca wymienił ogólne sprawdzenia: dzienniki zdarzeń, przyłączenie do domeny lub Azure AD, otwarte porty, agent niestandardowego obrazu oraz stan usługi. Autor pytania napisał później, że maszyna wirtualna sama nie dołączyła do domeny, a ręczne dołączenie i ponowne uruchomienie rozwiązało problem.
Sprawdź to na maszynie wirtualnej:
- Zaloguj się do maszyny wirtualnej na konto administratora lokalnego i sprawdź, czy komputer jest członkiem Twojej domeny.
- Z wiersza poleceń na maszynie wirtualnej wykonaj ping nazwy domeny, aby sprawdzić, czy jest ona poprawnie rozpoznawana. Learn podaje to jako podstawowy test.
Microsoft Learn wymienia typowe przyczyny nieudanego przyłączenia w artykule o konfiguracji hosta sesji: nieprawidłowe poświadczenia w szablonie wdrożenia, uwierzytelnianie wieloskładnikowe na koncie przyłączającym, brak uprawnień oraz problemy z DNS. W przypadku DNS sieć wirtualna maszyn musi mieć dostęp do sieci domeny (na przykład dzięki peeringowi), DNS sieci musi wskazywać kontrolery domeny, a karta sieciowa (NIC) musi dziedziczyć lub używać tych samych serwerów DNS.
Sprawdź też kwestię ponownego użycia nazwy konta komputera. Learn podaje, że ponowne użycie może być zablokowane, gdy zainstalowane są aktualizacje systemu Windows wydane 11 października 2022 r. lub później, a konto przyłączające nie ma uprawnień do ponownego użycia kont komputerów. Learn wskazuje trzy wyjścia: użyć konta, które utworzyło konto komputera, użyć członka grupy Administratorzy domeny albo użyć konta objętego ustawieniem zasad grupy, które zezwala na ponowne użycie konta komputera podczas przyłączania do domeny.
Krok 3: Sprawdź usługi agenta
Połącz się z maszyną wirtualną. Jeśli RDP nie działa, można skorzystać z funkcji Run Command w portalu Azure, jak zasugerowano w jednej z odpowiedzi.
- Otwórz
services.msci sprawdź, czy usługa Remote Desktop Agent Loader (moduł ładujący, nazwa usługiRDAgentBootLoader) jest uruchomiona. Jeśli jest zatrzymana, uruchom ją. Jedna z odpowiedzi w wątku o planie skalowania wskazywała również usługęRDAgentdo sprawdzenia. Strona z rozwiązywaniem problemów z agentem w Microsoft Learn wymienia w tym kroku wyłącznie usługę Remote Desktop Agent Loader, więc tę drugą informację należy traktować jako zgłoszoną w wątku społeczności, a nie potwierdzoną w Microsoft Learn. - Otwórz Podgląd zdarzeń, a następnie Dzienniki systemu Windows, potem Aplikacja. Learn wymienia źródła WVD-Agent, WVD-Agent-Updater, RDAgentBootLoader i MsiInstaller. Większość błędów to zdarzenia o identyfikatorze 3277 ze słowem kluczowym w komunikacie.
- Jeśli program ładujący zatrzyma się ponownie po uruchomieniu, podejrzewaj problem z rejestracją (krok 6).
Jeśli maszyna wirtualna uruchamia się wolno, strona Learn opisuje też przypadek przekroczenia limitu czasu rozruchu: ustaw typ uruchamiania programu ładującego na Automatyczny (opóźniony start), a w razie potrzeby zwiększ wartość ServicesPipeTimeout, zaczynając od 60000 milisekund.
Krok 4: Sprawdź łączność z usługą
Hosty sesji potrzebują tylko dostępu wychodzącego. Wymagana przez Learn lista punktów końcowych obejmuje .wvd.microsoft.com na porcie TCP 443, login.microsoftonline.com, punkty końcowe monitorowania gcs.prod.monitoring.core.windows.net oraz .prod.warm.ingest.monitor.core.windows.net, a także adresy infrastruktury Azure 169.254.169.254 (metadane) i 168.63.129.16 (WireServer). Learn wskazuje, że ruch do tych dwóch adresów nie może być przechwytywany, kierowany przez serwer proxy ani przekierowywany. Zaleca tagi usług i tagi FQDN, ponieważ nie publikuje listy zakresów adresów IP do dopuszczenia zamiast nazw FQDN.
Testuj w tej kolejności:
- Uruchom na hoście sesji narzędzie Azure Virtual Desktop Agent URL Tool. Sprawdza ono każdy wymagany punkt końcowy.
- W przypadku zdarzenia
INVALID_FORMLearn każe odczytać wartościBrokerResourceIdURIiBrokerResourceIdURIGlobalw kluczuHKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\RDInfraAgent, dołączyć/api/healthdo każdego adresu i otworzyć go w przeglądarce. Prawidłowy wynik oznacza, że broker jest sprawny. - Sprawdź, czy na ścieżce nie ma inspekcji TLS, serwera proxy ani własnego DNS.
Jeden z wątków dotyczących planu skalowania sugerował testowanie innego adresu kondycji w domenie rdweb.wvd.microsoft.com. Nie znalazłem tego adresu na stronach Learn, dlatego go nie polecam. Użyj wartości brokera z rejestru.
Ten wątek twierdził też, że brakujące punkty końcowe monitorowania powodują błędy sygnału pulsu. Learn wymienia sprawdzenie agenta monitorowania wśród kontroli niekrytycznych, które skutkują stanem Wymaga pomocy, a nie Niedostępna (w tabeli kontroli kondycji nazywa tę kontrolę częściowo krytyczną). Mimo to otwórz te punkty końcowe, ale nie przerywaj szukania, jeśli host pozostaje Niedostępna.
Krok 5: Jeśli problem zaczął się po włączeniu planu skalowania
Wątek o planach skalowania został opublikowany w czerwcu 2026 roku. Hosty przechodziły w stan Niedostępna jeden po drugim po włączeniu planu. Otwarcie nazw zapory i ponowne uruchomienie maszyn wirtualnych nie naprawiło większości z nich. Dwie odpowiedzi wymieniały kontrole, ale żadna nie została zaakceptowana.
Dokumentacja Microsoft Learn wyjaśnia, jak działa automatyczne skalowanie, i warto to porównać:
- Role na poziomie subskrypcji. Jednostka usługi lub tożsamość zarządzana grupy hostów potrzebuje roli Desktop Virtualization Power On Off Contributor, przypisanej na poziomie subskrypcji. Learn ostrzega, że węższy zakres może uniemożliwić prawidłowe działanie automatycznego skalowania.
- Tryb opróżniania. W fazie redukcji automatyczne skalowanie przełącza host z najmniejszą liczbą sesji w tryb opróżniania, wylogowuje użytkowników po upływie czasu oczekiwania i zwalnia maszynę wirtualną. Jedna z odpowiedzi w wątku o planie skalowania sugerowała, żeby po ponownym uruchomieniu sprawdzić w portalu kolumnę Zezwalaj na nowe sesje, ponieważ tryb opróżniania może się utrzymywać. Strona Learn o automatycznym skalowaniu tego nie opisuje, więc traktuj to jako informację z wątku społeczności.
- Tag wykluczenia. Hosty z tagiem wykluczenia są pomijane przez automatyczne skalowanie. Użyj go na hoście testowym, aby sprawdzić, czy to plan jest przyczyną.
- Minimalny procent hostów. Automatyczne skalowanie go respektuje i wyłącza host tylko wtedy, gdy pozostałe hosty mogą obsłużyć sesje. Nie znalazłem w Learn tekstu o hoście, który został uruchomiony przez automatyczne skalowanie, a mimo to nie zgłasza się do usługi, więc po uruchomieniu powtórz kroki od 2 do 4 na tym hoście.
- Brak mieszanego skalowania. Learn mówi, że na tej samej grupie hostów nie można używać jednocześnie automatycznego skalowania i starszego skalowania opartego na Azure Automation lub Logic Apps.
Do diagnostyki Learn ma stronę o konfigurowaniu diagnostyki automatycznego skalowania (Set up diagnostics for Autoscale), która zawiera odnośnik do najczęściej zadawanych pytań o automatycznym skalowaniu.
Krok 6: Ponowna rejestracja lub ponowna instalacja agenta
Wykonaj to, gdy powyższe kontrole nie wskazują przyczyny lub gdy dziennik pokazuje INVALID_REGISTRATION_TOKEN albo EXPIRED_MACHINE_TOKEN. W przypadku NAME_ALREADY_REGISTERED Learn podaje, że nazwa maszyny wirtualnej jest prawdopodobnie zduplikowana: usuń hosta sesji z grupy hostów, utwórz maszynę wirtualną o unikatowej nazwie i dodaj ją ponownie. Pełna procedura ponownej instalacji według Learn:
- Odinstaluj te składniki w Programy i funkcje, a następnie uruchom ponownie komputer: Remote Desktop Agent Boot Loader, Remote Desktop Services Infrastructure Agent, Remote Desktop Services Infrastructure Geneva Agent oraz Remote Desktop Services SxS Network Stack. Jeśli łączysz się przez RDP, przy usuwaniu stosu SxS wybierz opcję, aby nie zamykać aplikacji.
- Usuń hosta sesji z grupy hostów: Azure Virtual Desktop, Grupy hostów, wybrana grupa, Hosty sesji, zaznacz hosta, Usuń.
- Wygeneruj nowy klucz rejestracji na stronie Klucz rejestracji grupy hostów. Musi być ważny co najmniej jedną godzinę i nie dłużej niż 27 dni.
- Zainstaluj aktualny agent i program ładujący. Wklej klucz do instalatora agenta, a następnie uruchom instalator programu ładującego i uruchom ponownie maszynę.
- Poczekaj, aż host pokaże stan Dostępna.
Jedna z odpowiedzi w wątku sugerowała lżejszy wariant. Learn pokazuje wartości rejestru w HKLM:\SOFTWARE\Microsoft\RDInfraAgent: ustaw IsRegistered na 0, wpisz nowy klucz w RegistrationToken, uruchom ponownie program ładujący, a następnie sprawdź, czy IsRegistered ma wartość 1, a pole tokenu jest puste. Stosuj go tylko w przypadku błędów INVALID_REGISTRATION_TOKEN i EXPIRED_MACHINE_TOKEN.
Nie dołączaj maszyny wirtualnej z obrazu wzorcowego (golden image) do grupy hostów przez wdrożenie na niej agenta. Strona Learn o obrazach wzorcowych podaje, że hosty sesji utworzone z takiego obrazu później nie dołączają do grupy hostów, ponieważ token rejestracji wygasł, a proces wdrażania grupy hostów dołącza hosty sesji podczas aprowizacji.
Weryfikacja
- Host pokazuje stan Dostępna w ciągu kilku minut. Po pełnej ponownej instalacji Learn zaleca odczekanie od 5 do 10 minut.
- W portalu szczegóły nie pokazują żadnej nieudanej kontroli.
- Testowy użytkownik może się połączyć, a sesja trafia na ten host.
- Podgląd zdarzeń nie pokazuje żadnych nowych zdarzeń 3277.
Ograniczenia
- Tylko jeden z wątków ma potwierdzoną przyczynę, czyli brakujące dołączenie do domeny.
- Wątek dotyczący planu skalowania zakończył się bez rozwiązania, więc kroki z kroku 5 są porównaniem z dokumentacją Learn, a nie sprawdzonym rozwiązaniem.
- Jeśli host nadal ma status Niedostępny po czystej reinstalacji, zbierz nazwę nieudanego sprawdzenia, identyfikatory zdarzeń z czasem UTC oraz nazwę puli hostów, a następnie otwórz zgłoszenie do pomocy technicznej.
Powiązane
Źródła
- Microsoft Learn: Rozwiązywanie problemów z agentem usługi Azure Virtual Desktop
- Microsoft Learn: Rozwiązywanie problemów z konfiguracją hosta sesji usługi Azure Virtual Desktop
- Microsoft Learn: Stany hosta sesji i sprawdzenia kondycji
- Microsoft Learn: Wymagane nazwy FQDN i punkty końcowe
- Microsoft Learn: Konfigurowanie obrazu wzorcowego
- Microsoft Learn: Tworzenie i przypisywanie planu automatycznego skalowania
- Microsoft Q&A: Host sesji usługi Azure Virtual Desktop jest niedostępny (wrzesień 2025)
- Microsoft Q&A: Hosty sesji AVD stają się niedostępne po włączeniu planu skalowania (czerwiec 2026)