M365Con 2027 – bezpłatna konferencja online · 11–22 Jan 2027 · 120 sessions m365con.net

Blog · Mirko Peters

Jak używać trybu wyłączania (drain mode) do poprawek i prac konserwacyjnych hostów sesji

Partner · Neutralny partner: Nerdio

By ·

Procedura dla jednego hosta sesji Azure Virtual Desktop wycofywanego z eksploatacji: zabezpieczenie go przed automatycznym skalowaniem, włączenie trybu wyłączania, ostrzeżenie i zakończenie pozostałych sesji, wykonanie prac, a następnie wyłączenie trybu wyłączania.

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

Aby załatać jeden host sesji bez odcinania użytkowników, oznacz maszynę wirtualną tak, aby automatyczne skalowanie jej nie ruszało, włącz tryb wyłączania, przekaż pozostałym użytkownikom wiadomość i termin, zakończ ewentualne pozostałe sesje, zainstaluj poprawki i uruchom ponownie, a następnie wyłącz tryb wyłączania.

Najważniejsze wnioski

  • Tryb wyłączania blokuje nowe sesje na hoście. Istniejące sesje pozostają aktywne, dopóki użytkownik się nie wyloguje lub administrator ich nie zakończy.
  • Użytkownik, który ma już aktywną lub rozłączoną sesję w puli, nadal jest kierowany na ten host, nawet w trybie wyłączania, dlatego przed poprawkami wyświetl i zakończ sesje.
  • W pulach hostów współdzielonych automatyczne skalowanie zastępuje tryb wyłączania na każdej maszynie wirtualnej objętej skalowaniem, dlatego najpierw ustaw tag wykluczenia w planie skalowania. W pulach osobistych automatyczne skalowanie nie ustawia trybu wyłączania.
  • Do włączenia trybu wyłączania potrzebna jest rola Operator hosta sesji pulpitu wirtualnego (Desktop Virtualization Session Host Operator); do wysyłania komunikatów i wylogowywania użytkowników – rola Operator sesji użytkownika (User Session Operator). Sprawdź rzeczywiste uprawnienia konta, na którym działa procedura.
  • W przypadku aktualizacji obrazów hostów korzystających z konfiguracji hosta sesji aktualizacja hosta sesji sama obsługuje tryb wyłączania, a Learn zaleca, by podczas aktualizacji nie zmieniać go ręcznie.

Ten artykuł to procedura dla pojedynczego hosta. Czym jest tryb wyłączania, wyjaśnia artykuł „Drain mode in Azure Virtual Desktop explained”. Planowaniem fal aktualizacji dla całej puli hostów, z rozmiarami fal i pojemnością, zajmuje się artykuł „Patching AVD without downtime: rolling updates with drain mode”. Mechanizm tagu wykluczenia, w tym sposób jego stosowania, opisano w artykule „How to use the exclusion tag for maintenance windows and special session hosts”.

Czego potrzebujesz przed rozpoczęciem

  • Role. Microsoft Learn podaje, że włączenie lub wyłączenie trybu drain wymaga roli Desktop Virtualization Session Host Operator. Opis tej roli na stronie RBAC dodaje, że pozwala ona wyświetlać i usuwać hosty sesji oraz zmieniać tryb drain. Wysyłanie komunikatów, rozłączanie sesji i wylogowywanie użytkowników należy do roli Desktop Virtualization User Session Operator, która zgodnie ze stroną RBAC nie pozwala zmieniać trybu drain. Wbudowana definicja roli Session Host Operator obejmuje Microsoft.DesktopVirtualization/hostpools/sessionhosts/, a definicja User Session Operator wymienia wprost .../sessionhosts/usersessions/. To, czy jedno konto może wykonać oba kroki, zależy więc od faktycznie przypisanych ról, dlatego przetestuj to na koncie, które będzie uruchamiać runbook.
  • Azure PowerShell z modułem Az.DesktopVirtualization lub Azure Cloud Shell, jeśli chcesz zautomatyzować ten proces skryptem.
  • Pojemność. Learn podaje, że nowe połączenia trafiają na następny dostępny host sesji, dlatego sprawdź, czy pozostałe hosty udźwigną obciążenie. W puli działającej w trybie „depth-first” sprawdź także maksymalny limit sesji, ponieważ Learn podaje, że po osiągnięciu go przez wszystkie hosty trzeba go podnieść lub dodać hosty.

