Vyhledání a použití imagí virtuálních počítačů Azure Marketplace pomocí Azure PowerShellu
Platí pro: ✔️ Virtuální počítače s Windows s Linuxem ✔️ ✔️ – Flexibilní škálovací sady Uniform Scale Sets ✔️
Tento článek popisuje, jak pomocí Azure PowerShellu najít image virtuálních počítačů na 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 použít Azure Marketplace nebo Azure CLI.
Terminologie
Image Marketplace v Azure má následující atributy:
- Vydavatel: 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
- Skladová položka: Instance nabídky, například hlavní verze distribuce. Příklady: 18.04-LTS, 2019-Datacenter
- Verze: Číslo verze skladové položky image.
Tyto hodnoty lze předat jednotlivě nebo jako identifikátor URN obrázku a kombinovat hodnoty oddělené dvojtečkam (:). Příklad: Publisher:Offer:Sku:Version. Číslo verze v URN latest
můžete nahradit použitím nejnovější verze image.
Pokud vydavatel image poskytuje další licenční a nákupní podmínky, musíte tyto podmínky před použitím image přijmout. Další informace najdete v tématu Přijetí podmínek nákupního plánu.
Výchozí obrázky
PowerShell nabízí několik předdefinovaných aliasů obrázků, které usnadňují proces vytváření prostředků. Existují různé image pro prostředky s operačním systémem Windows nebo Linux. Několik rutin PowerShellu, například New-AzVM
a New-AzVmss
, umožňuje zadat název aliasu jako parametr.
Příklad:
$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
Názvy aliasů imagí Linuxu a jejich podrobnosti:
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
Názvy aliasů imagí Windows a jejich podrobnosti jsou:
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
Výpis imagí
Pomocí PowerShellu můžete seznam imagí zúžit, pokud chcete použít konkrétní image, která není ve výchozím nastavení k dispozici. Nahraďte hodnoty následujících proměnných tak, aby vyhovovaly vašim potřebám.
Vypíše vydavatele imagí pomocí rutiny Get-AzVMImagePublisher.
$locName="<location>" Get-AzVMImagePublisher -Location $locName | Select PublisherName
Pro daného vydavatele uveďte jejich nabídky pomocí rutiny Get-AzVMImageOffer.
$pubName="<publisher>" Get-AzVMImageOffer -Location $locName -PublisherName $pubName | Select Offer
Pro daného vydavatele a nabídku uveďte skladové položky, které jsou k dispozici pomocí Rutiny Get-AzVMImageSku.
$offerName="<offer>" Get-AzVMImageSku -Location $locName -PublisherName $pubName -Offer $offerName | Select Skus
V případě skladové položky vypíšete verze image pomocí rutiny Get-AzVMImage.
$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ídky, skladové položky a verze zkombinovat do URN (hodnoty oddělené :). Při vytváření virtuálního počítače pomocí rutiny New-AzVM předejte tento identifikátor URN s -Image
parametrem. Pokud chcete získat nejnovější verzi image, můžete také nahradit číslo verze v URN latest
.
Pokud nasadíte virtuální počítač pomocí šablony Resource Manageru, musíte parametry image nastavit jednotlivě ve vlastnostech imageReference
. Viz referenční informace k šablonám.
Zobrazení vlastností nákupního plánu
Některé image virtuálních počítačů na Azure Marketplace mají další licenční a nákupní podmínky, které musíte přijmout, abyste je mohli nasadit programově. Podmínky obrázku musíte přijmout jednou pro každé předplatné.
Pokud chcete zobrazit informace o plánu nákupu image, spusťte rutinu Get-AzVMImage
. PurchasePlan
Pokud vlastnost ve výstupu není null
, image obsahuje termíny, které musíte před programovým nasazením přijmout.
Například image Windows Serveru 2016 Datacenter nemá další termíny, takže tyto PurchasePlan
informace jsou null
:
$version = "2016.127.20170406"
Get-AzVMImage -Location $locName -PublisherName $pubName -Offer $offerName -Skus $skuName -Version $version
Výstup vypadá podobně jako následující výstup:
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 Datová Věda Virtual Machine – Windows 2016, která má následující PurchasePlan
vlastnosti: name
, product
a publisher
. Některé obrázky mají promotion code
také vlastnost. Pokud chcete tuto bitovou kopii nasadit, přečtěte si následující části s podmínkami a povolením programového nasazení.
Get-AzVMImage -Location "westus" -PublisherName "microsoft-ads" -Offer "windows-data-science-vm" -Skus "windows2016" -Version "0.2.02"
Výstup vypadá podobně jako následující výstup:
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 plánu nákupu. Výstup poskytuje odkaz na termíny pro image Marketplace a ukazuje, jestli jste podmínky dříve přijali. Nezapomeňte použít všechna malá písmena v hodnotách parametrů.
Get-AzMarketplaceterms -Publisher "microsoft-ads" -Product "windows-data-science-vm" -Name "windows2016"
Výstup bude vypadat nějak takto:
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 nákupního plánu
Pomocí rutiny Set-AzMarketplaceterms přijměte nebo odmítněte podmínky. Podmínky pro image musíte přijmout jenom jednou pro každé předplatné. Nezapomeňte použít všechna malá písmena v hodnotách parametrů.
$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 už 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 imagi 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í, abyste zadali informace o nákupním plánu pomocí rutiny 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 další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, přečtěte si předchozí část Přijetí podmínek nákupního plánu.
Vytvoření nového virtuálního počítače z virtuálního pevného disku s informacemi o nákupním plánu
Pokud máte existující virtuální pevný disk vytvořený pomocí image Azure Marketplace, budete možná muset při vytváření nového virtuálního počítače z daného virtuálního pevného disku zadat informace o nákupním plánu.
Pokud máte původní virtuální počítač nebo jiný virtuální počítač vytvořený ze stejné image, můžete získat název plánu, vydavatele a informace o produktu z něj pomocí rutiny 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 nedostali informace o plánu před odstraněním původního virtuálního počítače, můžete podat žádost o podporu. Žádost o podporu vyžaduje minimálně 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í informací o plánu do konfigurace virtuálního počítače pomocí rutiny Set-AzVMPlan podobné následujícímu:
$vmConfig = Set-AzVMPlan `
-VM $vmConfig `
-Publisher "publisherName" `
-Product "productName" `
-Name "planName"
Další kroky
Pokud chcete rychle vytvořit virtuální počítač pomocí rutiny New-AzVM
pomocí základních informací o imagi, přečtěte si téma Vytvoření virtuálního počítače s Windows pomocí PowerShellu.
Další informace o použití imagí Azure Marketplace k vytváření vlastních imagí v Galerii výpočetních prostředků Azure (dříve označované jako Galerie sdílených imagí) najdete v tématu Poskytnutí informací o nákupním plánu Azure Marketplace při vytváření imagí.