Menyesuaikan properti Protokol Desktop Jauh (RDP) untuk kumpulan host

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.

Anda dapat menyesuaikan properti Protokol Desktop Jauh (RDP) kumpulan host, seperti pengalaman multi-monitor dan pengalihan audio, untuk memberikan pengalaman optimal bagi pengguna berdasarkan kebutuhan mereka. Jika Anda ingin mengubah properti file RDP default, Anda dapat menyesuaikan properti RDP di Azure Virtual Desktop dengan menggunakan portal Azure atau dengan menggunakan -CustomRdpProperty parameter dalam Update-AzWvdHostPool cmdlet .

Lihat Properti RDP yang didukung dengan Azure Virtual Desktop untuk daftar lengkap properti yang didukung dan nilai defaultnya.

Properti file RDP default

File RDP memiliki properti berikut secara default:

Properti RDP Untuk Desktop dan RemoteApp
Mode multi-monitor Aktif
Pengalihan diaktifkan Drive, clipboard, printer, port COM, kartu pintar, perangkat, usbdevicestore, dan WebAuthn
Mode audio jarak jauh Memutar secara lokal
VideoPlayback Aktif
EnableCredssp Aktif

Penting

  • Mode multi-monitor hanya diaktifkan untuk grup aplikasi Desktop dan akan diabaikan untuk grup aplikasi RemoteApp.

  • Semua properti file RDP default diekspos di portal Microsoft Azure.

  • Bidang CustomRdpProperty null akan menerapkan semua properti RDP default ke kumpulan host Anda. Bidang CustomRdpProperty kosong tidak akan menerapkan properti RDP default ke kumpulan host Anda.

  • Jika Anda juga mengonfigurasi pengaturan pengalihan perangkat menggunakan objek Kebijakan Grup (GPO), pengaturan di GPO akan mengambil alih properti RDP yang Anda tentukan pada kumpulan host.

Prasyarat

Sebelum memulai, ikuti petunjuk dalam Menyiapkan modul PowerShell Azure Virtual Desktop untuk menyiapkan modul PowerShell dan masuk ke Azure.

Mengonfigurasi properti RDP di portal Azure

Untuk mengonfigurasi properti RDP di portal Azure:

  1. Masuk ke portal Microsoft Azure.
  2. Masukkan Azure Virtual Desktop ke bilah pencarian.
  3. Pada Layanan, pilih Azure Virtual Desktop.
  4. Di halaman Azure Virtual Desktop, pilih kumpulan host pada menu di sebelah kiri layar.
  5. Pilih nama kumpulan host yang ingin diperbarui.
  6. Pilih Properti RDP pada menu di sebelah kiri layar.
  7. Tetapkan properti yang Anda inginkan.
    • Atau, Anda dapat membuka tab Tingkat Lanjut dan menambahkan properti RDP dalam format yang dipisahkan titik koma seperti contoh PowerShell di bagian berikut.
  8. Setelah selesai, pilih Simpan untuk menyimpan perubahan Anda.

Bagian selanjutnya akan menjelaskan cara mengedit properti RDP kustom secara manual di PowerShell.

Menambahkan atau mengedit properti RDP kustom tunggal

Untuk menambahkan atau mengedit properti RDP kustom tunggal, jalankan cmdlet PowerShell berikut:

Update-AzWvdHostPool -ResourceGroupName <resourcegroupname> -Name <hostpoolname> -CustomRdpProperty <property>

Catatan

Layanan Azure Virtual Desktop tidak menerima karakter escape, seperti titik koma atau titik dua, sebagai nama properti RDP kustom yang valid.

Untuk memastikan apakah cmdlet yang baru saja Anda jalankan memperbarui properti, jalankan cmdlet ini:

Get-AzWvdHostPool -ResourceGroupName <resourcegroupname> -Name <hostpoolname> | format-list Name, CustomRdpProperty

Name              : <hostpoolname>
CustomRdpProperty : <customRDPpropertystring>

Misalnya, jika Anda memeriksa properti "audiocapturemode" pada kumpulan host bernama 0301HP, Anda perlu memasukkan cmdlet ini:

Get-AzWvdHostPool -ResourceGroupName 0301rg -Name 0301hp | format-list Name, CustomRdpProperty

Name              : 0301HP
CustomRdpProperty : audiocapturemode:i:1;

Menambahkan atau mengedit beberapa properti RDP kustom

Untuk menambahkan atau mengedit beberapa properti RDP kustom, jalankan cmdlet PowerShell berikut dengan menyediakan properti RDP kustom sebagai string yang dipisahkan titik koma:

$properties="<property1>;<property2>;<property3>"
Update-AzWvdHostPool -ResourceGroupName <resourcegroupname> -Name <hostpoolname> -CustomRdpProperty $properties

Catatan

Layanan Azure Virtual Desktop tidak menerima karakter escape, seperti titik koma atau titik dua, sebagai nama properti RDP kustom yang valid.

Anda dapat memeriksa untuk memastikan properti RDP telah ditambahkan dengan menjalankan cmdlet berikut:

Get-AzWvdHostPool -ResourceGroupName <resourcegroupname> -Name <hostpoolname> | format-list Name, CustomRdpProperty

Name              : <hostpoolname>
CustomRdpProperty : <customRDPpropertystring>

Berdasarkan contoh cmdlet kami sebelumnya, jika Anda menyiapkan beberapa properti RDP di kumpulan host 0301HP, cmdlet Anda akan terlihat seperti ini:

Get-AzWvdHostPool -ResourceGroupName 0301rg -Name 0301hp | format-list Name, CustomRdpProperty

Name              : 0301HP
CustomRdpProperty : audiocapturemode:i:1;audiomode:i:0;

Mereset semua properti RDP kustom

Anda dapat mengatur ulang properti RDP kustom individual ke nilai default-nya dengan mengikuti petunjuk di Menambahkan atau mengedit satu properti RDP kustom. Anda juga dapat mengatur ulang semua properti RDP kustom untuk kumpulan host dengan menjalankan cmdlet PowerShell berikut:

Update-AzWvdHostPool -ResourceGroupName <resourcegroupname> -Name <hostpoolname> -CustomRdpProperty ""

Untuk memastikan Anda telah berhasil menghapus pengaturan, masukkan cmdlet ini:

Get-AzWvdHostPool -ResourceGroupName <resourcegroupname> -Name <hostpoolname> | format-list Name, CustomRdpProperty

Name              : <hostpoolname>
CustomRdpProperty : <CustomRDPpropertystring>

Langkah berikutnya

Setelah menyesuaikan properti RDP untuk kumpulan host tertentu, Anda dapat masuk ke klien Azure Virtual Desktop untuk mengujinya sebagai bagian dari sesi pengguna. Panduan langkah-langkah berikutnya akan memberi tahu cara tersambung ke sesi menggunakan klien pilihan Anda: