Update-AzureVMImage
イメージ リポジトリ内のオペレーティング システム イメージのラベルを更新します。
注意
このドキュメントで参照されているコマンドレットは、Service Management API を使用するレガシ Azure リソースを管理するためのものです。 Azure Resource Manager リソースを管理するためのコマンドレットについては、Az 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
オペレーティング システム イメージの説明を指定します。
Type: | String |
Position: | 3 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DiskConfig
New-AzureVMImageDiskConfigSet、Set-AzureVMImageOSDiskConfig、および Set-AzureVMImageDataDiskConfig コマンドレットを使用して作成された仮想マシン イメージのオペレーティング システム ディスクとデータ ディスク構成を指定します。
Type: | VirtualMachineImageDiskConfigSet |
Position: | 8 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DontShowInGui
このコマンドレットが GUI にイメージを表示しないことを示します。
Type: | SwitchParameter |
Position: | 12 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Eula
エンド ユーザー使用許諾契約書を指定します。 値は URL にすることをお勧めします。
Type: | String |
Position: | 2 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-IconName
オペレーティング システムまたは仮想マシン イメージの標準アイコン名を指定します。
Type: | String |
Aliases: | IconUri |
Position: | 10 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ImageFamily
オペレーティング システムまたは仮想マシン イメージをグループ化するために使用できる値を指定します。
Type: | String |
Position: | 4 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ImageName
イメージ リポジトリで更新するイメージの名前を指定します。
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-InformationAction
このコマンドレットが情報イベントに応答する方法を指定します。
このパラメーターの有効値は、次のとおりです。
- 続行
- Ignore
- Inquire
- SilentlyContinue
- Stop
- Suspend
Type: | ActionPreference |
Aliases: | infa |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InformationVariable
情報変数を指定します。
Type: | String |
Aliases: | iv |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Label
イメージの新しいラベルを指定します。
Type: | String |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Language
仮想マシンまたはオペレーティング システム イメージ内のオペレーティング システムの言語を指定します。
Type: | String |
Position: | 9 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-PrivacyUri
オペレーティング システム イメージに関連するプライバシー ポリシーを含むドキュメントを指す URI を指定します。
Type: | Uri |
Position: | 6 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Profile
このコマンドレットが読み取る Azure プロファイルを指定します。 プロファイルを指定しない場合、このコマンドレットはローカルの既定のプロファイルから読み取ります。
Type: | AzureSMProfile |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PublishedDate
オペレーティング システム イメージがイメージ リポジトリに追加された日付を指定します。
Type: | DateTime |
Position: | 5 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-RecommendedVMSize
仮想マシンのサイズを指定します。
このパラメーターの有効値は、次のとおりです。
- Medium
- Large
- ExtraLarge
- A5
- A6
- A7
Type: | String |
Position: | 7 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-SmallIconName
オペレーティング システムまたは仮想マシン イメージの小さいアイコン名を指定します。
Type: | String |
Aliases: | SmallIconUri |
Position: | 11 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
出力
OSImageContext