Delen via

Azure Marketplace VM-installatiekopieën zoeken en gebruiken met Azure PowerShell

  • Artikel

Van toepassing op: ✔️ Virtuele Linux-machines voor Windows-VM's ✔️ ✔️ Flexibele schaalsets Uniform-schaalsets ✔️

In dit artikel wordt beschreven hoe u Azure PowerShell gebruikt om VM-installatiekopieën te vinden in Azure Marketplace. U kunt vervolgens een Marketplace-installatiekopieën opgeven en informatie plannen wanneer u een virtuele machine maakt.

U kunt ook bladeren door beschikbare installatiekopieën en aanbiedingen met behulp van De Azure Marketplace of de Azure CLI.

Terminologie

Een Marketplace-installatiekopieën in Azure hebben de volgende kenmerken:

  • Uitgever: de organisatie die de installatiekopieën heeft gemaakt. Voorbeelden: Canonical, MicrosoftWindowsServer
  • Aanbieding: De naam van een groep gerelateerde installatiekopieën die zijn gemaakt door een uitgever. Voorbeelden: UbuntuServer, WindowsServer
  • SKU: Een exemplaar van een aanbieding, zoals een grote release van een distributie. Voorbeelden: 18.04-LTS, 2019-Datacenter
  • Versie: het versienummer van een installatiekopieën-SKU.

Deze waarden kunnen afzonderlijk of als afbeeldings-URN worden doorgegeven, waarbij de waarden worden gecombineerd die worden gescheiden door de dubbele punt (:). Bijvoorbeeld: Publisher:Offer:Sku:Version. U kunt het versienummer in de URN vervangen door latest de nieuwste versie van de installatiekopieën te gebruiken.

Als de uitgever van de installatiekopieën andere licentie- en aankoopvoorwaarden biedt, moet u deze accepteren voordat u de installatiekopieën kunt gebruiken. Zie Voorwaarden voor het aankoopplan accepteren voor meer informatie.

Standaardafbeeldingen

PowerShell biedt verschillende vooraf gedefinieerde installatiekopiealiassen om het proces voor het maken van resources eenvoudiger te maken. Er zijn verschillende installatiekopieën voor resources met een Windows- of Linux-besturingssysteem. Met verschillende PowerShell-cmdlets, zoals New-AzVM en New-AzVmss, kunt u de aliasnaam invoeren als een parameter. Voorbeeld:

$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

De aliasnamen van de Linux-installatiekopieën en de bijbehorende gegevens zijn:

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

De namen van de Windows-installatiekopieën en de bijbehorende details zijn:

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

Afbeeldingen weergeven

U kunt PowerShell gebruiken om een lijst met installatiekopieën te verfijnen als u een specifieke installatiekopieën wilt gebruiken die niet standaard is opgegeven. Vervang de waarden van de onderstaande variabelen om aan uw behoeften te voldoen.

  1. Geef de uitgevers van installatiekopieën weer met Behulp van Get-AzVMImagePublisher.

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

  2. Voor een bepaalde uitgever vermeldt u hun aanbiedingen met behulp van Get-AzVMImageOffer.

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

  3. Vermeld voor een bepaalde uitgever en aanbieding de SKU's die beschikbaar zijn met Behulp van Get-AzVMImageSku.

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

  4. Voor een SKU vermeldt u de versies van de installatiekopie met behulp van Get-AzVMImage.

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

    U kunt ook gebruiken latest als u de meest recente installatiekopieën wilt gebruiken en niet een specifieke oudere versie.

U kunt nu de geselecteerde uitgever, aanbieding, SKU en versie combineren in een URN (waarden gescheiden door :). Geef deze URN door met de -Image parameter wanneer u een virtuele machine maakt met de cmdlet New-AzVM . U kunt ook het versienummer in de URN vervangen door latest de nieuwste versie van de installatiekopieën op te halen.

Als u een VIRTUELE machine met een Resource Manager-sjabloon implementeert, moet u de installatiekopieënparameters afzonderlijk instellen in de imageReference eigenschappen. Zie de sjabloonverwijzing.

Eigenschappen van het aankoopplan weergeven

Sommige VM-installatiekopieën in Azure Marketplace hebben andere licentie- en aankoopvoorwaarden die u moet accepteren voordat u ze programmatisch kunt implementeren. U moet de voorwaarden van de installatiekopieën eenmaal per abonnement accepteren.

Als u de aankoopplangegevens van een installatiekopieën wilt weergeven, voert u de Get-AzVMImage cmdlet uit. Als de PurchasePlan eigenschap in de uitvoer niet nullis, bevat de installatiekopieën termen die u moet accepteren voordat u programmatische implementatie uitvoert.

De installatiekopieën van Windows Server 2016 Datacenter bevatten bijvoorbeeld geen aanvullende voorwaarden, dus de PurchasePlan informatie isnull:

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

De uitvoer ziet er ongeveer als volgt uit:

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

In het onderstaande voorbeeld ziet u een vergelijkbare opdracht voor de Datawetenschap Virtual Machine - Windows 2016-installatiekopieën, met de volgende PurchasePlan eigenschappen: name, producten publisher. Sommige afbeeldingen hebben ook een promotion code eigenschap. Als u deze installatiekopieën wilt implementeren, raadpleegt u de volgende secties om de voorwaarden te accepteren en programmatische implementatie in te schakelen.

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

De uitvoer ziet er ongeveer als volgt uit:

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

Als u de licentievoorwaarden wilt bekijken, gebruikt u de cmdlet Get-AzMarketplaceterms en geeft u de parameters voor het aankoopplan door. De uitvoer bevat een koppeling naar de voorwaarden voor de Marketplace-installatiekopieën en geeft aan of u de voorwaarden eerder hebt geaccepteerd. Zorg ervoor dat u alle kleine letters in de parameterwaarden gebruikt.

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

De uitvoer ziet er ongeveer als volgt uit:

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

Voorwaarden voor een aankoopplan accepteren

Gebruik de cmdlet Set-AzMarketplaceterms om de voorwaarden te accepteren of af te wijzen. U hoeft de voorwaarden slechts eenmaal per abonnement voor de installatiekopieën te accepteren. Zorg ervoor dat u alle kleine letters in de parameterwaarden gebruikt.

$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

Een nieuwe VIRTUELE machine maken op basis van een Marketplace-installatiekopieën

Als u al beschikt over de informatie over welke installatiekopie u wilt gebruiken, kunt u die informatie doorgeven aan de cmdlet Set-AzVMSourceImage om installatiekopiegegevens toe te voegen aan de VM-configuratie. Zie de volgende secties voor het zoeken en weergeven van de afbeeldingen die beschikbaar zijn in de marketplace.

Voor sommige betaalde installatiekopieën moet u ook informatie over het aankoopplan opgeven met behulp van het 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

...

Vervolgens geeft u de VM-configuratie samen met de andere configuratieobjecten door aan de New-AzVM cmdlet. Zie dit script voor een gedetailleerd voorbeeld van het gebruik van een VM-configuratie met PowerShell.

Als u een bericht krijgt over het accepteren van de voorwaarden van de afbeelding, raadpleegt u de eerdere sectie Voorwaarden voor het aankoopplan accepteren.

Een nieuwe VIRTUELE machine maken op basis van een VHD met informatie over een aankoopplan

Als u een bestaande VHD hebt die is gemaakt met behulp van een Azure Marketplace-installatiekopieën, moet u mogelijk de aankoopplangegevens opgeven wanneer u een nieuwe VIRTUELE machine maakt op basis van die VHD.

Als u nog steeds de oorspronkelijke VIRTUELE machine of een andere VIRTUELE machine hebt gemaakt op basis van dezelfde installatiekopieën, kunt u de naam van het plan, de uitgever en het product ophalen met behulp van Get-AzVM. In dit voorbeeld wordt een virtuele machine met de naam myVM opgehaald in de resourcegroep myResourceGroup en wordt vervolgens de informatie over het aankoopplan weergegeven.

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

Als u de plangegevens niet hebt opgehaald voordat de oorspronkelijke VM werd verwijderd, kunt u een ondersteuningsaanvraag indienen. De ondersteuningsaanvraag heeft minimaal de vm-naam, abonnements-id en het tijdstempel van de verwijderbewerking nodig.

Als u een virtuele machine wilt maken met behulp van een VHD, raadpleegt u dit artikel Een VIRTUELE machine maken op basis van een gespecialiseerde VHD en voegt u een regel toe om de plangegevens toe te voegen aan de VM-configuratie met behulp van Set-AzVMPlan, vergelijkbaar met de volgende:

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

Volgende stappen

Zie Een virtuele Windows-machine maken met PowerShell als u snel een virtuele machine met de New-AzVM cmdlet wilt maken met behulp van basisinstallatiekopieën.

Zie Informatie over het aankoopplan van Azure Marketplace bij het maken van installatiekopieën in een Azure Compute Gallery (voorheen Shared Image Gallery genoemd) voor meer informatie over het gebruik van Azure Marketplace-installatiekopieën om aangepaste installatiekopieën te maken.