Krok po kroku

  1. Nie pozwól autoskalowaniu działać na hoście (pule hostów z pulą). Strona Learn dotycząca scenariuszy mówi, że w przypadku puli hostów z pulą autoskalowanie nadpisuje tryb opróżniania, a FAQ dotyczące autoskalowania wskazuje, że autoskalowanie nadal włącza lub wyłącza maszyny wirtualne w trybie opróżniania, niezależnie od tego, kto ten tryb ustawił, ponieważ zastępuje tryb opróżniania na wszystkich maszynach wirtualnych objętych skalowaniem. Tag wykluczenia to nazwa tagu, którą wpisujesz na karcie Podstawowe planu skalowania (na karcie Właściwości istniejącego planu). Przykładem z Learn jest excludeFromScaling. To pole istnieje dla planów zarządzania energią i planów dynamicznych, które dotyczą wyłącznie pul hostów z pulą z konfiguracją hosta sesji. Gdy tag jest ustawiony na hoście sesji, autoskalowanie nie uruchamia, nie zatrzymuje ani nie zmienia trybu opróżniania tego hosta. Dodaj do maszyny wirtualnej tag o tej nazwie. Uprawnienia do tagów i dalsze szczegóły znajdziesz w wymienionym wyżej artykule o tagu wykluczenia. Informacje o osobistych pulach hostów znajdziesz w dalszej części tekstu.
  2. Włącz tryb opróżniania. W Azure Portal otwórz Azure Virtual Desktop, następnie Pule hostów, wybierz pulę hostów, wybierz Hosty sesji, zaznacz host i wybierz Włącz tryb opróżniania. W Azure PowerShell strona Learn dotycząca trybu opróżniania ustawia ten tryb parametrem AllowNewSession polecenia Update-AzWvdSessionHost, uruchamianym raz dla każdego hosta sesji. Strona używa tabeli skrótów $params z wartością AllowNewSession = $False i przekazuje ją do polecenia przez splatting; to samo wywołanie w jednym bloku, w formie przykładu z dokumentacji polecenia, wygląda następująco:
Update-AzWvdSessionHost -ResourceGroupName <ResourceGroupName> `
    -HostPoolName <HostPoolName> `
    -Name <SessionHostName> `
    -AllowNewSession:$false

Learn ostrzega, że stan w portalu może wyglądać na nieaktualny, jeśli odświeżysz go od razu. Najpierw odczekaj co najmniej 60 sekund.

  1. Wypisz sesje pozostałe na hoście.
Get-AzWvdUserSession -ResourceGroupName <ResourceGroupName> `
    -HostPoolName <HostPoolName> -SessionHostName <SessionHostName>

Przykładowe dane wyjściowe w Learn podają każdą sesję w postaci HostPoolName/SessionHostName/2, a dokumentacja polecenia Remove-AzWvdUserSession przyjmuje numer sesji jako -Id (alias UserSessionId), więc jako identyfikatora sesji użyj ostatniej części nazwy.

  1. Ostrzeż użytkowników. Dokumentacja Learn pokazuje taką postać, w której tytuł i treść komunikatu są dowolnym tekstem:
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.'

Podaj termin, którego możesz dotrzymać.

  1. Zakończ pozostałe sesje. Po upływie terminu usuń pozostałe sesje:
