Azure Virtual Desktop PowerShell

Penting

Konten ini berlaku untuk Azure Virtual Desktop dengan objek Azure Resource Manager Azure Virtual Desktop. Jika Anda menggunakan Azure Virtual Desktop (klasik) tanpa objek Azure Resource Manager, lihat 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: New-AzRoleAssignment: Informasi yang diberikan tidak dipetakan ke ID objek AD

New-AzRoleAssignment -SignInName "admins@contoso.com" -RoleDefinitionName "Desktop Virtualization User" -ResourceName "0301HP-DAG" -ResourceGroupName 0301RG -ResourceType 'Microsoft.DesktopVirtualization/applicationGroups'

Penyebab: Pengguna yang ditentukan oleh parameter -SignInName tidak dapat ditemukan di Microsoft Entra yang terkait dengan lingkungan Azure Virtual Desktop.

Perbaiki: Pastikan hal-hal berikut.

  • Pengguna harus disinkronkan ke ID Microsoft Entra.
  • Pengguna tidak boleh terikat dengan perdagangan business-to-consumer (B2C) atau business-to-business (B2B).
  • Lingkungan Azure Virtual Desktop harus terikat untuk memperbaiki ID Microsoft Entra.

Kesalahan: New-AzRoleAssignment: "Klien dengan id objek tidak memiliki otorisasi untuk melakukan tindakan atas cakupan (kode: AuthorizationFailed)"

Penyebab 1: Akun yang digunakan tidak memiliki izin Pemilik pada langganan.

Perbaiki 1: Pengguna dengan izin Pemilik perlu menjalankan penetapan peran. Atau, pengguna harus ditetapkan ke peran Administrator Akses Pengguna untuk menetapkan pengguna ke grup aplikasi.

Penyebab 2: Akun yang digunakan memiliki izin Pemilik tetapi bukan bagian dari ID Microsoft Entra lingkungan atau tidak memiliki izin untuk mengkueri ID Microsoft Entra tempat pengguna berada.

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

Kesalahan: New-AzWvdHostPool -- lokasi tidak tersedia untuk jenis sumber daya

New-AzWvdHostPool_CreateExpanded: The provided location 'southeastasia' is not available for resource type 'Microsoft.DesktopVirtualization/hostpools'. List of available regions for the resource type is 'eastus,eastus2,westus,westus2,northcentralus,southcentralus,westcentralus,centralus'.

Penyebab: Azure Virtual Desktop mendukung pemilihan lokasi kumpulan host, grup aplikasi, dan ruang kerja untuk menyimpan metadata layanan di lokasi tertentu. Opsi Anda dibatasi hingga fitur ini tersedia. Kesalahan ini berarti fitur tidak tersedia di lokasi yang Anda pilih.

Perbaiki: Dalam pesan kesalahan, daftar wilayah yang didukung akan diterbitkan. Gunakan salah satu wilayah yang didukung.

Kesalahan: New-AzWvdApplicationGroup berada di lokasi yang sama dengan kumpulan host

New-AzWvdApplicationGroup_CreateExpanded: ActivityId: e5fe6c1d-5f2c-4db9-817d-e423b8b7d168 Error: ApplicationGroup must be in same location as associated HostPool

Penyebab: Ada ketidakcocokan lokasi. Semua kumpulan host, grup aplikasi, dan ruang kerja memiliki lokasi untuk menyimpan metadata layanan. Objek apa pun yang Anda buat yang terkait satu sama lain harus berada di lokasi yang sama. Misalnya, jika kumpulan host berada di eastus, Anda juga perlu membuat grup aplikasi di eastus. Jika Anda membuat ruang kerja untuk mendaftarkan grup aplikasi ini, ruang kerja tersebut juga harus berada di eastus.

Perbaiki: Ambil lokasi tempat kumpulan host dibuat, lalu tetapkan grup aplikasi yang Anda buat ke lokasi yang sama.

Langkah berikutnya