Update-AzureRmGalleryImageVersion

  • リファレンス
モジュール:
AzureRM.Compute

ギャラリー イメージのバージョンを更新します。

警告

AzureRM PowerShell モジュールは、2024 年 2 月 29 日の時点で正式に非推奨になりました。 引き続きサポートを受け、更新を受け取れるようにするために、AzureRM から Az PowerShell モジュールに移行することをお勧めします。

AzureRM モジュールは引き続き機能する可能性がありますが、メインが維持またはサポートされなくなり、ユーザーの判断とリスクで引き続き使用できます。 Az モジュールへの移行に関するガイダンスについては、移行リソースを参照してください。

構文

Update-AzureRmGalleryImageVersion
      [-ResourceGroupName] <String>
      [-GalleryName] <String>
      [-GalleryImageDefinitionName] <String>
      [-Name] <String>
      [-AsJob]
      [-Tag <Hashtable>]
      [-ReplicaCount <Int32>]
      [-PublishingProfileExcludeFromLatest]
      [-PublishingProfileEndOfLifeDate <DateTime>]
      [-TargetRegion <Hashtable[]>]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-AzureRmGalleryImageVersion
      [-ResourceId] <String>
      [-AsJob]
      [-Tag <Hashtable>]
      [-ReplicaCount <Int32>]
      [-PublishingProfileExcludeFromLatest]
      [-PublishingProfileEndOfLifeDate <DateTime>]
      [-TargetRegion <Hashtable[]>]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-AzureRmGalleryImageVersion
      [-InputObject] <PSGalleryImageVersion>
      [-AsJob]
      [-Tag <Hashtable>]
      [-ReplicaCount <Int32>]
      [-PublishingProfileExcludeFromLatest]
      [-PublishingProfileEndOfLifeDate <DateTime>]
      [-TargetRegion <Hashtable[]>]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

説明

ギャラリー イメージのバージョンを更新します。

例

例 1

PS C:\> $region1 = @{Name='West US';ReplicaCount=1}
PS C:\> $region2 = @{Name='East US';ReplicaCount=2}
PS C:\> $region3 = @{Name='Central US'}
PS C:\> $targetRegions = @($region1,$region2,$region3)
PS C:\> Update-AzureRmGalleryImageVersion -ResourceGroupName $rgname -GalleryName $galleryName -GalleryImageName $imageName -Name $versionName -ReplicaCount 2 -PublishingProfileEndOfLifeDate $endOfLifeDate -TargetRegion $targetRegions

ギャラリー イメージのバージョンを更新します。

パラメーター

-AsJob

バックグラウンドでコマンドレットを実行する

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Confirm

コマンドレットの実行前に確認を求めるメッセージが表示されます。

型:SwitchParameter
Aliases:cf
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-DefaultProfile

Azure との通信のために使用される資格情報、アカウント、テナント、サブスクリプションです。

型:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-GalleryImageDefinitionName

ギャラリー イメージ定義の名前。

型:String
配置:2
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-GalleryName

ギャラリーの名前。

型:String
配置:1
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-InputObject

PS ギャラリー イメージ バージョン オブジェクト。

型:PSGalleryImageVersion
Aliases:GalleryImageVersion
配置:0
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-Name

ギャラリー イメージ バージョンの名前。

型:String
Aliases:GalleryImageVersionName
配置:3
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-PublishingProfileEndOfLifeDate

ギャラリーイメージバージョンの有効期間の終了日。

型:DateTime
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-PublishingProfileExcludeFromLatest

設定されている場合、イメージ定義の最新バージョンからデプロイされた仮想マシンでは、このイメージ バージョンは使用されません。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-ReplicaCount

リージョンごとに作成されるイメージ バージョンのレプリカの数。

型:Int32
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-ResourceGroupName

リソース グループの名前。

型:String
配置:0
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-ResourceId

ギャラリー イメージ バージョンのリソース ID。

型:String
配置:0
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-Tag

リソース タグ

型:Hashtable
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-TargetRegion

イメージ バージョンがレプリケートされるターゲット リージョン。

型:Hashtable[]
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-WhatIf

コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。

型:SwitchParameter
Aliases:wi
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

入力

String

PSGalleryImageVersion

Hashtable

Int32

SwitchParameter

DateTime

Hashtable[]

出力

PSGalleryImageVersion