Remove-AzWvdUserSession -ResourceGroupName <ResourceGroupName> `
    -HostPoolName <HostPoolName> -SessionHostName <SessionHostName> -Id <id>

Strona dokumentacji wymienia też parametr -Force („Specify to force userSession deletion”), ale nie pokazuje przykładu z jego użyciem. Usunięcie sesji ją kończy, więc wszystko, czego użytkownik nie zapisał, zostanie utracone. Dlatego krok 4 wykonujemy jako pierwszy.

  1. Wykonaj konserwację. Learn podaje, że gdy nie pozostaje żadna sesja, możesz wykonać potrzebną konserwację, a administratorzy nadal mogą łączyć się z serwerem bezpośrednio, bez przechodzenia przez usługę Azure Virtual Desktop. Sama instalacja poprawek przez Windows Update, Intune, WSUS lub inne narzędzie wykracza poza ten artykuł, ale najpierw sprawdź, jak Learn ocenia poprawki instalowane na miejscu dla Twojego systemu operacyjnego (zob. ostatnia sekcja). Jeśli host po tym nie wróci do stanu dostępnego, skorzystaj z listy kontrolnej w powiązanym artykule „Azure Virtual Desktop Session Host Shows Unavailable: A Step-by-Step Checklist”.
  2. Wyłącz tryb opróżniania. W portalu zaznacz host i wybierz Wyłącz tryb opróżniania. W PowerShell uruchom to samo polecenie z parametrem -AllowNewSession:$true; strona Learn dotycząca trybu opróżniania pokazuje oba kierunki: $False, aby włączyć tryb opróżniania, i $True, aby go wyłączyć. Przed sprawdzeniem stanu w portalu odczekaj co najmniej 60 sekund. Następnie usuń tag wykluczenia, aby autoskalowanie ponownie zarządzało hostem.

Zachowania, które zaskakują

  • Rozłączone sesje wracają. Strona Learn dotycząca równoważenia obciążenia mówi, że użytkownik z aktywną lub rozłączoną sesją, który loguje się ponownie, zostaje skierowany na host z tą sesją, nawet w trybie opróżniania. Użytkownik bez sesji nigdy nie zostanie skierowany na opróżniany host. Dlatego krok 3 jest ważny: host, który wygląda na pusty, może nadal mieć rozłączone sesje.
  • Host w puli z pulą bez tagu nadal podlega skalowaniu. Jeśli ręcznie opróżnisz host w puli hostów z pulą i nie oznaczysz go tagiem, autoskalowanie nadal może go uruchamiać, zatrzymywać lub zmieniać jego tryb opróżniania, zgodnie z FAQ. Z wyłączenia hosta ze skalowania zdejmuje go tag, a nie sam tryb opróżniania.
  • Niezapisana praca przepada. Remove-AzWvdUserSession kończy sesję. Dokumentacja Learn nie opisuje sposobu odzyskania sesji, dlatego najpierw wyślij komunikat z kroku 4.
  • Pozostawiony tag blokuje host przed skalowaniem. Według Learn hosty z tagiem nadal wliczają się do obliczania minimalnego procentu hostów, ale automatyczne skalowanie ich nie uruchamia. Usuń tag w kroku 7. Dopóki tag pozostaje, automatyczne skalowanie nie uruchomi tego hosta, nawet gdy pula potrzebuje zasobów. Scenariusz 4 w Learn opisuje użytkowników, którzy widzą komunikat „No resources available”, gdy wszystkie hosty w puli są oznaczone tagiem i wyłączone.

Przykładowy harmonogram dla jednego hosta

Podane czasy są wymyślone na potrzeby ilustracji i nie stanowią zalecenia Microsoftu. Jeden host puli, avd-host-03, jest aktualizowany w wieczór w dzień roboczy.

CzasDziałanie
17:30Oznacz maszynę wirtualną tagiem, włącz tryb opróżniania i wyświetl listę sesji (kroki 1–3).
17:35Wyślij komunikat do każdej pozostałej sesji: zapisz pracę, wyloguj się, host zostanie zaktualizowany o 18:30 (krok 4).
18:30Zakończ pozostałe sesje, w tym rozłączone (krok 5).
18:35Zainstaluj aktualizacje i uruchom ponownie (krok 6).
19:15Potwierdź, że host zgłasza stan dostępny, wyłącz tryb opróżniania i usuń tag (krok 7).

Przed rozpoczęciem sprawdź, czy pozostałe hosty udźwigną wieczorne obciążenie. Powiązany artykuł o aktualizacjach zbiorczych (rolling updates) wyjaśnia, ile hostów można wyłączyć jednocześnie.

Osobiste pule hostów

FAQ Learn mówi, że automatyczne skalowanie nie przełącza osobistego hosta w tryb opróżniania przed zwolnieniem jego przydziału (deallocate), a użytkownik, który połączy się w trakcie zwalniania, zobaczy komunikat „No resources available”. FAQ dodaje też, że jeśli host sesji zostanie włączony przez automatyczne skalowanie, funkcję Start VM on Connect lub administratora, a nikt się do niego nie zaloguje, automatyczne skalowanie zwolni jego przydział po okresie bezczynności, którego strona nie określa. Dotyczy to Ciebie, jeśli pula ma plan skalowania: osobisty host uruchomiony do aktualizacji, bez logowania użytkownika, może zostać zwolniony w trakcie pracy. Learn opisuje pole tagu wykluczenia dla planów zarządzania zasilaniem bez ograniczania go do pul współdzielonych, ale nie wyjaśnia dokładnie jego wpływu na pule osobistych hostów. Oznaczenie osobistego hosta tagiem przed uruchomieniem maszyny wirtualnej jest więc środkiem ostrożności, który sugeruje ten artykuł, a nie udokumentowaną gwarancją. Sprawdź to na hoście testowym. Poinformuj też przypisanego użytkownika, ponieważ osobisty host sesji jest przypisany do jednego użytkownika.

Kiedy tryb opróżniania jest złym narzędziem

Strona Learn o metodach aktualizacji hostów sesji ocenia aktualizowanie na miejscu według systemu operacyjnego. Dla wieloseesyjnych hostów Windows client Learn oznacza Windows Update jako „Niezalecane” w przypadku aktualizacji miesięcznych i funkcji, a WSUS jako „Niezalecane” w przypadku aktualizacji funkcji. Aktualizację hosta sesji i Azure Compute Gallery oznacza jako „Zalecane”. Dla Windows Server oznacza Windows Update jako „Obsługiwane”, a Azure Update Manager i automatic guest patching jako „Zalecane”. Dla Windows client Enterprise (jednosesyjnego) oznacza Windows Update jako „Zalecane”, ale pule współdzielone tego typu jako „Niezalecane”. Akapit o poprawianiu na miejscu na tej samej stronie wymienia Windows Update wśród popularnych technologii, dlatego czytaj tabele dla poszczególnych systemów, a nie samo to zdanie. Nasza interpretacja: ten runbook pasuje do hostów Windows Server, osobistych hostów oraz prac konserwacyjnych innych niż aktualizacje, takich jak zmiany konfiguracji, restarty, rozwiązywanie problemów czy wycofywanie hosta. W przypadku wielosesyjnych pul Windows client Learn zaleca aktualizację opartą na obrazie.

Jeśli aktualizujesz, zastępując obraz zamiast poprawiać go w miejscu, funkcja aktualizacji hostów sesji opisana w Microsoft Learn wykonuje tę pracę za Ciebie w przypadku hostów korzystających z konfiguracji hosta sesji. Dokumentacja podaje, że wybrane hosty są przez nią przełączane w tryb opróżniania, a podczas aktualizacji nie wolno zmieniać tego trybu ręcznie. Na tej samej stronie zalecono wyłączenie autoskalowania w puli hostów przed aktualizacją, ponieważ włączony plan skalowania może spowodować błąd środowiska uruchomieniowego. Ręczne modyfikacje, takie jak pliki, klucze rejestru i certyfikaty, nie są zachowywane po aktualizacji. Microsoft ogłosił ogólną dostępność rozszerzonego zarządzania pulami hostów, obejmującego konfigurację i aktualizację hostów sesji, w lipcu 2026 roku (Tech Community). Niektóre strony w Microsoft Learn nadal zawierają sformułowania dotyczące wersji zapoznawczej. Na przykład strona konfiguracji oznacza polecenia cmdlet Azure PowerShell dla takich pul jako wersję zapoznawczą i wymaga wersji zapoznawczej modułu Az.DesktopVirtualization. Przed przyjęciem jakiegokolwiek ograniczenia sprawdź aktualną stronę. Porównaj to podejście z aktualizacją progresywną z użyciem trybu opróżniania opisaną w artykule „Patching AVD without downtime: rolling updates with drain mode”.

Źródła

Data dostępu: 17 listopada 2026.

Obserwuj podcastApple PodcastsSpotify

FAQ

Co się dzieje z zalogowanymi użytkownikami, gdy włączę tryb wyłączania?

Nic się z nimi nie dzieje. Microsoft Learn podaje, że istniejące połączenia pozostają aktywne, dopóki użytkownik się nie wyloguje lub administrator nie zakończy sesji. Tryb wyłączania blokuje wyłącznie nowe sesje. Musisz sam poinformować użytkowników i zakończyć sesje, na przykład poleceniami Send-AzWvdUserSessionMessage i Remove-AzWvdUserSession.

Dlaczego użytkownik nadal trafia na wyłączony host?

Strona Learn dotycząca równoważenia obciążenia mówi, że użytkownik, który ma już aktywną lub rozłączoną sesję w puli hostów, jest kierowany na host, na którym ta sesja działa, nawet gdy tryb wyłączania jest włączony. Użytkownicy bez sesji nie są kierowani na wyłączony host. Rozłączone sesje sprawdzisz poleceniem Get-AzWvdUserSession.

Czy automatyczne skalowanie włączy mi z powrotem host w trakcie prac konserwacyjnych?

W puli hostów współdzielonych może. FAQ Learn dotyczące automatycznego skalowania mówi, że skalowanie zastępuje tryb wyłączania na wszystkich maszynach wirtualnych objętych skalowaniem. Aby wyłączyć maszynę wirtualną z działań skalowania, użyj tagu wykluczenia ustawionego w planie skalowania: Learn podaje, że wtedy automatyczne skalowanie nie uruchamia, nie zatrzymuje ani nie zmienia trybu wyłączania oznaczonych hostów. W pulach hostów osobistych FAQ podaje, że automatyczne skalowanie nie włącza trybu wyłączania na hoście sesji, ale nadal może zwolnić zasoby hosta, na którym nikt się nie zalogował.

Entities in this article

Tematy tego artykułu:

Drain mode (Azure Virtual Desktop) – Pojęcie Session host (Azure Virtual Desktop) – Część Azure Virtual Desktop

Related articles

Więcej artykułów (temat: Session host (Azure Virtual Desktop)):

RSS