Vyhledání a použití Azure Marketplace imagí virtuálních Azure PowerShell

Platí pro: ✔️ Virtuální počítače s Linuxem ✔️ virtuální počítače Windows:heavy_check_mark: Flexibilní škálovací sady ✔️ Jednotné škálovací sady

Tento článek popisuje, jak pomocí Azure PowerShell k vyhledání imagí virtuálních Azure Marketplace. Při vytváření virtuálního počítače pak můžete zadat image Marketplace a informace o plánu.

K procházení dostupných imagí a nabídek můžete také použít Azure Marketplace nebo Azure CLI.

Terminologie

Image z Marketplace v Azure má následující atributy:

  • Publisher: Organizace, která image vytvořila. Příklady: Canonical, MicrosoftWindowsServer
  • Nabídka: Název skupiny souvisejících imagí vytvořených vydavatelem. Příklady: UbuntuServer, WindowsServer
  • SKU: Instance nabídky, například hlavní verze distribuce. Příklady: 18.04-LTS, 2019-Datacenter
  • Verze: Číslo verze SKU image.

Tyto hodnoty lze předat jednotlivě nebo jako název URN obrázku, který kombinuje hodnoty oddělené dvojtečkou (:). Příklad: Publisher:Nabídka:Sku:Verze. Číslo verze v URN můžete nahradit za , abyste mohli latest použít nejnovější verzi image.

Pokud vydavatel image poskytuje další licenční a nákupní podmínky, musíte je před použitím image přijmout. Další informace najdete v tématu Přijetí podmínek plánu nákupu.

Zobrazení seznamu imagí

Pomocí PowerShellu můžete zúžit seznam imagí. Nahraďte hodnoty proměnných tak, aby splňovaly vaše potřeby.

  1. Vy list the image publishers using Get-AzVMImagePublisher.

    $locName="<location>"
    Get-AzVMImagePublisher -Location $locName | Select PublisherName
    
  2. Pro daného vydavatele pomocí příkazu Get-AzVMImageOffer vyobrazte jejich nabídky.

    $pubName="<publisher>"
    Get-AzVMImageOffer -Location $locName -PublisherName $pubName | Select Offer
    
  3. Pro daného vydavatele a nabídku pomocí příkazu Get-AzVMImageSkuvyobrazte dostupné skladové položky.

    $offerName="<offer>"
    Get-AzVMImageSku -Location $locName -PublisherName $pubName -Offer $offerName | Select Skus
    
  4. V případě SKU pomocí příkazu Get-AzVMImagevyískejte seznam verzí image.

    $skuName="<SKU>"
    Get-AzVMImage -Location $locName -PublisherName $pubName -Offer $offerName -Sku $skuName | Select Version
    

    Můžete také použít latest , pokud chcete použít nejnovější image, a ne konkrétní starší verzi.

Teď můžete vybraného vydavatele, nabídku, skladovou položku a verzi zkombinovat do URN (hodnoty oddělené :). Předejte tento název URN s parametrem při vytváření virtuálního -Image počítače pomocí rutiny New-AzVM. Číslo verze v URN můžete také nahradit za a latest získat tak nejnovější verzi image.

Pokud nasadíte virtuální počítač s Resource Manager, nastavíte parametry image jednotlivě ve imageReference vlastnostech. Viz referenční informace k šablonám.

Zobrazení vlastností plánu nákupu

Některé image virtuálních Azure Marketplace mají další licenční a nákupní podmínky, které musíte přijmout, než je můžete nasadit prostřednictvím kódu programu. Podmínky image budete muset pro předplatné přijmout jednou.

Pokud chcete zobrazit informace o plánu nákupu image, spusťte Get-AzVMImage rutinu . Pokud vlastnost ve výstupu není , image obsahuje podmínky, které musíte PurchasePlan null před programickým nasazením přijmout.

Například image Windows Server 2016 Datacenter nemá další termíny, takže informace PurchasePlan jsou null :

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

Výstup bude vypadat podobně jako v následujícím příkladu:

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   : []

Následující příklad ukazuje podobný příkaz pro image Data Science Virtual Machine–Windows 2016, který má následující vlastnosti: , a PurchasePlan name product publisher . Některé obrázky mají také promotion code vlastnost . Pokud chcete nasadit tuto image, přijměte podmínky a povolte programové nasazení v následujících částech.

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

Výstup bude vypadat podobně jako v následujícím příkladu:

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   : []

Pokud chcete zobrazit licenční podmínky, použijte rutinu Get-AzMarketplaceterms a předejte parametry nákupního plánu. Výstup obsahuje odkaz na podmínky pro image z Marketplace a ukazuje, jestli jste podmínky už přijali. V hodnotách parametrů používejte všechna malá písmena.

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

Výstup bude vypadat podobně jako v následujícím příkladu:

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

Přijetí podmínek plánu nákupu

K přijetí nebo zamítnutí podmínek použijte rutinu Set-AzMarketplaceterms. Podmínky pro image je potřeba přijmout jenom jednou pro předplatné. V hodnotách parametrů používejte všechna malá písmena.

$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

Vytvoření nového virtuálního počítače z image marketplace

Pokud již máte informace o tom, jakou image chcete použít, můžete tyto informace předat do rutiny Set-AzVMSourceImage a přidat informace o i image do konfigurace virtuálního počítače. V dalších částech najdete informace o vyhledávání a výpisu imagí dostupných na marketplace.

Některé placené image také vyžadují, aby informace o plánu nákupu poskytovaly pomocí 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

...

Pak do rutiny předáte konfiguraci virtuálního počítače spolu s ostatními objekty New-AzVM konfigurace. Podrobný příklad použití konfigurace virtuálního počítače s PowerShellem najdete v tomto skriptu.

Pokud se zobrazí zpráva o přijetí podmínek image, podívejte se do předchozí části Přijetí podmínek plánu nákupu.

Vytvoření nového virtuálního počítače z virtuálního pevného disku s informacemi o plánu nákupu

Pokud máte existující virtuální pevný disk vytvořený pomocí image Azure Marketplace, možná budete muset při vytváření nového virtuálního počítače z tohoto virtuálního pevného disku zadat informace o plánu nákupu.

Pokud stále máte původní virtuální počítač nebo jiný virtuální počítač vytvořený ze stejné image, můžete z něj získat název plánu, vydavatele a informace o produktu pomocí příkazu Get-AzVM. Tento příklad získá virtuální počítač myVM ve skupině prostředků myResourceGroup a pak zobrazí informace o plánu nákupu.

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

Pokud jste před odstraněním původního virtuálního počítače nedostali informace o plánu, můžete vytvořit žádost o podporu. Budou potřebovat název virtuálního počítače, ID předplatného a časové razítko operace odstranění.

Pokud chcete vytvořit virtuální počítač pomocí virtuálního pevného disku, přečtěte si tento článek Vytvoření virtuálního počítače ze specializovaného virtuálního pevného disku a přidáním řádku pro přidání informací o plánu do konfigurace virtuálního počítače pomocí set-AzVMPlan podobně jako v následujícím příkladu:

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

Další kroky

Informace o rychlém vytvoření virtuálního počítače pomocí rutiny pomocí základních informací o i image najdete v tématu Vytvoření virtuálního Windows počítače pomocí New-AzVM PowerShellu.

Další informace o vytváření vlastních Azure Marketplace imagí v galerii služby Azure Compute (dříve Shared Image Gallery) pomocí imagí Azure Marketplace najdete v tématu o poskytování informací o plánu nákupu Azure Marketplace při vytváření imagí.