Remove-WAPackVMRole
仮想マシン ロール オブジェクトを削除します。
Note
このドキュメントで参照されているコマンドレットは、Azure Service Manager (ASM) API を使用する従来の Azure リソースを管理するためのものです。 ASM の提供終了が予定されているため、新しいリソースを作成する場合、このレガシ PowerShell モジュールは推奨されません。 詳細については、Azure Service Manager の提供終了に関するページを参照してください。
Az PowerShell モジュールは、PowerShell を使用して Azure Resource Manager (ARM) リソースを管理するために推奨される 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
仮想マシン ロールのクラウド サービス名を指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Confirm
コマンドレットの実行前に確認を求めるメッセージが表示されます。
| 型: | SwitchParameter |
| Aliases: | cf |
| 配置: | Named |
| 規定値: | False |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Force
ユーザーに確認せずに、直ちにコマンドを実行します。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-PassThru
作業中の項目を表すオブジェクトを返します。 既定では、このコマンドレットによる出力はありません。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Profile
このコマンドレットが読み取る Azure プロファイルを指定します。 プロファイルを指定しない場合、このコマンドレットはローカルの既定のプロファイルから読み取ります。
| 型: | AzureSMProfile |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-VMRole
仮想マシンロールを指定します。 仮想マシンロールを取得するには、Get-WAPackVMRole コマンドレットを使用します。
| 型: | VMRole |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-WhatIf
コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。
| 型: | SwitchParameter |
| Aliases: | wi |
| 配置: | Named |
| 規定値: | False |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |