Remove-AzureVMImage
イメージ リポジトリからオペレーティング システム イメージを削除します。
Note
このドキュメントで参照されているコマンドレットは、Azure Service Manager (ASM) API を使用するレガシ Azure リソースを管理するためのものです。 ASM の廃止が予定されているため、新しいリソースを作成する場合、このレガシ PowerShell モジュールは推奨されません。 詳細については、「Azure Service Manager の廃止」を参照してください。
Az PowerShell モジュールは、PowerShell を使用して Azure Resource Manager (ARM) リソースを管理するための推奨される PowerShell モジュールです。
構文
Remove-AzureVMImage
[-ImageName] <String>
[-DeleteVHD]
[-Profile <AzureSMProfile>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>]
説明
Remove-AzureVMImage コマンドレットは、イメージ リポジトリからオペレーティング システム イメージを削除します。 既定では、このコマンドレットは、関連付けられている物理イメージ BLOB をストレージ アカウントから削除しません。 関連付けられている仮想ハード ドライブ (VHD) を削除するには、DeleteVHD パラメーターを使用します。
例
例 1: イメージ リポジトリからイメージを削除する
PS C:\> Remove-AzureVMImage -ImageName "Image001"
このコマンドは、Image001 という名前のイメージをイメージ リポジトリから削除します。
例 2: イメージ リポジトリと VHD からイメージを削除する
PS C:\> Remove-AzureVMImage -ImageName " Image001" -DeleteVHD
このコマンドは、Image001 という名前のイメージをイメージ リポジトリから削除し、ストレージ アカウントから物理 VHD イメージも削除します。
例 3: サブスクリプション コンテキストを設定し、すべてのイメージを削除する
PS C:\> $SubsId = <MySubscriptionID>
PS C:\> $Cert = Get-AzureCertificate cert:\LocalMachine\MY\<CertificateThumbprint>
PS C:\> Get-AzureVMImage `
| Where-Object {$_.Label -match "Beta" }`
| Foreach-Object {Remove-AzureVMImage -ImageName $_.name }
このコマンドは、サブスクリプション コンテキストを設定し、Label に Beta という名前が含まれるイメージ リポジトリからすべてのイメージを削除します。
パラメーター
-DeleteVHD
このコマンドレットがストレージ アカウントから物理 VHD イメージ BLOB を削除することを示します。
型: | SwitchParameter |
配置: | 1 |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-ImageName
イメージ リポジトリから削除するオペレーティング システムまたは仮想マシン イメージを指定します。
型: | String |
配置: | 0 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-InformationAction
このコマンドレットが情報イベントに応答する方法を指定します。
このパラメーターの有効値は、次のとおりです。
- 続行
- Ignore
- Inquire
- SilentlyContinue
- 阻止
- [中断]
型: | ActionPreference |
Aliases: | infa |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-InformationVariable
情報変数を指定します。
型: | String |
Aliases: | iv |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Profile
このコマンドレットが読み取る Azure プロファイルを指定します。 プロファイルを指定しない場合、このコマンドレットはローカルの既定のプロファイルから読み取ります。
型: | AzureSMProfile |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |