Menemukan dan menggunakan citra VM di Azure Marketplace dengan Azure PowerShell

Artikel
04/28/2023

Perhatian

Artikel ini mereferensikan CentOS, distribusi Linux yang mendekati status End Of Life (EOL). Harap pertimbangkan penggunaan dan rencanakan yang sesuai. Untuk informasi selengkapnya, lihat panduan Akhir Masa Pakai CentOS.

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 CentOS85Gen285Gen2 -Credential $credential -DomainNameLabel $domainNameLabel

Nama alias gambar Linux dan detailnya adalah:

Alias                     Architecture    Offer                         Publisher               Sku                                 Urn                                                                            Version
-----------------------   --------------  ----------------------------  ----------------------  ----------------------------------  ------------------------------------------------------------------------------ ---------
CentOS85Gen2              x64             CentOS                        OpenLogic               8_5-gen2                            OpenLogic:CentOS:8_5-gen2:latest                                               latest
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
----------------------- --------------  ----------------------------  ----------------------  ----------------------------------  ------------------------------------------------------------------------------   ---------
Win2022Datacenter       x64             WindowsServer                 MicrosoftWindowsServer  2022-Datacenter                     MicrosoftWindowsServer:WindowsServer:2022-Datacenter: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 PublisherName

Untuk penerbit tertentu, mencantumkan penawaran mereka menggunakan Get-AzVMImageOffer.

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

Untuk penerbit dan penawaran tertentu, hubungi SKU yang tersedia menggunakan Get-AzVMImageSku.

$offerName="<offer>"
Get-AzVMImageSku -Location $locName -PublisherName $pubName -Offer $offerName | Select Skus

Untuk SKU, cantumkan versi citra menggunakan Get-AzVMImage.
```
$skuName="<SKU>"
Get-AzVMImage -Location $locName -PublisherName $pubName -Offer $offerName -Sku $skuName | Select Version
```
Anda juga dapat latest menggunakan 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.

Bagikan melalui