次の方法で共有

Remove-AzResourceGroup

  • リファレンス
モジュール:
Az.Resources

リソース グループを削除します。

構文

Remove-AzResourceGroup
      [-Name] <String>
      [-ForceDeletionType <String>]
      [-Force]
      [-AsJob]
      [-ApiVersion <String>]
      [-Pre]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
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
配置: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:AzContext, AzureRmContext, AzureCredential
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Force

ユーザーに確認せずに、直ちにコマンドを実行します。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ForceDeletionType

強制的に削除するリソースの種類。現在、サポートされているのは forceDeletionTypes=Microsoft.Compute/virtualMachines、Microsoft.Compute/virtualMachineScaleSets のみです。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Id

削除するリソース グループの ID を指定します。 ワイルドカード文字は使用できません。

型:String
Aliases:ResourceGroupId, ResourceId
配置:Named
規定値: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

入力

String

出力

Boolean