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

Blog · Mirko Peters

Drain mode di Azure Virtual Desktop dijelaskan

Mitra · Mitra netral: Nerdio

By ·

Drain mode menghentikan session host agar tidak lagi menerima sesi baru dari pengguna baru, sementara sesi yang sudah ada tetap berjalan sampai berakhir. Artikel ini menjelaskan apa yang diubah dan apa yang tidak, bagaimana load balancer dan autoscale memperlakukannya, serta cara mengaturnya di portal dan mengatur serta membacanya melalui PowerShell.

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

Drain mode adalah pengaturan per host yang menghentikan session host agar tidak lagi menerima sesi pengguna baru. Sesi yang sudah ada tidak terpengaruh. Artikel ini menjelaskan apa yang diubah oleh pengaturan ini, apa yang tidak, bagaimana load balancer dan autoscale memperlakukannya, serta cara mengaturnya di portal dan mengatur serta membacanya di PowerShell. Runbook maintenance langkah demi langkah dibahas dalam artikel terpisah, "How to use drain mode for patching and maintenance of session hosts", dan perencanaan gelombang di seluruh pool dibahas dalam "Patching AVD without downtime: rolling updates with drain mode".

Poin Penting

  • Session host yang di-drain tidak menerima sesi baru. Sesi yang ada tetap terhubung sampai pengguna keluar atau administrator mengakhirinya, dan administrator tetap dapat terhubung langsung ke server.
  • Drain mode bukan sign-out, shutdown, atau status kesehatan. Fitur ini hanya mengubah apakah host dapat dipilih untuk koneksi baru.
  • Pengguna yang sudah memiliki sesi aktif atau terputus pada host yang di-drain tetap diarahkan ke host tersebut saat masuk kembali. Pengguna baru tidak ditempatkan di sana.
  • Pada host pool bersama, autoscale mengaktifkan dan menonaktifkan drain mode tanpa memedulikan siapa yang mengaturnya. Gunakan exclusion tag untuk melindungi sebuah host. Pada personal host pool, autoscale tidak menggunakan drain mode.
  • Di PowerShell, Update-AzWvdSessionHost dengan AllowNewSession $False mengaktifkan drain, dan $True menonaktifkannya. Learn mencantumkan peran Desktop Virtualization Session Host Operator sebagai prasyarat.

Apa yang dilakukan drain mode

Microsoft Learn menggambarkan drain mode sebagai cara untuk mengisolasi session host sehingga Anda dapat melakukan pemeliharaan tanpa mengganggu layanan. Efek yang didokumentasikan adalah:

  • Sesi baru. Host yang di-drain tidak menerima sesi baru. Koneksi baru diarahkan ke session host berikutnya yang tersedia.
  • Sesi yang ada. Sesi tersebut tetap aktif sampai pengguna keluar atau administrator mengakhirinya.
  • Pemeliharaan. Setelah tidak ada sesi tersisa di host, Anda dapat melakukan pemeliharaan.
  • Akses administrator. Administrator tetap dapat terhubung langsung ke server, tanpa melalui layanan Azure Virtual Desktop.

Dalam referensi Azure PowerShell, status yang sama direpresentasikan oleh parameter -AllowNewSession pada Update-AzWvdSessionHost, dan objek output dari Get-AzWvdSessionHost memiliki properti AllowNewSession yang dijelaskan sebagai "Allow a new session." Teks Learn di beberapa tempat menggunakan bentuk jamak AllowNewSessions, dan FAQ autoscale-nya menyebutkan bahwa ketika autoscale menonaktifkan drain mode setelah mendealokasikan VM, autoscale mengatur AllowNewSessions ke true. Jadi drain mode aktif berarti sesi baru tidak diizinkan, dan drain mode nonaktif berarti sesi baru diizinkan.

Apa yang bukan drain mode

  • Bukan sign-out. Tidak ada sesi yang berakhir karena Anda mengaktifkannya.
  • Bukan shutdown. Learn tidak menyebutkan shutdown, sehingga VM tetap berjalan dan biayanya terus berlanjut. Ini merupakan kesimpulan dari deskripsi tersebut, bukan pernyataan langsung dari Learn.
  • Bukan status kesehatan. Learn mencantumkan pengaturan sesi baru dan status sebagai properti yang terpisah. Health check dan status merupakan topik tersendiri; lihat "Azure Virtual Desktop Session Host Shows Unavailable: A Step-by-Step Checklist".
  • Ini tidak sama dengan batas maksimum sesi. Di bawah penyeimbangan beban depth-first, host yang berada di batas maksimum sesi dikeluarkan dari kueri untuk sesi baru, tetapi hanya sampai sesi berakhir dan ada ruang lagi. Host yang sudah dikosongkan tetap dikecualikan hingga mode drain dinonaktifkan, baik oleh Anda maupun, pada host pool bersama dengan rencana penskalaan, oleh autoscale kecuali host tersebut memiliki tag pengecualian (lihat di bawah).

Cara penyeimbang beban memperlakukan host yang dikosongkan

Halaman penyeimbangan beban di Learn menyebutkan dua aturan yang menjelaskan apa yang dialami pengguna:

  1. Untuk pengguna baru, penyeimbang beban tidak mempertimbangkan host sesi yang berada dalam mode drain.
  2. Pengguna yang memiliki sesi aktif atau terputus lalu masuk kembali akan diarahkan ke host sesi tersebut, meskipun mode drain diaktifkan.

Aturan kedua penting untuk perencanaan. Pengguna dengan sesi terputus di host yang dikosongkan akan kembali ke host itu, sehingga host tidak kosong dengan sendirinya selama sesi semacam itu masih ada. Host baru benar-benar kosong ketika penggunanya sudah keluar atau Anda telah mengakhiri sesi mereka. Learn mencantumkan kedua aturan ini sebagai perilaku yang sama untuk penyeimbangan beban breadth-first dan depth-first. Halaman tersebut menambahkan bahwa penyeimbangan beban tidak berlaku untuk host pool pribadi.

Siapa yang dapat mengaturnya, dan caranya

Halaman drain di Learn mencantumkan prasyarat untuk seluruh prosedur, baik melalui portal maupun PowerShell: host pool dengan setidaknya satu host sesi dan peran Desktop Virtualization Session Host Operator. Untuk Azure PowerShell lokal, Anda juga memerlukan modul Az.DesktopVirtualization, atau Anda dapat menggunakan Azure Cloud Shell.

Di portal Azure, buka host pool, pilih Session hosts, centang host, lalu pilih Turn drain mode on. Pilih Turn drain mode off untuk mengizinkan koneksi kembali.

Di Azure PowerShell, halaman drain di Learn memberikan satu perintah untuk masing-masing arah. Perintah tersebut dijalankan pada satu host sesi dalam satu waktu, sehingga ulangi untuk setiap host yang ingin Anda ubah:

# 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 @params

Halaman tersebut menampilkan kedua blok secara terpisah; tabel hash tunggal di atas merupakan penyingkatan dari artikel ini.

Untuk membaca statusnya, Get-AzWvdSessionHost mengembalikan objek ISessionHost. Properti AllowNewSession-nya menyimpan pengaturan tersebut, dan referensi REST mencantumkan nilai yang sama sebagai properties.allowNewSession. Baris seperti Get-AzWvdSessionHost -ResourceGroupName <ResourceGroupName> -HostPoolName <HostPoolName> | Select-Object Name, AllowNewSession, Session, Status menampilkan setiap host dalam sebuah pool beserta pengaturannya dan jumlah sesinya. Filter Select-Object adalah saran dari artikel ini, bukan contoh dari Learn. Setelah perubahan di portal, tunggu minimal 60 detik sebelum menyegarkan, karena Learn memperingatkan bahwa penyegaran langsung dapat menampilkan status yang tidak sinkron.

Cara autoscale menggunakan dan mengesampingkan mode drain

Autoscale menggunakan mode drain sendiri, dan hal ini mudah terlewat. Pada host pool bersama, autoscale memasukkan host ke mode drain sebelum melepas alokasinya, mengembalikan AllowNewSessions ke true setelahnya, dan mengaktifkan atau menonaktifkan mode drain pada VM mana pun dalam cakupannya, siapa pun yang mengaturnya sebelumnya. Hanya host yang memiliki tag pengecualian yang dibiarkan. Pada host pool pribadi, autoscale tidak menggunakan mode drain, dan pengguna yang terhubung selama pelepasan alokasi akan menerima pesan "No resources available". Artikel runbook menunjukkan cara memberi tag pada host sebelum Anda mengosongkannya, dan artikel force sign-out menjelaskan urutan ramp-down.

Contoh singkat

Ambil host kumpulan dengan tiga sesi: pengguna A aktif, pengguna B terputus, dan pengguna C aktif. Anda mengaktifkan drain mode. Pengguna D masuk untuk pertama kali dan diarahkan ke host lain, karena load balancer tidak mempertimbangkan host yang sedang di-drain untuk pengguna baru. Pengguna A keluar. Pengguna B terhubung kembali, dan karena B memiliki sesi terputus di host ini, B kembali ke host tersebut meskipun sedang di-drain. Pengguna C tetap terhubung. Host baru bebas untuk pemeliharaan setelah B dan C keluar atau administrator mengakhiri sesi mereka. Jika Anda tidak melakukan apa pun, host akan tetap dalam kondisi tersebut, kecuali penskalaan otomatis mengubah drain mode pada host kumpulan yang tidak diberi tag. Penjelasan langkah demi langkah ini menerapkan aturan yang didokumentasikan dan bukan skenario resmi dari Learn.

Perbandingan drain mode dengan kontrol terkait

KontrolApa yang diubahSesi yang sudah ada
Drain modeHost tidak menerima sesi baru dari pengguna baruTetap terhubung
Batas maksimum sesi yang lebih rendahJumlah sesi yang diterima hostLearn menyatakan bahwa menurunkan batas ini pada host dengan sesi aktif tidak memengaruhi sesi tersebut
Tag pengecualianPenskalaan otomatis tidak memulai, menghentikan, atau mengubah drain mode pada hostTidak terpengaruh
Paksa keluar pada ramp-downPenskalaan otomatis mengakhiri sisa sesi setelah waktu tungguDiakhiri

Hanya baris terakhir yang mengakhiri sesi. Oleh karena itu, drain mode memerlukan langkah kedua, yaitu menunggu atau mengakhiri sesi, sebelum host bebas digunakan untuk pekerjaan. Tabel ini merupakan ringkasan dari pernyataan Learn di atas.

Membaca hasilnya

  • Sesi. Periksa jumlah sesi pada host sebelum Anda mulai bekerja. Drain mode tidak mengakhiri sesi yang sudah ada. Glosarium Insights menyebutkan bahwa item Sessions menampilkan sesi yang terhubung dan terputus, sedangkan Idle sessions hanya menampilkan sesi yang terputus.
  • Akses langsung. Ini adalah kesimpulan dari hak akses administrator yang didokumentasikan, bukan pernyataan Learn: karena administrator dapat mengakses VM tanpa melalui layanan, pengujian Anda sendiri pada host yang di-drain tidak membuktikan apa yang akan dilihat pengguna.

Kesalahpahaman umum

  • "Saya mengaktifkan drain mode dan pengguna terputus." Halaman drain mode tidak menjelaskan hal tersebut. Periksa penskalaan otomatis, kebijakan, atau proses patching yang mungkin mengakhiri sesi.
  • "Host sudah di-drain tetapi masih ada pengguna." Ini sesuai harapan: sesi tetap berjalan, dan pengguna yang kembali akan diarahkan ke host mereka.
  • "Drain mode sudah mati lagi." Pada kumpulan pooled, periksa dahulu rencana penskalaan dan tag pengecualian.
  • "Pengguna baru sama sekali tidak bisa terhubung." Jika setiap host dalam satu kumpulan berada dalam drain mode, tidak ada host yang dapat menerima pengguna baru. Halaman drain mode tidak mendokumentasikan pesan galat untuk kasus ini.

Sumber

Diakses pada 17 November 2026.

FAQ

Apakah drain mode akan mengeluarkan pengguna dari sesi?

Tidak. Microsoft Learn menyatakan bahwa koneksi yang ada tetap aktif sampai pengguna keluar atau administrator mengakhiri sesi. Drain mode hanya memengaruhi tempat sesi baru ditempatkan.

Mengapa host saya keluar dari drain mode dengan sendirinya?

Jika host berada di host pool bersama dengan scaling plan autoscale, autoscale akan menimpa drain mode pada VM yang termasuk dalam penskalaan, siapa pun yang mengaturnya. FAQ menyarankan untuk menggunakan exclusion tag agar sebuah VM tidak ikut dalam tindakan penskalaan.

Berapa lama portal menampilkan perubahan?

Learn menyatakan bahwa jika Anda menyegarkan portal segera setelah mengubah drain mode, status mungkin tampil tidak sinkron. Learn menyarankan untuk menunggu setidaknya 60 detik sebelum menyegarkan.

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