New-AzGalleryImageVersion

  • Referentie
Module:
Az.Compute

Maak een versie van de galerie-installatiekopieën.

Notitie

Dit is de vorige versie van onze documentatie. Raadpleeg de meest recente versie voor actuele informatie.

Syntax

New-AzGalleryImageVersion
   [-ResourceGroupName] <String>
   [-GalleryName] <String>
   [-GalleryImageDefinitionName] <String>
   [-Name] <String>
   [-AsJob]
   -Location <String>
   [-DataDiskImage <GalleryDataDiskImage[]>]
   [-OSDiskImage <GalleryOSDiskImage>]
   [-PublishingProfileEndOfLifeDate <DateTime>]
   [-PublishingProfileExcludeFromLatest]
   [-ReplicaCount <Int32>]
   [-SourceImageId <String>]
   [-StorageAccountType <String>]
   [-Tag <Hashtable>]
   [-TargetRegion <Hashtable[]>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Maak een versie van de galerie-installatiekopieën.

Voorbeelden

Voorbeeld 1: Een versie van een installatiekopieën maken op basis van een virtuele machine

$rgName = "myResourceGroup"
$galleryName = "myGallery"
$galleryImageDefinitionName = "myImage"
$galleryImageVersionName = "1.0.0"
$location = "eastus"
$sourceImageId = "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myVMRG/providers/Microsoft.Compute/virtualMachines/myVM"
New-AzGalleryImageVersion -ResourceGroupName $rgName -GalleryName $galleryName -GalleryImageDefinitionName $galleryImageDefinitionName -Name $galleryImageVersionName -Location $location -SourceImageId $sourceImageId

Voeg een nieuwe versie van een installatiekopieën van een virtuele machine toe aan de definitie van de installatiekopieën.

Voorbeeld 2: Een versie van een installatiekopieën maken op basis van een beheerde installatiekopieën

$rgName = "myResourceGroup"
$galleryName = "myGallery"
$galleryImageDefinitionName = "myImage"
$galleryImageVersionName = "1.0.0"
$location = "eastus"
$sourceImageId = "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myImageRG/providers/Microsoft.Compute/images/myImage"
New-AzGalleryImageVersion -ResourceGroupName $rgName -GalleryName $galleryName -GalleryImageDefinitionName $galleryImageDefinitionName -Name $galleryImageVersionName -Location $location -SourceImageId $sourceImageId

Voeg een nieuwe versie van een installatiekopieën toe vanuit een beheerde installatiekopieën in de definitie van de installatiekopieën.

Voorbeeld 3: Een versie van een installatiekopieën maken van een andere versie van een installatiekopieën

$rgName = "myResourceGroup"
$galleryName = "myGallery"
$galleryImageDefinitionName = "myImage"
$galleryImageVersionName = "1.0.0"
$location = "eastus"
$sourceImageId = "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myImageRG/providers/Microsoft.Compute/galleries/myOtherGallery/images/myImageDefinition/versions/1.0.0"
New-AzGalleryImageVersion -ResourceGroupName $rgName -GalleryName $galleryName -GalleryImageDefinitionName $galleryImageDefinitionName -Name $galleryImageVersionName -Location $location -SourceImageId $sourceImageId

Een versie van een installatiekopie kopiëren naar een andere versie van de installatiekopie

Voorbeeld 4: Een nieuwe installatiekopieënversie toevoegen vanaf een beheerde schijf

$rgName = "myResourceGroup"
$galleryName = "myGallery"
$galleryImageDefinitionName = "myImage"
$galleryImageVersionName = "1.0.0"
$location = "eastus"
$osDisk = @{Source = @{Id = "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myDiskRG/providers/Microsoft.Compute/disks/myOSDisk" }}
New-AzGalleryImageVersion -ResourceGroupName $rgName -GalleryName $galleryName -GalleryImageDefinitionName $galleryImageDefinitionName -Name $galleryImageVersionName -Location $location -OSDiskImage $osDisk

Een installatiekopieënversie maken van een beheerde schijf

Voorbeeld 5: Een nieuwe installatiekopieënversie toevoegen vanaf een beheerde schijf en extra gegevensschijven toevoegen

$rgName = "myResourceGroup"
$galleryName = "myGallery"
$galleryImageDefinitionName = "myImage"
$galleryImageVersionName = "1.0.0"
$location = "eastus"
$osDisk = @{Source = @{Id = "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myDiskRG/providers/Microsoft.Compute/disks/myOSDisk" }}
$dataDisk0 = @{Source = @{Id = "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myDiskRG/providers/Microsoft.Compute/disks/myDataDisk" }; Lun = 0; }
$dataDisks = @($dataDisk0)
New-AzGalleryImageVersion -ResourceGroupName $rgName -GalleryName $galleryName -GalleryImageDefinitionName $galleryImageDefinitionName -Name $galleryImageVersionName -Location $location -OSDiskImage $osDisk  -DataDiskImage $dataDisks

Een installatiekopieënversie maken door besturingssysteem- en gegevensschijven op te geven

Voorbeeld 6: Een nieuwe installatiekopieënversie toevoegen vanaf een momentopname van een besturingssysteemschijf

$rgName = "myResourceGroup"
$galleryName = "myGallery"
$galleryImageDefinitionName = "myImage"
$galleryImageVersionName = "1.0.0"
$location = "eastus"
$osSnapshot = @{Source = @{Id = "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/mySnapshotRG/providers/Microsoft.Compute/snapshots/myOSSnapshot" }}
New-AzGalleryImageVersion -ResourceGroupName $rgName -GalleryName $galleryName -GalleryImageDefinitionName $galleryImageDefinitionName -Name $galleryImageVersionName -Location $location -OSDiskImage $osDisk

Een installatiekopieënversie maken op basis van een momentopname van een schijf

Voorbeeld 7: Een nieuwe installatiekopieënversie toevoegen vanaf een momentopname van een besturingssysteemschijf en extra gegevensschijven toevoegen

$rgName = "myResourceGroup"
$galleryName = "myGallery"
$galleryImageDefinitionName = "myImage"
$galleryImageVersionName = "1.0.0"
$location = "eastus"
$osSnapshot = @{Source = @{Id = "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/mySnapshotRG/providers/Microsoft.Compute/snapshots/myOSSnapshot" }}
$dataSnapshot0 = @{Source = @{Id = "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/mySnapshotRG/providers/Microsoft.Compute/snapshots/myDataSnapshot" }; Lun = 0; }
$dataDisks = @($dataSnapshot0)
New-AzGalleryImageVersion -ResourceGroupName $rgName -GalleryName $galleryName -GalleryImageDefinitionName $galleryImageDefinitionName -Name $galleryImageVersionName -Location $location -OSDiskImage $osSnapshot  -DataDiskImage $dataDisks

Maak een installatiekopieënversie door momentopnamen op te geven voor besturingssysteem- en gegevensschijven.

Voorbeeld 8: Een nieuwe installatiekopieënversie toevoegen op basis van een combinatie van schijven en momentopnamen

$rgName = "myResourceGroup"
$galleryName = "myGallery"
$galleryImageDefinitionName = "myImage"
$galleryImageVersionName = "1.0.0"
$location = "eastus"
$osSnapshot = @{Source = @{Id = "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/mySnapshotRG/providers/Microsoft.Compute/snapshots/myOSSnapshot" }}
$dataDisk0 = @{Source = @{Id = "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myDiskRG/providers/Microsoft.Compute/disks/myDataDisk" }; Lun = 0; }
$dataDisks = @($dataDisk0)
New-AzGalleryImageVersion -ResourceGroupName $rgName -GalleryName $galleryName -GalleryImageDefinitionName $galleryImageDefinitionName -Name $galleryImageVersionName -Location $location -OSDiskImage $osSnapshot  -DataDiskImage $dataDisks

Maak een installatiekopieënversie door een momentopname op te geven als een besturingssysteemschijf en een beheerde schijf als gegevensschijf.

Voorbeeld 9: Voeg een nieuwe versie van de installatiekopie toe en kopieer deze naar extra regio's.

$rgName = "myResourceGroup"
$galleryName = "myGallery"
$galleryImageDefinitionName = "myImage"
$galleryImageVersionName = "1.0.0"
$location = "eastus"
$sourceImageId = "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myVMRG/providers/Microsoft.Compute/virtualMachines/myVM"
$replicaCount = 1
$storageAccountType = "Standard_ZRS"
$region_eastus = @{Name = 'East US';ReplicaCount = 3;StorageAccountType = Standard_LRS}
$region_westus = @{Name = 'West US'}
$region_ukwest = @{Name = 'UK West';ReplicaCount = 2}
$region_southcentralus = @{Name = 'South Central US';StorageAccountType = Standard_LRS}
$targetRegions = @($region_eastus, $region_westus, $region_ukwest, $region_southcentralus)
New-AzGalleryImageVersion -ResourceGroupName $rgName -GalleryName $galleryName -GalleryImageDefinitionName $galleryImageDefinitionName -Name $galleryImageVersionName -Location $location -SourceImageId $sourceImageId -ReplicaCount 1 -StorageAccountType $storageAccountType -TargetRegion $targetRegions

Maak een installatiekopieënversie in vier regio's. In dit voorbeeld is het aantal globale replica's 1 en is het type globale opslagaccount Standard_ZRS. VS - oost heeft 3 replica's, elk opgeslagen op Standard_LRS accountopslag. VS - west neemt over van globale instellingen en heeft 1 replica opgeslagen op Standard_ZRS. UK - west heeft een replicaaantal van 2 dat is opgeslagen op Standard_ZRS. VS - zuid-centraal heeft één replica opgeslagen op Standard_LRS.

Voorbeeld 10: Een nieuwe versie van de installatiekopie met versleuteling toevoegen in meerdere regio's

$rgName = "myResourceGroup"
$galleryName = "myGallery"
$galleryImageDefinitionName = "myImage"
$galleryImageVersionName = "1.0.0"
$location = "eastus"
$sourceImageId = "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myVMRG/providers/Microsoft.Compute/virtualMachines/myVM"
$replicaCount = 1
$storageAccountType = "Standard_ZRS"

# East US regional settings
$eastUSdes = "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myDESrg/providers/Microsoft.Compute/diskEncryptionSets/myEastUSDES"
$encryption_eastus_os = @{DiskEncryptionSetId = $eastUSdes }
$encryption_eastus_dd0 = @{DiskEncryptionSetId = $eastUSdes; Lun = 0 }
$encryption_eastus_dd = @($encryption_eastus_dd0)
$eastus_encryption = @{OSDiskImage = $eastus_encryption_os; DataDiskImages = $eastus_encryption_dd }
$region_eastus = @{Name = 'East US';ReplicaCount = 3;StorageAccountType = Standard_LRS; Encryption = $encryption_eastus}

# West US regional settings
$westUS2des = "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myDESrg/providers/Microsoft.Compute/diskEncryptionSets/myWestUSDES"
$encryption_westus_os = @{DiskEncryptionSetId = $westUSdes }
$encryption_westus_dd0 = @{DiskEncryptionSetId = $westUSdes; Lun = 0 }
$encryption_westus_dd = @($encryption_westus_dd0)
$westus_encryption = @{OSDiskImage = $encryption_westus_os; DataDiskImages = $encryption_westus_dd }
$region_westus = @{Name = 'West US'; Encryption = $westus_encryption}}

