Hitta och använda Azure Marketplace VM-avbildningar med Azure PowerShell

  • Artikel
  • 5 minuter för att läsa

Gäller för: ✔️ Virtuella Linux-datorer:heavy_check_mark: Windows vm:heavy_check_mark: Flexibla skalningsuppsättningar:heavy_check_mark: Enhetliga skalningsuppsättningar

Den här artikeln beskriver hur du använder Azure PowerShell för att hitta VM-avbildningar i Azure Marketplace. Du kan sedan ange en Marketplace-avbildning och planinformation när du skapar en virtuell dator.

Du kan också bläddra bland tillgängliga avbildningar och erbjudanden med hjälp Azure Marketplace eller Azure CLI.

Terminologi

En Marketplace-avbildning i Azure har följande attribut:

  • Publisher: Organisationen som skapade avbildningen. Exempel: Canonical, Microsoft Windows Server
  • Erbjudande: Namnet på en grupp med relaterade avbildningar som skapats av en utgivare. Exempel: UbuntuServer, WindowsServer
  • SKU: En instans av ett erbjudande, till exempel en större distribution. Exempel: 18.04-LTS, 2019-Datacenter
  • Version: Versionsnumret för en avbildnings-SKU.

Dessa värden kan skickas individuellt eller som en bild-URN genom att kombinera värdena avgränsade med kolon (:). Exempel: *Publisher:*Erbjudande:*SKU:*Version. Du kan ersätta versionsnumret i URN med om latest du vill använda den senaste versionen av avbildningen.

Om avbildningsutgivaren tillhandahåller ytterligare licens- och köpvillkor måste du godkänna dem innan du kan använda avbildningen. Mer information finns i Acceptera köpvillkor.

Lista avbildningar

Du kan använda PowerShell för att begränsa en lista med bilder. Ersätt värdena för variablerna så att de uppfyller dina behov.

  1. Visa en lista över avbildningsutgivare med hjälp av Get-AzVMImagePublisher.

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

  2. För en viss utgivare listar du sina erbjudanden med hjälp av Get-AzVMImageOffer.

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

  3. För en viss utgivare och ett erbjudande listar du de SKU:er som är tillgängliga med hjälp av Get-AzVMImageSku.

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

  4. För en SKU listar du versionerna av avbildningen med hjälp av Get-AzVMImage.

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

    Du kan också använda latest om du vill använda den senaste avbildningen och inte en specifik äldre version.

Nu kan du kombinera den valda utgivaren, erbjudandet, SKU:n och versionen till en URN (värden avgränsade med :). Skicka det här URN:et -Image med parametern när du skapar en virtuell dator med cmdleten New-AzVM. Du kan också ersätta versionsnumret i URN med för latest att hämta den senaste versionen av avbildningen.

Om du distribuerar en virtuell dator Resource Manager en mall anger du avbildningsparametrarna individuellt i imageReference egenskaperna. Se mallreferensen.

Visa egenskaper för köpplan

Vissa VM-avbildningar Azure Marketplace ytterligare licens- och köpvillkor som du måste godkänna innan du kan distribuera dem programmatiskt. Du måste godkänna avbildningens villkor en gång per prenumeration.

Om du vill visa information om en avbildnings inköpsplan kör Get-AzVMImage du cmdleten . Om egenskapen PurchasePlan i utdata inte är null har avbildningen termer som du måste godkänna före programmatisk distribution.

Till exempel har Windows Server 2016 Datacenter-avbildningen inga ytterligare villkor, så informationen är PurchasePlan null :

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

Utdata ser ut ungefär så här:

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

Exemplet nedan visar ett liknande kommando för Data Science Virtual Machine - Windows 2016-avbildningen, som har följande PurchasePlan egenskaper: , och name product publisher . Vissa bilder har också en promotion code -egenskap. Information om hur du distribuerar den här avbildningen finns i följande avsnitt för att godkänna villkoren och aktivera programmatisk distribution.

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

Utdata ser ut ungefär så här:

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

Om du vill visa licensvillkoren använder du cmdleten Get-AzMarketplaceterms och skickar parametrarna för inköpsplanen. Utdata innehåller en länk till villkoren för Marketplace-avbildningen och visar om du tidigare har accepterat villkoren. Se till att använda alla gemener i parametervärdena.

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

Utdata ser ut ungefär så här:

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

Acceptera villkoren för köpplanen

Använd cmdleten Set-AzMarketplaceterms för att godkänna eller avvisa villkoren. Du behöver bara godkänna villkoren en gång per prenumeration för avbildningen. Se till att använda alla gemener i parametervärdena.

$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

Skapa en ny virtuell dator från en Marketplace-avbildning

Om du redan har information om vilken avbildning du vill använda kan du skicka informationen till cmdleten Set-AzVMSourceImage för att lägga till avbildningsinformation i VM-konfigurationen. Se nästa avsnitt för att söka efter och lista de avbildningar som är tillgängliga på Marketplace.

Vissa betalda avbildningar kräver också att du anger information om köpplanen med hjälp av 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

...

Sedan skickar du VM-konfigurationen tillsammans med de andra konfigurationsobjekten till New-AzVM cmdleten . Ett detaljerat exempel på hur du använder en VM-konfiguration med PowerShell finns i det här skriptet.

Om du får ett meddelande om att godkänna villkoren i bilden kan du läsa det tidigare avsnittet Acceptera köpvillkor.

Skapa en ny virtuell dator från en virtuell hårddisk med köpplansinformation

Om du har en befintlig virtuell hårddisk som har skapats med en Azure Marketplace-avbildning kan du behöva ange information om inköpsplanen när du skapar en ny virtuell dator från den virtuella hårddisken.

Om du fortfarande har den ursprungliga virtuella datorn eller en annan virtuell dator som skapats från samma avbildning kan du hämta plannamn, utgivare och produktinformation från den med hjälp av Get-AzVM. Det här exemplet hämtar en virtuell dator med namnet myVM i resursgruppen myResourceGroup och visar sedan informationen om inköpsplanen.

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

Om du inte fick informationen om planen innan den ursprungliga virtuella datorn togs bort kan du skicka en supportbegäran. De behöver den virtuella datorns namn, prenumerations-ID och tidsstämpel för borttagningsåtgärden.

Information om hur du skapar en virtuell dator med hjälp av en virtuell hårddisk finns i den här artikeln Skapa en virtuell dator från en specialiserad virtuell hårddisk och lägg till i en rad för att lägga till planinformationen i VM-konfigurationen med Set-AzVMPlan på ett sätt som liknar följande:

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

Nästa steg

Information om hur du snabbt skapar en virtuell dator med cmdleten med hjälp av grundläggande avbildningsinformation finns i New-AzVM Skapa en Windows virtuell dator med PowerShell.

Mer information om hur du använder Azure Marketplace-avbildningar för att skapa anpassade avbildningar i ett Azure Compute-galleri (kallades tidigare Shared Image Gallery) finns i Ange information Azure Marketplace köpplan när du skapar avbildningar.