Menemukan dan menggunakan citra VM di Azure Marketplace dengan Azure PowerShell
Berlaku untuk: ✔️ Mesin virtual Linux ✔️ Mesin virtual Windows ✔️ Set skala fleksibel ✔️ Set skala seragam
Artikel ini menjelaskan cara menggunakan Azure PowerShell untuk menemukan citra VM di Azure Marketplace. Anda kemudian dapat menentukan informasi citra dan paket Marketplace saat membuat VM.
Anda juga dapat menelusuri gambar dan penawaran yang tersedia menggunakan Azure Marketplace atau Azure CLI.
Terminologi
Citra Marketplace di Azure memiliki atribut berikut:
- Penerbit: Organisasi yang membuat citra. Contoh: Canonical, MicrosoftWindowsServer
- Penawaran: Nama grup citra terkait yang dibuat oleh penerbit. Contoh: UbuntuServer, WindowsServer
- SKU: Instans penawaran, seperti rilis utama distribusi. Contoh: 18.04-LTS, 2019-Datacenter
- Versi: Nomor versi SKU citra.
Nilai-nilai ini dapat dilewatkan secara individual atau sebagai URN citra, yang menggabungkan nilai yang dipisahkan oleh titik dua (:). Misalnya: Penerbit:Penawaran:Sku:Versi. Anda dapat mengganti nomor versi di URN dengan latest menggunakan versi citra terbaru.
Jika penerbit gambar menyediakan lisensi lain dan ketentuan pembelian, maka Anda harus menerimanya sebelum dapat menggunakan gambar tersebut. Untuk informasi selengkapnya, lihat Menerima ketentuan paket pembelian.
Gambar Default
Powershell menawarkan beberapa alias gambar yang telah ditentukan sebelumnya untuk mempermudah proses pembuatan sumber daya. Ada gambar yang berbeda untuk sumber daya dengan sistem operasi Windows atau Linux. Beberapa cmdlet Powershell, seperti New-AzVM dan New-AzVmss, memungkinkan Anda memasukkan nama alias sebagai parameter.
Contohnya:
$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
Nama alias gambar Linux dan detailnya adalah:
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
Nama alias gambar Windows dan detailnya adalah:
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
Daftar citra
Anda dapat menggunakan PowerShell untuk mempersempit daftar gambar jika Anda ingin menggunakan gambar tertentu yang tidak disediakan secara default. Ganti nilai variabel di bawah ini untuk memenuhi kebutuhan Anda.
Daftar penerbit citra menggunakan Get-AzVMImagePublisher.
$locName="<location>" Get-AzVMImagePublisher -Location $locName | Select PublisherNameUntuk penerbit tertentu, mencantumkan penawaran mereka menggunakan Get-AzVMImageOffer.
$pubName="<publisher>" Get-AzVMImageOffer -Location $locName -PublisherName $pubName | Select OfferUntuk penerbit dan penawaran tertentu, hubungi SKU yang tersedia menggunakan Get-AzVMImageSku.
$offerName="<offer>" Get-AzVMImageSku -Location $locName -PublisherName $pubName -Offer $offerName | Select SkusUntuk SKU, cantumkan versi citra menggunakan Get-AzVMImage.
$skuName="<SKU>" Get-AzVMImage -Location $locName -PublisherName $pubName -Offer $offerName -Sku $skuName | Select VersionAnda juga dapat
latestmenggunakan jika ingin menggunakan citra terbaru dan bukan versi lama tertentu.
Sekarang Anda dapat menggabungkan penerbit, penawaran, SKU, dan versi yang dipilih ke dalam URN (nilai yang dipisahkan oleh :). Berikan URN ini dengan -Image parameter saat Anda membuat VM dengan cmdlet New-AzVM. Anda dapat mengganti nomor versi di URN dengan latest menggunakan versi citra terbaru.
Jika Anda menyebarkan VM dengan templat Resource Manager, maka Anda harus mengatur parameter gambar satu per imageReference satu di properti. Lihat referensi templat.
Lihat properti paket pembelian
Beberapa gambar VM di Marketplace Azure memiliki lisensi lain dan ketentuan pembelian yang harus Anda terima sebelum Anda dapat menyebarkannya secara terprogram. Anda perlu menerima persyaratan gambar sekali per langganan.
Untuk melihat informasi paket pembelian citra, jalankan Get-AzVMImage cmdlet. Jika properti PurchasePlan dalam output adalah tidak, citra null memiliki istilah yang perlu Anda terima sebelum penyebaran terprogram.
Misalnya, citraPusat Data Windows Server 2016 tidak memiliki persyaratan tambahan, jadi PurchasePlan informasinya null adalah:
$version = "2016.127.20170406"
Get-AzVMImage -Location $locName -PublisherName $pubName -Offer $offerName -Skus $skuName -Version $version
Output terlihat mirip dengan output berikut:
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 : []
Contoh di bawah ini menunjukkan perintah serupa untuk Data Science Virtual Machine - Gambar Windows 2016, yang memiliki properti PurchasePlan berikut: name, product, dan publisher. Beberapa citra juga memiliki promotion code properti. Untuk menyebarkan gambar ini, lihat bagian berikut untuk menerima persyaratan dan mengaktifkan penyebaran terprogram.
Get-AzVMImage -Location "westus" -PublisherName "microsoft-ads" -Offer "windows-data-science-vm" -Skus "windows2016" -Version "0.2.02"
Output terlihat mirip dengan output berikut:
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 : []
Untuk melihat ketentuan lisensi, gunakan cmdlet Get-AzMarketplaceterms dan lewati parameter paket pembelian. Output menyediakan tautan ke persyaratan untuk gambar Marketplace dan menunjukkan apakah Anda sebelumnya menerima persyaratan. Pastikan untuk menggunakan semua huruf kecil dalam nilai parameter.
Get-AzMarketplaceterms -Publisher "microsoft-ads" -Product "windows-data-science-vm" -Name "windows2016"
Output akan terlihat serupa seperti berikut:
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
Terima ketentuan paket pembelian
Gunakan cmdlet Set-AzMarketplaceterms untuk menerima atau menolak persyaratan. Anda hanya perlu menerima persyaratan sekali per langganan untuk citra. Pastikan untuk menggunakan semua huruf kecil dalam nilai parameter.
$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
Membuat VM dari citra terkelola
Jika Anda sudah memiliki informasi tentang gambar apa yang ingin Anda gunakan, Anda dapat meneruskan informasi tersebut ke cmdlet Set-AzVMSourceImage untuk menambahkan informasi citra ke konfigurasi VM. Lihat bagian berikutnya untuk mencari dan mencantumkan citra yang tersedia di marketplace.
Beberapa citra berbayar juga mengharuskan Anda memberikan informasi paket pembelian menggunakan 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
...
Anda kemudian akan meneruskan konfigurasi VM bersama dengan objek konfigurasi lainnya ke New-AzVM cmdlet. Untuk contoh terperinci menggunakan konfigurasi VM dengan PowerShell, lihat skrip ini.
Jika Anda mendapatkan pesan tentang menerima ketentuan citra, lihat bagian sebelumnya Terima ketentuan paket pembelian.
Buat VM baru dari VHD dengan informasi paket pembelian
Jika Anda memiliki VHD yang sudah ada dari komputer virtual yang dibuat menggunakan citra Azure Marketplace berbayar, sebaiknya sediakan informasi paket pembelian saat membuat komputer virtual baru dari VHD tersebut.
Jika Anda masih memiliki VM asli, atau VM lain yang dibuat dari gambar yang sama, Anda bisa mendapatkan nama paket, penerbit, dan informasi produk darinya menggunakan Get-AzVM. Contoh ini mendapatkan VM bernama myVMdi grup sumber daya myResourceGroup lalu menampilkan informasi paket pembelian.
$vm = Get-azvm `
-ResourceGroupName myResourceGroup `
-Name myVM
$vm.Plan
Jika Anda tidak mendapatkan informasi paket sebelum VM asli dihapus, Anda dapat mengajukan permintaan dukungan. Permintaan dukungan membutuhkan minimal nama VM, ID langganan, dan stempel waktu operasi penghapusan.
Untuk membuat VM menggunakan VHD, lihat artikel ini Membuat VM dari VHD khusus dan menambahkan baris untuk menambahkan informasi rencana ke konfigurasi VM menggunakan Set-AzVMPlan yang mirip dengan yang berikut ini:
$vmConfig = Set-AzVMPlan `
-VM $vmConfig `
-Publisher "publisherName" `
-Product "productName" `
-Name "planName"
Langkah berikutnya
Untuk membuat mesin virtual dengan cepat menggunakan New-AzVM cmdlet dengan menggunakan informasi gambar dasar, lihat Membuat mesin virtual Windows dengan PowerShell.
Untuk informasi selengkapnya tentang cara menggunakan citra Marketplace Azure guna membuat citra kustom di Azure Compute Gallery (sebelumnya dikenal sebagai Shared Image Gallery), lihat Menyediakan informasi paket pembelian Azure Marketplace saat membuat citra.