Update-AzureVMImage

  • リファレンス
モジュール:
Azure

イメージ リポジトリ内のオペレーティング システム イメージのラベルを更新します。

Note

このドキュメントで参照されているコマンドレットは、Azure Service Manager (ASM) API を使用する従来の Azure リソースを管理するためのものです。 ASM の提供終了が予定されているため、新しいリソースを作成する場合、このレガシ PowerShell モジュールは推奨されません。 詳細については、Azure Service Manager の提供終了に関するページを参照してください。

Az PowerShell モジュールは、PowerShell を使用して Azure Resource Manager (ARM) リソースを管理するために推奨される PowerShell モジュールです。

構文

Update-AzureVMImage
      [-ImageName] <String>
      [-Label] <String>
      [[-Eula] <String>]
      [[-Description] <String>]
      [[-ImageFamily] <String>]
      [[-PublishedDate] <DateTime>]
      [[-PrivacyUri] <Uri>]
      [[-RecommendedVMSize] <String>]
      [[-DiskConfig] <VirtualMachineImageDiskConfigSet>]
      [[-Language] <String>]
      [[-IconName] <String>]
      [[-SmallIconName] <String>]
      [-DontShowInGui]
      [-Profile <AzureSMProfile>]
      [-InformationAction <ActionPreference>]
      [-InformationVariable <String>]
      [<CommonParameters>]

説明

Update-AzureVMImage コマンドレットは 、 イメージ リポジトリ内のオペレーティング システム イメージのラベルを更新します。 更新されたイメージに関する情報を含むイメージ オブジェクトを返します。

例

例 1: イメージ ラベルを変更してイメージを更新する

PS C:\> Update-AzureVMImage -ImageName "Windows-Server-2008-SP2" -Label "DoNotUse"

このコマンドは、イメージ ラベルを DoNotUse に変更することで、Windows-Server-2008-SP2 という名前のイメージを更新します。

例 2: すべてのオペレーティング システムをラベルで取得し、ラベルを更新する

PS C:\> Get-AzureVMImage | Where-Object {$_.Label -eq "DoNotUse" } | Update-AzureVMImage -Label "Updated"

このコマンドは、DoNotUse というラベルが付いたオペレーティング システム イメージをすべて取得し、ラベルを [更新済み] に変更します。

パラメーター

-Description

オペレーティング システム イメージの説明を指定します。

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

-DiskConfig

New-AzureVMImageDiskConfigSet、Set-AzureVMImageOSDiskConfig、および Set-AzureVMImageDataDiskConfig コマンドレットを使用して作成された仮想マシン イメージのオペレーティング システム ディスクとデータ ディスク構成を指定します。

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

-DontShowInGui

このコマンドレットが GUI にイメージを表示しないことを示します。

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

-Eula

エンド ユーザー使用許諾契約書を指定します。 値は URL にすることをお勧めします。

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

-IconName

オペレーティング システムまたは仮想マシン イメージの標準アイコン名を指定します。

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

-ImageFamily

オペレーティング システムまたは仮想マシン イメージをグループ化するために使用できる値を指定します。

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

-ImageName

イメージ リポジトリで更新するイメージの名前を指定します。

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

-InformationAction

このコマンドレットが情報イベントに応答する方法を指定します。

このパラメーターの有効値は、次のとおりです。

  • 続行
  • Ignore
  • Inquire
  • SilentlyContinue
  • Stop
  • [中断]
型:ActionPreference
Aliases:infa
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-InformationVariable

情報変数を指定します。

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

-Label

イメージの新しいラベルを指定します。

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

-Language

仮想マシンまたはオペレーティング システム イメージ内のオペレーティング システムの言語を指定します。

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

-PrivacyUri

オペレーティング システム イメージに関連するプライバシー ポリシーを含むドキュメントを指す URI を指定します。

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

-Profile

このコマンドレットが読み取る Azure プロファイルを指定します。 プロファイルを指定しない場合、このコマンドレットはローカルの既定のプロファイルから読み取ります。

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

-PublishedDate

オペレーティング システム イメージがイメージ リポジトリに追加された日付を指定します。

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

-RecommendedVMSize

仮想マシンのサイズを指定します。

このパラメーターの有効値は、次のとおりです。

  • Medium
  • Large
  • ExtraLarge
  • A5
  • A6
  • A7
型:String
配置:7
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-SmallIconName

オペレーティング システムまたは仮想マシン イメージの小さいアイコン名を指定します。

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

出力

OSImageContext