Skema Pengidentifikasi Sumber Daya Seragam dengan klien Desktop Jauh untuk Azure Virtual Desktop
Anda dapat menggunakan skema Pengidentifikasi Sumber Daya Seragam (URI) untuk memanggil klien Desktop Jauh dengan perintah, parameter, dan nilai tertentu untuk digunakan dengan Azure Virtual Desktop. Misalnya, Anda dapat berlangganan ruang kerja atau menyambungkan ke desktop atau RemoteApp tertentu.
Artikel ini merinci perintah dan parameter yang tersedia, bersama dengan beberapa contoh.
Klien yang Didukung
Tabel berikut mencantumkan klien yang didukung untuk digunakan dengan skema URI:
| Klien | Versi |
|---|---|
| Klien Desktop Jauh untuk Windows | 1.2.4065 dan yang lebih baru |
Skema URI yang tersedia
Ada dua skema URI untuk klien Desktop Jauh yang didukung, ms-avd dan ms-rd. Dengan ms-avd, Anda dapat menentukan sumber daya dan pengguna Azure Virtual Desktop tertentu yang akan disambungkan. Dengan ms-rd, Anda dapat secara otomatis berlangganan ruang kerja di klien Desktop Jauh, daripada harus menambahkan ruang kerja secara manual.
Bagian berikut merinci perintah dan parameter yang dapat Anda gunakan dengan setiap skema URI.
ms-avd
Skema Pengidentifikasi Sumber Daya Seragam ms-avd untuk Azure Virtual Desktop sekarang tersedia secara umum. Berikut adalah daftar perintah yang saat ini didukung untuk ms-avd dan parameter yang sesuai.
ms-avd:connect
ms-avd:connect menemukan sumber daya Azure Virtual Desktop tertentu dan memulai sesi RDP, langsung menyambungkan pengguna tertentu ke sumber daya tersebut.
Nama perintah: sambungkan
Parameter perintah:
| Parameter | Nilai | Deskripsi |
|---|---|---|
| workspaceid | ID Objek (GUID). | Tentukan ID objek ruang kerja yang valid. Untuk mendapatkan nilai ID objek menggunakan PowerShell, lihat Mengambil ID objek kumpulan host, ruang kerja, grup aplikasi, atau aplikasi. Anda juga dapat menggunakan REST API Virtualisasi Desktop. |
| resourceid | ID Objek (GUID). | Tentukan ID objek sumber daya yang diterbitkan yang terdapat di ruang kerja. Nilainya bisa untuk desktop atau RemoteApp. Untuk mendapatkan nilai ID objek menggunakan PowerShell, lihat Mengambil ID objek kumpulan host, ruang kerja, grup aplikasi, atau aplikasi. Anda juga dapat menggunakan REST API Virtualisasi Desktop. |
| pengguna | Nama Prinsipal Pengguna (UPN), misalnya user@contoso.com. |
Tentukan pengguna yang valid dengan akses ke sumber daya tertentu. |
| env (opsional) | avdarm (Azure komersial) avdgov (Azure Government) |
Tentukan cloud Azure tempat sumber daya berada. |
| versi | 0 | Tentukan versi skema URI sambungkan yang akan digunakan. |
| launchpartnerid (opsional) | GUID. | Tentukan ID yang disediakan mitra atau pelanggan yang dapat Anda gunakan dengan Diagnostik Azure Virtual Desktop untuk membantu pemecahan masalah. Sebaiknya gunakan GUID, yang dapat Anda hasilkan dengan cmdlet PowerShell New-Guid . |
| peeractivityid (opsional) | GUID. | Tentukan ID yang disediakan mitra atau pelanggan yang dapat Anda gunakan dengan Diagnostik Azure Virtual Desktop untuk membantu pemecahan masalah. Sebaiknya gunakan GUID, yang dapat Anda hasilkan dengan cmdlet PowerShell New-Guid . |
| usemultimon | benar atau salah | Tentukan apakah sesi jarak jauh akan menggunakan satu atau beberapa tampilan dari komputer lokal. |
Contoh:
ms-avd:connect?workspaceId=1638e073-63b2-46d8-bd84-ea02ea905467&resourceid=c2f5facc-196f-46af-991e-a90f3252c185&username=user@contoso.com&version=0
ms-rd
Berikut adalah daftar perintah yang saat ini didukung untuk ms-rd dan parameter yang sesuai.
Tip
Menggunakan ms-rd: tanpa perintah apa pun meluncurkan klien Desktop Jauh.
ms-rd:subscribe
ms-rd:subscribe meluncurkan klien Desktop Jauh dan memulai proses langganan.
Nama perintah: berlangganan
Parameter perintah:
| Parameter | Nilai | Deskripsi |
|---|---|---|
| url | URL yang valid, seperti https://rdweb.wvd.microsoft.com. | Tentukan URL ruang kerja. |
Contoh:
ms-rd:subscribe?url=https://rdweb.wvd.microsoft.com
Batasan Umum
Berikut adalah batasan yang diketahui dengan skema URI:
- Properti tampilan tidak dapat dikonfigurasi melalui URI. Anda dapat mengonfigurasi properti tampilan sebagai admin pada kumpulan host atau pengguna akhir dapat mengonfigurasi properti tampilan di klien Azure Virtual Desktop.
Langkah berikutnya
Pelajari cara Menyambungkan ke Azure Virtual Desktop dengan klien Desktop Jauh untuk Windows.