Remove-WAPackVMRole
仮想マシン ロール オブジェクトを削除します。
注意
このドキュメントで参照されているコマンドレットは、Service Management API を使用するレガシ Azure リソースを管理するためのものです。 Azure Resource Manager リソースを管理するためのコマンドレットについては、Az PowerShell モジュールを参照してください。
構文
Remove-WAPackVMRole
-VMRole <VMRole>
[-PassThru]
[-Force]
[-Profile <AzureSMProfile>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-WAPackVMRole
-VMRole <VMRole>
-CloudServiceName <String>
[-PassThru]
[-Force]
[-Profile <AzureSMProfile>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
説明
これらのトピックは非推奨となり、今後削除される予定です。
このトピックでは、Microsoft Azure PowerShell モジュールの 0.8.1 バージョンのコマンドレットについて説明します。
使用しているモジュールのバージョンを確認するには、Azure PowerShell コンソールで「.」と入力します (Get-Module -Name Azure).Version
。
Remove-WAPackVMRole コマンドレットは、仮想マシン ロール オブジェクトを削除します。
例
例 1: (WAP ポータルを使用して作成された) 仮想マシンの役割を削除する
PS C:\> $VMRole = Get-WAPackVMRole -Name "ContosoVMRole01"
PS C:\> Remove-WAPackVMRole -VMRole $VMRole
最初のコマンドは、Get-WAPackVMRole コマンドレットを使用して ContosoVMRole01 という名前の仮想マシン ロールを取得し、そのオブジェクトを$VMRole変数に格納します。
2 番目のコマンドは、$VMRoleに格納されている仮想マシン ロールを削除します。 コマンドを実行すると、確認を求められます。この仮想マシンの役割が WAP ポータルを使用して作成されたと仮定すると、クラウド サービス名を指定する必要はありません。
例 2: クラウド サービスを手動で作成した後に作成された仮想マシン ロールを削除する
PS C:\> $VMRole = Get-WAPackVMRole -Name "ContosoVMRole02"
PS C:\> Remove-WAPackVMRole -VMRole $VMRole -CloudServiceName "ContosoCloudService02"
最初のコマンドは、Get-WAPackVMRole コマンドレットを使用して "ContosoVMRole02" という名前の仮想マシン ロールを取得し、そのオブジェクトを $VMRole 変数に格納します。
2 番目のコマンドは、$VMRoleに格納されている仮想マシン ロールを削除します。 コマンドを実行すると、確認を求められます。 この仮想マシンロールがポータルを使用して作成されなかった場合、ユーザーはクラウド サービス名を指定する必要があります。 この場合、"ContosoCloudService02" という名前が付けられます。
例 3: 確認なしで仮想マシンロールを削除する
PS C:\> $VMRole = Get-WAPackVMRole -Name "ContosoVMRole03"
PS C:\> Remove-WAPackVMRole -VMRole $VMRole -Force
最初のコマンドは、Get-WAPackVMRole コマンドレットを使用して ContosoVMRole03 という名前のクラウド サービスを取得し、そのオブジェクトを$VMRole変数に格納します。
2 番目のコマンドは、$VMRoleに格納されている仮想マシン ロールを削除します。 このコマンドには Force パラメーターが含まれています。 このコマンドは、確認を求めるメッセージを表示しません。
パラメーター
-CloudServiceName
仮想マシン ロールのクラウド サービス名を指定します。
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-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
作業中の項目を表すオブジェクトを返します。 既定では、このコマンドレットによる出力はありません。
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 |
-VMRole
仮想マシンロールを指定します。 仮想マシンロールを取得するには、Get-WAPackVMRole コマンドレットを使用します。
Type: | VMRole |
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 |