Remove-AzureRmResourceGroup

Referentie

Module:: AzureRM.Resources

Hiermee verwijdert u een resourcegroep.

Waarschuwing

De AzureRM PowerShell-module is vanaf 29 februari 2024 officieel afgeschaft. Gebruikers wordt aangeraden om van AzureRM naar de Az PowerShell-module te migreren om ondersteuning en updates te garanderen.

Hoewel de AzureRM-module nog steeds kan functioneren, wordt deze niet meer onderhouden of ondersteund, waardoor het gebruik naar eigen goeddunken en risico van de gebruiker blijft bestaan. Raadpleeg onze migratiebronnen voor hulp bij de overgang naar de Az-module.

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

Description

Met de cmdlet Remove-AzureRmResourceGroup worden een Azure-resourcegroep en de bijbehorende resources uit het huidige abonnement verwijderd. Als u een resource wilt verwijderen, maar de resourcegroep wilt verlaten, gebruikt u de cmdlet Remove-AzureRmResource.

Voorbeelden

Voorbeeld 1: Een resourcegroep verwijderen

PS C:\>Remove-AzureRmResourceGroup -Name "ContosoRG01"

Met deze opdracht wordt de resourcegroep ContosoRG01 uit het abonnement verwijderd. De cmdlet vraagt u om bevestiging en retourneert geen uitvoer.

Voorbeeld 2: Een resourcegroep verwijderen zonder bevestiging

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

Met deze opdracht wordt de cmdlet Get-AzureRmResourceGroup gebruikt om de resourcegroep ContosoRG01 op te halen en door te geven aan Remove-AzureRmResourceGroup met behulp van de pijplijnoperator. De uitgebreide algemene parameter krijgt statusinformatie over de bewerking en de parameter Force onderdrukt de bevestigingsprompt.

Voorbeeld 3: Alle resourcegroepen verwijderen

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

Met deze opdracht wordt de cmdlet Get-AzureRmResourceGroup gebruikt om alle resourcegroepen op te halen en deze vervolgens door te geven aan Remove-AzureRmResourceGroup met behulp van de pijplijnoperator.

Parameters

-ApiVersion

Hiermee geeft u de API-versie op die wordt ondersteund door de resourceprovider. U kunt een andere versie opgeven dan de standaardversie.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AsJob

Cmdlet op de achtergrond uitvoeren

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

De referenties, het account, de tenant en het abonnement dat wordt gebruikt voor communicatie met Azure

Type:	IAzureContextContainer
Aliases:	AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Force

Hiermee dwingt u de opdracht uit te voeren zonder dat u om bevestiging van de gebruiker wordt gevraagd.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Id

Hiermee geeft u de id van de resourcegroep die moet worden verwijderd. Jokertekens zijn niet toegestaan.

Type:	String
Aliases:	ResourceGroupId, ResourceId
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Name

Hiermee geeft u de namen van resourcegroepen die moeten worden verwijderd. Jokertekens zijn niet toegestaan.

Type:	String
Aliases:	ResourceGroupName
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Pre

Hiermee wordt aangegeven dat deze cmdlet api-versies van de voorlopige versie beschouwt wanneer deze automatisch bepaalt welke versie moet worden gebruikt.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False