Remove-AzResourceGroup
語法
RemoveByResourceGroupName (預設值)
Remove-AzResourceGroup
[-Name] <String>
[-ForceDeletionType <String>]
[-Force]
[-AsJob]
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
RemoveByResourceGroupId
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-AzResourceGroup 。 「 力」 參數會隱藏確認提示。
範例 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
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-AsJob
在背景執行 Cmdlet
參數屬性
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Confirm
在執行 Cmdlet 之前,提示您進行確認。
參數屬性
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-DefaultProfile
用來與 Azure 通訊的認證、帳戶、租用戶和訂用帳戶
參數屬性
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Force
強制命令執行,而不要求使用者確認。
參數屬性
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ForceDeletionType
您要強制刪除的資源類型。目前僅支援下列專案:forceDeletionTypes=Microsoft.Compute/virtualMachines,Microsoft.Compute/virtualMachineScaleSets
參數屬性
| 類型: | String
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Id
指定要移除的資源群組識別碼。
不允許使用萬用字元。
參數屬性
| 類型: | String
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | 資源群組標識符, 資源識別碼 (ResourceId) |
參數集
RemoveByResourceGroupId
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-Name
指定要移除的資源群組名稱。
不允許使用萬用字元。
參數屬性
| 類型: | String
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | ResourceGroupName |
參數集
RemoveByResourceGroupName
| Position: | 0 |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-Pre
指出此 Cmdlet 在自動決定要使用的版本時,會考慮發行前 API 版本。
參數屬性
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-WhatIf
顯示 Cmdlet 執行時會發生什麼事。
指令未執行。
參數屬性
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
CommonParameters
此 cmdlet 支援常見參數:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊,請參閱 about_CommonParameters。
輸出