Skapa en bilddefinition och en avbildningsversion

Ett Azure Compute Gallery förenklar anpassad bilddelning i organisationen. Anpassade avbildningar liknar Marketplace-avbildningar, men du skapar dem själv. Avbildningar kan skapas från en virtuell dator, en virtuell hårddisk, en ögonblicksbild, en hanterad avbildning eller en annan avbildningsversion.

Med Azure Compute Gallery kan du dela dina anpassade VM-avbildningar med andra i organisationen, inom eller mellan regioner, inom en Microsoft Entra klientorganisation eller offentligt med hjälp av ett community gallery. Välj vilka bilder du vill dela, vilka regioner du vill göra dem tillgängliga i och vilka du vill dela dem med. Du kan skapa flera gallerier så att du logiskt kan gruppera bilder. Många nya funktioner som ARM64, Accelererat nätverk och TrustedVM stöds bara via Azure Compute Gallery och är inte tillgängliga för hanterade avbildningar.

Funktionen Azure Compute Gallery har flera resurstyper:

Resurs	beskrivning
Bildkälla	Det här är en resurs som kan användas för att skapa en avbildningsversion i ett galleri. En avbildningskälla kan vara en befintlig Azure virtuell dator som antingen är generaliserad eller specialiserad, en hanterad avbildning, en ögonblicksbild eller en bildversion i ett annat galleri.
Galleri	Precis som Azure Marketplace är en gallery en lagringsplats för att hantera och dela bilder och VM-program, men du styr vem som har åtkomst.
Bilddefinition	Bilddefinitioner skapas i ett galleri och innehåller information om avbildningen och krav för att använda den internt. Detta inkluderar om avbildningen är Windows eller Linux, releasenoter och minimi- och maximikrav för minne. Det är en definition av en typ av bild.
Avbildningsversion	En bildversion är vad du använder för att skapa en virtuell dator när du använder galleri. Du kan ha flera versioner av en avbildning efter behov för din miljö. Precis som en hanterad avbildning används avbildningsversionen för att skapa nya diskar för den virtuella datorn när du använder en avbildningsversion för att skapa en virtuell dator. Avbildningsversioner kan användas flera gånger.

Förutsättningar

För att kunna slutföra den här artikeln måste du ha ett befintligt Azure Compute Gallery och en källa till din avbildning tillgänglig i Azure. Bildkällor kan vara:

En virtuell dator i din prenumeration. Du kan skapa en avbildning från både specialiserade och generaliserade virtuella maskiner.
En hanterad avbildning
Hanterade operativsystem och datadiskar.
operativsystem och datadiskar som virtuella hårddiskar (VHD) i ett lagringskonto.
Andra bildversioner i samma galleri eller i ett annat galleri i samma prenumeration.

Om avbildningen innehåller datadiskar får datadiskens storlek inte vara större än 1 TB.

Bilddefinitionsnamn kan bestå av versaler eller gemener, siffror, prickar, bindestreck och punkter. Mer information om de värden som du kan ange för en bilddefinition finns i Bilddefinitioner.

Tillåtna tecken för avbildningsversionen är siffror och punkter. Tal måste ligga inom intervallet för ett 32-bitars heltal. Format: MajorVersion.MinorVersion.Patch.

När du arbetar med den här artikeln ersätter du resursnamnen där det behövs.

Information om generaliserade avbildningar finns i operativsystemets specifika vägledning innan du samlar in avbildningen:

Linux
- Allmänna steg
- CentOS
- Debian
- Flatvagn
- FreeBSD
- Oracle Linux
- OpenBSD
- Röd hatt
- SUSE
- Ubuntu
Windows

Om du planerar att köra Sysprep innan du laddar upp den virtuella hårddisken (VHD) till Azure för första gången kontrollerar du att du har förberedd din virtuella dator.

Communitygalleriet

Om du ska dela dina bilder med hjälp av ett communitygalleri måste du skapa galleriet, bilddefinitionerna och bildversionerna i samma region.

När användare söker efter bilder från communitygalleriet visas endast den senaste versionen av en bild.

Viktigt!

Information från dina bilddefinitioner blir offentligt tillgänglig, till exempel vad du anger för Publicera, Erbjudande och SKU.

Skapa en avbildning

Välj ett alternativ nedan för att skapa din bilddefinition och bildversion:

Information om hur du skapar en avbildning från en virtuell dator i portalen finns i Avbilda en avbildning av en virtuell dator.

Följ dessa steg om du vill skapa en avbildning med en annan källa än en virtuell dator.

Gå till Azure-portalen och sök sedan efter och välj Azure Compute Gallery.
Välj det galleri som du vill använda i listan.
På sidan för ditt galleri väljer du Lägg till överst på sidan och sedan väljer du VM-avbildningsdefinition i listrutan.
på sidan Lägg till ny bilddefinition till Azure Compute Gallery på fliken Basics väljer du en Region.
För Bilddefinitionsnamn skriver du ett namn som myImageDefinition.
För Operativsystem väljer du rätt alternativ baserat på källan.
För VM-generering väljer du alternativet baserat på din källa. I de flesta fall är detta Gen 1. Mer information finns i Stöd för virtuella datorer i generation 2.
För Operativsystemtillstånd väljer du alternativet baserat på källan. Mer information finns i Generaliserad och specialiserad.
För Publisher anger du ett unikt namn som myPublisher.
För Erbjudande skriver du ett unikt namn som myOffer.
För SKU skriver du ett unikt namn som mySKU.
Längst ned på sidan väljer du Granska + skapa.
När bilddefinitionen har godkänts väljer du Skapa.
När distributionen är klar väljer du Gå till resurs.
På sidan för bilddefinitionen går du till fliken Kom igång och väljer Skapa en version.
I Region väljer du den region där du vill att avbildningen ska skapas. I vissa fall måste källan finnas i samma region där avbildningen skapas. Om du inte ser din källa i de senare listrutorna, försök att ändra regionen för bilden. Du kan alltid replikera bilden till andra regioner senare.
För Versionsnummer skriver du ett tal som 1.0.0. Namnet på avbildningsversionen ska följa huvud.mindre.korrigering-formatet med heltal.

I Källa väljer du den typ av fil som du använder för källan i listrutan. Se tabellen nedan för specifik information för varje källtyp.

Källa	Andra fält
Diskar eller ögonblicksbilder	– För OS-disk väljer du disken eller ögonblicksbilden i listrutan. – Om du vill lägga till en datadisk skriver du LUN-numret och väljer sedan datadisken i listrutan.
Bildversion	– Välj källgalleriet i listrutan. – Välj rätt bilddefinition i listrutan. – Välj den befintliga avbildningsversion som du vill använda i listrutan.
Hanterad avbildning	Välj källavbildningen i listrutan. Den hanterade avbildningen måste finnas i samma region som du valde i Instansdetaljer.
VHD i ett lagringskonto	Välj Bläddra för att välja lagringskontot för den virtuella hårddisken.

I Exkludera från den senaste lämnar du standardvärdet Nej om du inte vill att den här versionen ska användas när du skapar en virtuell dator med i latest stället för ett versionsnummer.
För Slutdatum väljer du ett datum i kalendern för när du tycker att den här versionen ska sluta användas.
På fliken Replikering väljer du lagringstyp i listrutan.
Ange antalet standardrepliker. Du kan åsidosätta detta för varje region som du lägger till.
Du måste replikera till källregionen, så den första repliken i listan finns i den region där du skapade avbildningen. Du kan lägga till fler repliker genom att välja region i listrutan och justera antalet repliker efter behov.
När du är klar väljer du Granska + skapa. Azure verifierar konfigurationen.
När avbildningsversionen godkänns väljer du Skapa.
När distributionen är klar väljer du Gå till resurs.

Det kan ta en stund att replikera avbildningen till alla målregioner.

Du kan också avbilda en befintlig virtuell dator som en avbildning från portalen. Mer information finns i Skapa en avbildning av en virtuell dator i portalen.

Om du vill skapa en avbildning med hjälp av Azure CLI måste du först skapa en bilddefinition. Bilddefinitioner skapar en logisk gruppering för bilder. De används för att hantera information om de avbildningsversioner som skapas i dem.

