Remove-AzureRmResourceGroup
リソース グループを削除します。
警告
AzureRM PowerShell モジュールは、2024 年 2 月 29 日に正式に非推奨になりました。 引き続きサポートを受け、更新を受け取れるようにするために、AzureRM から Az PowerShell モジュールに移行することをお勧めします。
AzureRM モジュールの機能は今後も使用できますが、メンテナンスやサポートは行われないため、引き続きの使用はユーザーの判断に委ねられ、リスクが発生することがあります。 Az モジュールへの移行に関するガイダンスについては、移行リソースを参照してください。
構文
Remove-AzureRmResourceGroup
[-Name] <String>
[-Force]
[-AsJob]
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-AzureRmResourceGroup
[-Id] <String>
[-Force]
[-AsJob]
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
説明
Remove-AzureRmResourceGroup コマンドレットは、現在のサブスクリプションから Azure リソース グループとそのリソースを削除します。 リソースを削除し、リソース グループを残すには、Remove-AzureRmResource コマンドレットを使用します。
例
例 1: リソース グループを削除する
PS C:\>Remove-AzureRmResourceGroup -Name "ContosoRG01"
このコマンドは、ContosoRG01 リソース グループをサブスクリプションから削除します。 コマンドレットによって確認のプロンプトが表示され、出力は返されません。
例 2: 確認なしでリソース グループを削除する
PS C:\>Get-AzureRmResourceGroup -Name "ContosoRG01" | Remove-AzureRmResourceGroup -Verbose -Force
このコマンドは、Get-AzureRmResourceGroup コマンドレットを使用してリソース グループ ContosoRG01 を取得し、パイプライン オペレーターを使用して Remove-AzureRmResourceGroup に渡します。 Verbose共通パラメーターは操作に関する状態情報を取得し、Force パラメーターは確認プロンプトを抑制します。
例 3: すべてのリソース グループを削除する
PS C:\>Get-AzureRmResourceGroup | Remove-AzureRmResourceGroup
このコマンドは、 Get-AzureRmResourceGroup コマンドレットを使用してすべてのリソース グループを取得し、パイプライン 演算子を使用して Remove-AzureRmResourceGroup に渡します。
パラメーター
-ApiVersion
リソース プロバイダーでサポートされている API バージョンを指定します。 既定のバージョンとは異なるバージョンを指定できます。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-AsJob
バックグラウンドでコマンドレットを実行する
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Confirm
コマンドレットの実行前に確認を求めるメッセージが表示されます。
型: | SwitchParameter |
Aliases: | cf |
配置: | Named |
規定値: | False |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-DefaultProfile
Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション
型: | IAzureContextContainer |
Aliases: | AzureRmContext, AzureCredential |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Force
ユーザーに確認せずに、直ちにコマンドを実行します。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Id
削除するリソース グループの ID を指定します。 ワイルドカード文字は使用できません。
型: | String |
Aliases: | ResourceGroupId, ResourceId |
配置: | 0 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-Name
削除するリソース グループの名前を指定します。 ワイルドカード文字は使用できません。
型: | String |
Aliases: | ResourceGroupName |
配置: | 0 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-Pre
このコマンドレットは、使用するバージョンを自動的に決定するときに、プレリリース API バージョンを考慮することを示します。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-WhatIf
コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。
型: | SwitchParameter |
Aliases: | wi |
配置: | Named |
規定値: | False |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |