Mengatur properti Protokol Desktop Jauh (RDP) kustom pada kumpulan host di Azure Virtual Desktop

Saat pengguna masuk ke Aplikasi Windows atau aplikasi Desktop Jauh, desktop dan aplikasi yang dapat mereka akses ditampilkan. Untuk setiap desktop dan aplikasi, ada file terkait .rdp yang berisi semua properti koneksi yang akan digunakan saat menyambungkan ke sesi jarak jauh melalui Protokol Desktop Jarak Jauh (RDP). Properti RDP ini diatur per kumpulan host.

Setiap kumpulan host memiliki sekumpulan properti dan nilai RDP default. Anda dapat menambahkan properti lain ke set default atau mengambil alih nilai default dengan mengatur properti RDP kustom. Artikel ini memperlihatkan kepada Anda cara mengatur properti RDP kustom pada kumpulan host dengan menggunakan portal Azure, Azure PowerShell, dan Azure CLI.

Properti RDP kumpulan host default

Kumpulan host memiliki properti dan nilai RDP berikut secara default:

Properti RDP	Detail
audiomode:i:0	Menentukan apakah komputer lokal atau jarak jauh memutar audio.
devicestoredirect:s:*	Menentukan periferal mana yang menggunakan Protokol Transfer Media (MTP) atau Protokol Transfer Gambar (PTP), seperti kamera digital, dialihkan dari perangkat Windows lokal ke sesi jarak jauh.
drivestoredirect:s:*	Menentukan drive tetap, dapat dilepas, dan jaringan mana pada perangkat lokal yang akan dialihkan dan tersedia dalam sesi jarak jauh.
enablecredsspsupport:i:1	Menentukan apakah klien akan menggunakan Penyedia Dukungan Keamanan Kredensial (CredSSP) untuk autentikasi jika tersedia.
redirectclipboard:i:1	Menentukan apakah akan mengalihkan papan klip.
redirectcomports:i:1	Menentukan apakah port serial atau COM pada perangkat lokal dialihkan ke sesi jarak jauh.
redirectprinters:i:1	Menentukan apakah printer yang tersedia pada perangkat lokal dialihkan ke sesi jarak jauh.
redirectsmartcards:i:1	Menentukan apakah perangkat kartu pintar pada perangkat lokal akan dialihkan dan tersedia dalam sesi jarak jauh.
redirectwebauthn:i:1	Menentukan apakah permintaan WebAuthn dari sesi jarak jauh dialihkan ke perangkat lokal yang memungkinkan penggunaan pengautentikasi lokal (seperti Windows Hello untuk Bisnis dan kunci keamanan).
usbdevicestoredirect:s:*	Menentukan perangkat USB mana yang didukung pada komputer klien yang dialihkan menggunakan pengalihan tingkat rendah buram ke sesi jarak jauh.
use multimon:i:1	Menentukan apakah sesi jarak jauh akan menggunakan satu atau beberapa tampilan dari perangkat lokal.
videoplaybackmode:i:1	Menentukan apakah koneksi akan menggunakan streaming multimedia yang efisien RDP untuk pemutaran video.

Untuk daftar lengkap properti dan nilai yang didukung, lihat Properti RDP yang didukung dengan Azure Virtual Desktop

Tip

Untuk mempelajari selengkapnya tentang mengalihkan periferal dan sumber daya, lihat Pengalihan periferal dan sumber daya melalui Protokol Desktop Jarak Jauh. Anda mungkin perlu mengonfigurasi lebih dari sekadar properti RDP.

Prasyarat

Sebelum Anda dapat mengatur properti RDP kustom pada kumpulan host, Anda memerlukan:

• Kumpulan host yang ada.

• Akun Azure menetapkan peran Kontributor Kumpulan Host Virtualisasi Desktop atau yang setara.

• Jika Anda ingin menggunakan Azure CLI atau Azure PowerShell secara lokal, lihat Menggunakan Azure CLI dan Azure PowerShell dengan Azure Virtual Desktop untuk memastikan Anda memiliki ekstensi Azure CLI desktopvirtualisasi atau modul Az.DesktopVirtualization PowerShell yang terinstal. Atau, gunakan Azure Cloud Shell.

