M365Con 2027 – konferensi online gratis · 11–22 Jan 2027 · 120 sessions m365con.net

Blog · Mirko Peters

Cara menggunakan drain mode untuk patching dan pemeliharaan session host

Mitra · Mitra netral: Nerdio

By ·

Runbook untuk mengeluarkan satu session host Azure Virtual Desktop dari layanan: lindungi dari autoscale, aktifkan drain mode, beri peringatan dan akhiri sesi yang tersisa, lakukan pekerjaannya, lalu nonaktifkan drain mode.

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

Untuk melakukan patching pada satu session host tanpa memutus pengguna, beri tag pada VM agar autoscale tidak menyentuhnya, aktifkan drain mode, kirim pesan dan tenggat waktu kepada pengguna yang tersisa, akhiri sesi yang masih ada, lakukan patching dan restart, lalu nonaktifkan drain mode.

Poin Penting

  • Drain mode menghentikan sesi baru pada sebuah host. Sesi yang sudah ada tetap berjalan sampai pengguna keluar atau administrator mengakhirinya.
  • Pengguna yang sudah memiliki sesi aktif atau terputus di pool tetap dialihkan kembali ke host tersebut, bahkan dalam drain mode. Karena itu, daftar dan akhiri sesi sebelum Anda melakukan patching.
  • Pada host pool bersama, autoscale menimpa drain mode pada setiap VM dalam cakupan, jadi atur tag pengecualian pada scaling plan terlebih dahulu. Pada pool personal, autoscale tidak mengatur drain mode.
  • Drain mode memerlukan peran Desktop Virtualization Session Host Operator; mengirim pesan dan mengeluarkan pengguna memerlukan User Session Operator. Periksa izin efektif akun yang menjalankan runbook ini.
  • Untuk pembaruan berbasis image pada host yang menggunakan konfigurasi session host, session host update menangani drain mode sendiri, dan Learn menyarankan agar Anda tidak mengubahnya secara manual selama pembaruan.

Artikel ini adalah runbook untuk satu host. Apa itu drain mode dijelaskan dalam "Drain mode in Azure Virtual Desktop explained". Perencanaan gelombang (wave) di seluruh host pool, termasuk ukuran wave dan kapasitas, dibahas dalam "Patching AVD without downtime: rolling updates with drain mode". Mekanisme tag pengecualian, termasuk cara menerapkannya, ada dalam "How to use the exclusion tag for maintenance windows and special session hosts".

Yang perlu disiapkan sebelum memulai

  • Peran. Microsoft Learn menyebutkan bahwa mengaktifkan atau menonaktifkan drain mode memerlukan peran Desktop Virtualization Session Host Operator. Deskripsinya di halaman RBAC menambahkan bahwa peran tersebut dapat melihat dan menghapus session host serta mengubah drain mode. Mengirim pesan, memutus sesi, dan mengeluarkan pengguna dicakup oleh peran Desktop Virtualization User Session Operator, yang menurut halaman RBAC tidak mengizinkan perubahan drain mode. Definisi bawaan peran Session Host Operator mencantumkan Microsoft.DesktopVirtualization/hostpools/sessionhosts/, sedangkan definisi User Session Operator mencantumkan .../sessionhosts/usersessions/ secara eksplisit. Apakah satu akun dapat melakukan kedua langkah tersebut bergantung pada peran yang benar-benar ditetapkan, jadi uji dengan akun yang akan menjalankan runbook.
  • Azure PowerShell dengan modul Az.DesktopVirtualization, atau Azure Cloud Shell, jika Anda ingin membuat skripnya.
  • Kapasitas. Learn menyatakan bahwa koneksi baru diarahkan ke session host yang tersedia berikutnya, jadi pastikan host yang tersisa mampu menanggung beban. Untuk pool depth-first, periksa juga batas maksimum sesi, karena Learn menyatakan bahwa setelah semua host mencapainya, Anda harus menaikkan batas tersebut atau menambah host.

