Remove-AzResourceGroup

  • Reference
Modul:
Az.Resources

Odebere skupinu prostředků.

Syntaxe

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

Rutina Remove-AzResourceGroup odebere skupinu prostředků Azure a její prostředky z aktuálního předplatného. Pokud chcete odstranit prostředek, ale skupinu prostředků ponechte, použijte rutinu Remove-AzResource.

Příklady

Příklad 1: Odebrání skupiny prostředků

Remove-AzResourceGroup -Name "ContosoRG01"

Tento příkaz odebere skupinu prostředků ContosoRG01 z předplatného. Rutina vás vyzve k potvrzení a nevrátí žádný výstup.

Příklad 2: Odebrání skupiny prostředků bez potvrzení

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

Tento příkaz pomocí rutiny Get-AzResourceGroup získá skupinu prostředků ContosoRG01 a pak ji předá rutině Remove-AzResourceGroup pomocí operátoru kanálu. Parametr Force potlačí výzvu k potvrzení.

Příklad 3: Odebrání všech skupin prostředků

Get-AzResourceGroup | Remove-AzResourceGroup

Tento příkaz pomocí rutiny Get-AzResourceGroup získá všechny skupiny prostředků a pak je předá rutině Remove-AzResourceGroup pomocí operátoru kanálu.

Příklad 4: Odebrání skupin prostředků pomocí ForceDeletionType

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

Tento příkaz odebere skupinu prostředků ContosoRG01 pomocí forceDeletionType. Rutina vás vyzve k potvrzení a nevrátí žádný výstup.

Parametry

-ApiVersion

Určuje verzi rozhraní API podporovanou poskytovatelem prostředků. Můžete zadat jinou verzi, než je výchozí verze.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-AsJob

Spuštění rutiny na pozadí

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-DefaultProfile

Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure

Typ:IAzureContextContainer
Aliasy:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Force

Vynutí spuštění příkazu bez výzvy k potvrzení uživatele.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ForceDeletionType

Typy prostředků, které chcete vynutit odstranění. V současné době se podporuje pouze následující: forceDeletionTypes=Microsoft.Compute/virtualMachines,Microsoft.Compute/virtualMachineScaleSets

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Id

Určuje ID skupiny prostředků, která se má odebrat. Zástupné znaky nejsou povoleny.

Typ:String
Aliasy:ResourceGroupId, ResourceId
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Name

Určuje názvy skupin prostředků, které se mají odebrat. Zástupné znaky nejsou povoleny.

Typ:String
Aliasy:ResourceGroupName
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Pre

Označuje, že tato rutina bere v úvahu předběžné verze rozhraní API, když automaticky určí, kterou verzi použít.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Vstupy

String

Výstupy

Boolean