Mengidentifikasi dan mendiagnosis masalah di Azure Virtual Desktop (klasik)

Penting

Konten ini berlaku untuk Azure Virtual Desktop (klasik), yang tidak mendukung objek Azure Resource Manager Azure Virtual Desktop. Jika Anda berusaha mengelola objek Azure Resource Manager Azure Virtual Desktop, baca artikel ini.

Azure Virtual Desktop menawarkan fitur diagnostik yang memungkinkan administrator mengidentifikasi masalah melalui integrasi tunggal. Peran Azure Virtual Desktop mencatat aktivitas diagnostik setiap kali pengguna berinteraksi dengan sistem. Setiap log berisi informasi yang relevan seperti peran Azure Virtual Desktop yang terlibat dalam transaksi, pesan kesalahan, informasi penyewa, dan informasi pengguna. Aktivitas diagnostik dibuat oleh pengguna akhir dan tindakan administratif, dan dapat dikategorikan ke dalam tiga wadah utama:

  • Aktivitas langganan umpan: pengguna akhir memicu aktivitas ini setiap kali mereka mencoba menyambungkan ke umpan mereka melalui aplikasi Microsoft Remote Desktop.
  • Aktivitas sambungan: pengguna akhir memicu aktivitas ini setiap kali mereka mencoba tersambung ke desktop atau RemoteApp melalui aplikasi Microsoft Remote Desktop.
  • Aktivitas manajemen: administrator memicu aktivitas ini setiap kali mereka melakukan operasi manajemen pada sistem, seperti membuat kumpulan host, menetapkan pengguna ke grup aplikasi, dan membuat penetapan peran.

Koneksi yang tidak mencapai Azure Virtual Desktop tidak akan muncul dalam hasil diagnostik karena layanan peran diagnostik itu sendiri adalah bagian dari Azure Virtual Desktop. Masalah koneksi Azure Virtual Desktop dapat terjadi ketika pengguna akhir mengalami masalah konektivitas jaringan.

Untuk memulai, unduh dan impor modul Azure Virtual Desktop PowerShell untuk digunakan dalam sesi PowerShell Anda, jika Anda belum melakukannya. Setelah itu, jalankan cmdlet berikut untuk masuk ke akun Anda:

Add-RdsAccount -DeploymentUrl "https://rdbroker.wvd.microsoft.com"

Mendiagnosis masalah menggunakan PowerShell

Azure Virtual Desktop Diagnostics hanya menggunakan satu cmdlet PowerShell tetapi berisi banyak parameter opsional untuk membantu mempersempit dan mengisolasi masalah. Bagian berikut mencantumkan cmdlet yang dapat Anda jalankan untuk mendiagnosis masalah. Sebagian besar filter dapat diterapkan bersama-sama. Nilai yang tercantum dalam tanda kurung, seperti <tenantName>, harus diganti dengan nilai yang berlaku untuk situasi Anda.

Penting

Fitur diagnostik adalah untuk pemecahan masalah pengguna tunggal. Semua kueri yang menggunakan PowerShell harus menyertakan parameter -UserName atau -ActivityID. Untuk kemampuan pemantauan, gunakan Analitik Log. Lihat Menggunakan Analitik Log untuk fitur diagnostik untuk informasi selengkapnya tentang cara mengirim data diagnostik ke ruang kerja Anda.

Memfilter aktivitas diagnostik menurut pengguna

Parameter -UserName mengembalikan daftar aktivitas diagnostik yang dimulai oleh pengguna tertentu, seperti yang ditunjukkan dalam contoh cmdlet berikut.

Get-RdsDiagnosticActivities -TenantName <tenantName> -UserName <UserUPN>

Parameter -UserName juga dapat digabungkan dengan parameter pemfilteran opsional lainnya.

Memfilter aktivitas diagnostik menurut waktu

Anda dapat memfilter daftar aktivitas diagnostik yang dikembalikan dengan parameter -StartTime dan -EndTime. Parameter -StartTime akan mengembalikan daftar aktivitas diagnostik mulai dari tanggal tertentu, seperti yang ditunjukkan pada contoh berikut.

Get-RdsDiagnosticActivities -TenantName <tenantName> -UserName <UserUPN> -StartTime "08/01/2018"

Parameter -EndTime dapat ditambahkan ke cmdlet dengan parameter -StartTime untuk menentukan periode waktu tertentu yang Anda inginkan untuk menerima hasil. Contoh cmdlet berikut akan mengembalikan daftar aktivitas diagnostik antara 1 Agustus dan 10 Agustus.

Get-RdsDiagnosticActivities -TenantName <tenantName> -UserName <UserUPN> -StartTime "08/01/2018" -EndTime "08/10/2018"

Parameter -StartTime dan -EndTime juga dapat dikombinasikan dengan parameter pemfilteran opsional lainnya.

Filter aktivitas diagnostik menurut jenis aktivitas

Anda juga dapat memfilter aktivitas diagnostik menurut jenis aktivitas dengan parameter -ActivityType. Cmdlet berikut akan mengembalikan daftar sambungan pengguna akhir:

Get-RdsDiagnosticActivities -TenantName <tenantName> -UserName <UserUPN> -ActivityType Connection

Cmdlet berikut akan mengembalikan daftar tugas manajemen administrator:

Get-RdsDiagnosticActivities -TenantName <tenantName> -ActivityType Management

Cmdlet Get-RdsDiagnosticActivities saat ini tidak mendukung penetapan Umpan sebagai ActivityType.

Filter aktivitas diagnostik berdasarkan hasil

Anda dapat memfilter daftar aktivitas diagnostik yang dikembalikan menurut hasil dengan parameter -Outcome. Contoh cmdlet berikut akan mengembalikan daftar aktivitas diagnostik yang berhasil.

Get-RdsDiagnosticActivities -TenantName <tenantName> -UserName <UserUPN> -Outcome Success

Contoh cmdlet berikut akan mengembalikan daftar aktivitas diagnostik yang gagal.

Get-RdsDiagnosticActivities -TenantName <tenantName> -Outcome Failure

Parameter -Outcome juga dapat digabungkan dengan parameter pemfilteran opsional lainnya.

Mengambil aktivitas diagnostik tertentu berdasarkan ID aktivitas

Parameter -ActivityId mengembalikan aktivitas diagnostik tertentu jika ada, seperti yang ditunjukkan dalam contoh cmdlet berikut.

Get-RdsDiagnosticActivities -TenantName <tenantName> -ActivityId <ActivityIdGuid>

Lihat pesan kesalahan untuk aktivitas yang gagal menurut ID aktivitas

Untuk melihat pesan kesalahan untuk aktivitas yang gagal, Anda harus menjalankan cmdlet dengan parameter -Detailed. Anda dapat melihat daftar kesalahan dengan menjalankan cmdlet Select-Object.

Get-RdsDiagnosticActivities -TenantName <tenantname> -ActivityId <ActivityGuid> -Detailed | Select-Object -ExpandProperty Errors

Ambil aktivitas diagnostik terperinci

Parameter -Detailed memberikan detail tambahan untuk setiap aktivitas diagnostik yang ditampilkan. Format untuk setiap aktivitas bervariasi tergantung pada jenis aktivitasnya. Parameter -Detailed dapat ditambahkan ke kueri Get-RdsDiagnosticActivities apa pun, seperti yang ditunjukkan pada contoh berikut.

Get-RdsDiagnosticActivities -TenantName <tenantName> -ActivityId <ActivityGuid> -Detailed

Skenario kesalahan umum

Skenario kesalahan dikategorikan dalam internal ke layanan dan eksternal ke Azure Virtual Desktop.

  • Masalah Internal: menentukan skenario yang tidak dapat dimitigasi oleh administrator penyewa dan perlu diselesaikan sebagai masalah dukungan. Saat memberikan umpan balik melalui Azure Virtual Desktop Tech Community, sertakan ID aktivitas dan perkiraan kerangka waktu saat masalah terjadi.
  • Masalah Eksternal: berhubungan dengan skenario yang dapat dimitigasi oleh administrator sistem. Ini adalah eksternal untuk Azure Virtual Desktop.

Tabel berikut mencantumkan kesalahan umum yang mungkin dialami oleh admin Anda.

Catatan

Daftar ini mencakup kesalahan paling umum dan diperbarui secara teratur. Untuk memastikan Anda memiliki informasi terbaru, pastikan untuk memeriksa kembali artikel ini minimal sebulan sekali.

Kode galat manajemen eksternal

