Skapa azure local vm-avbildning med Azure Marketplace-avbildningar
Gäller för: Azure Local 2311.2 och senare
I den här artikeln beskrivs hur du skapar virtuella datoravbildningar (VM) för Azure Local med hjälp av källavbildningar från Azure Marketplace. Du kan skapa VM-avbildningar med hjälp av Azure Portal eller Azure CLI och sedan använda dessa VM-avbildningar för att skapa virtuella Arc-datorer på Azure Local.
Förutsättningar
Innan du börjar kontrollerar du att följande krav har slutförts.
Se till att granska och slutföra förutsättningarna.
Kontrollera att du har rollen Azure Connected Machine Resource Manager. Mer information finns i Tilldela Azure-roller.
Kontrollera att din prenumeration är registrerad hos
Microsoft.EdgeMarketplace
-resursprovidern. För mer information, se Registrera resursleverantör.Om du använder en klient för att ansluta till din lokala Azure-instans, se Anslut till systemet via fjärranslutning.
Lägga till VM-avbildning från Azure Marketplace
Du skapar en VM-avbildning från en Azure Marketplace-avbildning och använder sedan den här avbildningen för att distribuera virtuella datorer på din lokala Azure-instans.
Följ de här stegen för att skapa en vm-avbildning med hjälp av Azure CLI.
Logga in och ange prenumeration
Anslut till en dator på din Azure Local.
Logga in. Ange:
az login --use-device-code
Ställ in din prenumeration.
az account set --subscription <Subscription ID>
Ange vissa parametrar
Ange parametrar för din prenumeration, resursgrupp, plats, operativsystemtyp för avbildningen. Ersätt parametrarna i
< >
med lämpliga värden.$subscription = "<Subscription ID>" $resource_group = "<Resource group>" $mktplaceImage = "<Marketplace image name>" $customLocationName = "<Custom location name>" $customLocationID = (az customlocation show --resource-group $resource_group --name "<custom_location_name_for_Azure_Local>" --query id -o tsv) $location = "<Location for your Azure Local>" $osType = "<OS of source image>"
Parametrarna beskrivs i följande tabell:
Parameter Beskrivning subscription
Prenumeration som är associerad med din Azure Local. resource-group
Resursgrupp för din Azure Local som du associerar med den här bilden. name
Namnet på marketplace-avbildningen för Azure Local. customLocation
Resurs-ID för anpassad plats för din Azure Local. location
Plats för din Azure Local. Det kan till exempel vara eastus
.os-type
Operativsystem som är associerat med källavbildningen. Detta kan vara Windows eller Linux. Här är ett exempel på utdata:
PS C:\Users\azcli> $subscription = "<Subscription ID>" PS C:\Users\azcli> $resource_group = "mylocal-rg" PS C:\Users\azcli> $mktplaceImage= "mylocal-marketplaceimage" PS C:\Users\azcli> $customLocationName = "mylocal-cl" PS C:\Users\azcli> $customerLocationID /subscriptions$subscription/resourcegroups/$resource_group/providers/microsoft.extendedlocation/customlocations/$customLocationName PS C:\Users\azcli> $location = "eastus" PS C:\Users\azcli> $ostype = "Windows"
Skapa VM-avbildning från Marketplace-avbildning
Ange ytterligare parametrar som anger den avsedda VM-avbildningen som du vill skapa. Du måste inkludera erbjudandet, utgivaren, SKU:n och versionen för Marketplace-avbildningen. Ersätt parametrarna i <> med lämpliga värden:
$publisher = "<Publisher name>" $offer = "<OS offer>" $sku = "<Image SKU>"
Använd följande tabell för att hitta tillgängliga Marketplace-avbildningar och deras attributvärden:
Name Utgivare Erbjudande Varunummer Windows 11 Enterprise flera sessioner + Microsoft 365 Microsoft Windows-skrivbord office-365 win11-23h2-avd-m365
win11-24h2-avd-m365Windows 10 Enterprise med flera sessioner + Microsoft 365 Microsoft Windows Desktop office-365 win10-21h2-avd-m365 Windows 11 Pro Microsoft Windows Desktop windows-11 win11-23h2-pro Windows 11 Enterprise Microsoft Windows-skrivbord windows-11 win11-22h2-ent
win11-23h2-ent
win11-24h2-entWindows 11 Enterprise med flera sessioner Microsoft Windows Desktop windows-11 win11-22h2-avd
win11-23h2-avd
win11-24h2-avdWindows 10 Pro Microsoft Windows Skrivbord windows-10 win10-22h2-pro-g2 Windows 10 Enterprise Microsoft Windows skrivbord windows-10 win10-22h2-ent-g2 Windows 10 Enterprise med flera sessioner Microsoft Windows Desktop windows-10 win10-22h2-avd Windows Server 2025 Datacenter: Azure Edition microsoftwindowsserver windowsserver 2025-datacenter-azure-edition-smalldisk
2025-datacenter-azure-edition-core
2025-datacenter-azure-editionWindows Server 2022 Datacenter: Azure Edition microsoftwindowsserver windowsserver 2022-datacenter-azure-edition-hotpatch
2022-datacenter-azure-edition-core
2022-datacenter-azure-editionWindows Server 2019 microsoftwindowsserver windowsserver 2019-datacenter-gensecond
2019-datacenter-core-g2SQL Server 2022 Enterprise på Windows Server 2022 microsoftsqlserver sql2022-ws2022 enterprise-gen2
standard-gen2Om du vill skapa en Windows Server 2019 Datacenter-avbildning skulle du ha följande parametrar:
$publisher = "microsoftwindowsserver" $offer = "windowsserver" $sku = "2019-datacenter-gensecond"
Skapa den virtuella datoravbildningen som börjar med en angiven marketplace-avbildning:
az stack-hci-vm image create --resource-group $resource_group --custom-location $customLocationID --name $mktplaceImage --os-type $ostype --offer $offer --publisher $publisher --sku $sku
Här är ett exempel på utdata:
PS C:\Users\azcli> az stack-hci-vm image create --custom-location $cl --name $mktplaceImage --os-type $ostype --resource-group $rg --publisher $publisher --offer $offer --sku $sku
{
"extendedLocation": {
"name": “/subscriptions/<Subscription ID>/resourceGroups/mylocal-rg/providers/Microsoft.ExtendedLocation/customLocations/mylocal-cl",
"type": "CustomLocation"
},
"id": "/subscriptions/<Subscription ID>/resourceGroups/mylocal-rg/providers/Microsoft.AzureStackHCI/marketplacegalleryimages/myhci-marketplaceimage",
\
"location": "eastus",
"name": "myhci-marketplaceimage",
"properties": {
"cloudInitDataSource": null,
"containerId": null,
"hyperVGeneration": null,
"identifier": {
"offer": "windowsserver",
"publisher": "microsoftwindowsserver",
"sku": "2019-datacenter-gensecond"
},
"osType": "Windows",
"provisioningState": "Succeeded",
"status": {
"downloadStatus": {
"downloadSizeInMb": 10832
},
"errorCode": "",
"errorMessage": "",
"progressPercentage": 100,
"provisioningStatus": {
"operationId": "13efc468-7473-429f-911b-858c1e6fc1d5*B11A62EE76B08EF194F8293CDD40F7BC71BFB93255D5A99DD11B4167690752D9",
"status": "Succeeded"
}
},
"version": {
"name": "17763.6293.240905",
"properties": {
"storageProfile": {
"osDiskImage": {
"sizeInMb": 130050
}
}
}
}
},
"resourceGroup": "mylocal-rg",
"systemData": {
"createdAt": "2024-09-23T18:53:13.734389+00:00",
"createdBy": "guspinto@contoso.com",
"createdByType": "User",
"lastModifiedAt": "2024-09-23T19:06:07.532276+00:00",
"lastModifiedBy": "319f651f-7ddb-4fc6-9857-7aef9250bd05",
"lastModifiedByType": "Application"
},
"tags": null,
"type": "microsoft.azurestackhci/marketplacegalleryimages"
}
Mer information om det här CLI-kommandot finns i az stack-hci-vm image.
Lista VM-avbildningar
Du behöver se listan över VM-bilder för att välja en bild att hantera.
Följ de här stegen för att visa VM-avbilder med hjälp av Azure CLI.
Kör PowerShell som administratör.
Ange några parametrar.
$subscription = "<Subscription ID associated with your Azure Local>" $resource_group = "<Resource group name for your Azure Local>"
Visa en lista över alla VM-avbildningar som är associerade med din Azure Local. Kör följande kommando:
az stack-hci-vm image list --subscription $subscription --resource-group $resource_group
Beroende på vilket kommando som används visas en motsvarande uppsättning avbildningar som är associerade med din Azure Local.
- Om du bara anger prenumerationen visar kommandot alla bilder i prenumerationen.
- Om du anger både prenumerationen och resursgruppen visar kommandot alla bilder i resursgruppen.
Dessa bilder omfattar:
- VM-avbildningar från en marknadsplats.
- Anpassade avbildningar som finns i ditt Azure Storage-konto eller finns i en lokal resurs i systemet eller en klient som är ansluten till systemet.
Här är ett exempel på resultat.
PS C:\Users\azcli> az stack-hci-vm image list --subscription "<Subscription ID>" --resource-group "myhci-rg"
Command group 'stack-hci-vm' is experimental and under development. Reference and support levels: https://aka.ms/CLI_refstatus
[
{
"extendedLocation": {
"name": "/subscriptions/<Subscription ID>/resourcegroups/myhci-rg/providers/microsoft.extendedlocation/customlocations/myhci-cl",
"type": "CustomLocation"
},
"id": "/subscriptions/<Subscription ID>/resourceGroups/myhci-rg/providers/microsoft.azurestackhci/marketplacegalleryimages/w
inServer2022Az-01",
"location": "eastus",
"name": "winServer2022Az-01",
"properties": {
"hyperVGeneration": "V2",
"identifier": {
"offer": "windowsserver",
"publisher": "microsoftwindowsserver",
"sku": "2022-datacenter-azure-edition-core"
},
"imagePath": null,
"osType": "Windows",
"provisioningState": "Succeeded",
"status": {
"downloadStatus": {
"downloadSizeInMB": 6710
},
"progressPercentage": 100,
"provisioningStatus": {
"operationId": "19742d69-4a00-4086-8f17-4dc1f7ee6681*E1E9889F0D1840B93150BD74D428EAE483CB67B0904F9A198C161AD471F670ED",
"status": "Succeeded"
}
},
"storagepathId": null,
"version": {
"name": "20348.2031.231006",
"properties": {
"storageProfile": {
"osDiskImage": {
"sizeInMB": 130050
}
}
}
}
},
"resourceGroup": "mylocal-rg",
"systemData": {
"createdAt": "2023-10-30T21:44:53.020512+00:00",
"createdBy": "guspinto@contoso.com",
"createdByType": "User",
"lastModifiedAt": "2023-10-30T22:08:25.495995+00:00",
"lastModifiedBy": "319f651f-7ddb-4fc6-9857-7aef9250bd05",
"lastModifiedByType": "Application"
},
"tags": {},
"type": "microsoft.azurestackhci/marketplacegalleryimages"
}
]
PS C:\Users\azcli>
Mer information om det här CLI-kommandot finns i az stack-hci-vm image list.
Visa egenskaper för VM-avbildning
Du kanske vill visa egenskaperna för VM-avbildningar innan du använder avbildningen för att skapa en virtuell dator. Följ de här stegen för att visa bildegenskaperna:
Följ de här stegen för att använda Azure CLI för att visa egenskaper för en bild:
Kör PowerShell som administratör.
Ange följande parametrar.
$subscription = "<Subscription ID>" $resource_group = "<Azure Local resource group>" $mktplaceImage = "<Marketplace image name>"
Du kan visa bildegenskaper på två olika sätt: ange ID eller ange namn och resursgrupp. Utför följande steg när du anger Marketplace-avbildnings-ID:
Ange följande parameter.
$mktplaceImageID = "/subscriptions/<Subscription ID>/resourceGroups/myhci-rg/providers/Microsoft.AzureStackHCI/galleryimages/mylocal-marketplaceimage"
Kör följande kommando för att visa egenskaperna.
az stack-hci-vm image show --ids $mktplaceImageID
Här är ett exempel på utdata för det här kommandot:
PS C:\Users\azcli> az stack-hci-vm image show --ids $mktplaceImageID Command group 'stack-hci-vm' is experimental and under development. Reference and support levels: https://aka.ms/CLI_refstatus { "extendedLocation": { "name": "/subscriptions/<Subscription ID>/resourcegroups/myhci-rg/providers/microsoft.extendedlocation/customlocations/mylocal-cl", "type": "CustomLocation" }, "id": "/subscriptions/<Subscription ID>/resourceGroups/myhci-rg/providers/Microsoft.AzureStackHCI/galleryimages/mylocal-marketplaceimage", "location": "eastus", "name": "mylocal-marketplaceimage", "properties": { "containerName": null, "hyperVGeneration": null, "identifier": null, "imagePath": null, "osType": "Windows", "provisioningState": "Succeeded", "status": null, "version": null }, "resourceGroup": "mylocal-rg", "systemData": { "createdAt": "2022-08-05T20:52:38.579764+00:00", "createdBy": "guspinto@microsoft.com", "createdByType": "User", "lastModifiedAt": "2022-08-05T20:52:38.579764+00:00", "lastModifiedBy": "guspinto@microsoft.com", "lastModifiedByType": "User" }, "tags": null, "type": "microsoft.azurestackhci/galleryimages" } PS C:\Users\azcli>
Uppdatera VM-avbildning
Viktigt!
De senaste uppdateringarna kan ta lite tid att synas på dina VM-bilder eftersom ytterligare verifieringar utförs.
När en ny uppdaterad avbildning är tillgänglig på Azure Marketplace blir de virtuella datoravbildningarna på Azure Local inaktuella och bör uppdateras. Uppdateringsåtgärden är inte en uppdatering på plats av avbildningen. I stället kan du se för vilka vm-avbildningar en uppdaterad avbildning är tillgänglig och välja avbildningar som ska uppdateras. När du har uppdaterat använder åtgärden skapa VM-avbildning den nya uppdaterade avbildningen.
Om du vill uppdatera en VM-avbildning använder du följande steg i Azure Portal.
Om du vill se om en uppdatering är tillgänglig väljer du en VM-avbildning i listvyn.
På bladet Översikt ser du en banderoll som visar den nya VM-avbildningen som är tillgänglig för nedladdning, om en är tillgänglig. Om du vill uppdatera till den nya bilden väljer du pilikonen.
Granska bildinformationen och välj sedan Granska och skapa. Som standard använder den nya avbildningen samma resursgrupp och instansinformation som föregående bild.
Namnet på den nya avbildningen ökas baserat på namnet på föregående bild. En befintlig avbildning med namnet winServer2022-01 har till exempel en uppdaterad avbildning med namnet winServer2022-02.
Slutför åtgärden genom att välja Skapa.
När den nya VM-avbildningen har skapats skapar du en virtuell dator med den nya avbildningen och kontrollerar att den virtuella datorn fungerar korrekt. Efter verifieringen kan du ta bort den gamla vm-avbildningen.
Ta bort VM-avbildning
Du kanske vill ta bort en VM-avbildning om nedladdningen misslyckas av någon anledning eller om avbildningen inte längre behövs. Följ de här stegen för att ta bort vm-avbildningarna.
Kör PowerShell som administratör.
Ställ in följande parametrar:
$subscription = "<Subscription ID>" $resource_group = "<Azure Local resource group>" $mktplaceImage = "<Markeplace image name>"
Ta bort en befintlig VM-avbildning. Kör följande kommando:
az stack-hci-vm image delete --subscription $subscription --resource-group $resource_group --name $mktplaceImage --yes
Du kan ta bort bilden på två sätt:
- Ange namn och resursgrupp.
- Ange ID.
När du har tagit bort en bild kan du kontrollera att avbildningen har tagits bort. Här är ett exempel på utdata när bilden togs bort genom att ange namnet och resursgruppen.
PS C:\Users\azcli> $subscription = "<Subscription ID>"
PS C:\Users\azcli> $resource_group = "mylocal-rg"
PS C:\Users\azcli> $mktplaceImage = "mymylocal-marketplaceimage"
PS C:\Users\azcli> az stack-hci-vm image delete --name $mktplaceImage --resource-group $resource_group
Command group 'stack-hci-vm' is experimental and under development. Reference and support levels: https://aka.ms/CLI_refstatus
Are you sure you want to perform this operation? (y/n): y
PS C:\Users\azcli> az stack-hci-vm image show --name $mktplaceImage --resource-group $resource_group
Command group 'stack-hci-vm' is experimental and under development. Reference and support levels: https://aka.ms/CLI_refstatus
ResourceNotFound: The Resource 'Microsoft.AzureStackHCI/marketplacegalleryimages/myhci-marketplaceimage' under resource group 'mylocal-rg' was not found. For more details please go to https://aka.ms/ARMResourceNotFoundFix
PS C:\Users\azcli>