Partilhar via

Update-AzGalleryImageVersion

Módulo:
Az.Compute Module

Atualize uma versão da imagem da galeria.

Sintaxe

DefaultParameter (Padrão) 

Update-AzGalleryImageVersion
    [-ResourceGroupName] <String>
    [-GalleryName] <String>
    [-GalleryImageDefinitionName] <String>
    [-Name] <String>
    [-AsJob]
    [-PublishingProfileEndOfLifeDate <DateTime>]
    [-PublishingProfileExcludeFromLatest]
    [-ReplicaCount <Int32>]
    [-Tag <Hashtable>]
    [-TargetRegion <Hashtable[]>]
    [-TargetExtendedLocation <Hashtable[]>]
    [-AllowDeletionOfReplicatedLocation <Boolean>]
    [-BlockDeletionBeforeEndOfLife <Boolean>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ResourceIdParameter 

Update-AzGalleryImageVersion
    [-ResourceId] <String>
    [-AsJob]
    [-PublishingProfileEndOfLifeDate <DateTime>]
    [-PublishingProfileExcludeFromLatest]
    [-ReplicaCount <Int32>]
    [-Tag <Hashtable>]
    [-TargetRegion <Hashtable[]>]
    [-TargetExtendedLocation <Hashtable[]>]
    [-AllowDeletionOfReplicatedLocation <Boolean>]
    [-BlockDeletionBeforeEndOfLife <Boolean>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ObjectParameter 

Update-AzGalleryImageVersion
    [-InputObject] <PSGalleryImageVersion>
    [-AsJob]
    [-PublishingProfileEndOfLifeDate <DateTime>]
    [-PublishingProfileExcludeFromLatest]
    [-ReplicaCount <Int32>]
    [-Tag <Hashtable>]
    [-TargetRegion <Hashtable[]>]
    [-TargetExtendedLocation <Hashtable[]>]
    [-AllowDeletionOfReplicatedLocation <Boolean>]
    [-BlockDeletionBeforeEndOfLife <Boolean>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Descrição

Atualize uma versão da imagem da galeria.

Exemplos

Exemplo 1: Alterar as regiões de replicação e a contagem de réplicas

$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

Atualize as regiões de uma versão da imagem da galeria.

Exemplo 2: Altere se uma versão da imagem deve ser considerada para a versão mais recente.

$rgName = "myResourceGroup"
$galleryName = "myGallery"
$imageName = "myImage"
$versionName = "1.0.0"
Update-AzGalleryImageVersion -ResourceGroupName $rgname -GalleryName $galleryName -GalleryImageDefinitionName $imageName -Name $versionName -PublishingProfileExcludeFromLatest:$false

Atualizar a exclusão de uma versão da imagem da galeria do status mais recente. Para incluir uma versão de imagem em consideração para a mais recente, use -PublishingProfileExcludeFromLatest:$false. Para excluir uma versão de imagem da consideração para a versão mais recente, use -PublishingProfileExcludeFromLatest.

Exemplo 3: Alterar a data de fim de vida de uma versão de imagem.

$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

Atualize a data de fim de vida útil de uma versão da imagem da galeria. A versão da imagem ainda pode ser usada para criar máquinas virtuais após a data de fim de vida.

Exemplo 4: Atualização para remover TargetExtendedLocations.

$rgName = "myResourceGroup"
$galleryName = "myGallery"
$imageName = "myImage"
$versionName = "1.0.0"

Update-AzGalleryImageVersion -ResourceGroupName $rgname -GalleryName $galleryName -GalleryImageDefinitionName $imageName -Name $versionName -TargetExtendedLocation @() -AllowDeletionOfReplicatedLocation $True

Atualize uma versão de imagem de galeria para remover locais estendidos de destino existentes. Passe uma matriz vazia para -TargetExtendedLocation e defina -AllowDeletionOfReplicatedLocation como true.

Parâmetros

-AllowDeletionOfReplicatedLocation

Indica se a remoção desta Versão da Imagem da Galeria das regiões replicadas é permitida ou não.

Propriedades dos parâmetros

Tipo:Boolean
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:True
Valor dos argumentos restantes:False

-AsJob

Executar cmdlet em segundo plano

Propriedades dos parâmetros

Tipo:SwitchParameter
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False

-BlockDeletionBeforeEndOfLife

Este booleano será passado pelos clientes para habilitar seus recursos GalleryImageVersion de exclusões acidentais. Se este booleano estiver definido como true, as exclusões de imagem serão bloqueadas antes de sua data de Fim de Vida.

Propriedades dos parâmetros

Tipo:

Nullable<T>[Boolean]

Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:True
Valor dos argumentos restantes:False

-Confirm

Solicita confirmação antes de executar o cmdlet.

Propriedades dos parâmetros

Tipo:SwitchParameter
Valor padrão:None
Suporta curingas:False
DontShow:False
Pseudónimos:Cf.

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para comunicação com o Azure.

Propriedades dos parâmetros

Tipo:IAzureContextContainer
Valor padrão:None
Suporta curingas:False
DontShow:False
Pseudónimos:AzContext, AzureRmContext, AzureCredential

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False

-GalleryImageDefinitionName

O nome da definição da imagem da galeria.

Propriedades dos parâmetros

Tipo:String
Valor padrão:None
Suporta curingas:False
DontShow:False
Pseudónimos:GalleryImageName

Conjuntos de parâmetros

DefaultParameter
Posição:2
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome da propriedade:True
Valor dos argumentos restantes:False

-GalleryName

O nome da galeria.

Propriedades dos parâmetros

Tipo:String
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

DefaultParameter
Posição:1
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome da propriedade:True
Valor dos argumentos restantes:False

-InputObject

O objeto PS Gallery Image Version.

Propriedades dos parâmetros

Tipo:PSGalleryImageVersion
Valor padrão:None
Suporta curingas:False
DontShow:False
Pseudónimos:GalleryImageVersion

Conjuntos de parâmetros

ObjectParameter
Posição:0
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False

-Name

O nome da versão da imagem da galeria.

Propriedades dos parâmetros

Tipo:String
Valor padrão:None
Suporta curingas:False
DontShow:False
Pseudónimos:GalleryImageVersionName

Conjuntos de parâmetros

DefaultParameter
Posição:3
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome da propriedade:True
Valor dos argumentos restantes:False

-PublishingProfileEndOfLifeDate

A data de fim da vida útil da galeria Versão da Imagem.

Propriedades dos parâmetros

Tipo:DateTime
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:True
Valor dos argumentos restantes:False

-PublishingProfileExcludeFromLatest

Se estiver definida, as Máquinas Virtuais implantadas a partir da versão mais recente da Definição de Imagem não usarão essa Versão de Imagem.

Propriedades dos parâmetros

Tipo:SwitchParameter
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:True
Valor dos argumentos restantes:False

-ReplicaCount

O número de réplicas da Versão da Imagem a ser criada por região.

Propriedades dos parâmetros

Tipo:Int32
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:True
Valor dos argumentos restantes:False

-ResourceGroupName

O nome do grupo de recursos.

Propriedades dos parâmetros

Tipo:String
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

DefaultParameter
Posição:0
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome da propriedade:True
Valor dos argumentos restantes:False

-ResourceId

O ID do recurso para a versão da imagem da galeria.

Propriedades dos parâmetros

Tipo:String
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

ResourceIdParameter
Posição:0
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome da propriedade:True
Valor dos argumentos restantes:False

-Tag

Etiquetas de recursos

Propriedades dos parâmetros

Tipo:Hashtable
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:True
Valor dos argumentos restantes:False

-TargetExtendedLocation

Os locais estendidos de destino para onde a Versão da Imagem será replicada. Esta propriedade é atualizável.

Propriedades dos parâmetros

Tipo:

Hashtable[]

Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:True
Valor dos argumentos restantes:False

-TargetRegion

As regiões de destino para as quais a Versão da Imagem será replicada.

Propriedades dos parâmetros

Tipo:

Hashtable[]

Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:True
Valor dos argumentos restantes:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Propriedades dos parâmetros

Tipo:SwitchParameter
Valor padrão:None
Suporta curingas:False
DontShow:False
Pseudónimos:Wi

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Entradas

String

PSGalleryImageVersion

Hashtable

Int32

SwitchParameter

DateTime

Hashtable

Saídas

PSGalleryImageVersion