Kode numerik Kode kesalahan Solusi yang disarankan
1322 ConnectionFailedNoMappingOfSIDinAD Pengguna bukan anggota Azure Active Directory. Ikuti petunjuk di Pusat Administratif Direktori Aktif untuk menambahkannya.
3 UnauthorizedAccess Pengguna yang mencoba menjalankan cmdlet PowerShell administratif tidak memiliki izin untuk melakukannya atau salah mengetik nama pengguna mereka.
1000 TenantNotFound Nama penyewa yang Anda masukkan tidak cocok dengan penyewa yang ada. Tinjau nama penyewa untuk kesalahan ketik dan coba lagi.
1006 TenantCannotBeRemovedHasSessionHostPools Anda tidak dapat menghapus penyewa selama penyewa berisi objek. Hapus kumpulan host sesi terlebih dahulu, lalu coba lagi.
2000 HostPoolNotFound Nama kumpulan host yang Anda masukkan tidak cocok dengan kumpulan host yang ada. Tinjau nama kumpulan host untuk kesalahan ketik dan coba lagi.
2005 HostPoolCannotBeRemovedHasApplicationGroups Anda tidak dapat menghapus kumpulan host selama itu berisi objek. Hapus semua grup aplikasi di kumpulan host terlebih dahulu.
2004 HostPoolCannotBeRemovedHasSessionHosts Hapus semua host sesi terlebih dahulu sebelum menghapus kumpulan host sesi.
5001 SessionHostNotFound Host sesi yang Anda tanyakan mungkin sedang offline. Periksa status kumpulan host.
5008 SessionHostUserSessionsExist Anda harus mengeluarkan semua pengguna di host sesi sebelum menjalankan aktivitas pengelolaan yang Anda maksudkan.
6000 AppGroupNotFound Nama grup aplikasi yang Anda masukkan tidak cocok dengan grup aplikasi yang ada. Tinjau nama grup aplikasi untuk kesalahan ketik dan coba lagi.
6022 RemoteAppNotFound Nama RemoteApp yang Anda masukkan tidak cocok dengan RemoteApps mana pun. Tinjau nama RemoteApp untuk kesalahan ketik dan coba lagi.
6010 PublishedItemsExist Nama sumber daya yang Anda coba publikasikan sama dengan sumber daya yang sudah ada. Ubah nama sumber daya dan coba lagi.
7002 NameNotValidWhiteSpace Jangan gunakan ruang putih pada nama.
8000 InvalidAuthorizationRoleScope Nama peran yang Anda masukkan tidak cocok dengan nama peran yang ada. Tinjau nama peran untuk memeriksa kesalahan ketik dan coba lagi.
8001 UserNotFound Nama pengguna yang Anda masukkan tidak cocok dengan nama pengguna yang ada. Tinjau nama untuk memeriksa kesalahan ketik dan coba lagi.
8005 UserNotFoundInAAD Nama pengguna yang Anda masukkan tidak cocok dengan nama pengguna yang ada. Tinjau nama untuk memeriksa kesalahan ketik dan coba lagi.
8008 TenantConsentRequired Ikuti petunjuk di sini untuk memberikan persetujuan bagi penyewa Anda.

Kode kesalahan sambungan eksternal

Kode numerik Kode kesalahan Solusi yang disarankan
-2147467259 ConnectionFailedAdErrorNoSuchMember Pengguna bukan anggota Direktori Aktif. Ikuti petunjuk di Pusat Administratif Direktori Aktif untuk menambahkannya.
-2147467259 ConnectionFailedAdTrustedRelationshipFailure Host sesi tidak bergabung dengan benar ke Direktori Aktif.
-2146233088 ConnectionFailedUserHasValidSessionButRdshIsUnhealthy Sambungan gagal karena host sesi tidak tersedia. Periksa kesehatan host sesi.
-2146233088 ConnectionFailedClientDisconnect Jika Anda sering melihat kesalahan ini, pastikan komputer pengguna tersambung ke jaringan.
-2146233088 ConnectionFailedNoHealthyRdshAvailable Sesi yang coba disambungkan oleh pengguna host tidak sehat. Debug komputer virtual.
-2146233088 ConnectionFailedUserNotAuthorized Pengguna tidak memiliki izin untuk mengakses aplikasi atau desktop yang diterbitkan. Kesalahan mungkin muncul setelah admin menghapus sumber daya yang diterbitkan. Minta pengguna untuk me-refresh umpan di aplikasi Desktop Jauh.
2 FileNotFound Aplikasi yang coba diakses pengguna salah dipasang atau diatur ke jalur yang salah.
3 InvalidCredentials Nama pengguna atau sandi yang dimasukkan pengguna tidak cocok dengan nama pengguna atau sandi yang ada. Tinjau kredensial untuk kesalahan ketik dan coba lagi.
8 ConnectionBroken Sambungan antara Klien dan Gateway atau Server terputus. Tidak ada tindakan yang diperlukan kecuali itu terjadi secara tidak terduga.
14 UnexpectedNetworkDisconnect Sambungan ke jaringan terputus. Minta pengguna untuk tersambung lagi.
24 ReverseConnectFailed Komputer virtual host tidak memiliki garis pandang langsung ke RD Gateway. Pastikan alamat IP Gateway dapat diatasi.
1322 ConnectionFailedNoMappingOfSIDinAD Pengguna bukan anggota Direktori Aktif. Ikuti petunjuk di Pusat Administratif Direktori Aktif untuk menambahkannya.

Langkah berikutnya

Untuk mempelajari lebih lanjut tentang peran dalam Azure Virtual Desktop, lihat lingkungan Azure Virtual Desktop.

Untuk melihat daftar cmdlet PowerShell yang tersedia untuk Azure Virtual Desktop, lihat referensi PowerShell.