Een afbeeldingsdefinitie en een afbeeldingsversie maken

Een Azure Compute Gallery vereenvoudigt het delen van aangepaste afbeeldingen in uw organisatie. Aangepaste afbeeldingen zijn vergelijkbaar met Marketplace-afbeeldingen, maar die u zelf maakt. Afbeeldingen kunnen worden gemaakt van een VM, VHD, momentopname, beheerde afbeelding of een andere versie van een afbeelding.

Met de Azure Compute Gallery kunt u uw aangepaste VM-installatiekopieën delen met anderen in uw organisatie, binnen of tussen regio's, binnen een Microsoft Entra-tenant of openbaar gebruikmaken van een communitygalerie. U kunt kiezen welke afbeeldingen u wilt delen, in welke regio’s u ze beschikbaar wilt stellen en met wie u ze wilt delen. U kunt meerdere galerieën maken, zodat u afbeeldingen logisch kunt groeperen. Veel nieuwe functies, zoals ARM64, Versneld netwerken en TrustedVM, worden alleen ondersteund via Azure Compute Gallery en niet beschikbaar voor beheerde installatiekopieën.

De functie Azure Compute Gallery heeft meerdere resourcetypen:

Bron	Beschrijving
Afbeeldingsbron	Dit is een resource die kan worden gebruikt voor het maken van een afbeeldingsversie in een galerij. Een bron van een image kan een bestaande Azure-VM zijn die gegeneraliseerd of gespecialiseerd is, een beheerde image, een momentopname of een imageversie in een andere galerij.
Galerij	Net als de Azure Marketplace is een gallery een opslagplaats voor het beheren en delen van installatiekopieën en VM-toepassingen, maar u bepaalt wie toegang heeft.
Definitie van schijfkopie	Definities van afbeeldingen worden binnen een galerij gemaakt en bevatten informatie over de afbeelding en de vereisten voor intern gebruik. Dit omvat of de images Windows of Linux zijn, releaseopmerkingen en de minimale en maximale geheugenvereisten. Het is een definitie van een type afbeelding.
Imageversie	U gebruikt een versie van een afbeeldingskopie om een VM te maken wanneer u een afbeeldingengalerij gebruikt. U kunt meerdere versies van een afbeelding gebruiken zoals nodig voor uw omgeving. Net als bij een beheerde installatiekopie, wanneer u een versie van een installatiekopie gebruikt om een VM te maken, wordt de versie van de installatiekopie gebruikt voor het maken van nieuwe schijven voor de VM. Versies van imageafbeeldingen kunnen meerdere keren worden gebruikt.

Vereiste voorwaarden

Om dit artikel te voltooien, moet u een bestaande Azure Compute Gallery hebben en een bron voor uw image die beschikbaar is in Azure. Afbeeldingsbronnen kunnen het volgende zijn:

Een VM in uw abonnement. U kunt een afbeelding vastleggen van zowel gespecialiseerde als gegeneraliseerde vm's.
Een beheerste afbeelding
Beheerde besturingssystemen en gegevensschijven.
Besturingssysteem- en gegevensschijven als VHD's in een opslagaccount.
Andere versies van afbeeldingen in dezelfde galerie of een andere galerie in hetzelfde abonnement.

Als de installatiekopieën gegevensschijven bevatten, mag de grootte van de gegevensschijf niet groter zijn dan 1 TB.

Namen van afbeeldingsdefinities kunnen bestaan uit hoofdletters, kleine letters, cijfers, punten en streepjes. Zie Installatiekopiedefinities voor meer informatie over de waarden die u kunt specificeren voor een installatiekopiedefinitie.

Toegestane tekens voor de versie van de afbeelding zijn cijfers en punten. Cijfers moeten binnen het bereik van een 32-bits geheel getal zijn. Formaat: MajorVersion.MinorVersion.Patch.

Wanneer u dit artikel doorloopt, vervangt u waar nodig de resourcenamen.

