استخدام Azure CLI وAzure PowerShell مع Azure Virtual Desktop

هناك ملحق Azure CLI وحدة نمطية Azure PowerShell ل Azure Virtual Desktop يمكنك استخدامها لإنشاء كائنات خدمة Azure Virtual Desktop وتحديثها وحذفها والتفاعل معها كبدائل لاستخدام مدخل Microsoft Azure. إنها جزء من Azure CLI وAzure PowerShell، والتي تغطي مجموعة واسعة من خدمات Azure.

تشرح هذه المقالة كيف يمكنك استخدام ملحق Azure CLI والوحدة النمطية Azure PowerShell، وتوفر بعض أوامر الأمثلة المفيدة.

ملحق Azure CLI والوحدة النمطية Azure PowerShell

فيما يلي أسماء ملحق Azure CLI والوحدة النمطية Azure PowerShell، وارتباطات إلى وثائقنا المرجعية:

• واجهة سطر الأوامر Azure CLI: az desktopvirtualization

• Azure PowerShell: Az.DesktopVirtualization

يتوفر كل من Azure CLI وAzure PowerShell للاستخدام في Azure Cloud Shell أصلا في مدخل Azure دون تثبيت، أو يمكنك تثبيتهما محليا على جهازك لنظام التشغيل Windows وmacOS وLinux.

لمعرفة كيفية تثبيت Azure CLI وAzure PowerShell عبر جميع الأنظمة الأساسية المدعومة، راجع الارتباطات التالية:

• Azure CLI: كيفية تثبيت Azure CLI

• Azure PowerShell: تثبيت الوحدة النمطية Azure Az PowerShell

أمثلة على الأوامر

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

Azure CLI

هام

في الأمثلة التالية، ستحتاج إلى تغيير <placeholder> القيم الخاصة بك.

مناطق Azure المتوفرة

عند إنشاء كائنات خدمة Azure Virtual Desktop باستخدام أي من أوامر CLI التي تحتوي على create، تحتاج إلى تحديد منطقة Azure التي تريد إنشاؤها فيها. للعثور على اسم منطقة Azure لاستخدامها مع المعلمة --location ، قم بتشغيل الأمر التالي واستخدم قيمة من Location العمود:

az account list-locations --query "sort_by([].{DisplayName:displayName, Location:name}, &Location)" -o table

استرداد معرف الكائن لتجمع مضيف أو مساحة عمل أو مجموعة تطبيقات أو تطبيق

• لاسترداد معرف الكائن لتجمع مضيف، قم بتشغيل الأمر التالي:

  az desktopvirtualization hostpool show \
       --name <Name> \
       --resource-group <ResourceGroupName> \
       --query objectId 
       --output tsv
  

• لاسترداد معرف الكائن لمساحة عمل، قم بتشغيل الأمر التالي:

  az desktopvirtualization workspace show \
       --name <Name> \
       --resource-group <ResourceGroupName> \
       --query objectId 
       --output tsv
  

• لاسترداد معرف الكائن لمجموعة تطبيقات، قم بتشغيل الأمر التالي:

  az desktopvirtualization applicationgroup show \
       --name <Name> \
       --resource-group <ResourceGroupName> \
       --query objectId 
       --output tsv
  

تلميح

لا يحتوي ملحق Azure CLI ل Azure Virtual Desktop على أوامر للتطبيقات. استخدم Azure PowerShell بدلا من ذلك.

Azure PowerShell

هام

في الأمثلة التالية، ستحتاج إلى تغيير <placeholder> القيم الخاصة بك.

مناطق Azure المتوفرة

عند إنشاء كائنات خدمة Azure Virtual Desktop باستخدام أي من أوامر PowerShell cmdlets التي تبدأ New-AzWvd...، تحتاج إلى تحديد منطقة Azure التي تريد إنشاؤها فيها. للعثور على اسم منطقة Azure لاستخدامها مع المعلمة -Location ، قم بتشغيل الأمر التالي واستخدم قيمة من Location العمود:

Get-AzLocation | Sort-Object DisplayName | FT DisplayName, Location

استرداد معرف الكائن لتجمع مضيف أو مساحة عمل أو مجموعة تطبيقات أو تطبيق

تتطلب منك بعض أوامر PowerShell cmdlets توفير معرف الكائن لعناصر خدمة Azure Virtual Desktop. إليك بعض الأمثلة:

• لاسترداد معرف الكائن لتجمع مضيف، قم بتشغيل الأمر التالي:

  (Get-AzWvdHostPool -Name <HostPoolName> -ResourceGroupName <ResourceGroupName>).ObjectId
  

• لاسترداد معرف الكائن لمساحة عمل، قم بتشغيل الأمر التالي:

  (Get-AzWvdWorkspace -Name <WorkspaceName> -ResourceGroupName <ResourceGroupName>).ObjectID
  

• لاسترداد معرف الكائن لمجموعة تطبيقات، قم بتشغيل الأمر التالي:

  (Get-AzWvdApplicationGroup -Name <ApplicationGroupName> -ResourceGroupName <ResourceGroupName>).ObjectId
  

• لاسترداد معرف الكائن لتطبيق سطح المكتب، قم بتشغيل الأمر التالي:

  (Get-AzWvdDesktop -Name <DesktopName> -ApplicationGroupName <ApplicationGroupName> -ResourceGroupName <ResourceGroupName>).ObjectId
  

• لاسترداد معرفات الكائن لكافة تطبيقات RemoteApp في مجموعة تطبيقات، قم بتشغيل الأمر التالي:

  Get-AzWvdApplication -ApplicationGroupName <ApplicationGroupName> -ResourceGroupName <ResourceGroupName> | Select-Object Name, FilePath, ObjectId
  

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

الآن بعد أن عرفت كيفية استخدام Azure CLI وAzure PowerShell مع Azure Virtual Desktop، إليك بعض المقالات التي تستخدمها:

• إنشاء تجمع مضيف Azure Virtual Desktop باستخدام PowerShell أو Azure CLI
• إدارة مجموعات التطبيقات باستخدام PowerShell أو Azure CLI
• للحصول على وثائق مرجع PowerShell الكاملة، راجع Az.DesktopVirtualization.