Freigeben über

Remove-AzResourceGroup

  • Referenz
Modul:
Az.Resources

Entfernt eine Ressourcengruppe.

Syntax

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

Beschreibung

Das Cmdlet Remove-AzResourceGroup entfernt eine Azure-Ressourcengruppe und die zugehörigen Ressourcen aus dem aktuellen Abonnement. Wenn Sie eine Ressource löschen möchten, die Ressourcengruppe aber verlassen möchten, 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.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-AsJob

Cmdlet im Hintergrund ausführen

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DefaultProfile

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

Typ:IAzureContextContainer
Aliase:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Force

Erzwingt die Ausführung des Befehls ohne Aufforderung zur Bestätigung durch den Benutzer.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Id

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

Typ:String
Aliase:ResourceGroupId, ResourceId
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Name

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

Typ:String
Aliase:ResourceGroupName
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Pre

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

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-WhatIf

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

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

String

Ausgaben

Boolean