Remove-WAPackVM
仮想マシン オブジェクトを削除します。
注意
このドキュメントで参照されているコマンドレットは、Service Management API を使用するレガシ Azure リソースを管理するためのものです。 Azure Resource Manager リソースを管理するためのコマンドレットについては、Az PowerShell モジュールを参照してください。
構文
Remove-WAPackVM
-VM <VirtualMachine>
[-PassThru]
[-Force]
[-Profile <AzureSMProfile>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
説明
これらのトピックは非推奨となり、今後削除される予定です。
このトピックでは、Microsoft Azure PowerShell モジュールの 0.8.1 バージョンのコマンドレットについて説明します。
使用しているモジュールのバージョンを確認するには、Azure PowerShell コンソールで「.」と入力します (Get-Module -Name Azure).Version
。
Remove-WAPackVM コマンドレットは、仮想マシン オブジェクトを削除します。
例
例 1: 仮想マシンを削除する
PS C:\> $VirtualMachine = Get-WAPackVM -Name "ContosoV126"
PS C:\> Remove-WAPackVM -VM $VirtualMachine
最初のコマンドは、Get-WAPackVM コマンドレットを使用して ContosoV126 という名前の仮想マシンを取得し、そのオブジェクトを$VirtualMachine変数に格納します。
2 番目のコマンドは、$VirtualMachineに格納されている仮想マシンを削除します。 コマンドを実行すると、確認を求められます。
例 2: 確認なしで仮想マシンを削除する
PS C:\> $VirtualMachine = Get-WAPackVM -Name "ContosoV126"
PS C:\> Remove-WAPackVM -VM $VirtualMachine -Force
最初のコマンドは、Get-WAPackVM コマンドレットを使用して ContosoV126 という名前の仮想マシンを取得し、そのオブジェクトを$VirtualMachine変数に格納します。
2 番目のコマンドは、$VirtualMachineに格納されている仮想マシンを削除します。 このコマンドには Force パラメーターが含まれています。 このコマンドは、確認を求めるメッセージを表示しません。
パラメーター
-Confirm
コマンドレットの実行前に確認を求めるメッセージが表示されます。
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Force
確認を求めずに、コマンドレットによって仮想マシンが削除されることを示します。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PassThru
コマンドレットからブール値が返されることを示します。 操作が成功した場合、コマンドレットは $True の値を返します。 一致しない場合は、値 $False を返します。 既定では、このコマンドレットによる出力はありません。
Type: | SwitchParameter |
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 |
-VM
仮想マシンを指定します。 仮想マシンを取得するには、Get-WAPackVM コマンドレットを使用します。
Type: | VirtualMachine |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WhatIf
コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |