أنظمة معرف الموارد الموحدة مع عميل سطح المكتب البعيد ل Azure Virtual Desktop
يمكنك استخدام أنظمة معرف الموارد الموحد (URI) لاستدعاء عميل سطح المكتب البعيد مع أوامر ومعلمات وقيم معينة للاستخدام مع Azure Virtual Desktop. على سبيل المثال، يمكنك الاشتراك في مساحة عمل أو الاتصال بسطح مكتب معين أو RemoteApp.
توضح هذه المقالة تفاصيل الأوامر والمعلمات المتوفرة، بالإضافة إلى بعض الأمثلة.
العملاء المعتمدون
يسرد الجدول التالي العملاء المعتمدين للاستخدام مع أنظمة URI:
| العميل | إصدار |
|---|---|
| عميل سطح المكتب البعيد لنظام التشغيل Windows | 1.2.4065 والإصدارات الأحدث |
مخططات URI المتوفرة
هناك نظامان ل URI لعملاء سطح المكتب البعيد المدعومين، ms-avd وms-rd. باستخدام ms-avd، يمكنك تحديد مورد Azure Virtual Desktop معين ومستخدم للاتصال به. باستخدام ms-rd، يمكنك الاشتراك تلقائيا في مساحة عمل في عميل سطح المكتب البعيد، بدلا من الاضطرار إلى إضافة مساحة العمل يدويا.
توضح الأقسام التالية بالتفصيل الأوامر والمعلمات التي يمكنك استخدامها مع كل نظام URI.
ms-avd
نظام معرف الموارد الموحد ms-avd ل Azure Virtual Desktop متاح الآن بشكل عام. فيما يلي قائمة بالأوامر المدعومة حاليا ل ms-avd والمعلمات المقابلة لها.
ms-avd:connect
ms-avd:connect يحدد موقع مورد Azure Virtual Desktop محدد ويبدأ جلسة RDP، ويربط مباشرة مستخدما محددا بهذا المورد.
اسم الأمر: الاتصال
معلمات الأمر:
| المعلمة | القيم | الوصف |
|---|---|---|
| معرف مساحة العمل | معرف الكائن (GUID). | حدد معرف الكائن لمساحة عمل صالحة. للحصول على قيمة معرف الكائن باستخدام PowerShell، راجع استرداد معرف الكائن لتجمع مضيف أو مساحة عمل أو مجموعة تطبيقات أو تطبيق. يمكنك أيضا استخدام واجهات برمجة تطبيقات REST لظاهرية سطح المكتب. |
| Resourceid | معرف الكائن (GUID). | حدد معرف الكائن لمورد منشور موجود في مساحة العمل. يمكن أن تكون القيمة لسطح المكتب أو RemoteApp. للحصول على قيمة معرف الكائن باستخدام PowerShell، راجع استرداد معرف الكائن لتجمع مضيف أو مساحة عمل أو مجموعة تطبيقات أو تطبيق. يمكنك أيضا استخدام واجهات برمجة تطبيقات REST لظاهرية سطح المكتب. |
| المستخدم | اسم المستخدم الأساسي (UPN)، على سبيل المثال user@contoso.com. |
حدد مستخدما صالحا لديه حق الوصول إلى مورد محدد. |
| env (اختياري) | avdarm (Azure التجاري) avdgov (Azure Government) |
حدد سحابة Azure حيث توجد الموارد. |
| إصدار | 0 | حدد إصدار نظام URI للاتصال لاستخدامه. |
| launchpartnerid (اختياري) | Guid. | حدد المعرف الذي يوفره الشريك أو العميل الذي يمكنك استخدامه مع تشخيصات Azure Virtual Desktop للمساعدة في استكشاف الأخطاء وإصلاحها. نوصي باستخدام GUID، والذي يمكنك إنشاؤه باستخدام New-Guid PowerShell cmdlet. |
| نظير النشاط (اختياري) | Guid. | حدد المعرف الذي يوفره الشريك أو العميل الذي يمكنك استخدامه مع تشخيصات Azure Virtual Desktop للمساعدة في استكشاف الأخطاء وإصلاحها. نوصي باستخدام GUID، والذي يمكنك إنشاؤه باستخدام New-Guid PowerShell cmdlet. |
مثال:
ms-avd:connect?workspaceId=1638e073-63b2-46d8-bd84-ea02ea905467&resourceid=c2f5facc-196f-46af-991e-a90f3252c185&username=user@contoso.com&version=0
ms-rd
فيما يلي قائمة بالأوامر المدعومة حاليا ل ms-rd والمعلمات المقابلة لها.
تلميح
يؤدي استخدام ms-rd: بدون أي أوامر إلى تشغيل عميل سطح المكتب البعيد.
ms-rd:subscribe
ms-rd:subscribe تشغيل عميل سطح المكتب البعيد وبدء عملية الاشتراك.
اسم الأمر: الاشتراك
معلمات الأمر:
| المعلمة | القيم | الوصف |
|---|---|---|
| عنوان URL | عنوان URL صالح، مثل https://rdweb.wvd.microsoft.com. | حدد عنوان URL لمساحة العمل. |
مثال:
ms-rd:subscribe?url=https://rdweb.wvd.microsoft.com
القيود المعروفة
فيما يلي القيود المعروفة مع مخططات URI:
- لا يمكن تكوين خصائص العرض عبر URI. يمكنك تكوين خصائص العرض كمسؤول على تجمع مضيف أو يمكن للمستخدمين النهائيين تكوين خصائص العرض في عميل Azure Virtual Desktop.
الخطوات التالية
تعرف على كيفية الاتصال إلى Azure Virtual Desktop باستخدام عميل سطح المكتب البعيد لنظام التشغيل Windows.