Freigeben über

Remove-AzureRmResourceGroup

  • Referenz
Modul:
AzureRM.Resources

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 möglicherweise weiterhin funktioniert, wird es nicht mehr gewartet, und es wird kein Support mehr angeboten. Die weitere Nutzung erfolgt daher nach Ermessen und Risiko des Benutzers. 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