Remove-AzResourceGroup
構文
RemoveByResourceGroupName (既定)
Remove-AzResourceGroup
[-Name] <String>
[-ForceDeletionType <String>]
[-Force]
[-AsJob]
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
RemoveByResourceGroupId
Remove-AzResourceGroup
-Id <String>
[-ForceDeletionType <String>]
[-Force]
[-AsJob]
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
説明
Remove-AzResourceGroup コマンドレットは、現在のサブスクリプションから Azure リソース グループとそのリソースを削除します。
リソースを削除し、リソース グループを残すには、Remove-AzResource コマンドレットを使用します。
例
例 1: リソース グループを削除する
Remove-AzResourceGroup -Name "ContosoRG01"
このコマンドは、ContosoRG01 リソース グループをサブスクリプションから削除します。
このコマンドレットは、確認を求めるメッセージを表示し、出力を返しません。
例 2: 確認なしでリソース グループを削除する
Get-AzResourceGroup -Name "ContosoRG01" | Remove-AzResourceGroup -Force
このコマンドでは、Get-AzResourceGroup コマンドレットを使用してリソース グループ ContosoRG01 を取得し、パイプライン 演算子を使用して Remove-AzResourceGroup 渡します。
Force パラメーターは、確認プロンプトを抑制します。
例 3: すべてのリソース グループを削除する
Get-AzResourceGroup | Remove-AzResourceGroup
このコマンドは、Get-AzResourceGroup コマンドレットを使用してすべてのリソース グループを取得し、パイプライン 演算子を使用して Remove-AzResourceGroup に渡します。
例 4: ForceDeletionType を使用してリソース グループを削除する
Remove-AzResourceGroup -Name "ContosoRG01" -ForceDeletionType "Microsoft.Compute/virtualMachineScaleSets,Microsoft.Compute/virtualMachines,Microsoft.Databricks/workspaces"
このコマンドは、ForceDeletionType を使用して ContosoRG01 リソース グループを削除します。
このコマンドレットは、確認を求めるメッセージを表示し、出力を返しません。
パラメーター
-ApiVersion
リソース プロバイダーでサポートされている API バージョンを指定します。
既定のバージョンとは異なるバージョンを指定できます。
パラメーターのプロパティ
型: | String
|
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-AsJob
バックグラウンドでコマンドレットを実行する
パラメーターのプロパティ
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-Confirm
コマンドレットを実行する前に確認を求めるメッセージが表示されます。
パラメーターのプロパティ
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-DefaultProfile
Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション
パラメーターのプロパティ
型: | IAzureContextContainer
|
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
Aliases: | AzContext, AzureRmContext, AzureCredential |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-Force
ユーザーの確認を求めずにコマンドを強制的に実行します。
パラメーターのプロパティ
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-ForceDeletionType
強制的に削除するリソースの種類。現在、サポートされているのは forceDeletionTypes=Microsoft.Compute/virtualMachines、Microsoft.Compute/virtualMachineScaleSets のみです。
パラメーターのプロパティ
型: | String
|
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-Id
削除するリソース グループの ID を指定します。
ワイルドカード文字は使用できません。
パラメーターのプロパティ
型: | String
|
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
Aliases: | ResourceGroupId, リソースID |
パラメーター セット
RemoveByResourceGroupId
配置: | Named |
必須: | True |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | True |
残りの引数からの値: | False |
-Name
削除するリソース グループの名前を指定します。
ワイルドカード文字は使用できません。
パラメーターのプロパティ
型: | String
|
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
Aliases: | リソースグループ名 |
パラメーター セット
RemoveByResourceGroupName
配置: | 0 |
必須: | True |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | True |
残りの引数からの値: | False |
-Pre
このコマンドレットは、使用するバージョンを自動的に決定するときに、プレリリース API バージョンを考慮することを示します。
パラメーターのプロパティ
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-WhatIf
コマンドレットを実行した場合の動作を示します。
コマンドレットは実行されません。
パラメーターのプロパティ
型: | SwitchParameter
|
規定値: | False |
ワイルドカードのサポート: | False |
DontShow: | False |
Aliases: | ウィスコンシン |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。
出力