# Create images
$targetRegions = @($region_eastus, $region_westus)
New-AzGalleryImageVersion -ResourceGroupName $rgName -GalleryName $galleryName -GalleryImageDefinitionName $galleryImageDefinitionName -Name $galleryImageVersionName -Location $location -SourceImageId $sourceImageId -TargetRegion $targetRegions

Maak een installatiekopieversie met versleuteling in twee regio's. Schijfversleutelingssets zijn regionale resources en er moet in elke regio een andere schijfversleutelingsset worden gebruikt.

Voorbeeld 11: Maak een installatiekopieënversie en laat deze uitsluiten van de meest recente versie

$rgName = "myResourceGroup"
$galleryName = "myGallery"
$galleryImageDefinitionName = "myImage"
$galleryImageVersionName = "1.0.0"
$location = "eastus"
New-AzGalleryImageVersion -ResourceGroupName $rgName -GalleryName $galleryName -GalleryImageDefinitionName $galleryImageDefinitionName -Name $galleryImageVersionName -Location $location -SourceImageId $sourceImageId -PublishingProfileExcludeFromLatest

Voeg een nieuwe versie van de installatiekopieën toe aan een installatiekopieëndefinitie, maar sluit deze uit zodat deze niet in aanmerking komt voor de nieuwste versie binnen de definitie van de installatiekopieën.

