Bagikan melalui


Azure Virtual Desktop (klasik) PowerShell

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.

Gunakan artikel ini untuk mengatasi kesalahan dan masalah saat menggunakan PowerShell dengan Azure Virtual Desktop. Untuk informasi selengkapnya tentang PowerShell Layanan Desktop Jauh, lihat Azure Virtual Desktop Powershell.

Memberikan tanggapan

Kunjungi Komunitas Teknologi Azure Virtual Desktop untuk membahas layanan Azure Virtual Desktop dengan tim produk dan anggota komunitas aktif.

Perintah PowerShell yang digunakan selama pengaturan Azure Virtual Desktop

Bagian ini mencantumkan perintah PowerShell yang biasanya digunakan saat mengatur Azure Virtual Desktop dan menyediakan cara untuk menyelesaikan masalah yang mungkin terjadi saat menggunakannya.

Kesalahan: Perintah Add-RdsAppGroupUser -- UserPrincipalName yang ditentukan sudah ditetapkan ke grup aplikasi RemoteApp di Kumpulan Host yang ditentukan

Add-RdsAppGroupUser -TenantName <TenantName> -HostPoolName <HostPoolName> -AppGroupName 'Desktop Application Group' -UserPrincipalName <UserName>

Penyebab: Nama pengguna yang digunakan telah ditetapkan ke grup aplikasi dengan jenis yang berbeda. Pengguna tidak dapat ditetapkan ke desktop jarak jauh dan grup aplikasi RemoteApp di bawah kumpulan host sesi yang sama.

Perbaikan: Jika pengguna membutuhkan RemoteApp dan desktop, buat kumpulan host yang berbeda atau hanya berikan akses pengguna ke desktop jarak jauh, yang akan mengizinkan penggunaan aplikasi apa pun pada VM host sesi.

Kesalahan: Perintah Add-RdsAppGroupUser -- UserPrincipalName yang ditentukan tidak ada di ID Microsoft Entra yang terkait dengan penyewa Desktop Jauh

Add-RdsAppGroupUser -TenantName <TenantName> -HostPoolName <HostPoolName> -AppGroupName "Desktop Application Group" -UserPrincipalName <UserPrincipalName>

Penyebab: Pengguna yang ditentukan oleh -UserPrincipalName tidak dapat ditemukan di Microsoft Entra yang terkait dengan penyewa Azure Virtual Desktop.

Perbaikan: Konfirmasi item dalam daftar berikut.

  • Pengguna disinkronkan ke ID Microsoft Entra.
  • Pengguna tidak terikat dengan bisnis ke konsumen (B2C) atau bisnis ke bisnis (B2B).
  • Penyewa Azure Virtual Desktop terikat untuk memperbaiki ID Microsoft Entra.

Kesalahan: Get-RdsDiagnosticActivities -- Pengguna tidak diizinkan untuk menanyakan layanan manajemen

Get-RdsDiagnosticActivities -ActivityId <ActivityId>

Penyebab: -parameter TenantName

Perbaiki: Masalah Get-RdsDiagnosticActivities dengan -TenantName <TenantName>.

Kesalahan: Get-RdsDiagnosticActivities -- pengguna tidak diizinkan untuk menanyakan layanan manajemen

Get-RdsDiagnosticActivities -Deployment -username <username>

Penyebab: Menggunakan sakelar -Penyebaran.

Perbaikan: -Sakelar penyebaran hanya dapat digunakan oleh administrator penyebaran. Administrator ini biasanya adalah anggota tim Layanan Desktop Jauh/Azure Virtual Desktop. Mengganti sakelar -Penyebaran dengan -TenantName <TenantName>.

Kesalahan: New-RdsRoleAssignment -- pengguna tidak diizinkan untuk meminta layanan manajemen

Penyebab 1: Akun yang digunakan tidak memiliki izin Pemilik Layanan Desktop Jauh pada penyewa.

Perbaikan 1: Pengguna dengan izin pemilik Layanan Desktop Jauh perlu menjalankan penetapan peran.

Penyebab 2: Akun yang digunakan memiliki izin pemilik Layanan Desktop Jarak Jauh tetapi bukan bagian dari ID Microsoft Entra penyewa atau tidak memiliki izin untuk mengkueri ID Microsoft Entra tempat pengguna berada.

Perbaikan 2: Pengguna dengan izin Active Directory perlu menjalankan penetapan peran.

Catatan

New-RdsRoleAssignment tidak dapat memberikan izin kepada pengguna yang tidak ada di ID Microsoft Entra.

Kesalahan: SessionHostPool tidak dapat dihapus

Kesalahan ini biasanya terjadi ketika Anda menjalankan perintah berikut dalam mencoba menghapus host sesi.

Remove-RdsHostPool -TenantName <TenantName> -Name <HostPoolName>

Penyebab: Jika Anda menjalankan perintah sebelum menghapus objek daun kumpulan host, perintah tersebut tidak akan berfungsi.

Perbaikan: Jalankan perintah berikut untuk menghapus host sesi.

Get-RdsSessionHost-TenantName <TenantName> -Hostpook <HostPoolName> | Remove-RdsSessionHost -Force

Menggunakan perintah force akan memungkinkan Anda menghapus host sesi meskipun telah menetapkan pengguna.

Langkah berikutnya