Skapa en bilddefinition i ett galleri med az sig image-definition create. Kontrollera att bilddefinitionen är rätt typ. Om du har generaliserad den virtuella datorn (med hjälp av waagent -deprovision för Linux eller Sysprep för Windows) bör du skapa en generaliserad avbildningsdefinition med hjälp av --os-state generalized. Om du vill använda den virtuella datorn utan att ta bort befintliga användarkonton skapar du en specialiserad avbildningsdefinition med .--os-state specialized

Mer information om de parametrar som du kan ange för en bilddefinition finns i Bilddefinitioner.

I det här exemplet heter bilddefinitionen myImageDefinition och är avsedd för en specialiserad Linux OS-avbildning. Använd --os-type Windows om du vill skapa en definition för avbildningar med hjälp av ett Windows operativsystem.

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

Kommentar

För bilddefinitioner som innehåller bilder som härstammar från bilder på tredje parts marknadsplats måste planinformationen överensstämma exakt med planinformationen från bilden från tredje part. Inkludera planinformationen i bilddefinitionen genom att lägga till --plan-name, --plan-productoch --plan-publisher när du skapar avbildningsdefinitionen.

Skapa avbildningsversionen

Skapa en avbildningsversion med az sig image version create.

Syntaxen för att skapa avbildningen ändras beroende på vad du använder som källa. Du kan blanda källtyperna så länge du bara har en OS-källa. Du kan också ha olika källor för varje datadisk.

Källa	Parameteruppsättning
OS-disk:
Virtuell dator med hjälp av VM-ID:t	`--managed-image <Resource ID of the VM>`
Hanterad avbildning eller annan avbildningsversion	`--managed-image <Resource ID of the managed image or image version`
Ögonblicksbild eller hanterad disk	`--os-snapshot <Resource ID of the snapshot or managed disk>`
VHD i ett lagringskonto	`--os-vhd-uri <URI> --os-vhd-storage-account <storage account name>`.
Datadisk:
Ögonblicksbild eller hanterad disk	`--data-snapshots <Resource ID of the snapshot or managed disk> --data-snapshot-luns <LUN number>`
VHD i ett lagringskonto	`--data-vhds-sa <storageaccountname> --data-vhds-uris <URI> --data-vhds-luns <LUN number>`

Detaljerade exempel på hur du anger olika källor för avbildningen finns i az sig image-version create examples.

I exemplet nedan skapar vi en avbildning från en virtuell dator. Versionen av vår avbildning är 1.0.0 och vi ska skapa 2 repliker i regionen USA , västra centrala, 1 replik i regionen USA , södra centrala och 1 replik i regionen USA, östra 2 med zonredundant lagring. Replikeringsregionerna måste innehålla den region som den virtuella källdatorn finns i.

Det är en bra praxis att stoppa\frånkoble den virtuella datorn innan man skapar en avbildning.

Ersätt värdet --virtual-machine för i det här exemplet med ID:t för den virtuella datorn.

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"

Kommentar

Du måste vänta tills avbildningsversionen har skapats och replikerats helt innan du kan använda samma hanterade avbildning för att skapa en annan avbildningsversion.

Du kan också lagra avbildningen i Premium Storage genom att lägga till --storage-account-type premium_lrs, eller Zonredundant lagring genom att lägga till --storage-account-type standard_zrs när du skapar avbildningsversionen.

Om du vill skapa en avbildning med PowerShell måste du först skapa en avbildningsdefinition. Bilddefinitioner skapar en logisk gruppering för bilder. När du skapar bilddefinitionen kontrollerar du att den har all rätt information. Om du generaliserade den virtuella källdatorn bör du skapa en bilddefinition med -OsState generalized. Om du inte generaliserade källan skapar du en bilddefinition med hjälp av -OsState specialized.

Mer information om de värden som du kan ange för en bilddefinition finns i Bilddefinitioner.

Skapa avbildningsdefinitionen med New-AzGalleryImageDefinition.

I det här exemplet heter avbildningsdefinitionen myImageDefinition och är för en specialiserad virtuell dator som kör Windows. Om du vill skapa en definition för avbildningar med Linux använder du -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'