Langkah demi langkah

  1. Jauhkan autoscale dari host (kumpulan host bersama/pooled). Halaman skenario di Learn menyebutkan bahwa untuk kumpulan host bersama, autoscale menimpa mode drain, dan FAQ autoscale menyebutkan bahwa autoscale tetap menyalakan atau mematikan VM yang di-drain, siapa pun yang mengaktifkan mode drain, karena autoscale menimpa mode drain pada semua VM yang termasuk dalam penskalaan. Tag pengecualian adalah nama tag yang Anda masukkan di tab Basics dari rencana penskalaan (di tab Properties pada rencana yang sudah ada). Contoh dari Learn adalah excludeFromScaling. Kolom ini tersedia untuk rencana manajemen daya dan rencana dinamis, yang hanya berlaku untuk kumpulan host bersama dengan konfigurasi session host. Dengan tag ini pada session host, autoscale tidak memulai, menghentikan, atau mengubah mode drain host tersebut. Tambahkan tag dengan nama tersebut ke VM. Izin tag dan detail lainnya ada di artikel tag pengecualian yang disebutkan di atas. Untuk kumpulan host pribadi, lihat bagian di bawah.
  2. Aktifkan mode drain. Di portal Azure, buka Azure Virtual Desktop, lalu Host pools, pilih kumpulan host, pilih Session hosts, centang host, dan pilih Turn drain mode on. Dengan Azure PowerShell, halaman mode drain di Learn mengatur mode drain dengan parameter AllowNewSession pada Update-AzWvdSessionHost, dijalankan satu kali untuk setiap session host. Halaman tersebut menggunakan tabel hash $params dengan AllowNewSession = $False dan melakukan splatting ke cmdlet; pemanggilan yang sama dalam satu blok, dalam bentuk contoh pada referensi cmdlet, adalah:
Update-AzWvdSessionHost -ResourceGroupName <ResourceGroupName> `
    -HostPoolName <HostPoolName> `
    -Name <SessionHostName> `
    -AllowNewSession:$false

Learn memperingatkan bahwa status di portal bisa tampak tidak sinkron jika Anda langsung menyegarkan halaman. Tunggu minimal 60 detik terlebih dahulu.

  1. Daftarkan sesi yang masih ada di host.
Get-AzWvdUserSession -ResourceGroupName <ResourceGroupName> `
    -HostPoolName <HostPoolName> -SessionHostName <SessionHostName>

Contoh output dari Learn menampilkan setiap sesi sebagai HostPoolName/SessionHostName/2, dan referensi Remove-AzWvdUserSession menerima nomor sesi sebagai -Id (alias UserSessionId), jadi gunakan bagian terakhir dari nama tersebut sebagai ID sesi.

  1. Beri peringatan kepada pengguna. Referensi Learn menunjukkan bentuk berikut, dengan judul dan isi pesan sebagai teks bebas:
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.'

Tentukan tenggat waktu yang dapat Anda penuhi.

  1. Akhiri sesi yang tersisa. Setelah tenggat waktu, hapus sesi yang tersisa:
Remove-AzWvdUserSession -ResourceGroupName <ResourceGroupName> `
    -HostPoolName <HostPoolName> -SessionHostName <SessionHostName> -Id <id>

Halaman referensi juga mencantumkan parameter -Force ("Specify to force userSession deletion"), tetapi tidak menunjukkan contoh penggunaannya. Menghapus sesi berarti mengakhirinya, sehingga pekerjaan yang belum disimpan pengguna akan hilang. Itulah sebabnya langkah 4 dilakukan lebih dulu.

  1. Lakukan pemeliharaan. Learn menyebutkan bahwa setelah tidak ada sesi yang tersisa, Anda dapat melakukan pemeliharaan yang diperlukan, dan administrator tetap dapat terhubung langsung ke server tanpa melalui layanan Azure Virtual Desktop. Proses patching itu sendiri, melalui Windows Update, Intune, WSUS, atau alat lain, berada di luar artikel ini, tetapi periksa terlebih dahulu bagaimana Learn menilai patching di tempat (in-place) untuk sistem operasi Anda (lihat bagian terakhir). Jika host tidak kembali berstatus tersedia setelahnya, gunakan daftar periksa di artikel terkait "Azure Virtual Desktop Session Host Shows Unavailable: A Step-by-Step Checklist".
  2. Matikan mode drain. Di portal, centang host dan pilih Turn drain mode off. Di PowerShell, jalankan cmdlet yang sama dengan -AllowNewSession:$true; halaman mode drain di Learn menunjukkan kedua arah, yaitu $False untuk mengaktifkan mode drain dan $True untuk mematikannya. Tunggu minimal 60 detik sebelum memeriksa status di portal. Setelah itu, hapus tag pengecualian agar autoscale kembali mengelola host tersebut.

Perilaku yang mengejutkan banyak orang

  • Sesi yang terputus kembali. Halaman penyeimbangan beban di Learn menyebutkan bahwa pengguna dengan sesi aktif atau terputus yang masuk kembali akan diarahkan ke host yang memiliki sesi tersebut, bahkan dalam mode drain. Pengguna tanpa sesi tidak akan pernah diarahkan ke host yang di-drain. Inilah alasan langkah 3 penting: host yang tampak kosong masih bisa menyimpan sesi yang terputus.
  • Host bersama yang tidak diberi tag tetap termasuk dalam cakupan. Jika Anda men-drain host di kumpulan host bersama secara manual dan tidak memberinya tag, autoscale tetap dapat memulai, menghentikan, atau mengubah mode drain host tersebut, sesuai FAQ. Yang mengeluarkan host dari penskalaan adalah tag, bukan mode drain.
  • Pekerjaan yang belum disimpan akan hilang. Remove-AzWvdUserSession mengakhiri sesi. Referensi Learn tidak menjelaskan cara memulihkan sesi, jadi kirimkan pesan pada langkah 4 terlebih dahulu.
  • Tag yang tertinggal membuat host tetap berada di luar penskalaan. Learn menyebutkan bahwa host yang diberi tag tetap dihitung dalam perhitungan persentase minimum host, tetapi autoscale tidak akan menyalakannya. Hapus tag pada langkah 7. Selama tag masih ada, autoscale tidak akan menyalakan host tersebut, meskipun kumpulan membutuhkan kapasitas tambahan. Skenario 4 dari Learn menggambarkan pengguna melihat pesan "No resources available" ketika setiap host dalam kumpulan diberi tag dan dimatikan.

Contoh garis waktu untuk satu host

Waktu-waktu ini hanya contoh ilustrasi dan bukan rekomendasi Microsoft. Satu host kumpulan, avd-host-03, diperbarui pada malam hari di hari kerja.

WaktuTindakan
17:30Beri tag pada VM, aktifkan mode drain, lalu tampilkan daftar sesi (langkah 1 sampai 3).
17:35Kirim pesan ke setiap sesi yang tersisa: simpan pekerjaan, keluar, host akan diperbarui pukul 18.30 (langkah 4).
18:30Hapus sesi yang masih tersisa, termasuk sesi yang terputus (langkah 5).
18:35Pasang pembaruan dan mulai ulang (langkah 6).
19:15Pastikan host melaporkan status tersedia, nonaktifkan mode drain, lalu hapus tag (langkah 7).

Sebelum memulai, pastikan host lain mampu menanggung beban malam hari. Artikel terkait tentang pembaruan bergulir membahas berapa banyak host yang sebaiknya dikeluarkan sekaligus.

Kumpulan host personal

FAQ Learn menyebutkan bahwa autoscale tidak memasukkan desktop personal ke mode drain sebelum melakukan deallocate, dan pengguna yang tersambung selama deallocation akan melihat pesan "No resources available". FAQ tersebut juga menyebutkan bahwa jika host sesi dinyalakan oleh autoscale, Start VM on Connect, atau administrator, dan tidak ada yang masuk ke dalamnya, autoscale akan melakukan deallocate setelah periode tidak aktif yang tidak didefinisikan di halaman tersebut. Hal ini berpengaruh jika kumpulan memiliki rencana penskalaan: host personal yang Anda nyalakan untuk pembaruan, tanpa ada pengguna yang masuk, dapat di-deallocate di tengah proses. Learn menjelaskan kolom tag pengecualian untuk rencana manajemen daya tanpa membatasinya pada kumpulan host bersama, tetapi tidak menjelaskan secara rinci efeknya pada kumpulan host personal. Oleh karena itu, memberi tag pada host personal sebelum VM dinyalakan adalah langkah pencegahan yang disarankan artikel ini, bukan jaminan yang tercantum dalam dokumentasi. Periksa hal ini pada host uji. Beri tahu juga pengguna yang ditugaskan, karena host sesi personal ditugaskan kepada satu pengguna.

Kapan mode drain bukan alat yang tepat

Halaman Learn tentang metode pembaruan untuk host sesi memberi peringkat patching di tempat (in-place) berdasarkan sistem operasi. Untuk host multi-sesi Windows client, halaman ini menandai Windows Update sebagai "Not recommended" untuk pembaruan bulanan dan fitur, serta WSUS sebagai "Not recommended" untuk pembaruan fitur, dan menandai pembaruan host sesi serta Azure Compute Gallery sebagai "Recommended". Untuk Windows Server, halaman ini menandai Windows Update sebagai "Supported" serta Azure Update Manager dan automatic guest patching sebagai "Recommended". Untuk Windows client Enterprise (sesi tunggal), halaman ini menandai Windows Update sebagai "Recommended", tetapi menandai kumpulan host bersama dengan jenis tersebut sebagai "Not recommended". Paragraf patch in-place di halaman yang sama mencantumkan Windows Update sebagai salah satu teknologi umum, jadi baca tabel per sistem, bukan kalimat itu saja. Menurut pandangan kami, runbook ini cocok untuk host Windows Server, host personal, dan pemeliharaan selain patching, seperti perubahan konfigurasi, restart, pemecahan masalah, atau penonaktifan host. Untuk kumpulan bersama Windows client multi-sesi, Learn merekomendasikan image-based servicing.

Jika Anda memperbarui dengan mengganti image, bukan menambal di tempat, fitur pembaruan session host di Learn akan menangani prosesnya untuk host yang menggunakan konfigurasi session host. Menurut Learn, fitur ini memindahkan host yang dipilih ke mode drain secara otomatis, dan Anda tidak boleh mengubah mode drain secara manual selama pembaruan. Halaman tersebut juga menyarankan untuk menonaktifkan autoscale pada host pool sebelum pembaruan, karena rencana penskalaan yang aktif dapat menyebabkan pembaruan gagal dengan kesalahan runtime. Halaman itu juga menjelaskan bahwa kustomisasi manual seperti file, kunci registry, dan sertifikat tidak akan ada setelah pembaruan. Microsoft mengumumkan ketersediaan umum (general availability) untuk manajemen host pool yang ditingkatkan, yang mencakup konfigurasi dan pembaruan session host, pada Juli 2026 (Tech Community). Beberapa halaman Learn masih memuat keterangan pratinjau. Misalnya, halaman konfigurasi menandai cmdlet Azure PowerShell untuk host pool tersebut sebagai pratinjau dan meminta versi pratinjau dari modul Az.DesktopVirtualization. Periksa halaman terkini sebelum mengandalkan suatu batasan. Bandingkan pendekatan ini dengan rolling drain dalam "Patching AVD without downtime: rolling updates with drain mode".

Sumber

Diakses pada 17 November 2026.

FAQ

Apa yang terjadi pada pengguna yang sedang terhubung saat saya mengaktifkan drain mode?

Tidak ada yang terjadi pada mereka. Microsoft Learn menyatakan bahwa koneksi yang sudah ada tetap aktif sampai pengguna keluar (sign out) atau administrator mengakhiri sesi. Drain mode hanya menghentikan sesi baru. Anda perlu mengirim pesan kepada pengguna dan mengakhiri sesi sendiri, misalnya dengan Send-AzWvdUserSessionMessage dan Remove-AzWvdUserSession.

Mengapa pengguna masih masuk ke host yang sudah saya set ke drain mode?

Halaman load balancing di Learn menyatakan bahwa pengguna yang sudah memiliki sesi aktif atau terputus (disconnected) di host pool akan dialihkan ke host yang menyimpan sesi tersebut, meskipun drain mode aktif. Pengguna tanpa sesi tidak akan dikirim ke host yang sedang di-drain. Periksa sesi yang terputus dengan Get-AzWvdUserSession.

Apakah autoscale akan menyalakan kembali host saya selama pemeliharaan?

Pada host pool bersama (pooled), bisa. FAQ autoscale di Learn menyatakan bahwa autoscale menimpa drain mode pada semua VM yang termasuk dalam penskalaan. Untuk menjaga VM tetap di luar tindakan penskalaan, gunakan tag pengecualian yang diatur dalam scaling plan: Learn menyatakan bahwa autoscale kemudian tidak akan memulai, menghentikan, atau mengubah drain mode pada host yang diberi tag tersebut. Untuk host pool personal, FAQ menyatakan bahwa autoscale tidak mengatur session host ke drain mode, tetapi tetap dapat mendealokasi host yang tidak pernah digunakan untuk masuk.

Entities in this article

Topik artikel ini:

Drain mode (Azure Virtual Desktop) – Subtopik dari Session host (Azure Virtual Desktop) Session host (Azure Virtual Desktop) – Bagian dari Azure Virtual Desktop

Related articles

Artikel lain tentang Session host (Azure Virtual Desktop):

RSS