Menggunakan Azure CLI dan Azure PowerShell dengan Azure Virtual Desktop

Ada ekstensi Azure CLI dan modul Azure PowerShell untuk Azure Virtual Desktop yang dapat Anda gunakan untuk membuat, memperbarui, menghapus, dan berinteraksi dengan objek layanan Azure Virtual Desktop sebagai alternatif untuk menggunakan portal Azure. Mereka adalah bagian dari Azure CLI dan Azure PowerShell, yang mencakup berbagai layanan Azure.

Artikel ini menjelaskan cara menggunakan ekstensi Azure CLI dan modul Azure PowerShell, dan menyediakan beberapa contoh perintah yang berguna.

Ekstensi Azure CLI dan modul Azure PowerShell

Berikut adalah nama ekstensi Azure CLI dan modul Azure PowerShell, dan tautan ke dokumentasi referensi kami:

• Azure CLI: az desktopvirtualization

• Azure PowerShell: Az.DesktopVirtualization

Azure CLI dan Azure PowerShell tersedia untuk digunakan di Azure Cloud Shell secara asli di portal Azure tanpa instalasi, atau Anda dapat menginstalnya secara lokal di perangkat Anda untuk Windows, macOS, dan Linux.

Untuk mempelajari cara menginstal Azure CLI dan Azure PowerShell di semua platform yang didukung, lihat tautan berikut:

• Azure CLI: Cara menginstal Azure CLI

• Azure PowerShell: Menginstal modul Azure Az PowerShell

Contoh perintah

Berikut adalah beberapa contoh perintah yang dapat Anda gunakan untuk mendapatkan informasi dan nilai tentang sumber daya Azure Virtual Desktop yang mungkin berguna bagi Anda. Pilih tab yang relevan untuk skenario Anda.

Azure CLI

Penting

Dalam contoh berikut, Anda harus mengubah <placeholder> nilai untuk anda sendiri.

Wilayah Azure yang tersedia

Saat membuat objek layanan Azure Virtual Desktop menggunakan salah satu perintah CLI yang berisi create, Anda perlu menentukan wilayah Azure tempat Anda ingin membuatnya. Untuk menemukan nama wilayah Azure yang akan digunakan dengan --location parameter , jalankan perintah berikut dan gunakan nilai dari Location kolom :

az account list-locations --query "sort_by([].{DisplayName:displayName, Location:name}, &Location)" -o table

Mengambil ID objek kumpulan host, ruang kerja, grup aplikasi, atau aplikasi

• Untuk mengambil ID objek kumpulan host, jalankan perintah berikut:

  az desktopvirtualization hostpool show \
       --name <Name> \
       --resource-group <ResourceGroupName> \
       --query objectId 
       --output tsv
  

• Untuk mengambil ID objek ruang kerja, jalankan perintah berikut:

  az desktopvirtualization workspace show \
       --name <Name> \
       --resource-group <ResourceGroupName> \
       --query objectId 
       --output tsv
  

• Untuk mengambil ID objek grup aplikasi, jalankan perintah berikut:

  az desktopvirtualization applicationgroup show \
       --name <Name> \
       --resource-group <ResourceGroupName> \
       --query objectId 
       --output tsv
  

Tip

Ekstensi Azure CLI untuk Azure Virtual Desktop tidak memiliki perintah untuk aplikasi. Gunakan Azure PowerShell sebagai gantinya.

Azure PowerShell

Penting

Dalam contoh berikut, Anda harus mengubah <placeholder> nilai untuk anda sendiri.

Wilayah Azure yang tersedia

Saat membuat objek layanan Azure Virtual Desktop menggunakan salah satu cmdlet PowerShell yang dimulai New-AzWvd..., Anda perlu menentukan wilayah Azure tempat Anda ingin membuatnya. Untuk menemukan nama wilayah Azure yang akan digunakan dengan -Location parameter , jalankan perintah berikut dan gunakan nilai dari Location kolom :

Get-AzLocation | Sort-Object DisplayName | FT DisplayName, Location

Mengambil ID objek kumpulan host, ruang kerja, grup aplikasi, atau aplikasi

Beberapa cmdlet PowerShell mengharuskan Anda untuk memberikan ID objek objek objek layanan Azure Virtual Desktop. Berikut adalah beberapa contoh:

• Untuk mengambil ID objek kumpulan host, jalankan perintah berikut:

  (Get-AzWvdHostPool -Name <HostPoolName> -ResourceGroupName <ResourceGroupName>).ObjectId
  

• Untuk mengambil ID objek ruang kerja, jalankan perintah berikut:

  (Get-AzWvdWorkspace -Name <WorkspaceName> -ResourceGroupName <ResourceGroupName>).ObjectID
  

• Untuk mengambil ID objek grup aplikasi, jalankan perintah berikut:

  (Get-AzWvdApplicationGroup -Name <ApplicationGroupName> -ResourceGroupName <ResourceGroupName>).ObjectId
  

• Untuk mengambil ID objek aplikasi desktop, jalankan perintah berikut:

  (Get-AzWvdDesktop -Name <DesktopName> -ApplicationGroupName <ApplicationGroupName> -ResourceGroupName <ResourceGroupName>).ObjectId
  

• Untuk mengambil ID objek dari semua aplikasi RemoteApp dalam grup aplikasi, jalankan perintah berikut:

  Get-AzWvdApplication -ApplicationGroupName <ApplicationGroupName> -ResourceGroupName <ResourceGroupName> | Select-Object Name, FilePath, ObjectId
  

Langkah berikutnya

Sekarang setelah Anda tahu cara menggunakan Azure CLI dan Azure PowerShell dengan Azure Virtual Desktop, berikut adalah beberapa artikel yang menggunakannya:

• Membuat kumpulan host Azure Virtual Desktop dengan PowerShell atau Azure CLI
• Mengelola grup aplikasi menggunakan PowerShell atau Azure CLI
• Untuk dokumentasi referensi PowerShell lengkap, lihat Az.DesktopVirtualization.