Update-AzGalleryImageVersion

Обновление версии образа коллекции.

Синтаксис

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>]

Описание

Обновление версии образа коллекции.

Примеры

Пример 1. Изменение регионов репликации и количества реплик

$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

Обновите регионы версии образа коллекции.

Пример 2. Измените, следует ли учитывать версию образа для последней версии.

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

Обновление исключения версии образа коллекции из последнего состояния. Чтобы включить версию образа в учетную версию последнего, используйте -PublishingProfileExcludeFromLatest:$false. Чтобы исключить версию образа из рассмотрения последней версии, используйте -PublishingProfileExcludeFromLatest.

Пример 3. Изменение даты окончания срока жизни для версии образа.

$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

Обновите дату окончания срока действия версии образа коллекции. Версия образа по-прежнему может использоваться для создания виртуальных машин после окончания срока действия.

Пример 4. Обновление для удаления TargetExtendedLocations.

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

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

Обновите версию образа коллекции, чтобы удалить существующие расширенные расположения. Передайте пустой массив для -TargetExtendedLocation и задайте значение true -AllowDeletionOfReplicatedLocation.

Параметры

-AllowDeletionOfReplicatedLocation

Указывает, разрешено ли удаление этой версии образа коллекции из реплицированных регионов.

Тип:Boolean
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-AsJob

Запуск командлета в фоновом режиме

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Confirm

Запрос подтверждения перед выполнением командлета.

Тип:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-DefaultProfile

Учетные данные, учетная запись, клиент и подписка, используемые для взаимодействия с Azure.

Тип:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-GalleryImageDefinitionName

Имя определения изображения коллекции.

Тип:String
Aliases:GalleryImageName
Position:2
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-GalleryName

Имя коллекции.

Тип:String
Position:1
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-InputObject

Объект версии образа коллекции PS.

Тип:PSGalleryImageVersion
Aliases:GalleryImageVersion
Position:0
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-Name

Имя версии образа коллекции.

Тип:String
Aliases:GalleryImageVersionName
Position:3
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-PublishingProfileEndOfLifeDate

Дата окончания срока действия версии образа коллекции.

Тип:DateTime
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-PublishingProfileExcludeFromLatest

Если он задан, Виртуальные машины развернутые из последней версии определения образа не будут использовать эту версию образа.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-ReplicaCount

Количество реплик версии образа для каждого региона.

Тип:Int32
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-ResourceGroupName

Имя группы ресурсов.

Тип:String
Position:0
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-ResourceId

Идентификатор ресурса для версии образа коллекции.

Тип:String
Position:0
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-Tag

Теги ресурсов

Тип:Hashtable
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-TargetExtendedLocation

Целевые расширенные расположения, в которых будет реплицироваться версия образа. Это свойство является обновляемым.

Тип:Hashtable[]
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-TargetRegion

Целевые регионы, в которых будет реплицироваться версия образа.

Тип:Hashtable[]
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-WhatIf

Показывает, что произойдет при запуске командлета. Командлет не выполняется.

Тип:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

Входные данные

String

PSGalleryImageVersion

Hashtable

Int32

SwitchParameter

DateTime

Hashtable[]

Выходные данные

PSGalleryImageVersion