البحث عن صور جهاز ظاهري من Azure Marketplace واستخدامها مع Azure PowerShell

مقالة
05/16/2022
قراءة خلال 5 دقائق

ينطبق على: ✔️ أجهزة ظاهرية بنظام التشغيل Linux ✔️ أجهزة ظاهرية بنظام التشغيل Windows ✔️ مجموعات التوسعة المرنة ✔️ مجموعات التوسعة الموحدة

توضح هذه المقالة كيفية استخدام Azure PowerShell للبحث عن صور الجهاز الظاهري في Azure Marketplace. يمكنك بعد ذلك تحديد صورة Marketplace ومعلومات الخطة عند إنشاء جهاز ظاهري.

يمكنك أيضاً استعراض الصور والعروض المتوفرة باستخدام Azure Marketplace أو Azure CLI.

المصطلحات

تحتوي صورة Marketplace في Azure على السمات التالية:

الموزع: المؤسسة التي أنشأت الصورة. الأمثلة: Canonical وMicrosoftWindowsServer
العرض: اسم مجموعة الصور ذات الصلة التي أنشأها موزع. الأمثلة: UbuntuServer، وWindowsServer
SKU: مثيل أحد العروض، مثل إصدار رئيسي للتوزيع. الأمثلة: 18.04-LTS، و2019-Datacenter
الإصدار: رقم إصدار SKU للصورة.

يمكن تمرير هذه القيم بشكلٍ فردي أو كصورة URN مع دمج القيم المفصولة بنقطتين (:). على سبيل المثال: الموزع:العرض:Sku:الإصدار. يمكنك استبدال رقم الإصدار في URN بـ latest لاستخدام أحدث نسخة من الصورة.

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

قائمة الصور

يمكنك استخدام PowerShell لتضييق نطاق قائمة الصور. استبدل قيم المتغيرات لتلبية احتياجاتك.

أدرج موزعي الصور باستخدام Get-AzVMImagePublisher.

$locName="<location>"
Get-AzVMImagePublisher -Location $locName | Select PublisherName

لموزع معين، قم بإدراج عروضه باستخدام Get-AzVMImageOffer.

$pubName="<publisher>"
Get-AzVMImageOffer -Location $locName -PublisherName $pubName | Select Offer

لموزع وعرض معينين، قم بإدراج وحدات SKU المتوفرة باستخدام Get-AzVMImageSku.
```
$offerName="<offer>"
Get-AzVMImageSku -Location $locName -PublisherName $pubName -Offer $offerName | Select Skus
```
لـ SKU، قم بإدراج إصدارات الصورة باستخدام Get-AzVMImage.
```
$skuName="<SKU>"
Get-AzVMImage -Location $locName -PublisherName $pubName -Offer $offerName -Sku $skuName | Select Version
```
يمكنك أيضاً استخدام latest إذا كنت ترغب في استخدام أحدث صورة وليس إصداراً قديماً محدداً.

يمكنك الآن دمج الموزع، والعرض، وSKU، والإصدار المحددين في URN (قيم مفصولة بـ :). قم بتمرير URN هذا باستخدام المعلمة -Image عند إنشاء جهاز ظاهري باستخدام New-AzVM cmdlet. يمكنك أيضاً استبدال رقم الإصدار في URN بـ latest للحصول على أحدث نسخة من الصورة.

إذا قمت بتوزيع جهاز ظاهري باستخدام قالب Resource Manager، فإنك تقوم بتعيين معلمات الصورة بشكلٍ فردي في الخصائص imageReference. راجع مرجع القالب.

عرض خصائص خطة الشراء

تحتوي بعض صور الأجهزة الظاهرية في Azure Marketplace على شروط ترخيص وشراء إضافية يجب عليك قبولها قبل أن تتمكن من توزيعها برمجياً. ستحتاج إلى قبول شروط الصورة مرة واحدة لكل اشتراك.

لعرض معلومات خطة شراء صورة، قم بتشغيل Get-AzVMImage cmdlet. إذا كانت الخاصية PurchasePlan في الإخراج ليست null، فإن الصورة فيها شروط تحتاج إلى قبولها قبل التوزيع البرمجي.

على سبيل المثال، لا تحتوي صورة مركز بيانات Windows Server 2016 على شروط إضافية، ومن ثَمَّ فإن المعلومات PurchasePlan هيnull:

$version = "2016.127.20170406"
Get-AzVMImage -Location $locName -PublisherName $pubName -Offer $offerName -Skus $skuName -Version $version

سيبدو الإخراج مشابهاً لما يلي:

Id               : /Subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/Providers/Microsoft.Compute/Locations/westus/Publishers/MicrosoftWindowsServer/ArtifactTypes/VMImage/Offers/WindowsServer/Skus/2016-Datacenter/Versions/2019.0.20190115
Location         : westus
PublisherName    : MicrosoftWindowsServer
Offer            : WindowsServer
Skus             : 2019-Datacenter
Version          : 2019.0.20190115
FilterExpression :
Name             : 2019.0.20190115
OSDiskImage      : {
                     "operatingSystem": "Windows"
                   }
PurchasePlan     : null
DataDiskImages   : []

يوضح المثال أدناه أمراً مشابهاً لصورة الجهاز الظاهري لعلوم البيانات - Windows 2016، والذي يحتوي على خصائص PurchasePlan التالية: name، وproduct، وpublisher. تحتوي بعض الصور أيضاً على الخاصية promotion code. لتوزيع هذه الصورة، راجع الأقسام التالية لقبول الشروط ولتمكين التوزيع البرمجي.

Get-AzVMImage -Location "westus" -PublisherName "microsoft-ads" -Offer "windows-data-science-vm" -Skus "windows2016" -Version "0.2.02"

سيبدو الإخراج مشابهاً لما يلي:

Id               : /Subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/Providers/Microsoft.Compute/Locations/westus/Publishers/microsoft-ads/ArtifactTypes/VMImage/Offers/windows-data-science-vm/Skus/windows2016/Versions/19.01.14
Location         : westus
PublisherName    : microsoft-ads
Offer            : windows-data-science-vm
Skus             : windows2016
Version          : 19.01.14
FilterExpression :
Name             : 19.01.14
OSDiskImage      : {
                     "operatingSystem": "Windows"
                   }
PurchasePlan     : {
                     "publisher": "microsoft-ads",
                     "name": "windows2016",
                     "product": "windows-data-science-vm"
                   }
DataDiskImages   : []

لعرض شروط الترخيص، استخدم Get-AzMarketplaceterms cmdlet ومرر معلمات خطة الشراء. يوفر الإخراج رابطاً إلى شروط صورة Marketplace ويوضح ما إذا كنت قد قبلت الشروط مسبقاً. تأكد من استخدام كافة الأحرف الصغيرة في قيم المعلمات.

Get-AzMarketplaceterms -Publisher "microsoft-ads" -Product "windows-data-science-vm" -Name "windows2016"

سيبدو الإخراج مشابهاً لما يلي:

Publisher         : microsoft-ads
Product           : windows-data-science-vm
Plan              : windows2016
LicenseTextLink   : https://storelegalterms.blob.core.windows.net/legalterms/3E5ED_legalterms_MICROSOFT%253a2DADS%253a24WINDOWS%253a2DDATA%253a2DSCIENCE%253a2DVM%253a24WINDOWS2016%253a24OC5SKMQOXSED66BBSNTF4XRCS4XLOHP7QMPV54DQU7JCBZWYFP35IDPOWTUKXUC7ZAG7W6ZMDD6NHWNKUIVSYBZUTZ245F44SU5AD7Q.txt
PrivacyPolicyLink : https://www.microsoft.com/EN-US/privacystatement/OnlineServices/Default.aspx
Signature         : 2UMWH6PHSAIM4U22HXPXW25AL2NHUJ7Y7GRV27EBL6SUIDURGMYG6IIDO3P47FFIBBDFHZHSQTR7PNK6VIIRYJRQ3WXSE6BTNUNENXA
Accepted          : False
Signdate          : 1/25/2019 7:43:00 PM

قبول شروط خطة الشراء

استخدم Set-AzMarketplaceterms cmdlet لقبول الشروط أو رفضها. تحتاج فقط إلى قبول الشروط مرة واحدة لكل اشتراك للصورة. تأكد من استخدام كافة الأحرف الصغيرة في قيم المعلمات.

$agreementTerms=Get-AzMarketplaceterms -Publisher "microsoft-ads" -Product "windows-data-science-vm" -Name "windows2016"

Set-AzMarketplaceTerms -Publisher "microsoft-ads" -Product "windows-data-science-vm" -Name "windows2016" -Terms $agreementTerms -Accept

Publisher         : microsoft-ads
Product           : windows-data-science-vm
Plan              : windows2016
LicenseTextLink   : https://storelegalterms.blob.core.windows.net/legalterms/3E5ED_legalterms_MICROSOFT%253a2DADS%253a24WINDOWS%253a2DDATA%253a2DSCIENCE%253a2DV
                    M%253a24WINDOWS2016%253a24OC5SKMQOXSED66BBSNTF4XRCS4XLOHP7QMPV54DQU7JCBZWYFP35IDPOWTUKXUC7ZAG7W6ZMDD6NHWNKUIVSYBZUTZ245F44SU5AD7Q.txt