Voor gegeneraliseerde images raadpleegt u de specifieke richtlijnen per besturingssysteem voordat u de afbeelding vastlegt.

Linux
- Algemene stappen
- CentOS
- Debian
- Flatcar
- FreeBSD
- Oracle Linux
- OpenBSD
- Red Hat
- SUSE
- Ubuntu
Windows

Als u Sysprep wilt uitvoeren voordat u uw virtuele harde schijf (VHD) voor het eerst uploadt naar Azure, moet u ervoor zorgen dat u uw virtuele machine voorbereid hebt gemaakt.

Community-galerie

Als u uw afbeeldingen gaat delen met behulp van een communitygalerie, zorg ervoor dat u de galerie, afbeeldingsdefinities en afbeeldingsversies in dezelfde regio maakt.

Wanneer gebruikers zoeken naar afbeeldingen in de communitygalerie, worden alleen de meest recente versies van de afbeeldingen weergegeven.

Belangrijk

Informatie uit uw afbeeldingsdefinities is openbaar beschikbaar, zoals wat u opgeeft voor Publiceren, Aanbieden en SKU.

Een afbeelding maken

Kies hieronder een optie voor het maken van uw afbeeldingsdefinitie en afbeeldingsversie:

Zie Een installatiekopie van een virtuele machine vastleggen in de portal.

Volg deze stappen om een image te maken met een andere bron dan een virtuele machine.

Ga naar de Azure portal en zoek en selecteer Azure Compute Gallery.
Selecteer de galerie die u wilt gebruiken in de lijst.
Op de pagina voor uw galerie selecteert u boven aan de pagina de optie Toevoegen en vervolgens selecteert u VM-imagedefinitie in de vervolgkeuzelijst.
op de pagina Nieuwe installatiedefinitie toevoegen aan Azure Compute Gallery, selecteert u op het tabblad Basis een Regio.
Type voor Image definition name een naam zoals myImageDefinition.
Voor het besturingssysteem selecteert u de juiste optie op basis van uw bron.
Selecteer voor het genereren van vm's de optie op basis van uw bron. In de meeste gevallen is dit Gen 1. Zie Ondersteuning voor VM's van de tweede generatie voor meer informatie.
Selecteer voor de status van het besturingssysteem de optie op basis van uw bron. Zie Gegeneraliseerde en gespecialiseerde informatie voor meer informatie.
Typ voor Publisher een unieke naam, zoals myPublisher.
Voor Offer typt u een unieke naam zoals myOffer.
Voor SKU typt u een unieke naam, zoals mySKU.
Selecteer onder aan de pagina Controleren en maken.
Nadat de definitie van de afbeelding de validatie doorstaat, selecteert u Maken.
Nadat de implementatie klaar is, selecteert u Ga naar resource.
Selecteer op de pagina voor de definitie van je afbeelding, op het tabblad Aan de slag, Een versie maken.
Selecteer in Regio de regio waar u de afbeelding wilt maken. In sommige gevallen moet de bron zich in dezelfde regio bevinden als waar de afbeelding wordt gemaakt. Probeer de regio voor de afbeelding te wijzigen als u de bron niet in latere vervolgkeuzelijsten ziet staan. U kunt de image altijd later naar andere regio's repliceren.
Voor versienummer typt u een getal zoals 1.0.0. De naam van de imageversie moet het major.minor.patch formaat volgen met gehele getallen.

Selecteer in De bron het type bestand dat u voor uw bron gebruikt in de vervolgkeuzelijst. Zie de onderstaande tabel voor specifieke details voor elk brontype.

