Een Azure lokale VM-image maken met behulp van afbeeldingen in een lokale gedeelde map.

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 een lokale share. 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.

• Voor aangepaste afbeeldingen in een lokale share op uw Azure Local, hebt u de volgende extra voorwaarden:

  • U moet een VHD/VHDX hebben geüpload naar een gedeelde locatie op uw systeem.
  • De VHDX-installatiekopie moet van het type Gen 2 zijn en beveiligd opstarten moet ingeschakeld zijn.
  • De VHDX-image moet worden voorbereid met behulp van sysprep /generalize /shutdown /oobe. Zie De opdrachtregelopties van Sysprep voor meer informatie.
  • De afbeelding moet zich bevinden op een gedeeld clustervolume dat beschikbaar is voor alle machines. Zowel de Windows- als Linux-besturingssystemen worden ondersteund.

• Als u een client gebruikt om verbinding te maken met uw instance van Azure Local, raadpleegt u Verbinding maken met Azure Local via de Azure CLI-client.

Azure-portal

• Zorg ervoor dat u de vereisten controleert en voltooit.

• Voor aangepaste afbeeldingen in een lokale share op uw Azure Local hebt u de volgende extra vereisten:

  • U moet een VHD/VHDX hebben geüpload naar een lokale gedeelde schijf op uw systeem.
  • De VHDX-installatiekopie moet van het type Gen 2 zijn en beveiligd opstarten moet zijn ingeschakeld.
  • De VHDX-image moet worden voorbereid met sysprep /generalize /shutdown /oobe. Zie De opdrachtregelopties van Sysprep voor meer informatie.
  • Het beeld moet zich bevinden op een gedeeld clustervolume dat beschikbaar is voor alle machines in het exemplaar. Zowel de Windows- als Linux-besturingssystemen worden ondersteund.

VM-image toevoegen van image in lokale share

U maakt een VM-installatiekopie vanuit een installatiekopie in een lokale gedeelde map van uw systeem en gebruikt deze installatiekopie vervolgens om VM's te implementeren op uw Azure lokaal.

Azure-CLI

Volg deze stappen om een VM-afbeelding 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 uw abonnement, resourcegroep, locatie en het type besturingssysteem voor het image-bestand in. Vervang de parameters in < > door de juiste waarden.

   $subscription = "<Subscription ID>"
   $resource_group = "<Resource group>"
   $location = "<Location for your Azure Local>"
   $imageName = <VM image name>
   $imageSourcePath = <path to the source image>
   $osType = "<OS of source image>"
   

   De parameters worden beschreven in de volgende tabel:

   Parameter	Beschrijving
   subscription	Abonnementsgroep voor Azure Local die u aan dit beeld koppelt.
   resource_group	Resourcegroep voor Azure Local die u aan deze image associeert.
   location	Locatie voor uw Azure Local. Dit kan bijvoorbeeld zijn eastus.
   image-path	Naam van de VM-afbeelding die is gemaakt vanaf de afbeelding in uw lokale share. Opmerking: Azure weigert alle namen die het trefwoord Windows bevatten.
   name	Pad naar de schijfimage van de brongalerie (alleen VHDX) op uw systeem. Bijvoorbeeld C:\OSImages\winos.vhdx. Bekijk de vereisten van de bronafbeelding.
   os-type	Besturingssysteem dat is verbonden met 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 = "mylocalrg"
   PS C:\Users\azcli> $location = "eastus"
   PS C:\Users\azcli> $osType = "Windows"
   PS C:\ClusterStorage\Volume1> $imageName = "mylocal-localimage"
   PS C:\ClusterStorage\Volume1> $imageSourcePath = "C:\ClusterStorage\Volume1\Windows_K8s_17763.2928.220505-1621_202205101158.vhdx"
   

VM-afbeelding maken van een afbeelding in een lokale share

1. 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. Haal de aangepaste locatie-id voor uw Lokale Azure-locatie op. Voer de volgende opdracht uit:

   $customLocationID=(az customlocation show --resource-group $resource_group --name "<custom location name for system>" --query id -o tsv)
   

2. Maak de VM-afbeelding aan, beginnend met een gespecificeerde afbeelding in een lokale share in uw lokale Azure-omgeving.

   az stack-hci-vm image create --subscription $subscription --resource-group $resource_group --custom-location $customLocationID --location $location --image-path $ImageSourcePath --name $ImageName --os-type $osType --storage-path-id $storagepathid
   
   

   Er wordt een implementatietaak gestart voor de VM-image.

   In dit voorbeeld is het opslagpad opgegeven met behulp van de --storage-path-id vlag en dat ervoor gezorgd dat de workloadgegevens (inclusief de VM, VM-installatiekopieën, niet-besturingssysteemgegevensschijf) in het opgegeven opslagpad worden geplaatst.

   Als de vlag niet is opgegeven, worden de workloadgegevens automatisch in een opslagpad met hoge beschikbaarheid geplaatst.

