共用方式為


Remove-AzResourceGroup

移除資源群組。

語法

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>]

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

範例 4:移除資源群組使用 ForceDeletionType

Remove-AzResourceGroup -Name "ContosoRG01" -ForceDeletionType "Microsoft.Compute/virtualMachineScaleSets,Microsoft.Compute/virtualMachines,Microsoft.Databricks/workspaces"

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

參數

-ApiVersion

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

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-AsJob

在背景執行 Cmdlet

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Confirm

執行 Cmdlet 之前先提示您確認。

類型:SwitchParameter
別名:cf
Position:Named
預設值:False
必要:False
接受管線輸入:False
接受萬用字元:False

-DefaultProfile

用於與 azure 通訊的認證、帳戶、租用戶和訂用帳戶

類型:IAzureContextContainer
別名:AzContext, AzureRmContext, AzureCredential
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Force

強制命令執行,而不要求使用者確認。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-ForceDeletionType

您要強制刪除的資源類型。目前僅支援下列專案:forceDeletionTypes=Microsoft.Compute/virtualMachines,Microsoft.Compute/virtualMachineScaleSets

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Id

指定要移除的資源群組識別碼。 不允許通配符。

類型:String
別名:ResourceGroupId, ResourceId
Position:Named
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-Name

指定要移除的資源群組名稱。 不允許通配符。

類型:String
別名:ResourceGroupName
Position:0
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-Pre

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

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-WhatIf

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

類型:SwitchParameter
別名:wi
Position:Named
預設值:False
必要:False
接受管線輸入:False
接受萬用字元:False

輸入

String

輸出

Boolean