Kommentar

För bilddefinitioner som innehåller bilder som härstammar från bilder från tredje part måste planinformationen matcha exakt planinformationen från tredjepartsbilden. Inkludera planinformationen i bilddefinitionen genom att lägga till -PurchasePlanName, -PurchasePlanProductoch -PurchasePlanPublisher när du skapar avbildningsdefinitionen.

Skapa en avbildningsversion

Skapa en avbildningsversion med New-AzGalleryImageVersion.

Syntaxen för att skapa avbildningen ändras beroende på vad du använder som källa.

Källa	Parameteruppsättning
OS Disk
Virtuell dator med hjälp av VM-ID:t	`-SourceImageId <Resource ID of the VM>`
Hanterad avbildning eller annan avbildningsversion	`-SourceImageId <Resource ID of the managed image or image version`
Ögonblicksbild eller hanterad disk	`-OSDiskImage <Resource ID of the snapshot or managed disk>`
Datadisk
Ögonblicksbild eller hanterad disk	`-DataDiskImage @{Source = @{Id=<source_id>}; Lun=<LUN>; SizeInGB = <Size in GB>; HostCaching = <Caching> }`

I exemplet nedan skapar vi en avbildningsversion från en virtuell dator. Det är bästa praxis att stoppa\avallokera den virtuella datorn innan du skapar en avbildning med Stop-AzVM.

I det här exemplet är bildversionen 1.0.0 och den replikeras till både Centrala Västra USA och Centrala Södra USA datacenter. När du väljer målregioner för replikering måste du också inkludera källregionen som mål för replikering.

   $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

Det kan ta en stund att replikera avbildningen till alla målregioner, så vi har skapat ett jobb så att vi kan spåra förloppet. Om du vill se förloppet för jobbet skriver du $job.State.

$job.State

Kommentar

Du måste vänta tills avbildningsversionen har skapats och replikerats helt innan du kan använda samma hanterade avbildning för att skapa en annan avbildningsversion.

Du kan också lagra avbildningen i Premium Storage genom att lägga till -StorageAccountType Premium_LRS, eller Zonredundant lagring genom att lägga till -StorageAccountType Standard_ZRS när du skapar avbildningsversionen.

Skapa en bilddefinition med hjälp av REST-API:et

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

Skapa en bildversion med hjälp av REST API. I det här exemplet skapar vi en avbildningsversion från en virtuell dator. Om du vill använda en annan källa skickar du in resurs-ID:t för källan (till exempel skicka in ID:t för ögonblicksbilden av OS-disken).

# @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}"
            }
        }
    }
}

Skapa en avbildningsversion i en klientorganisation från källavbildningsversionen i en annan klientorganisation.

I prenumerationen där källbildversionen finns beviljar du användaren läsbehörighet. När användaren har läsbehörighet till källbildversionen loggar du in på både konton (källa och mål).

Du kommer att behöva identifieraren för tenantID av källbildversionen, identifieraren för subscriptionID för prenumerationen där den nya avbildningsversionen ska lagras (mål), och identifieraren för resourceID av källbildversionen. Bilddefinitionen för målgalleriet måste redan finnas innan du skapar avbildningsversionen med az sig image-version create eller New-AzGalleryImageVersion. Se dessutom till att källbildversionens region eller replik och målregion är desamma.

CLI
PowerShell

Använd Azure CLI för att skapa en avbildningsversion i en klientorganisation med hjälp av källbildversionen i en annan klientorganisation.

# 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

Använd PowerShell för att skapa en avbildningsversion i en klientorganisation med hjälp av källbildversionen i en annan klientorganisation.

# 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

Nästa steg

Information om hur du tillhandahåller information om inköpsplaner finns i Tillhandahåll Azure Marketplace-information om inköpsplaner när du skapar bilder.

Feedback

Var den här sidan till hjälp?

Last updated on 2026-04-10

Dela via

Skapa en bilddefinition och en avbildningsversion

Förutsättningar

Communitygalleriet

Skapa en avbildning

Skapa en avbildningsversion i en klientorganisation från källavbildningsversionen i en annan klientorganisation.

Nästa steg

Feedback

Ytterligare resurser