Remove-AzureRmResourceGroup

Referentie

Module:: AzureRM.Resources

Hiermee verwijdert u een resourcegroep.

Belangrijk

Omdat Az PowerShell-modules nu alle mogelijkheden van AzureRM PowerShell-modules en meer hebben, wordt AzureRM PowerShell-modules op 29 februari 2024 buiten gebruik gesteld.

Als u serviceonderbrekingen wilt voorkomen, werkt u uw scripts bij die gebruikmaken van AzureRM PowerShell-modules voor het gebruik van Az PowerShell-modules op 29 februari 2024. Volg de snelstartgids om uw scripts automatisch bij te werken.

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 verwijdert u een Azure-resourcegroep en de bijbehorende resources uit het huidige abonnement. 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 verwijdert u de ContosoRG01-resourcegroep uit het abonnement. 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 Get-AzureRmResourceGroup-cmdlet gebruikt om de resourcegroep ContosoRG01 op te halen en deze vervolgens 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
Accept pipeline input:	False
Accept wildcard characters:	False

-AsJob

Cmdlet op de achtergrond uitvoeren

Type:	SwitchParameter
Position:	Named
Default value:	None
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
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
Accept pipeline input:	False
Accept wildcard characters:	False

-Force

Hiermee dwingt u de opdracht uit te voeren zonder om bevestiging van de gebruiker te vragen.

Type:	SwitchParameter
Position:	Named
Default value:	None
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
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
Accept pipeline input:	True
Accept wildcard characters:	False

-Pre

Hiermee wordt aangegeven dat deze cmdlet API-versies van de voorlopige versie als automatisch bepaalt welke versie moet worden gebruikt.

Type:	SwitchParameter
Position:	Named
Default value:	None
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
Accept pipeline input:	False
Accept wildcard characters:	False