Remove-AzureRmResourceGroup

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

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

重要

Az PowerShell モジュール で AzureRM PowerShell モジュールのすべての機能およびその他を利用できるようになったため、2024 年 2 月 29 日に AzureRM PowerShell モジュールは廃止になります。

サービスの中断を回避するために、2024 年 2 月 29 日までに、AzureRM PowerShell モジュールを使用するスクリプトを更新して、Az PowerShell モジュールを使用するようにしてください。 スクリプトを自動的に更新するには、 クイックスタート ガイドに従ってください。

構文

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 バージョンを指定します。 既定のバージョンとは異なるバージョンを指定できます。

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-AsJob

バックグラウンドでコマンドレットを実行する

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Confirm

コマンドレットの実行前に確認を求めるメッセージが表示されます。

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False
-DefaultProfile

Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション

Type:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Force

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

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Id

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

Type:String
Aliases:ResourceGroupId, ResourceId
Position:0
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-Name

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

Type:String
Aliases:ResourceGroupName
Position:0
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-Pre

このコマンドレットで、使用するバージョンが自動的に決定されるときに、プレリリース API のバージョンが考慮されることを示します。

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-WhatIf

コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False