Delen via


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.

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

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

  2. Meld u aan. Type:

    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, 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

  1. 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-m365
    Windows 11 Pro microsoftwindowsdesktop windows-11 win11-23h2-pro
    Windows 11 Enterprise microsoftwindowsdesktop 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 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-edition
    Windows Server 2022 Datacenter: Azure Edition microsoftwindowsserver windowsserver 2022-datacenter-azure-edition-hotpatch
    2022-datacenter-azure-edition-core
    2022-datacenter-azure-edition
    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ën van Windows Server 2019 Datacenter wilt maken, hebt u de volgende parameters:

    $publisher = "microsoftwindowsserver" 
    $offer = "windowsserver" 
    $sku = "2019-datacenter-gensecond"
    
  2. 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.

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

  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-installatiekopieën-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> 
      

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.

  1. Als u wilt zien of er een update beschikbaar is, selecteert u een VM-installatiekopieën in de lijstweergave.

    Schermopname die laat zien dat er een update van een VM-installatiekopieën beschikbaar is om te downloaden.

    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.

    Schermopname van een nieuwe VM-installatiekopieën die beschikbaar zijn om te downloaden in de details van de VM-installatiekopieën.

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

    Schermopname van het dialoogvenster Controleren en maken voor een nieuwe VM-installatiekopieën.

  3. Selecteer Maken om de bewerking te voltooien.

    Schermopname van het dialoogvenster Installatiekopieën maken voor een nieuwe VM-installatiekopieën.

    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.

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

Volgende stappen