Remove-AzureRmResourceGroup
移除資源群組。
警告
自 2024 年 2 月 29 日起,AzureRM PowerShell 模組已正式淘汰。 建議使用者從 AzureRM 遷移至 Az PowerShell 模組,以確保持續支援和更新。
雖然 AzureRM 模組可能仍可運作,但不再維護或支援它,但會根據用戶的判斷權和風險放置任何繼續使用。 如需轉換至 Az 模組的指引,請參閱我們的 移轉資源 。
語法
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-AzureRmResourceGroup 。 Verbose 一般參數會取得作業的狀態資訊,而 Force 參數會隱藏確認提示。
範例 3:移除所有資源群組
PS C:\>Get-AzureRmResourceGroup | Remove-AzureRmResourceGroup
此命令會使用 Get-AzureRmResourceGroup Cmdlet 來取得所有資源群組,然後使用管線運算符將它們傳遞至 Remove-AzureRmResourceGroup 。
參數
-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 |
別名: | AzureRmContext, AzureCredential |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-Force
強制命令執行,而不要求使用者確認。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-Id
指定要移除的資源群組識別碼。 不允許通配符。
類型: | String |
別名: | ResourceGroupId, ResourceId |
Position: | 0 |
預設值: | 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 |