Voorbeeld 12: Een installatiekopieënversie maken en de einddatum van de installatiekopieën instellen

$rgName = "myResourceGroup"
$galleryName = "myGallery"
$galleryImageDefinitionName = "myImage"
$galleryImageVersionName = "1.0.0"
$location = "eastus"
$endOfLifeDate = "2024-08-02T00:00:00+00:00"
New-AzGalleryImageVersion -ResourceGroupName $rgName -GalleryName $galleryName -GalleryImageDefinitionName $galleryImageDefinitionName -Name $galleryImageVersionName -Location $location -SourceImageId $sourceImageId -PublishingProfileEndOfLifeDate $endOfLifeDate

In dit voorbeeld is de einddatum voor de installatiekopieënversie ingesteld op 2 augustus 2024 om mignight UTC. Einddatums kunnen worden opgegeven voor zowel de definitie van de installatiekopieën als de versies van installatiekopieën. Versies van installatiekopieën kunnen nog steeds worden gebruikt na de datums van het einde van de levensduur.

Parameters

-AsJob

Cmdlet op de achtergrond uitvoeren

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DataDiskImage

Installatiekopieën van gegevensschijven. bijvoorbeeld @{Source = @{Id = <source_id>}; Lun = 1; SizeInGB = 100; HostCaching = "ReadOnly" }

