Remove-AzResourceGroup

移除資源群組。

Syntax

Remove-AzResourceGroup
      [-Name] <String>
      [-Force]
      [-AsJob]
      [-ApiVersion <String>]
      [-Pre]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzResourceGroup
      -Id <String>
      [-Force]
      [-AsJob]
      [-ApiVersion <String>]
      [-Pre]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Remove-AzResourceGroup Cmdlet 會從目前的訂用帳戶中移除 Azure 資源群組及其資源。 若要刪除資源,但離開資源群組,請使用 Remove-AzResource Cmdlet。

範例

範例 1:移除資源群組

Remove-AzResourceGroup -Name "ContosoRG01"

此命令會從訂用帳戶中移除 ContosoRG01 資源群組。 此 Cmdlet 會提示您確認,並且不會傳回任何輸出。

範例 2:移除資源群組而不確認

Get-AzResourceGroup -Name "ContosoRG01" | Remove-AzResourceGroup -Force

此命令會使用 Get-AzResourceGroup Cmdlet 來取得資源群組 ContosoRG01,然後使用管線運算子將它傳遞至 Remove-AzResourceGroupForce參數會隱藏確認提示。

範例 3:移除所有資源群組

Get-AzResourceGroup | Remove-AzResourceGroup

此命令會使用 Get-AzResourceGroup Cmdlet 來取得所有資源群組,然後使用管線運算子將它們傳遞至 Remove-AzResourceGroup

參數

-ApiVersion

指定資源提供者所支援的 API 版本。 您可以指定與預設版本不同的版本。

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

-AsJob

在背景中執行 Cmdlet

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

-Confirm

在執行 Cmdlet 前提示您確認。

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

-DefaultProfile

用來與 azure 通訊的認證、帳戶、租使用者和訂用帳戶

Type:IAzureContextContainer
Aliases:AzContext, 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

指定要移除的資源群組識別碼。 不允許使用萬用字元。

Type:String
Aliases:ResourceGroupId, ResourceId
Position:Named
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

指出當此 Cmdlet 自動判斷要使用的版本時,此 Cmdlet 會考慮發行前版本的 API 版本。

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

-WhatIf

顯示執行 Cmdlet 後會發生的情況。 Cmdlet 並不會執行。

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

輸入

String

輸出

Boolean