Bron	Andere velden
Schijven of momentopnamen	- Selecteer voor de besturingssysteemschijf de schijf of momentopname in de vervolgkeuzelijst. - Als u een gegevensschijf wilt toevoegen, typt u het LUN-nummer en selecteert u vervolgens de gegevensschijf in de vervolgkeuzelijst.
Imageversie	- Selecteer de brongalerie in de vervolgkeuzelijst. - Selecteer de juiste afbeeldingsdefinitie in de vervolgkeuzelijst. - Selecteer de bestaande versie van de afbeelding die u wilt gebruiken uit de vervolgkeuzelijst.
Beheerde afbeelding	Selecteer de bronafbeelding in de vervolgkeuzelijst. De beheerd image moet zich in dezelfde regio bevinden die u hebt gekozen in Exemplaardetails.
VHD in een opslagaccount	Selecteer Bladeren om het opslagaccount voor de VHD te kiezen.

Laat in Uitsluiten van de meest recente waarde de standaardwaarde Nee staan, tenzij u niet wilt dat deze versie wordt gebruikt bij het maken van een virtuele machine latest in plaats van een versienummer.
Voor de einddatum van de levensduur selecteert u een datum in de kalender voor wanneer u denkt dat deze versie niet meer moet worden gebruikt.
Selecteer op het tabblad Replicatie het opslagtype in de vervolgkeuzelijst.
Stel het standaardaantal replica's in. U kunt dit overschrijven voor elke regio die u toevoegt.
U moet repliceren naar de oorspronkelijke regio, dus de eerste replica in de lijst bevindt zich in de regio waarin u de afbeelding hebt gemaakt. U kunt meer replica's toevoegen door de regio in de vervolgkeuzelijst te selecteren en het aantal replica's zo nodig aan te passen.
Als u klaar bent, selecteert u Beoordelen en maken. Azure valideert de configuratie.
Nadat de beeldversie gevalideerd is, selecteert u Maken.
Nadat de implementatie klaar is, selecteert u Ga naar resource.

Het kan even duren om de afbeelding naar alle doelregio's te repliceren.

U kunt ook vanuit het portal een bestaande virtuele machine vastleggen als een afbeelding. Voor meer informatie, zie Een installatiekopie van een virtuele machine maken in de portal.

Als u een afbeelding wilt maken met behulp van de Azure CLI, moet u eerst een afbeeldingsdefinitie maken. Definities van afbeeldingen maken een logische groepering voor afbeeldingen. Die worden gebruikt voor het beheren van informatie over de afbeeldingsversies die daar worden aangemaakt.

Maak een afbeeldingsdefinitie in een gallery met behulp van az sig image-definition create. Controleer of uw afbeeldingsdefinitie van het juiste type is. Als u generaliseerde de virtuele machine (met waagent -deprovision voor Linux of Sysprep voor Windows) hebt, moet u een gegeneraliseerde installatiekopieëndefinitie maken met behulp van --os-state generalized. Als u de VM wilt gebruiken zonder bestaande gebruikersaccounts te verwijderen, maakt u een gespecialiseerde afbeeldingsdefinitie aan met --os-state specialized.

Zie Afbeeldingsdefinities voor meer informatie over de parameters die u kunt opgeven voor een afbeeldingsdefinitie.

In dit voorbeeld heeft de definitie van de installatiekopie de naam myImageDefinition en is deze voor een gespecialiseerde installatiekopie van een Linux-besturingssysteem. Gebruik --os-type Windows om een definitie voor afbeeldingen te maken met een Windows-besturingssysteem.

az sig image-definition create \
   --resource-group myGalleryRG \
   --gallery-name myGallery \
   --gallery-image-definition myImageDefinition \
   --publisher myPublisher \
   --offer myOffer \
   --sku mySKU \
   --os-type Linux \
   --os-state specialized

Notitie

Voor afbeeldingsdefinities die afbeeldingen bevatten afgeleid van marktplaatsafbeeldingen van derden, moeten de plangegevens exact overeenkomen met de plangegevens van de afbeelding van de derde partij. Neem de plangegevens op in de afbeelding definitie door --plan-name, --plan-product, en --plan-publisher toe te voegen wanneer u de afbeeldingsdefinitie maakt.

De afbeeldingversie maken

