Freigeben über


Remove-AzureRmResourceGroup

Entfernt eine Ressourcengruppe.

Warnung

Das AzureRM PowerShell-Modul ist seit dem 29. Februar 2024 offiziell veraltet. Benutzern wird empfohlen, von AzureRM zum Az PowerShell-Modul zu migrieren, um weiterhin Support und Updates zu erhalten.

Obwohl das AzureRM-Modul weiterhin funktioniert, wird es nicht mehr Standard tained oder unterstützt, wobei eine fortgesetzte Verwendung nach Ermessen und Risiko des Benutzers erfolgt. Weitere Informationen zum Übergang zum Az-Modul finden Sie in unseren Migrationsressourcen.

Syntax

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

Beschreibung

Das Cmdlet Remove-AzureRmResourceGroup entfernt eine Azure-Ressourcengruppe und die zugehörigen Ressourcen aus dem aktuellen Abonnement. Verwenden Sie das Cmdlet Remove-AzureRmResource, um eine Ressource zu löschen, aber die Ressourcengruppe verlassen.

Beispiele

Beispiel 1: Entfernen einer Ressourcengruppe

PS C:\>Remove-AzureRmResourceGroup -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

PS C:\>Get-AzureRmResourceGroup -Name "ContosoRG01" | Remove-AzureRmResourceGroup -Verbose -Force

Dieser Befehl verwendet das Cmdlet "Get-AzureRmResourceGroup" zum Abrufen der Ressourcengruppe "ContosoRG01" und übergibt ihn dann mithilfe des Pipelineoperators an Remove-AzureRmResourceGroup . Der ausführliche allgemeine Parameter ruft Statusinformationen zum Vorgang ab, und der Parameter Force unterdrückt die Bestätigungsaufforderung.

Beispiel 3: Entfernen aller Ressourcengruppen

PS C:\>Get-AzureRmResourceGroup | Remove-AzureRmResourceGroup

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

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

-Id

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

Typ:String
Aliase:ResourceGroupId, ResourceId
Position:0
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