Azure Local VM-installatiekopieën maken met behulp van Azure Marketplace-installatiekopieën
Van toepassing op: Azure Local, versie 23H2
In dit artikel wordt beschreven hoe u installatiekopieën van virtuele machines (VM's) maakt voor Azure Local met behulp van broninstallatiekopieën van Azure Marketplace. U kunt VM-installatiekopieën maken met behulp van Azure Portal of Azure CLI en deze VM-installatiekopieën vervolgens gebruiken om Arc-VM's te maken in Azure Local.
Vereisten
Voordat u begint, moet u ervoor zorgen dat de volgende vereisten zijn voltooid.
Zorg ervoor dat u de vereisten controleert en voltooit.
Zorg ervoor dat u de rol Azure Connected Machine Resource Manager hebt. Zie Azure-rollen toewijzenvoor meer informatie.
Als u een client gebruikt om verbinding te maken met uw lokale Exemplaar van Azure, raadpleegt u Verbinding maken met het systeem op afstand.
VM-installatiekopieën toevoegen vanuit Azure Marketplace
U maakt een VM-installatiekopieën vanaf een Azure Marketplace-installatiekopieën en gebruikt deze installatiekopieën vervolgens om VM's te implementeren op uw lokale Azure-exemplaar.
Volg deze stappen om een VM-installatiekopieën te maken met behulp van de Azure CLI.
Aanmelden en abonnement instellen
Maak verbinding met een computer op uw lokale Azure-computer .
Meld u aan. Type:
az login --use-device-code
Stel uw abonnement in.
az account set --subscription <Subscription ID>
Enkele parameters instellen
Stel parameters in voor uw abonnement, resourcegroep, locatie, type besturingssysteem voor de installatiekopie. Vervang de parameters door
< >
de juiste waarden.$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>"
De parameters worden beschreven in de volgende tabel:
Parameter Description subscription
Abonnement dat is gekoppeld aan uw Azure Local. resource-group
Resourcegroep voor uw Azure Local die u aan deze installatiekopieën koppelt. name
Naam van de marketplace-installatiekopieën voor Azure Local. customLocation
Resource-id van aangepaste locatie voor uw Azure Local. location
Locatie voor uw Azure Local. Dit kan bijvoorbeeld zijn eastus
.os-type
Besturingssysteem dat is gekoppeld aan de broninstallatiekopieën. Dit kan Windows of Linux zijn. Hier volgt een voorbeelduitvoer:
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"
VM-installatiekopieën maken op basis van marketplace-installatiekopieën
Stel aanvullende parameters in waarmee de beoogde VM-installatiekopieën worden opgegeven die u wilt maken. U moet de aanbieding, uitgever, SKU en versie voor de marketplace-installatiekopieën opnemen. Vervang de parameters door <> de juiste waarden:
$publisher = "<Publisher name>" $offer = "<OS offer>" $sku = "<Image SKU>"
Gebruik de volgende tabel om de beschikbare Marketplace-installatiekopieën en de bijbehorende kenmerkwaarden te vinden:
Naam Publisher Aanbieden SKU Windows 11 Enterprise-multisessie + Microsoft 365 microsoftwindowsdesktop office-365 win11-23h2-avd-m365 Windows 10 Enterprise-multisessie + Microsoft 365 microsoftwindowsdesktop office-365 win10-21h2-avd-m365
win10-22h2-avd-m365Windows 11 Pro microsoftwindowsdesktop windows-11 win11-23h2-pro Windows 11 Enterprise microsoftwindowsdesktop windows-11 win11-22h2-ent
win11-23h2-ent
win11-24h2-entWindows 11 Enterprise multi-sessie microsoftwindowsdesktop windows-11 win11-22h2-avd
win11-23h2-avd
win11-24h2-avdWindows 10 Pro microsoftwindowsdesktop windows-10 win10-22h2-pro-g2 Windows 10 Enterprise microsoftwindowsdesktop windows-10 win10-22h2-ent-g2 Windows 10 Enterprise multi-sessie microsoftwindowsdesktop 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 op Windows Server 2022 microsoftsqlserver sql2022-ws2022 enterprise-gen2
standard-gen2Als u een installatiekopieën van Windows Server 2019 Datacenter wilt maken, hebt u de volgende parameters:
$publisher = "microsoftwindowsserver" $offer = "windowsserver" $sku = "2019-datacenter-gensecond"
Maak de VM-installatiekopieën die beginnen met een opgegeven Marketplace-installatiekopieën:
az stack-hci-vm image create --resource-group $resource_group --custom-location $customLocationID --name $mktplaceImage --os-type $ostype --offer $offer --publisher $publisher --sku $sku
Hier volgt een voorbeelduitvoer:
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"
}
Zie az stack-hci-vm image voor meer informatie over deze CLI-opdracht.
VM-installatiekopieën weergeven
U moet de lijst met VM-installatiekopieën weergeven om een installatiekopieën te kiezen die u wilt beheren.
Volg deze stappen om de VM-installatiekopieën weer te geven met behulp van Azure CLI.
Voer PowerShell uit als beheerder.
Stel enkele parameters in.
$subscription = "<Subscription ID associated with your Azure Local>" $resource_group = "<Resource group name for your Azure Local>"
Geef een lijst weer van alle VM-installatiekopieën die zijn gekoppeld aan uw Azure Local. Voer de volgende opdracht uit:
az stack-hci-vm image list --subscription $subscription --resource-group $resource_group
Afhankelijk van de gebruikte opdracht worden een bijbehorende set installatiekopieën die zijn gekoppeld aan uw Azure Local weergegeven.
- Als u alleen het abonnement opgeeft, bevat de opdracht alle installatiekopieën in het abonnement.
- Als u zowel het abonnement als de resourcegroep opgeeft, worden met de opdracht alle installatiekopieën in de resourcegroep weergegeven.
Deze afbeeldingen zijn onder andere:
- VM-installatiekopieën van Marketplace-installatiekopieën.
- Aangepaste installatiekopieën die zich in uw Azure Storage-account bevinden of zich in een lokale share op uw systeem bevinden of een client die is verbonden met uw systeem.
Hier volgt een voorbeelduitvoer.
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>
Zie az stack-hci-vm image list voor meer informatie over deze CLI-opdracht.
Eigenschappen van VM-installatiekopieën weergeven
Mogelijk wilt u de eigenschappen van VM-installatiekopieën weergeven voordat u de installatiekopieën gebruikt om een virtuele machine te maken. Volg deze stappen om de afbeeldingseigenschappen weer te geven:
Volg deze stappen om Azure CLI te gebruiken om eigenschappen van een installatiekopieën weer te geven:
Voer PowerShell uit als beheerder.
Stel de volgende parameters in.
$subscription = "<Subscription ID>" $resource_group = "<Azure Local resource group>" $mktplaceImage = "<Marketplace image name>"
U kunt afbeeldingseigenschappen op twee verschillende manieren weergeven: id opgeven of naam en resourcegroep opgeven. Voer de volgende stappen uit bij het opgeven van de Marketplace-installatiekopieën-id:
Stel de volgende parameter in.
$mktplaceImageID = "/subscriptions/<Subscription ID>/resourceGroups/myhci-rg/providers/Microsoft.AzureStackHCI/galleryimages/mylocal-marketplaceimage"
Voer de volgende opdracht uit om de eigenschappen weer te geven.
az stack-hci-vm image show --ids $mktplaceImageID
Hier volgt een voorbeelduitvoer voor deze opdracht:
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>
VM-installatiekopieën bijwerken
Belangrijk
Het kan enige tijd duren voordat de meest recente updates op uw VM-installatiekopieën worden weergegeven wanneer er extra validaties worden uitgevoerd.
Wanneer er een nieuwe bijgewerkte installatiekopieën beschikbaar zijn in Azure Marketplace, worden de VM-installatiekopieën op uw Azure Local verlopen en moeten ze worden bijgewerkt. De updatebewerking is geen in-place update van de installatiekopieën. In plaats daarvan kunt u zien voor welke VM-installatiekopieën een bijgewerkte installatiekopieën beschikbaar zijn en selecteert u installatiekopieën die u wilt bijwerken. Nadat u de vm-installatiekopieën hebt bijgewerkt, wordt de nieuwe bijgewerkte installatiekopieën gebruikt.
Als u een VM-installatiekopieën wilt bijwerken, gebruikt u de volgende stappen in Azure Portal.
Als u wilt zien of er een update beschikbaar is, selecteert u een VM-installatiekopieën in de lijstweergave.
Op de blade Overzicht ziet u een banner met de nieuwe VM-installatiekopieën die u kunt downloaden, indien beschikbaar. Als u wilt bijwerken naar de nieuwe afbeelding, selecteert u het pijlpictogram.
Controleer de details van de afbeelding en selecteer Vervolgens Controleren en maken. De nieuwe installatiekopieën maken standaard gebruik van dezelfde resourcegroep en instantiedetails als de vorige installatiekopieën.
De naam voor de nieuwe installatiekopieën wordt verhoogd op basis van de naam van de vorige afbeelding. Een bestaande installatiekopieën met de naam winServer2022-01 hebben bijvoorbeeld een bijgewerkte installatiekopieën met de naam winServer2022-02.
Selecteer Maken om de bewerking te voltooien.
Nadat de nieuwe VM-installatiekopieën zijn gemaakt, maakt u een virtuele machine met behulp van de nieuwe installatiekopieën en controleert u of de VIRTUELE machine correct werkt. Na verificatie kunt u de oude VM-installatiekopie verwijderen.
VM-installatiekopieën verwijderen
U kunt een VM-installatiekopieën verwijderen als het downloaden om een of andere reden mislukt of als de installatiekopieën niet meer nodig zijn. Volg deze stappen om de VM-installatiekopieën te verwijderen.
Voer PowerShell uit als beheerder.
Stel de volgende parameters in:
$subscription = "<Subscription ID>" $resource_group = "<Azure Local resource group>" $mktplaceImage = "<Markeplace image name>"
Verwijder een bestaande VM-installatiekopieën. Voer de volgende opdracht uit:
az stack-hci-vm image delete --subscription $subscription --resource-group $resource_group --name $mktplaceImage --yes
U kunt afbeelding op twee manieren verwijderen:
- Geef de naam en resourcegroep op.
- Geef de id op.
Nadat u een afbeelding hebt verwijderd, kunt u controleren of de afbeelding is verwijderd. Hier volgt een voorbeelduitvoer wanneer de afbeelding is verwijderd door de naam en de resourcegroep op te geven.
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>