Maak een afbeeldingsversie met de opdracht az sig image version create.

De syntaxis voor het maken van de afbeelding wordt gewijzigd, afhankelijk van wat u als bron gebruikt. U kunt de brontypen combineren, zolang u maar één besturingssysteembron hebt. U kunt ook verschillende bronnen voor elke gegevensschijf hebben.

Bron	Parameterset
Besturingssysteemschijf:
VM met behulp van de VM-id	`--managed-image <Resource ID of the VM>`
Beheerde images of een andere versie van de images	`--managed-image <Resource ID of the managed image or image version`
Momentopname of beheerde schijf	`--os-snapshot <Resource ID of the snapshot or managed disk>`
VHD in een opslagaccount	`--os-vhd-uri <URI> --os-vhd-storage-account <storage account name>`.
Gegevensschijf:
Momentopname of beheerde schijf	`--data-snapshots <Resource ID of the snapshot or managed disk> --data-snapshot-luns <LUN number>`
VHD in een opslagaccount	`--data-vhds-sa <storageaccountname> --data-vhds-uris <URI> --data-vhds-luns <LUN number>`

Zie de voorbeelden van az sig image-version create voor gedetailleerde beschrijvingen van hoe u verschillende bronnen voor uw afbeelding kunt specificeren.

In het onderstaande voorbeeld maken we een afbeelding van een VM. De versie van onze image is 1.0.0 en we gaan 2 replica's maken in de regio West Centraal VS, 1 replica in de regio Zuid Centraal VS en 1 replica in de regio Oost VS 2 met zone-redundante opslag. De replicatieregio’s moeten de regio omvatten waarin de bron-VM zich bevindt.

Het is aanbevolen om de virtuele machine te stoppen/de-alloceren voordat u een installatiekopie maakt.

Vervang de waarde van --virtual-machine in dit voorbeeld door de id van uw VIRTUELE machine.

az sig image-version create \
   --resource-group myGalleryRG \
   --gallery-name myGallery \
   --gallery-image-definition myImageDefinition \
   --gallery-image-version 1.0.0 \
   --target-regions "westcentralus" "southcentralus=1" "eastus=1=standard_zrs" \
   --replica-count 2 \
   --virtual-machine "/subscriptions/<Subscription ID>/resourceGroups/MyResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM"

Notitie

U moet wachten tot de imageversie helemaal is aangemaakt en gerepliceerd voordat u dezelfde beheerde afbeelding kunt gebruiken om een andere imageversie te maken.

U kunt uw image ook opslaan in Premium-opslag door --storage-account-type premium_lrs toe te voegen of in zone-redundante opslag door Zone Redundant Storage toe te voegen --storage-account-type standard_zrs wanneer u de imageversie maakt.

Als u een afbeelding wilt maken met behulp van PowerShell, moet u eerst een afbeeldingsdefinitie maken. Definities van afbeeldingen maken een logische groepering voor afbeeldingen. Zorg ervoor dat uw beelddefinitie bij het aanmaken alle juiste informatie bevat. Als u de bron-VM hebt gegeneraliseerd, moet u een imagedefinitie maken met behulp van -OsState generalized. Als u de bron niet hebt gegeneraliseerd, maakt u een afbeeldingsdefinitie met behulp van -OsState specialized.

Zie Installatiekopiedefinities voor meer informatie over de waarden die u kunt specificeren voor een installatiekopiedefinitie.

Maak de afbeeldingsdefinitie met New-AzGalleryImageDefinition.

In dit voorbeeld heet de image-definitie myImageDefinition, die bestemd is voor een gespecialiseerde VM waarop Windows wordt uitgevoerd. Om een definitie voor afbeeldingen met Linux te maken, gebruikt u -OsType Linux.

$imageDefinition = New-AzGalleryImageDefinition `
   -GalleryName $gallery.Name `
   -ResourceGroupName $gallery.ResourceGroupName `
   -Location $gallery.Location `
   -Name 'myImageDefinition' `
   -OsState specialized `
   -OsType Windows `
   -Publisher 'myPublisher' `
   -Offer 'myOffer' `
   -Sku 'mySKU'

Notitie

Voor afbeeldingsdefinities die afbeeldingen bevatten die zijn afgeleid van afbeeldingen van derden, moeten de plangegevens precies overeenkomen met die van de derde-partij afbeelding. Neem de plangegevens op in de afbeelding definitie door -PurchasePlanName, -PurchasePlanProduct, en -PurchasePlanPublisher toe te voegen wanneer u de afbeeldingsdefinitie maakt.

Een image-versie maken

Maak een afbeeldingsversie met New-AzGalleryImageVersion.

De syntaxis voor het maken van de afbeelding wordt gewijzigd, afhankelijk van wat u als bron gebruikt.

Bron	Parameterset
OS-schijf
VM met behulp van de VM-id	`-SourceImageId <Resource ID of the VM>`
Beheerde images of een andere versie van de images	`-SourceImageId <Resource ID of the managed image or image version`
Momentopname of beheerde schijf	`-OSDiskImage <Resource ID of the snapshot or managed disk>`
Gegevensschijf
Momentopname of beheerde schijf	`-DataDiskImage @{Source = @{Id=<source_id>}; Lun=<LUN>; SizeInGB = <Size in GB>; HostCaching = <Caching> }`

In het onderstaande voorbeeld maken we een imageversie van een virtuele machine. Het is een best practice om de VM te stoppen\toe te wijzen voordat u een installatiekopie maakt met behulp van Stop-AzVM.

In dit voorbeeld is de image versie 1.0.0 en wordt gerepliceerd naar zowel West Central US als South Central US datacenters. Wanneer u doelregio's kiest voor replicatie, moet u ook de bronregio opnemen als doel voor replicatie.

   $region1 = @{Name='South Central US';ReplicaCount=1}
   $region2 = @{Name='East US';ReplicaCount=2}
   $targetRegions = @($region1,$region2)

$job = $imageVersion = New-AzGalleryImageVersion `
   -GalleryImageDefinitionName $imageDefinition.Name`
   -GalleryImageVersionName '1.0.0' `
   -GalleryName $gallery.Name `
   -ResourceGroupName $gallery.ResourceGroupName `
   -Location $gallery.Location `
   -TargetRegion $targetRegions  `
   -SourceImageId $sourceVm.Id.ToString() `
   -PublishingProfileEndOfLifeDate '2020-12-01' `  
   -asJob

Het kan even duren voordat de installatiekopie naar alle doelregio's is gerepliceerd, dus hebben we een proces gemaakt zodat we de voortgang kunnen bijhouden. Als u de voortgang van de taak wilt zien, typ $job.State.

$job.State

Notitie

U moet wachten tot de beeldversie volledig is voltooid en gerepliceerd voordat u hetzelfde beheerde beeld kunt gebruiken om een andere beeldversie te maken.

U kunt uw afbeelding ook opslaan in Premium-opslag door -StorageAccountType Premium_LRS toe te voegen, of in zone-redundante opslag door -StorageAccountType Standard_ZRS toe te voegen wanneer u de versie van de afbeelding maakt.

Een afbeeldingsdefinitie maken met behulp van de REST API

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/galleries/{galleryName}/images/{galleryDefinitionName}?api-version=2019-12-01

{
    "location": "eastus",
    "properties": {
        "hyperVGeneration": "V1",
        "identifier": {
            "offer": "myOffer",
            "publisher": "myPublisher",
            "sku": "mySKU"
        },
        "osState": "Specialized",
        "osType": "Linux",
    },
}

Maak een afbeeldingsversie met de REST API. In dit voorbeeld maken we een imageversie van een virtuele machine. Als u een andere bron wilt gebruiken, geeft u de resource-id voor de bron door (geef bijvoorbeeld de id van de momentopname van de besturingssysteemschijf door).

