إعداد وحدة PowerShell النمطية لسطح المكتب الظاهري Azure

  • مقالة
  • قراءة خلال 2 دقائق

هام

ينطبق هذا المحتوى على سطح المكتب الظاهري Azure مع تكامل Azure Resource Manager.

تم دمج وحدة Azure Virtual Desktop PowerShell النمطية في وحدة Azure PowerShell. ستخبرك هذه المقالة بكيفية إعداد وحدة PowerShell النمطية حتى تتمكن من تشغيل cmdlets لسطح مكتب Azure الظاهري.

إعداد بيئة PowerShell الخاصة بك

لبدء استخدام الوحدة النمطية، قم أولا بتثبيت أحدث إصدار من PowerShell Core. تعمل cmdlets Azure Virtual Desktop حاليا فقط مع PowerShell Core.

بعد ذلك، ستحتاج إلى تثبيت الوحدة النمطية DesktopVirtualization لاستخدامها في جلسة عمل PowerShell.

قم بتشغيل cmdlet PowerShell التالي في الوضع المرتفع لتثبيت الوحدة النمطية:

Install-Module -Name Az.DesktopVirtualization

ملاحظة

إذا لم يعمل cmdlet هذا، فحاول تشغيله مرة أخرى باستخدام أذونات مرتفعة.

بعد ذلك، قم بتشغيل cmdlet التالي للاتصال ب Azure:

Connect-AzAccount

هام

إذا كنت تتصل ببوابة US Gov ، فقم بتشغيل cmdlet هذا بدلا من ذلك:

Connect-AzAccount -EnvironmentName AzureUSGovernment

للاتصال بمدخل Azure China، قم بتشغيل cmdlet هذا:

Connect-AzAccount -EnvironmentName AzureChinaCloud

يتطلب تسجيل الدخول إلى حساب Azure الخاص بك تعليمة برمجية يتم إنشاؤها عند تشغيل cmdlet الاتصال. لتسجيل الدخول، انتقل إلى https://microsoft.com/devicelogin، أدخل الرمز، ثم سجل الدخول باستخدام بيانات اعتماد مسؤول Azure.

Account SubscriptionName TenantId Environment

------- ---------------- -------- -----------

Youradminupn subscriptionname AzureADTenantID AzureCloud

سيؤدي ذلك إلى تسجيل دخولك مباشرة إلى الاشتراك الافتراضي لبيانات اعتماد المشرف.

تغيير الاشتراك الافتراضي

إذا كنت تريد تغيير الاشتراك الافتراضي بعد تسجيل الدخول، فقم بتشغيل cmdlet هذا:

Select-AzSubscription -Subscription <preferredsubscriptionname>

يمكنك أيضا تحديد واحد من قائمة باستخدام Out-GridView cmdlet:

Get-AzSubscription | Out-GridView -PassThru | Select-AzSubscription

عند تحديد اشتراك جديد لاستخدامه، لن تحتاج إلى تحديد معرف هذا الاشتراك في cmdlets الذي تقوم بتشغيله بعد ذلك. على سبيل المثال، يقوم cmdlet التالي باسترداد مضيف جلسة عمل معين دون الحاجة إلى معرف الاشتراك:

Get-AzWvdSessionHost -HostPoolName <hostpoolname> -Name <sessionhostname> -ResourceGroupName <resourcegroupname>

يمكنك أيضا تغيير الاشتراكات على أساس كل cmdlet عن طريق إضافة اسم الاشتراك المطلوب كمعلمة. cmdlet التالي هو نفسه المثال السابق ، باستثناء معرف الاشتراك المضاف كمعلمة لتغيير الاشتراك الذي يستخدمه cmdlet.

Get-AzWvdSessionHost -HostPoolName <hostpoolname> -Name <sessionhostname> -ResourceGroupName <resourcegroupname> -SubscriptionId <subscriptionGUID>

الحصول على المواقع

معلمة الموقع إلزامية لجميع cmdlets AzWVD الجديدة التي تنشئ كائنات جديدة.

قم بتشغيل cmdlet التالي للحصول على قائمة بالمواقع التي يدعمها اشتراكك:

Get-AzLocation

سيبدو إخراج Get-AzLocation كما يلي:

Location : eastasia

DisplayName : East Asia

Providers : {Microsoft.RecoveryServices, Microsoft.ManagedIdentity,
Microsoft.SqlVirtualMachine, microsoft.insights…}

Location : southeastasia

DisplayName : Southeast Asia

Providers : {Microsoft.RecoveryServices, Microsoft.ManagedIdentity,
Microsoft.SqlVirtualMachine, microsoft.insights…}

Location : centralus

DisplayName : Central US

Providers : {Microsoft.RecoveryServices, Microsoft.DesktopVirtualization,
Microsoft.ManagedIdentity, Microsoft.SqlVirtualMachine…}

Location : eastus

DisplayName : East US

Providers : {Microsoft.RecoveryServices, Microsoft.DesktopVirtualization,
Microsoft.ManagedIdentity, Microsoft.SqlVirtualMachine…}

بمجرد معرفة موقع حسابك، يمكنك استخدامه في cmdlet. على سبيل المثال، إليك cmdlet الذي ينشئ تجمعا مضيفا في موقع "جنوب شرق آسيا":

New-AzWvdHostPool -ResourceGroupName <resourcegroupname> -Name <hostpoolname> -WorkspaceName <workspacename> -Location “southeastasia”

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

الآن بعد أن قمت بإعداد وحدة PowerShell النمطية الخاصة بك، يمكنك تشغيل cmdlets للقيام بجميع أنواع الأشياء في سطح مكتب Azure الظاهري. فيما يلي بعض الأماكن التي يمكنك فيها استخدام وحدتك:

إذا واجهت أي مشكلات، فراجع مقالة استكشاف الأخطاء وإصلاحها في PowerShell للحصول على المساعدة.