Mengonfigurasi properti RDP kustom

Pilih tab yang relevan untuk skenario Anda.

Portal Azure

Berikut cara mengonfigurasi properti RDP menggunakan portal Azure. Untuk daftar lengkap properti dan nilai yang didukung, lihat Properti RDP yang didukung dengan Azure Virtual Desktop.

1. Masuk ke portal Azure.

2. Pada bilah pencarian, masukkan Azure Virtual Desktop dan pilih entri layanan yang sesuai.

3. Pilih Kumpulan host, lalu pilih nama kumpulan host yang ingin Anda perbarui.

4. Pilih Properti RDP, lalu pilih tab Tingkat Lanjut .

   

5. Tambahkan properti RDP tambahan atau buat perubahan pada properti RDP yang ada dalam format yang dipisahkan titik koma, seperti nilai default yang sudah ditampilkan.

6. Setelah selesai, pilih Simpan untuk menyimpan perubahan Anda. Pengguna perlu me-refresh sumber daya mereka untuk menerima perubahan.

Azure PowerShell

Untuk mengonfigurasi properti RDP menggunakan Azure PowerShell, gunakan contoh berikut. Pastikan untuk mengubah <placeholder> nilai untuk nilai Anda sendiri. Untuk daftar lengkap properti dan nilai yang didukung, lihat Properti RDP yang didukung dengan Azure Virtual Desktop.

1. Buka Azure Cloud Shell di portal Azure dengan jenis terminal PowerShell, atau jalankan PowerShell di perangkat lokal Anda.

   • Jika Anda menggunakan Cloud Shell, pastikan konteks Azure Anda diatur ke langganan yang ingin Anda gunakan.

   • Jika Anda menggunakan PowerShell secara lokal, pertama-tama masuk dengan Azure PowerShell, lalu pastikan konteks Azure Anda diatur ke langganan yang ingin Anda gunakan.

2. Gunakan salah satu contoh berikut berdasarkan kebutuhan Anda:

   • Untuk menambahkan properti RDP kustom ke kumpulan host dan mempertahankan properti kustom yang sudah ada sudah diatur, jalankan perintah berikut. Properti RDP perlu ditulis dalam format yang dipisahkan titik koma. Contoh ini menambahkan menonaktifkan pengalihan clipboard dan printer:

     $hostPool = "<HostPoolName>"
     $resourceGroup = "<ResourceGroupName>"
     $addCustomProperties = "redirectclipboard:i:0;redirectprinters:i:0"
     
     $currentCustomProperties = (Get-AzWvdHostPool -Name $hostPool -ResourceGroupName $resourceGroup).CustomRdpProperty
     $customProperties = $currentCustomProperties + $addCustomProperties
     
     Update-AzWvdHostPool -Name $hostPool -ResourceGroupName $resourceGroup -CustomRdpProperty $customProperties
     

   • Untuk mengganti semua properti kustom yang ada dengan sekumpulan properti RDP kustom baru, jalankan perintah berikut. Contoh ini hanya mengatur menonaktifkan pengalihan clipboard dan printer:

     $hostPool = "<HostPoolName>"
     $resourceGroup = "<ResourceGroupName>"
     $customProperties = "redirectclipboard:i:0;redirectprinters:i:0"
     
     Update-AzWvdHostPool -Name $hostPool -ResourceGroupName $resourceGroup -CustomRdpProperty $customProperties
     

   • Untuk menghapus semua properti RDP kustom dari kumpulan host, jalankan perintah berikut. Contoh ini meneruskan string kosong ke CustomRdpProperty parameter :

     $hostPool = "<HostPoolName>"
     $resourceGroup = "<ResourceGroupName>"
     $customProperties = ""
     
     Update-AzWvdHostPool -Name $hostPool -ResourceGroupName $resourceGroup -CustomRdpProperty $customProperties
     