# @name imageVersion
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/galleries/{galleryName}/images/{galleryDefinitionName}/versions/{galleryImageVersionName}?api-version=2019-12-01

{
    "location": "{region}",
    "properties": {
        "publishingProfile": {
            "endOfLifeDate": "2024-12-02T00:00:00+00:00",
            "replicaCount": 1,
            "storageAccountType": "Standard_ZRS",
            "targetRegions": [
                {
                    "name": "eastus",
                    "regionalReplicaCount": 2,
                    "storageAccountType": "Standard_LRS",
                },
                {
                    "name": "westus2",
                }
            ]
        },
        "storageProfile": {
            "source": {
                "id": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{vmName}"
            }
        }
    }
}

Een versie van een afbeelding maken in de ene tenant met gebruik makend van de bronversie van een andere tenant

In het abonnement waarin de versie van de bronafbeelding bestaat, kent u lezermachtigingen toe aan de gebruiker. Zodra de gebruiker leesrechten heeft voor de bronafbeeldingsversie, meldt u zich aan bij beide accounts (bron en doel).

U hebt de tenantID van de bronimageversie nodig, het subscriptionID voor het abonnement waarin de nieuwe imageversie wordt opgeslagen (doel) en de resourceID van de bronimageversie. De afbeeldingsdefinitie van de doelgalerie moet al bestaan voordat u de afbeeldingsversie maakt met az sig image-version create of New-AzGalleryImageVersion. Zorg er bovendien voor dat de regio of replica van de bronimageversie en de doelregio hetzelfde zijn.

CLI
Powershell

Gebruik de Azure CLI om een imageversie in de ene tenant te maken met behulp van de bronimageversie in een andere tenant.

# Set some variables
tenantID="<tenant ID for the source image version>"
subID="<subscription ID where the image version will be created>"
sourceImageVersionID="<resource ID of the source image version>"

# Sign in to the subscription where the new image version will be created
az login

# Sign in to the tenant where the source image version is available
az login --tenant $tenantID

# Sign back in to the subscription where the image version will be created and ensure subscription context is set
az login
az account set --subscription $subID

# Create the image version from the source image version
az sig image-version create \
   --gallery-image-definition myImageDef \
   --gallery-image-version 1.0.0 \
   --gallery-name myGallery \
   --resource-group myResourceGroup \
   --image-version $sourceImageVersionID \
   --location myLocation

Gebruik PowerShell om een imageversie in de ene tenant te maken met de bronimageversie in een andere tenant.

# Set variables
$targetSubID = "<subscription ID for the target>"
$sourceTenantID = "<tenant ID for the source image version>"
$sourceImageVersionID = "<resource ID of the source image version>"

# Sign in to the tenant where the source image version is published
Connect-AzAccount -Tenant $sourceTenantID -UseDeviceAuthentication

# Sign in to the subscription where the new image version will be created and set the context
Connect-AzAccount -UseDeviceAuthentication -Subscription $targetSubID
Set-AzContext -Subscription $targetSubID

# Create the image version from the source image version in a different tenant
New-AzGalleryImageVersion -ResourceGroupName myResourceGroup -GalleryName myGallery -GalleryImageDefinitionName myImageDef -Location "West US 2" -Name 1.0.0 -SourceImageId $sourceImageVersionID

Volgende stappen

Zie Lever Azure Marketplace aankoopplangegevens bij het maken van installatiekopieën voor meer informatie over hoe u aankoopplangegevens kunt leveren.

Feedback

Is deze pagina nuttig?

Last updated on 2026-04-10

Delen via

Een afbeeldingsdefinitie en een afbeeldingsversie maken

Vereiste voorwaarden

Community-galerie

Een afbeelding maken

Een versie van een afbeelding maken in de ene tenant met gebruik makend van de bronversie van een andere tenant

Volgende stappen

Feedback

Aanvullende resources