Type:GalleryDataDiskImage[]
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-DefaultProfile

De referenties, het account, de tenant en het abonnement dat wordt gebruikt voor communicatie met Azure.

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-GalleryImageDefinitionName

De naam van de galerie.

Type:String
Position:2
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-GalleryName

De naam van de galerie.

Type:String
Position:1
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-Location

Resourcelocatie

Type:String
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-Name

De naam van de versie van de galerie-installatiekopieën.

Type:String
Aliases:GalleryImageVersionName
Position:3
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-OSDiskImage

Installatiekopieën van de besturingssysteemschijf, bijvoorbeeld @{Source = @{Id = <source_id>}; SizeInGB = 100; HostCaching = "ReadOnly" }

Type:GalleryOSDiskImage
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-PublishingProfileEndOfLifeDate

De einddatum van de levensduur van de installatiekopieënversie van de galerie.

Type:DateTime
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-PublishingProfileExcludeFromLatest

Als deze is ingesteld, gebruikt Virtual Machines geïmplementeerd vanuit de nieuwste versie van de installatiekopiedefinitie deze versie van de installatiekopie niet.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-ReplicaCount

Het aantal replica's van de versie van de installatiekopieën dat per regio moet worden gemaakt.

Type:Int32
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-ResourceGroupName

De naam van de resourcegroep.

Type:String
Position:0
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-SourceImageId

De id van de broninstallatiekopieën waaruit de versie van de installatiekopieën wordt gemaakt.

Type:String
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-StorageAccountType

Hiermee geeft u het type opslagaccount op dat moet worden gebruikt om de installatiekopie op te slaan. Deze eigenschap kan niet worden bijgewerkt. Beschikbare waarden zijn Standard_LRS, Standard_ZRS en Premium_LRS.

Type:String
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-Tag

Resourcetags

Type:Hashtable
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-TargetRegion

De doelregio's waarnaar de versie van de installatiekopieën wordt gerepliceerd.

Type:Hashtable[]
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Invoerwaarden

String

Hashtable

Int32

SwitchParameter

DateTime

Hashtable[]

Uitvoerwaarden

PSGalleryImageVersion