Remove-AzureVMImage
イメージ リポジトリからオペレーティング システム イメージを削除します。
注意
このドキュメントで参照されているコマンドレットは、Service Management API を使用するレガシ Azure リソースを管理するためのものです。 Azure Resource Manager リソースを管理するためのコマンドレットについては、Az 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 を削除することを示します。
Type: | SwitchParameter |
Position: | 1 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
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 |
-Profile
このコマンドレットが読み取る Azure プロファイルを指定します。 プロファイルを指定しない場合、このコマンドレットはローカルの既定のプロファイルから読み取ります。
Type: | AzureSMProfile |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |