Menemukan dan menggunakan citra VM di Azure Marketplace dengan Azure PowerShell

  • Artikel
  • 5 menit untuk membaca

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 citra menyediakan lisensi tambahan dan ketentuan pembelian, maka Anda harus menerimanya sebelum Anda dapat menggunakan citra. Untuk informasi selengkapnya, lihat Menerima ketentuan paket pembelian.

Daftar citra

Anda dapat menggunakan PowerShell untuk mempersempit daftar citra. Ganti nilai variabel untuk memenuhi kebutuhan Anda.

  1. Daftar penerbit citra menggunakan Get-AzVMImagePublisher.

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

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

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

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

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

  4. 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 menggunakan komputer virtual dengan templat Resource Manager, Anda mengatur parameter citra satu per satu di properti imageReference. Lihat referensi templat.

Lihat properti paket pembelian

Beberapa citra komputer virtual di Azure Marketplace memiliki lisensi tambahan dan ketentuan pembelian yang harus Anda terima sebelum Anda dapat menerapkannya secara terprogram. Anda harus menerima persyaratan citra 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 akan terlihat serupa seperti 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 akan terlihat serupa seperti 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. Tim dukungan akan membutuhkan nama komputer virtual, 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.