3. Periksa properti RDP kustom yang diatur pada kumpulan host yang sama dengan menjalankan perintah berikut:

   Get-AzWvdHostPool -Name $hostPool -ResourceGroupName $resourceGroup | FT Name, CustomRdpProperty
   

   Output harus mirip dengan contoh berikut:

    Name              : contoso-hp01
    CustomRdpProperty : use multimon:i:1;redirectclipboard:i:0;redirectprinters:i:0;
   

4. Pengguna perlu me-refresh sumber daya mereka untuk menerima perubahan.

Azure CLI

Untuk mengonfigurasi properti RDP menggunakan Azure CLI, gunakan contoh berikut. Pastikan untuk mengubah <placeholder> nilai untuk nilai Anda sendiri. Untuk daftar lengkap properti dan nilai yang didukung, lihat Properti RDP yang didukung dengan Azure Virtual Desktop.

1. Buka Azure Cloud Shell di portal Azure dengan jenis terminal Bash, atau jalankan Azure CLI di perangkat lokal Anda.

   • Jika Anda menggunakan Cloud Shell, pastikan konteks Azure Anda diatur ke langganan yang ingin Anda gunakan.

   • Jika Anda menggunakan Azure CLI secara lokal, pertama-tama masuk dengan Azure CLI, lalu pastikan konteks Azure Anda diatur ke langganan yang ingin Anda gunakan.

2. Gunakan salah satu contoh berikut berdasarkan kebutuhan Anda:

   • Untuk menambahkan properti RDP kustom ke kumpulan host dan mempertahankan properti kustom yang sudah ada sudah diatur, jalankan perintah berikut. Properti RDP perlu ditulis dalam format yang dipisahkan titik koma. Contoh ini menambahkan menonaktifkan pengalihan clipboard dan printer ke properti kustom yang ada:

     hostPool="<HostPoolName>"
     resourceGroup="<ResourceGroupName>"
     addCustomProperties="redirectclipboard:i:0;redirectprinters:i:0"
     
     currentCustomProperties=$(az desktopvirtualization hostpool show \
          --name $hostPool \
          --resource-group $resourceGroup \
          --query [customRdpProperty] \
          --output tsv)
     
     customProperties="$currentCustomProperties$addCustomProperties"
     
     az desktopvirtualization hostpool update \
          --name $hostPool \
          --resource-group $resourceGroup \
          --custom-rdp-property "$customProperties"
     

   • Untuk mengganti semua properti kustom yang ada dengan sekumpulan properti RDP kustom baru, jalankan perintah berikut. Contoh ini hanya mengatur menonaktifkan pengalihan clipboard dan printer:

     hostPool="<HostPoolName>"
     resourceGroup="<ResourceGroupName>"
     
     az desktopvirtualization hostpool update \
          --name $hostPool \
          --resource-group $resourceGroup \
          --custom-rdp-property "redirectclipboard:i:0;redirectprinters:i:0"
     

   • Untuk menghapus semua properti RDP kustom dari kumpulan host, jalankan perintah berikut. Contoh ini meneruskan string kosong ke --custom-rdp-property parameter :

     hostPool="<HostPoolName>"
     resourceGroup="<ResourceGroupName>"
     
     az desktopvirtualization hostpool update \
          --name $hostPool \
          --resource-group $resourceGroup \
          --custom-rdp-property ""
     

3. Periksa properti RDP kustom yang diatur pada kumpulan host yang sama dengan menjalankan perintah berikut:

   az desktopvirtualization hostpool show \
       --name $hostPool \
       --resource-group $resourceGroup \
       --query "{name:name, customRdpProperty:customRdpProperty}" \
       --output table
   

   Output harus mirip dengan contoh berikut:

   Name          CustomRdpProperty
   --------      ------------------------------------------------------------
   contoso-hp01  use multimon:i:0;redirectclipboard:i:0;redirectprinters:i:0;
   

4. Pengguna perlu me-refresh sumber daya mereka untuk menerima perubahan.

Konten terkait

• Properti RDP yang didukung dengan Azure Virtual Desktop
• Pengalihan periferal dan sumber daya melalui Protokol Desktop Jarak Jauh