Azure lokale VM-afbeeldingen maken met Azure Marketplace-afbeeldingen

Van toepassing op: Azure Local 2311.2 en hoger

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.

Azure-CLI

• 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.

• Zorg ervoor dat uw abonnement is geregistreerd bij de Microsoft.EdgeMarketplace resourceprovider. Zie Resourceprovider registrerenvoor meer informatie.

• Als u een client gebruikt om verbinding te maken met uw lokale exemplaar van Azure, raadpleeg dan Verbinding maken met het systeem op afstand.

Azure-portal

• 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.

• Zorg ervoor dat uw abonnement is geregistreerd bij de Microsoft.EdgeMarketplace resourceprovider. Zie Resourceprovider registrerenvoor meer informatie.

VM-installatiekopieën toevoegen vanuit Azure Marketplace

U maakt een VM-afbeelding vanuit een Azure Marketplace-afbeelding en gebruikt deze afbeelding vervolgens om VM's te implementeren op uw lokale Azure-omgeving.

Azure-CLI

Volg deze stappen om een VM-image te maken met behulp van de Azure CLI.

Aanmelden en abonnement instellen

1. Maak verbinding met een computer op uw lokale Azure-computer .

2. Meld u aan. Typ

   az login --use-device-code
   

3. Stel uw abonnement in.

   az account set --subscription <Subscription ID>
   

Enkele parameters instellen

1. Stel parameters in voor uw abonnement, resourcegroep, locatie en het type besturingssysteem voor de afbeelding. Vervang de parameters in < > 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	Beschrijving
   subscription	Abonnement dat is gekoppeld aan uw Azure Local.
   resource-group	Resourcegroep voor uw Azure Local die u aan deze image koppelt.
   name	Naam van de marktplaatsafbeelding 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 bronimage. 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-afbeelding maken van marketplace-afbeelding

1. Stel aanvullende parameters in waarmee de bedoelde VM-afbeelding wordt opgegeven die u wilt maken. U moet de aanbieding, uitgever, SKU en versie voor de marktplaatsafbeelding opnemen. Vervang de parameters in <> door de juiste waarden.

   $publisher = "<Publisher name>"
   $offer = "<OS offer>"
   $sku = "<Image SKU>"
   

   Gebruik de volgende tabel om de beschikbare marketplace-afbeeldingen en hun kenmerkwaarden te vinden.

   Naam	Uitgever	Aanbod	SKU
   Windows 11 Enterprise multisessie + Microsoft 365	Microsoft Windows Desktop	office-365	win11-23h2-avd-m365 win11-24h2-avd-m365
   Windows 10 Enterprise-multisessie + Microsoft 365	microsoftwindowsdesktop	office-365	win10-21h2-avd-m365
   Windows 11 Pro	Microsoft Windows Desktop	windows-11	win11-23h2-pro
   Windows 11 Enterprise	Microsoft Windows Desktop	windows-11	win11-22h2-ent win11-23h2-ent win11-24h2-ent
   Windows 11 Enterprise multi-sessie	microsoftwindowsdesktop	windows-11	win11-22h2-avd win11-23h2-avd win11-24h2-avd
   Windows 10 Pro	Microsoft Windows Desktop	windows-10	win10-22h2-pro-g2
   Windows 10 Enterprise	Microsoft Windows Desktop	windows-10	win10-22h2-ent-g2
   Windows 10 Enterprise met meerdere sessies	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-edition
   Windows Server 2022 Datacenter: Azure Edition	microsoftwindowsserver	windowsserver	2022-datacenter-azure-edition-hotpatch 2022-datacenter-azure-edition-core 2022-datacenter-azure-editie
   Windows Server 2019	microsoftwindowsserver	windowsserver	2019-datacenter-gensecond 2019-datacenter-core-g2
   SQL Server 2022 Enterprise op Windows Server 2022	microsoftsqlserver	sql2022-ws2022	enterprise-gen2 standard-gen2

   Als u een installatiekopie van Windows Server 2019 Datacenter wilde maken, zou u de volgende parameters hebben:

   $publisher = "microsoftwindowsserver" 
   $offer = "windowsserver" 
   $sku = "2019-datacenter-gensecond"
   

2. Maak de VM-afbeelding aan, beginnend met een opgegeven Marketplace-afbeelding.

   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.

Azure-portal

Volg deze stappen om een VM-image te maken met behulp van de Azure-portal. Voer in Azure Portal voor uw lokale Azure-resource de volgende stappen uit:

1. Ga naar Resources>VM-images.

2. Selecteer + VM-installatiekopieën toevoegen en selecteer in de vervolgkeuzelijst de optie VM-installatiekopieën toevoegen vanuit Azure Marketplace.

   

3. Voer op het tabblad Basisinformatie de volgende informatie in op de pagina Een afbeelding maken:

   1. Abonnement. Selecteer een abonnement dat u wilt koppelen aan uw VM-installatiekopieën.

   2. Resourcegroep. Maak een nieuwe resourcegroep of selecteer een bestaande resourcegroep die u aan de VM-installatiekopieën koppelt.

   3. Aangepaste locatie. Selecteer een aangepaste locatie om uw VM-installatiekopieën te implementeren. De aangepaste locatie moet overeenkomen met de aangepaste locatie voor uw Lokale Azure-locatie.

   4. Afbeelding die u wilt downloaden. Selecteer een VM-image uit de lijst met images in Azure Marketplace. In de vervolgkeuzelijst worden alle Azure Marketplace-afbeeldingen weergegeven die compatibel zijn met uw Azure-omgeving.

   5. Sla de afbeelding op als. Voer een naam in voor de VM-image.

   6. Opslagpad. Selecteer het opslagpad voor de VM-installatiekopieën. Selecteer Automatisch kiezen om een opslagpad te hebben met hoge beschikbaarheid automatisch geselecteerd. Selecteer Handmatig kiezen om een opslagpad op te geven voor het opslaan van VM-installatiekopieën en configuratiebestanden op het lokale Azure-exemplaar. Zorg er in dit geval voor dat het opgegeven opslagpad voldoende opslagruimte heeft.

4. Selecteer Beoordelen en maken om je VM-image te maken.

   

5. De invoerparameters worden gevalideerd. Als de validaties zijn geslaagd, kunt u de details van de VM-afbeeldingen bekijken en Maken selecteren.

   

6. Er wordt een Azure Resource Manager-sjabloonimplementatieopdracht gestart voor de VM-afbeelding. Het duurt enkele minuten voordat de image-implementatie is voltooid. De tijd die nodig is om de afbeelding te downloaden, is afhankelijk van de grootte van de Marketplace-afbeelding en de beschikbare netwerkbandbreedte voor de download.

   

   U kunt de implementatie van de images bijhouden in het raster van VM-images. U ziet de lijst met de VM-installatiekopieën die al zijn gedownload en de installatiekopieën die op het systeem worden gedownload.

   Als u meer details van een VM-image wilt bekijken, selecteer dan de naam van de VM-image in de lijst met VM-images.

7. Wanneer het downloaden van de afbeeldingen is voltooid, wordt de VM-afbeelding weergegeven in de lijst met afbeeldingen en is de statusBeschikbaar.

   

   Als het downloaden van de VM-installatiekopieën mislukt, worden de foutdetails weergegeven op de portalblade.

   

VM-installatiekopieën weergeven

Je moet de lijst met VM-installatiekopieën bekijken om een installatiekopie te kiezen die je wilt beheren.

Azure-CLI

Volg deze stappen om de VM-installatiekopieën weer te geven met behulp van Azure CLI.

1. Voer PowerShell uit als beheerder.

2. Stel enkele parameters in.

   $subscription = "<Subscription ID associated with your Azure Local>"
   $resource_group = "<Resource group name for your Azure Local>"
   

3. 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 afbeeldingen die zijn gekoppeld aan uw Azure Local weergegeven.

   • Als u alleen het abonnement opgeeft, geeft de opdracht alle afbeeldingen in het abonnement weer.
   • Als u zowel het abonnement als de resourcegroep opgeeft, worden met de opdracht alle afbeeldingen in de resourcegroep weergegeven.

   Deze afbeeldingen zijn onder andere:

   • VM-afbeeldingen van Marketplace-afbeeldingen.
   • Aangepaste installatiekopieën die zich in uw Azure Storage-account bevinden of in een lokale share op uw systeem, of op 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.

Azure-portal

In het Azure-portal van uw lokale Azure-resource kunt u de implementatie van de VM-installatiekopieën bijhouden in het VM-kopiëraster. U ziet de lijst met de VM-installatiekopieën die al zijn gedownload en de installatiekopieën die op uw systeem worden gedownload.

Volg deze stappen om de lijst met VM-installatiekopieën in Azure Portal weer te geven.

1. Ga in Azure Portal naar uw lokale Azure-resource.

2. Ga naar Resources > VM-afbeeldingen.

3. In het rechterdeelvenster kunt u de lijst met VM-afbeeldingen bekijken.

   

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:

Azure-CLI

Volg deze stappen om Azure CLI te gebruiken om eigenschappen van een afbeelding weer te geven:

1. Voer PowerShell uit als beheerder.

2. Stel de volgende parameters in.

   $subscription = "<Subscription ID>"
   $resource_group = "<Azure Local resource group>"
   $mktplaceImage = "<Marketplace image name>"
   

3. 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-image-ID:

   1. Stel de volgende parameter in.

      $mktplaceImageID = "/subscriptions/<Subscription ID>/resourceGroups/myhci-rg/providers/Microsoft.AzureStackHCI/galleryimages/mylocal-marketplaceimage"
      

   2. 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> 
      

Azure-portal

Voer in Azure Portal van uw lokale Azure-resource de volgende stappen uit:

1. Ga naar Resources>VM-images. In het rechterdeelvenster wordt een lijst met VM-installatiekopieën weergegeven.

   

2. Selecteer de VM-naam Afbeelding naam om de eigenschappen te bekijken.

   

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 VM-image beschikbaar is in Azure Marketplace, worden de VM-images op uw lokale Azure-instanties verouderd en moeten ze worden bijgewerkt. De updatebewerking is geen in-place update van de afbeelding. U kunt in plaats daarvan zien voor welke VM-installatiekopieën een bijgewerkte installatiekopie beschikbaar is en selecteert u installatiekopieën die u wilt bijwerken. Nadat u de VM-afbeeldingen hebt bijgewerkt, worden de nieuwe, bijgewerkte afbeeldingen gebruikt.

Om een VM-image bij te werken, gebruikt u de volgende stappen in de Azure portal.

1. Als u wilt zien of er een update beschikbaar is, selecteert u een VM-image 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.

   

2. Controleer de details van de afbeelding en selecteer Controleren en maken. De nieuwe image gebruikt standaard dezelfde resourcegroep en instantiedetails als de vorige image.

   De naam voor de nieuwe afbeelding wordt verhoogd op basis van de naam van de vorige afbeelding. Een bestaande installatiekopie met de naam winServer2022-01 heeft bijvoorbeeld een bijgewerkte installatiekopie met de naam winServer2022-02.

   

3. 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.

Azure-CLI

1. Voer PowerShell uit als beheerder.

2. Stel de volgende parameters in:

   $subscription = "<Subscription ID>"
   $resource_group = "<Azure Local resource group>"
   $mktplaceImage = "<Markeplace image name>"    
   

3. Verwijder een bestaande VM-afbeelding. 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>

Azure-portal

Voer in Azure Portal van uw lokale Azure-resource de volgende stappen uit:

1. Ga naar Resources>VM-installatiekopieën.

2. Selecteer in de lijst met VM-installatiekopieën die worden weergegeven in het rechterdeelvenster het prullenbakpictogram naast de VM-installatiekopieën die u wilt verwijderen.

   

3. Wanneer u wordt gevraagd om het verwijderen te bevestigen, selecteert u Ja.

   

Nadat de VM-installatiekopieën zijn verwijderd, wordt de lijst met VM-installatiekopieën vernieuwd om de verwijderde installatiekopieën weer te geven.

Volgende stappen

• Logische netwerken maken