共用方式為


Remove-AzureRmResourceGroup

移除資源群組。

警告

自 2024 年 2 月 29 日起,AzureRM PowerShell 模組已正式淘汰。 建議使用者從 AzureRM 遷移至 Az PowerShell 模組,以確保持續支援和更新。

雖然 AzureRM 模組可能仍可運作,但不再維護或支援它,但會根據用戶的判斷權和風險放置任何繼續使用。 如需轉換至 Az 模組的指引,請參閱我們的 移轉資源

Syntax

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

Description

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

範例

範例 1:移除資源群組

PS C:\>Remove-AzureRmResourceGroup -Name "ContosoRG01"

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

範例 2:在不確認的情況下移除資源群組

PS C:\>Get-AzureRmResourceGroup -Name "ContosoRG01" | Remove-AzureRmResourceGroup -Verbose -Force

此命令會使用 Get-AzureRmResourceGroup Cmdlet 來取得資源群組 ContosoRG01,然後使用管線運算符將它 傳遞給 Remove-AzureRmResourceGroupVerbose 一般參數會取得作業的狀態資訊,而 Force 參數會隱藏確認提示。

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

PS C:\>Get-AzureRmResourceGroup | Remove-AzureRmResourceGroup

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

參數

-ApiVersion

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

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

-AsJob

在背景執行 Cmdlet

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

-Confirm

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

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

-DefaultProfile

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

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

-Force

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

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

-Id

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

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

-Name

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

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

-Pre

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

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

-WhatIf

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

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