Host Sesi Azure Virtual Desktop Menampilkan Unavailable: Daftar Periksa Langkah demi Langkah
By Mirko Peters ·
Host sesi yang berjalan tetapi ditandai Unavailable di host pool tidak dapat menerima pengguna. Baca terlebih dahulu pemeriksaan kesehatan yang gagal, lalu periksa domain join, layanan, URL, autoscale, dan registrasi agen.
Automatically translated with AI from the original post. Read the English original
Anda membuka host pool di portal Azure. VM sedang berjalan. Host sesi menampilkan Unavailable. Pengguna tidak dapat terhubung, atau mereka terhubung ke satu-satunya host yang masih sehat.
Poin Penting
- VM dalam status Running tidak memberi tahu Anda apa pun tentang agen AVD. Status host berasal dari pemeriksaan kesehatan agen.
- Kegagalan domain join atau listener side-by-side stack yang rusak merupakan pemeriksaan fatal. Kegagalan pemeriksaan agen pemantauan, layanan metadata, atau URL tercantum sebagai non-fatal dan mengarah ke Needs Assistance.
- Setelah rencana autoscale memulai dan menghentikan host, periksa peran di tingkat langganan, mode drain, dan layanan agen sebelum Anda menginstal ulang apa pun.
- Instal ulang agen dan boot loader dengan kunci registrasi baru hanya setelah pemeriksaan yang lebih sederhana gagal.
Microsoft Q&A memiliki beberapa utas 2025 dan 2026 tentang hal ini. Seorang penanya dengan lingkungan baru memperbaikinya dengan menggabungkan VM ke domain secara manual. Penanya lain melihat host menjadi Unavailable satu per satu setelah mengaktifkan rencana penskalaan, dan utas tersebut tidak berakhir dengan perbaikan yang dikonfirmasi. Artikel ini mengikuti urutan yang disarankan Microsoft Learn dan menambahkan poin dari utas tersebut. Ini bukan prosedur resmi Microsoft. Periksa setiap langkah terhadap halaman Learn terkini, karena artikel pemecahan masalah agen dan artikel konfigurasi host sesi lebih lama dibandingkan beberapa halaman lain.
Yang Anda lihat
- Host pool, lalu Session hosts: status Unavailable, terkadang Needs Assistance atau Upgrading.
- VM itu sendiri berada dalam status Running.
- Setelah restart, VM berjalan kembali tetapi host tetap Unavailable.
- Pada kasus rencana penskalaan, host menjadi Unavailable secara bertahap, bukan sekaligus.
Langkah 1: Baca pemeriksaan kesehatan yang gagal
Di portal, buka host pool, pilih Session hosts, lalu lihat detail salah satu host yang terdampak. Learn menjelaskan status-status tersebut sebagai berikut:
- Available: semua pemeriksaan lolos.
- Needs Assistance: pemeriksaan non-fatal gagal. Ini mencakup agen pemantauan, Azure Instance Metadata Service, dan pemeriksaan URL. Pengguna masih dapat terhubung.
- Unavailable: host dimatikan, atau gagal dalam pemeriksaan fatal.
- Upgrading atau Upgrade Failed: pembaruan agen sedang berjalan atau telah gagal.
Pemeriksaan fatal di halaman Learn adalah pemeriksaan domain joined, pemeriksaan kepercayaan domain, dan pemeriksaan listener side-by-side stack. Yang pertama menjadi titik berakhirnya utas 2025 tersebut.
Langkah 2: Periksa domain join
Utas dengan perbaikan yang terkonfirmasi dimulai dari seorang pengguna yang tidak bisa terhubung ke lingkungan yang baru dibuat. Seorang moderator sukarelawan menyarankan panduan penerapan standar dan AVD Insights. Seorang penasihat independen mencantumkan pemeriksaan umum (log peristiwa, bergabung ke domain atau Azure AD, port yang terbuka, agen image kustom, kesehatan layanan). Penanya kemudian menulis bahwa VM tidak bergabung ke domain dengan sendirinya, dan setelah bergabung secara manual lalu memulai ulang, masalahnya teratasi.
Periksa hal berikut di VM:
- Masuk ke VM dengan akun administrator lokal dan periksa apakah mesin tersebut merupakan anggota domain Anda.
- Dari baris perintah di VM, lakukan ping ke nama domain untuk memastikan namanya dapat di-resolve. Learn menjadikan ini sebagai uji dasar.
Microsoft Learn mencantumkan alasan umum kegagalan bergabung dalam artikel konfigurasi session host: kredensial yang salah di templat penerapan, MFA pada akun yang digunakan untuk bergabung, izin yang tidak lengkap, dan masalah DNS. Untuk DNS, jaringan virtual dari VM harus dapat menjangkau jaringan domain (misalnya melalui peering), DNS jaringan harus mengarah ke domain controller, dan NIC harus mewarisi atau menggunakan server DNS yang sama.
Periksa juga poin tentang penggunaan ulang nama akun komputer. Learn menyebutkan bahwa penggunaan ulang dapat diblokir ketika pembaruan Windows yang dirilis pada atau setelah 11 Oktober 2022 terpasang dan akun yang digunakan untuk bergabung tidak memiliki hak untuk menggunakan ulang akun komputer. Learn menyebutkan tiga jalan keluar: gunakan akun yang membuat akun komputer tersebut, gunakan anggota grup Domain Admins, atau gunakan akun yang tercakup oleh kebijakan Group Policy yang mengizinkan penggunaan ulang akun komputer saat bergabung ke domain.
Langkah 3: Periksa layanan agen
Hubungkan ke VM. Jika RDP tidak berfungsi, Run Command di portal Azure bisa menjadi pilihan, seperti yang disarankan salah satu jawaban.
- Buka
services.mscdan pastikan Remote Desktop Agent Loader (boot loader, nama layananRDAgentBootLoader) berjalan. Mulai layanan tersebut jika statusnya berhenti. Salah satu jawaban di utas scaling plan juga menyebut layananRDAgentuntuk diperiksa. Halaman pemecahan masalah agen di Learn hanya menyebut layanan Remote Desktop Agent Loader pada langkah ini, jadi anggap saran tersebut sebagai hal yang dilaporkan di utas komunitas, bukan yang dikonfirmasi di Microsoft Learn. - Buka Event Viewer, lalu Windows Logs, lalu Application. Learn menyebutkan sumber WVD-Agent, WVD-Agent-Updater, RDAgentBootLoader, dan MsiInstaller. Sebagian besar kesalahan memiliki ID peristiwa 3277 dengan kata kunci tertentu di pesannya.
- Jika loader berhenti lagi setelah Anda memulainya, curigai adanya masalah registrasi (langkah 6).
Jika VM lambat dinyalakan, halaman Learn juga menjelaskan kasus timeout saat boot: atur tipe startup loader ke Automatic (Delayed Start), dan jika perlu naikkan nilai ServicesPipeTimeout, mulai dari 60000 milidetik.
Langkah 4: Periksa konektivitas ke layanan
Session host hanya memerlukan akses keluar (outbound). Daftar endpoint wajib dari Learn mencakup .wvd.microsoft.com pada TCP 443, login.microsoftonline.com, endpoint pemantauan gcs.prod.monitoring.core.windows.net dan .prod.warm.ingest.monitor.core.windows.net, serta alamat fabric Azure 169.254.169.254 (metadata) dan 168.63.129.16 (WireServer). Learn menegaskan bahwa lalu lintas ke dua alamat tersebut tidak boleh dicegat, di-proxy, atau dialihkan. Learn merekomendasikan service tag dan FQDN tag, karena Learn tidak mempublikasikan daftar rentang alamat IP untuk diizinkan sebagai pengganti FQDN.
Lakukan pengujian dengan urutan berikut:
- Jalankan Azure Virtual Desktop Agent URL Tool di session host. Alat ini memeriksa setiap endpoint yang diperlukan.
- Untuk event
INVALID_FORM, Learn meminta Anda membaca nilaiBrokerResourceIdURIdanBrokerResourceIdURIGlobaldi bawahHKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\RDInfraAgent, menambahkan/api/healthke setiap alamat, lalu membukanya di browser. Hasil yang sehat menyatakan bahwa broker dalam kondisi sehat. - Periksa apakah ada inspeksi TLS, proxy, atau DNS kustom di jalur koneksi.
Sebuah utas scaling plan menyarankan untuk menguji alamat health lain di rdweb.wvd.microsoft.com. Saya tidak menemukan alamat tersebut di halaman Learn, jadi saya tidak merekomendasikannya. Gunakan nilai broker dari registry.
Thread yang sama juga menyatakan bahwa endpoint pemantauan yang tidak tersedia menyebabkan kegagalan heartbeat. Learn mencantumkan pemeriksaan agen pemantauan sebagai salah satu pemeriksaan tidak fatal yang menghasilkan status Needs Assistance, bukan Unavailable (tabel pemeriksaan kesehatannya menyebut pemeriksaan ini semi-fatal). Tetap buka endpoint tersebut, tetapi jangan berhenti mencari jika host tetap Unavailable.
Langkah 5: Jika masalah muncul setelah Anda mengaktifkan paket penskalaan
Thread tentang paket penskalaan diposting pada Juni 2026. Host beralih ke Unavailable satu per satu setelah paket diaktifkan. Membuka nama firewall dan memulai ulang VM tidak memperbaiki sebagian besar host tersebut. Dua jawaban mencantumkan daftar pemeriksaan, dan tidak ada jawaban yang diterima.
Microsoft Learn menjelaskan cara kerja autoscale, dan ada baiknya membandingkannya:
- Peran di tingkat langganan. Service principal atau managed identity host pool memerlukan Desktop Virtualization Power On Off Contributor, yang ditetapkan di tingkat langganan. Learn memperingatkan bahwa cakupan yang lebih rendah dapat membuat autoscale tidak berfungsi dengan benar.
- Mode drain. Pada fase ramp-down, autoscale memasukkan host dengan sesi paling sedikit ke mode drain, mengeluarkan pengguna setelah waktu tunggu berakhir, lalu melepaskan alokasi VM. Sebuah jawaban di thread paket penskalaan menyarankan untuk memeriksa kolom Allow New Sessions di portal setelah restart, karena mode drain bisa tetap aktif. Halaman autoscale di Learn tidak menjelaskan hal ini, jadi anggap sebagai informasi yang dilaporkan dalam thread komunitas.
- Tag pengecualian. Host dengan tag pengecualian tidak diubah oleh autoscale. Gunakan tag ini pada host uji untuk melihat apakah paket tersebut menjadi penyebabnya.
- Persentase minimum host. Autoscale menghormati pengaturan ini, dan autoscale hanya mematikan host jika host yang tersisa mampu menangani sesi. Saya tidak menemukan teks di Learn tentang host yang dinyalakan oleh autoscale tetapi kemudian gagal melapor ke layanan, jadi setelah host dinyalakan, ulangi langkah 2 sampai 4 pada host tersebut.
- Tidak ada penskalaan campuran. Learn menyatakan bahwa Anda tidak dapat menggunakan autoscale bersamaan dengan penskalaan Azure Automation atau Logic Apps yang lebih lama pada host pool yang sama.
Untuk diagnosis, Learn memiliki halaman tentang cara menyiapkan diagnostik untuk autoscale (Set up diagnostics for Autoscale), yang mengarah ke FAQ autoscale.
Langkah 6: Daftarkan ulang atau instal ulang agen
Lakukan langkah ini jika pemeriksaan di atas tidak menunjukkan penyebabnya, atau jika log menampilkan INVALID_REGISTRATION_TOKEN atau EXPIRED_MACHINE_TOKEN. Untuk NAME_ALREADY_REGISTERED, Learn menyebutkan bahwa nama VM kemungkinan duplikat: hapus session host dari pool, buat VM dengan nama unik, lalu tambahkan kembali. Prosedur instal ulang lengkap dari Learn adalah sebagai berikut:
- Hapus instalasi komponen berikut melalui Programs and Features, lalu mulai ulang: Remote Desktop Agent Boot Loader, Remote Desktop Services Infrastructure Agent, Remote Desktop Services Infrastructure Geneva Agent, dan Remote Desktop Services SxS Network Stack. Jika Anda terhubung melalui RDP, pilih untuk tidak menutup aplikasi saat menghapus SxS stack.
- Hapus session host dari host pool: Azure Virtual Desktop, Host pools, pilih pool Anda, Session Hosts, pilih host, lalu Remove.
- Buat kunci registrasi baru pada halaman Registration key host pool. Kunci tersebut harus berlaku minimal satu jam dan maksimal 27 hari.
- Instal agen dan boot loader terbaru. Tempelkan kunci ke dalam penginstal agen, lalu jalankan penginstal boot loader dan mulai ulang.
- Tunggu hingga host menampilkan status Available.
Sebuah jawaban di thread menyarankan varian yang lebih ringan. Learn menampilkan nilai registry di bawah HKLM:\SOFTWARE\Microsoft\RDInfraAgent: atur IsRegistered ke 0, masukkan kunci baru ke RegistrationToken, mulai ulang boot loader, lalu pastikan IsRegistered bernilai 1 dan kolom token kosong. Gunakan cara ini hanya untuk error INVALID_REGISTRATION_TOKEN dan EXPIRED_MACHINE_TOKEN.
Jangan menggabungkan VM golden image ke host pool dengan menginstal agen di dalamnya. Halaman Learn tentang golden image menyebutkan bahwa session host yang dibuat dari image tersebut kemudian gagal bergabung ke host pool karena registration token sudah kedaluwarsa, dan proses deployment host pool menggabungkan session host selama provisioning.
Verifikasi
- Host menampilkan status Available dalam beberapa menit. Setelah instal ulang lengkap, Learn menyarankan untuk menunggu 5 hingga 10 menit.
- Di portal, detailnya tidak menampilkan pemeriksaan yang gagal.
- Pengguna uji dapat tersambung dan sesi masuk ke host tersebut.
- Event Viewer tidak menampilkan event 3277 baru.
Batasan
- Hanya satu dari thread tersebut yang penyebabnya sudah terkonfirmasi, yaitu host belum bergabung ke domain.
- Thread tentang scaling plan berakhir tanpa solusi, sehingga langkah-langkah di langkah 5 merupakan perbandingan dengan Learn, bukan obat yang sudah terbukti.
- Jika host masih berstatus Unavailable setelah instalasi ulang yang bersih, kumpulkan nama pemeriksaan yang gagal, ID event beserta waktu UTC-nya, dan nama host pool, lalu buka kasus dukungan.
Terkait
Sumber
- Microsoft Learn: Mengatasi masalah agen Azure Virtual Desktop
- Microsoft Learn: Mengatasi masalah konfigurasi session host Azure Virtual Desktop
- Microsoft Learn: Status session host dan pemeriksaan kesehatan
- Microsoft Learn: FQDN dan endpoint yang diperlukan
- Microsoft Learn: Menyiapkan golden image
- Microsoft Learn: Membuat dan menetapkan scaling plan autoscale
- Microsoft Q&A: Host sesi Azure Virtual Desktop tidak tersedia (September 2025)
- Microsoft Q&A: Host sesi AVD menjadi tidak tersedia setelah mengaktifkan rencana penskalaan (Juni 2026)