Azure Virtual Desktop PowerShell

  • مقالة

هام

ينطبق هذا المحتوى على Azure Virtual Desktop مع كائنات Azure Resource Manager Azure Virtual Desktop. إذا كنت تستخدم Azure Virtual Desktop (كلاسيكي) دون كائنات Azure Resource Manager، فراجع هذه المقالة.

استخدم هذه المقالة لحل الأخطاء والمشكلات عند استخدام PowerShell مع Azure Virtual Desktop. لمزيد من المعلومات بشأن PowerShell لخدمات سطح المكتب البعيد، راجع Azure Virtual Desktop PowerShell.

تقديم تعليقات

قم بزيارة Azure Virtual Desktop Tech Community لمناقشة خدمة Azure Virtual Desktop مع فريق المنتج وأعضاء المجتمع النشطين.

أوامر PowerShell المُستخدمة أثناء إعداد Azure Virtual Desktop

يسرد هذا القسم أوامر PowerShell التي يتم استخدامها عادة أثناء إعداد Azure Virtual Desktop ويوفر طرقًا لحل المشكلات التي قد تحدث أثناء استخدامها.

الخطأ: New-AzRoleAssignment: عدم تعيين المعلومات المقدمة إلى معرّف عنصر AD

New-AzRoleAssignment -SignInName "admins@contoso.com" -RoleDefinitionName "Desktop Virtualization User" -ResourceName "0301HP-DAG" -ResourceGroupName 0301RG -ResourceType 'Microsoft.DesktopVirtualization/applicationGroups'

السبب: لا يمكن العثور على المستخدم المحدد بواسطة المعلمة -SignInName في Microsoft Entra المرتبط ببيئة Azure Virtual Desktop.

الإصلاح: تأكد من الأشياء التالية.

  • يجب مزامنة المستخدم مع معرف Microsoft Entra.
  • لا ينبغي ربط المستخدم بالأعمال التجارية بين الشركات والمستهلك (B2C) أو التجارة بين الشركات (B2B).
  • يجب ربط بيئة Azure Virtual Desktop بتصحيح معرف Microsoft Entra.

الخطأ: New-AzRoleAssignment: "لا يمتلك العميل صاحب معرّف العنصر تخويلاً لتنفيذ الإجراء عبر النطاق (التعليمة البرمجية: AuthorizationFailed)"

السبب 1: لا يملك الحساب المستخدم أذونات المالك على الاشتراك.

الإصلاح 1: يحتاج المستخدم الذي يملك أذونات المالك إلى تنفيذ تعيين الدور. بدلاً من ذلك، يحتاج المستخدم إلى تعيينه لدور مسؤول وصول المستخدم لتعيين مستخدم إلى مجموعة تطبيقات.

السبب 2: الحساب المستخدم لديه أذونات المالك ولكنه ليس جزءا من معرف Microsoft Entra الخاص بالبيئة أو ليس لديه أذونات للاستعلام عن معرف Microsoft Entra حيث يوجد المستخدم.

الإصلاح 2: يحتاج المستخدم الذي لديه أذونات Active Directory إلى تنفيذ تعيين الدور.

الخطأ: New-AzWvdHostPool -- الموقع غير متوفر لنوع المورد

New-AzWvdHostPool_CreateExpanded: The provided location 'southeastasia' is not available for resource type 'Microsoft.DesktopVirtualization/hostpools'. List of available regions for the resource type is 'eastus,eastus2,westus,westus2,northcentralus,southcentralus,westcentralus,centralus'.

السبب: يدعم Azure Virtual Desktop تحديد موقع تجمعات المضيفين ومجموعات التطبيقات ومساحات العمل لتخزين بيانات تعريف الخدمة في مواقع معينة. تقتصر خياراتك على مكان توفر هذه الميزة. يعني هذا الخطأ أن الميزة غير متوفرة في الموقع الذي اخترته.

الإصلاح: في رسالة الخطأ، سيتم نشر قائمة بالمناطق المدعومة. استخدم إحدى المناطق المدعومة بدلاً من ذلك.

الخطأ: New-AzWvdApplicationGroup يجب أن يكون في نفس موقع تجمع المضيف

New-AzWvdApplicationGroup_CreateExpanded: ActivityId: e5fe6c1d-5f2c-4db9-817d-e423b8b7d168 Error: ApplicationGroup must be in same location as associated HostPool

السبب: هناك عدم تطابق في الموقع. تحتوي جميع تجمعات المضيفين، ومجموعات التطبيقات، ومساحات العمل على موقع لتخزين بيانات تعريف الخدمة. يجب أن تكون أي عناصر تقوم بإنشائها مقترنة ببعضها البعض في نفس الموقع. على سبيل المثال، إذا كان تجمع المضيف في eastus، فأنت بحاجة أيضاً إلى إنشاء مجموعات التطبيقات في eastus. إذا قمت بإنشاء مساحة عمل لتسجيل مجموعات التطبيقات هذه فيها، يجب أن تكون مساحة العمل هذه موجودة أيضاً في eastus.

الإصلاح: استرجع الموقع الذي تم إنشاء تجمع المضيف فيه، ثم قم بتعيين مجموعة التطبيقات التي تقوم بإنشائها إلى نفس الموقع.

الخطوات التالية