Freigeben über

Remove-AzResourceGroup

Modul:
Az.Resources Module

Entfernt eine Ressourcengruppe.

Syntax

RemoveByResourceGroupName (Standard) 

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

Beschreibung

Das Cmdlet Remove-AzResourceGroup entfernt eine Azure-Ressourcengruppe und die zugehörigen Ressourcen aus dem aktuellen Abonnement. Um eine Ressource zu löschen, aber die Ressourcengruppe zu verlassen, verwenden Sie das cmdlet Remove-AzResource.

Beispiele

Beispiel 1: Entfernen einer Ressourcengruppe

Remove-AzResourceGroup -Name "ContosoRG01"

Mit diesem Befehl wird die ContosoRG01-Ressourcengruppe aus dem Abonnement entfernt. Das Cmdlet fordert Sie zur Bestätigung auf und gibt keine Ausgabe zurück.

Beispiel 2: Entfernen einer Ressourcengruppe ohne Bestätigung

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

Dieser Befehl verwendet das Cmdlet Get-AzResourceGroup, um die Ressourcengruppe ContosoRG01 abzurufen, und übergibt ihn dann mithilfe des Pipelineoperators an Remove-AzResourceGroup . Der Parameter Force unterdrückt die Bestätigungsaufforderung.

Beispiel 3: Entfernen aller Ressourcengruppen

Get-AzResourceGroup | Remove-AzResourceGroup

Dieser Befehl verwendet das Cmdlet "Get-AzResourceGroup ", um alle Ressourcengruppen abzurufen, und übergibt sie dann mithilfe des Pipelineoperators an Remove-AzResourceGroup .

Beispiel 4: Entfernen einer Ressourcengruppen verwenden ForceDeletionType

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

Mit diesem Befehl wird die ContosoRG01-Ressourcengruppe "ForceDeletionType" entfernt. Das Cmdlet fordert Sie zur Bestätigung auf und gibt keine Ausgabe zurück.

Parameter

-ApiVersion

Gibt die API-Version an, die vom Ressourcenanbieter unterstützt wird. Sie können eine andere Version als die Standardversion angeben.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-AsJob

Cmdlet im Hintergrund ausführen

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Confirm

Fordert Sie zur Bestätigung auf, bevor Sie das Cmdlet ausführen.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:False
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:vgl

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-DefaultProfile

Anmeldeinformationen, Konto, Mandant und Abonnement für die Kommunikation mit Azure

Parametereigenschaften

Typ:IAzureContextContainer
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:AzContext, AzureRmContext, AzureCredential

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Force

Erzwingt die Ausführung des Befehls, ohne eine Benutzerbestätigung zu verlangen.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ForceDeletionType

Die Ressourcentypen, die Sie zum Löschen erzwingen möchten. Derzeit wird nur Folgendes unterstützt: forceDeletionTypes=Microsoft.Compute/virtualMachines,Microsoft.Compute/virtualMachineScaleSets

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Id

Gibt die ID der zu entfernenden Ressourcengruppe an. Wildcardzeichen sind nicht zulässig.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:ResourceGroupId (ResourceGroupId), RessourcenID

Parametersätze

RemoveByResourceGroupId
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-Name

Gibt die Namen der zu entfernenden Ressourcengruppen an. Wildcardzeichen sind nicht zulässig.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Ressourcengruppenname

Parametersätze

RemoveByResourceGroupName
Position:0
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-Pre

Gibt an, dass dieses Cmdlet vorab veröffentlichte API-Versionen berücksichtigt, wenn es automatisch bestimmt, welche Version verwendet werden soll.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-WhatIf

Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:False
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Wi

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Eingaben

String

Ausgaben

Boolean