البحث عن صور جهاز ظاهري من Azure Marketplace واستخدامها مع Azure PowerShell
ينطبق على: ✔️ أجهزة ظاهرية بنظام التشغيل 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 العديد من الأسماء المستعارة للصور المعرفة مسبقا لتسهيل عملية إنشاء الموارد. هناك صور مختلفة للموارد مع نظام التشغيل Windows أو Linux. تسمح لك العديد من أوامر Powershell cmdlets، مثل New-AzVM و New-AzVmss، بإدخال اسم الاسم المستعار كمعلمة.
على سبيل المثال:
$rgname = <Resource Group Name>
$location = <Azure Region>
$vmName = "v" + $rgname
$domainNameLabel = "d" + $rgname
$securePassword = <Password> | ConvertTo-SecureString -AsPlainText -Force
$username = <Username>
$credential = New-Object System.Management.Automation.PSCredential ($username, $securePassword)
New-AzVM -ResourceGroupName $rgname -Location $location -Name $vmName -image Ubuntu2204 -Credential $credential -DomainNameLabel $domainNameLabel
أسماء الأسماء المستعارة لصورة Linux وتفاصيلها هي:
Alias Architecture Offer Publisher Sku Urn Version
----------------------- -------------- ---------------------------- ---------------------- ---------------------------------- ------------------------------------------------------------------------------ ---------
Debian11 x64 Debian-11 Debian 11-backports-gen2 Debian:debian-11:11-backports-gen2:latest latest
FlatcarLinuxFreeGen2 x64 flatcar-container-linux-free kinvolk stable kinvolk:flatcar-container-linux-free:stable:latest latest
OpenSuseLeap154Gen2 x64 opensuse-leap-15-4 SUSE gen2 SUSE:opensuse-leap-15-4:gen2:latest latest
RHELRaw8LVMGen2 x64 RHEL RedHat 8-lvm-gen2 RedHat:RHEL:8-lvm-gen2:latest latest
SLES x64 sles-15-sp3 SUSE gen2 SUSE:sles-15-sp3:gen2:latest latest
Ubuntu2204 x64 0001-com-ubuntu-server-jammy Canonical 22_04-lts-gen2 Canonical:0001-com-ubuntu-server-jammy:22_04-lts-gen2:latest latest
أسماء الأسماء المستعارة لصورة Windows وتفاصيلها هي:
Alias Architecture Offer Publisher Sku Urn Version
----------------------- -------------- ---------------------------- ---------------------- ---------------------------------- ------------------------------------------------------------------------------ ---------
Win2022AzureEdition x64 WindowsServer MicrosoftWindowsServer 2022-datacenter-azure-edition MicrosoftWindowsServer:WindowsServer:2022-datacenter-azure-edition:latest latest
Win2022AzureEditionCore x64 WindowsServer MicrosoftWindowsServer 2022-datacenter-azure-edition-core MicrosoftWindowsServer:WindowsServer:2022-datacenter-azure-edition-core:latest latest
Win10 x64 Windows MicrosoftVisualStudio Windows-10-N-x64 MicrosoftVisualStudio:Windows:Windows-10-N-x64:latest latest
Win2019Datacenter x64 WindowsServer MicrosoftWindowsServer 2019-Datacenter MicrosoftWindowsServer:WindowsServer:2019-Datacenter:latest latest
Win2016Datacenter x64 WindowsServer MicrosoftWindowsServer 2016-Datacenter MicrosoftWindowsServer:WindowsServer:2016-Datacenter:latest latest
Win2012R2Datacenter x64 WindowsServer MicrosoftWindowsServer 2012-R2-Datacenter MicrosoftWindowsServer:WindowsServer:2012-R2-Datacenter:latest latest
Win2012Datacenter x64 WindowsServer MicrosoftWindowsServer 2012-Datacenter MicrosoftWindowsServer:WindowsServer:2012-Datacenter:latest 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 عند إنشاء الصور.