Het voltooien van de implementatie van de images duurt enkele minuten. De tijd die nodig is om de afbeelding te downloaden, is afhankelijk van de grootte van de afbeelding in de lokale share en de netwerkbandbreedte die beschikbaar is voor de download.

Hier volgt een voorbeelduitvoer:

PS C:\Users\azcli> $customLocationID=(az customlocation show --resource-group $resource_group --name "myhci-cl" --query id -o tsv)
PS C:\Users\azcli> az stack-hci-vm image create --subscription $subscription --resource-group $resource_group --custom-location $customLocationID --location $location --image-path $ImageSourcePath --name $ImageName --os-type $osType --storage-path-id $storagepathid
type="CustomLocation" --location $Location --name $mktplaceImage --os-type $osType --image-path $mktImageSourcePath
Command group 'azurestackhci' is experimental and under development. Reference and support levels: https://aka.ms/CLI_refstatus
{
  "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/galleryimages/mylocal-localimage",
  "location": "eastus",
  "name": "mylocal-localimage",
  "properties": {
    "identifier": null,
    "imagePath": null,
    "osType": "Windows",
    "provisioningState": "Succeeded",
    "status": {
      "downloadStatus": {},
      "progressPercentage": 100,
      "provisioningStatus": {
        "operationId": "82f58893-b252-43db-97a9-258f6f7831d9*43114797B86E6D2B28C4B52B02302C81C889DABDD9D890F993665E223A5947C3",
        "status": "Succeeded"
      }
    },
    "storagepathId": "/subscriptions/<Subscription ID>/resourceGroups/myhci-rg/providers/Microsoft.AzureStackHCI/storagecontainers/myhci-storagepath",
    "version": {
      "name": null,
      "properties": {
        "storageProfile": {
          "osDiskImage": {}
        }
      }
    }
  },
  "resourceGroup": "myhci-rg",
  "systemData": {
    "createdAt": "2023-11-02T06:15:10.450908+00:00",
    "createdBy": "guspinto@contoso.com",
    "createdByType": "User",
    "lastModifiedAt": "2023-11-02T06:15:56.689323+00:00",
    "lastModifiedBy": "319f651f-7ddb-4fc6-9857-7aef9250bd05",
    "lastModifiedByType": "Application"
  },
  "tags": null,
  "type": "microsoft.azurestackhci/galleryimages"
}

PS C:\Users\azcli>

Azure-portal

U kunt een VM-installatiekopie maken door een installatiekopie te downloaden die zich in een lokale share op uw lokale Azure bevindt en vervolgens die VM-installatiekopie gebruiken om een virtuele machine te implementeren.

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

1. Ga naar Resources>VM-afbeeldingen.

2. Selecteer + VM-installatiekopieën toevoegen en selecteer in de vervolgkeuzelijst VM-installatiekopieën toevoegen uit een lokale share.

   

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. Sla de afbeelding op als. Voer een naam in voor de VM-image.

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

   5. Type besturingssysteem. Selecteer het besturingssysteem van de image als Windows of Linux. Dit is het besturingssysteem dat is gekoppeld aan de afbeelding in uw opslagaccount.

   6. VM-generatie. Selecteer de generatie voor uw afbeelding.

   7. Bron. De bron van de afbeelding moet een lokale bestandsshare zijn en wordt automatisch ingevuld.

   8. Pad naar lokale bestandsshare. Geef het lokale pad op voor de bronafbeelding op uw systeem.

   9. 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-image bekijken en Maken selecteren.

   

   Er wordt een Azure Resource Manager-sjabloonimplementatie-taak gestart voor de VM-afbeelding. Het duurt enkele minuten voordat de imagedistributie is voltooid. De tijd die nodig is om de installatiekopieën te downloaden, is afhankelijk van de grootte van de aangepaste installatiekopieën en de netwerkbandbreedte die beschikbaar is voor de download.

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

6. Wanneer het downloaden van de VM-image is voltooid, verschijnt deze in de lijst met images en wordt de status weergegeven als Beschikbaar. Als u meer details van een VM-image wilt weergeven, selecteert u de naam van de VM-image in de lijst met VM-images.

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-image 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 wordt een bijbehorende set afbeeldingen die aan uw Azure-locatie gekoppeld zijn, weergegeven.

   • Als u alleen het abonnement opgeeft, geeft het commando alle afbeeldingen in het abonnement weer.
   • Als u zowel het abonnement als de resourcegroep opgeeft, geeft het commando alle afbeeldingen in de resourcegroep weer.

   Deze afbeeldingen zijn onder andere:

   • VM-installatiekopieën uit Marketplace.
   • Aangepaste installatiekopieën die zich in uw Azure Storage-account bevinden of op een lokale share van uw systeem of een met uw systeem verbonden client staan.

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 de Azure-portal van uw Azure-lokale resource kunt u de implementatie van de VM-afbeeldingen bijhouden in het VM-afbeeldingenraster. 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-installatiekopieën. In het rechterpaneel wordt een lijst met VM-images weergegeven.

   

2. Selecteer de VM-afbeelding om de eigenschappen weer te geven.

   

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-image. 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-afbeeldingen.

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.