Update-AzGalleryImageVersion
Aggiornare una versione dell'immagine della raccolta.
Sintassi
Update-AzGalleryImageVersion
[-ResourceGroupName] <String>
[-GalleryName] <String>
[-GalleryImageDefinitionName] <String>
[-Name] <String>
[-AsJob]
[-PublishingProfileEndOfLifeDate <DateTime>]
[-PublishingProfileExcludeFromLatest]
[-ReplicaCount <Int32>]
[-Tag <Hashtable>]
[-TargetRegion <Hashtable[]>]
[-TargetExtendedLocation <Hashtable[]>]
[-AllowDeletionOfReplicatedLocation <Boolean>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Update-AzGalleryImageVersion
[-ResourceId] <String>
[-AsJob]
[-PublishingProfileEndOfLifeDate <DateTime>]
[-PublishingProfileExcludeFromLatest]
[-ReplicaCount <Int32>]
[-Tag <Hashtable>]
[-TargetRegion <Hashtable[]>]
[-TargetExtendedLocation <Hashtable[]>]
[-AllowDeletionOfReplicatedLocation <Boolean>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Update-AzGalleryImageVersion
[-InputObject] <PSGalleryImageVersion>
[-AsJob]
[-PublishingProfileEndOfLifeDate <DateTime>]
[-PublishingProfileExcludeFromLatest]
[-ReplicaCount <Int32>]
[-Tag <Hashtable>]
[-TargetRegion <Hashtable[]>]
[-TargetExtendedLocation <Hashtable[]>]
[-AllowDeletionOfReplicatedLocation <Boolean>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Descrizione
Aggiornare una versione dell'immagine della raccolta.
Esempio
Esempio 1: Modificare le aree di replica e il numero di repliche
$rgName = "myResourceGroup"
$galleryName = "myGallery"
$imageName = "myImage"
$versionName = "1.0.0"
$region1 = @{Name='West US';ReplicaCount=1}
$region2 = @{Name='East US';ReplicaCount=2}
$region3 = @{Name='Central US'}
$targetRegions = @($region1,$region2,$region3)
Update-AzGalleryImageVersion -ResourceGroupName $rgname -GalleryName $galleryName -GalleryImageDefinitionName $imageName -Name $versionName -ReplicaCount 2 -TargetRegion $targetRegions
Aggiornare le aree di una versione dell'immagine della raccolta.
Esempio 2: Modificare se una versione dell'immagine deve essere considerata per la versione più recente.
$rgName = "myResourceGroup"
$galleryName = "myGallery"
$imageName = "myImage"
$versionName = "1.0.0"
Update-AzGalleryImageVersion -ResourceGroupName $rgname -GalleryName $galleryName -GalleryImageDefinitionName $imageName -Name $versionName -PublishingProfileExcludeFromLatest:$false
Aggiornare l'esclusione della versione dell'immagine della raccolta dallo stato più recente. Per includere una versione dell'immagine in considerazione per la versione più recente, usare -PublishingProfileExcludeFromLatest:$false
. Per escludere una versione dell'immagine dalla considerazione per la versione più recente, usare -PublishingProfileExcludeFromLatest
.
Esempio 3: Modificare la data di fine vita per una versione dell'immagine.
$rgName = "myResourceGroup"
$galleryName = "myGallery"
$imageName = "myImage"
$versionName = "1.0.0"
$endOfLifeDate = "2024-08-02T00:00:00+00:00"
Update-AzGalleryImageVersion -ResourceGroupName $rgname -GalleryName $galleryName -GalleryImageDefinitionName $imageName -Name $versionName -PublishingProfileEndOfLifeDate $endOfLifeDate
Aggiornare la data di fine vita di una versione dell'immagine della raccolta. La versione dell'immagine può comunque essere usata per creare macchine virtuali dopo la data di fine del ciclo di vita.
Esempio 4: aggiornare per rimuovere TargetExtendedLocations.
$rgName = "myResourceGroup"
$galleryName = "myGallery"
$imageName = "myImage"
$versionName = "1.0.0"
Update-AzGalleryImageVersion -ResourceGroupName $rgname -GalleryName $galleryName -GalleryImageDefinitionName $imageName -Name $versionName -TargetExtendedLocation @() -AllowDeletionOfReplicatedLocation $True
Aggiornare una versione dell'immagine della raccolta per rimuovere le posizioni estese di destinazione esistenti. Passare una matrice vuota per -TargetExtendedLocation e impostare -AllowDeletionOfReplicatedLocation su true.
Parametri
-AllowDeletionOfReplicatedLocation
Indica se è consentita o meno la rimozione della versione dell'immagine della raccolta dalle aree replicate.
Tipo: | Boolean |
Position: | Named |
valore predefinito: | None |
Necessario: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-AsJob
Eseguire il cmdlet in background
Tipo: | SwitchParameter |
Position: | Named |
valore predefinito: | None |
Necessario: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Richiede conferma prima di eseguire il cmdlet.
Tipo: | SwitchParameter |
Aliases: | cf |
Position: | Named |
valore predefinito: | None |
Necessario: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DefaultProfile
Le credenziali, l’account, il tenant e la sottoscrizione usati per comunicare con Azure.
Tipo: | IAzureContextContainer |
Aliases: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
valore predefinito: | None |
Necessario: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-GalleryImageDefinitionName
Nome della definizione dell'immagine della raccolta.
Tipo: | String |
Aliases: | GalleryImageName |
Position: | 2 |
valore predefinito: | None |
Necessario: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-GalleryName
Nome della raccolta.
Tipo: | String |
Position: | 1 |
valore predefinito: | None |
Necessario: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-InputObject
Oggetto Versione immagine di PS Gallery.
Tipo: | PSGalleryImageVersion |
Aliases: | GalleryImageVersion |
Position: | 0 |
valore predefinito: | None |
Necessario: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
Nome della versione dell'immagine della raccolta.
Tipo: | String |
Aliases: | GalleryImageVersionName |
Position: | 3 |
valore predefinito: | None |
Necessario: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-PublishingProfileEndOfLifeDate
Data di fine vita della raccolta Versione immagine.
Tipo: | DateTime |
Position: | Named |
valore predefinito: | None |
Necessario: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-PublishingProfileExcludeFromLatest
Se è impostata, Macchine virtuali distribuita dalla versione più recente della definizione dell'immagine non userà questa versione dell'immagine.
Tipo: | SwitchParameter |
Position: | Named |
valore predefinito: | None |
Necessario: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ReplicaCount
Numero di repliche della versione dell'immagine da creare per area.
Tipo: | Int32 |
Position: | Named |
valore predefinito: | None |
Necessario: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ResourceGroupName
Nome del gruppo di risorse.
Tipo: | String |
Position: | 0 |
valore predefinito: | None |
Necessario: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ResourceId
ID risorsa per la versione dell'immagine della raccolta.
Tipo: | String |
Position: | 0 |
valore predefinito: | None |
Necessario: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Tag
Tag delle risorse
Tipo: | Hashtable |
Position: | Named |
valore predefinito: | None |
Necessario: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-TargetExtendedLocation
I percorsi estesi di destinazione in cui verrà replicata la versione dell'immagine. Questa proprietà è aggiornabile.
Tipo: | Hashtable[] |
Position: | Named |
valore predefinito: | None |
Necessario: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-TargetRegion
Le aree di destinazione in cui verrà replicata la versione dell'immagine.
Tipo: | Hashtable[] |
Position: | Named |
valore predefinito: | None |
Necessario: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WhatIf
Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.
Tipo: | SwitchParameter |
Aliases: | wi |
Position: | Named |
valore predefinito: | None |
Necessario: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Input
Output
Commenti e suggerimenti
https://aka.ms/ContentUserFeedback.
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedereInvia e visualizza il feedback per