PrivacyPolicyLink : https://www.microsoft.com/EN-US/privacystatement/OnlineServices/Default.aspx
Signature         : XXXXXXK3MNJ5SROEG2BYDA2YGECU33GXTD3UFPLPC4BAVKAUL3PDYL3KBKBLG4ZCDJZVNSA7KJWTGMDSYDD6KRLV3LV274DLBXXXXXX
Accepted          : True
Signdate          : 2/23/2018 7:49:31 PM

إنشاء جهاز ظاهري جديد من صورة marketplace

إذا كانت لديك بالفعل معلومات حول الصورة التي تريد استخدامها، فيمكنك تمرير هذه المعلومات إلى Set-AzVMSourceImage cmdlet لإضافة معلومات الصورة إلى تكوين الجهاز الظاهري. راجع الأقسام التالية للبحث عن الصور المتوفرة في marketplace وإدراجها في القائمة.

تتطلب بعض الصور المدفوعة أيضاً تقديم معلومات خطة الشراء باستخدام Set-AzVMPlan.

...

$vmConfig = New-AzVMConfig -VMName "myVM" -VMSize Standard_D1

# Set the Marketplace image
$offerName = "windows-data-science-vm"
$skuName = "windows2016"
$version = "19.01.14"
$vmConfig = Set-AzVMSourceImage -VM $vmConfig -PublisherName $publisherName -Offer $offerName -Skus $skuName -Version $version

# Set the Marketplace plan information, if needed
$publisherName = "microsoft-ads"
$productName = "windows-data-science-vm"
$planName = "windows2016"
$vmConfig = Set-AzVMPlan -VM $vmConfig -Publisher $publisherName -Product $productName -Name $planName

...

ستقوم بعد ذلك بتمرير تكوين الجهاز الظاهري مع عناصر التكوين الأخرى إلى New-AzVM cmdlet. للحصول على مثال مفصل لاستخدام تكوين جهاز ظاهري مع PowerShell، راجع هذا البرنامج النصي.

إذا تلقيت رسالة حول قبول شروط الصورة، فراجع القسم السابق قبول شروط خطة الشراء.

إنشاء جهاز ظاهري جديد من VHD مع معلومات خطة الشراء

إذا كان لديك VHD موجود تم إنشاؤه باستخدام صورة Azure Marketplace، فقد تحتاج إلى توفير معلومات خطة الشراء عند إنشاء جهاز ظاهري جديد من VHD هذا.

إذا كان لا يزال لديك الجهاز الظاهري الأصلي، أو جهاز ظاهري آخر تم إنشاؤه من نفس الصورة، فيمكنك الحصول على اسم الخطة، والموزع، ومعلومات المنتج منه باستخدام Get-AzVM. يحصل هذا المثال على جهاز ظاهري يسمى myVM في مجموعة موارد myResourceGroup ثم يعرض معلومات خطة الشراء.

$vm = Get-azvm `
   -ResourceGroupName myResourceGroup `
   -Name myVM
$vm.Plan

إذا لم تحصل على معلومات الخطة قبل حذف الجهاز الظاهري الأصلي، فيمكنك تقديم طلب دعم. سيحتاجون إلى اسم الجهاز الظاهري، ومعرّف الاشتراك، والطابع الزمني لعملية الحذف.

لإنشاء جهاز ظاهري باستخدام VHD، راجع هذه المقالة إنشاء جهاز ظاهري من VHD متخصص وإضافة سطر لإضافة معلومات الخطة إلى تكوين الجهاز الظاهري باستخدام Set-AzVMPlan مشابهة لما يلي:

$vmConfig = Set-AzVMPlan `
   -VM $vmConfig `
   -Publisher "publisherName" `
   -Product "productName" `
   -Name "planName"

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

لإنشاء جهاز ظاهري بسرعة باستخدام New-AzVM cmdlet باستخدام معلومات الصورة الأساسية، راجع إنشاء جهاز ظاهري بنظام التشغيل Windows باستخدام PowerShell.

لمزيد من المعلومات حول استخدام الصور Azure Marketplace لإنشاء صور مخصصة في Azure Compute Gallery (المعروف سابقاً باسم Shared Image Gallery)، راجع توفير معلومات خطة شراء Azure Marketplace عند إنشاء الصور.

البحث عن صور جهاز ظاهري من Azure Marketplace واستخدامها مع Azure PowerShell

هل هذه الصفحة مفيدة؟

المصطلحات

قائمة الصور

عرض خصائص خطة الشراء

قبول شروط خطة الشراء

إنشاء جهاز ظاهري جديد من صورة marketplace

إنشاء جهاز ظاهري جديد من VHD مع معلومات خطة الشراء

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