Delen via

Remove-AzResourceGroup

Module:
Az.Resources Module

Hiermee verwijdert u een resourcegroep.

Syntaxis

RemoveByResourceGroupName (Standaard) 

Remove-AzResourceGroup
    [-Name] <String>
    [-ForceDeletionType <String>]
    [-Force]
    [-AsJob]
    [-ApiVersion <String>]
    [-Pre]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

RemoveByResourceGroupId 

Remove-AzResourceGroup
    -Id <String>
    [-ForceDeletionType <String>]
    [-Force]
    [-AsJob]
    [-ApiVersion <String>]
    [-Pre]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Met de cmdlet Remove-AzResourceGroup 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 Remove-AzResource-cmdlet.

Voorbeelden

Voorbeeld 1: Een resourcegroep verwijderen

Remove-AzResourceGroup -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

Get-AzResourceGroup -Name "ContosoRG01" | Remove-AzResourceGroup -Force

Met deze opdracht wordt de Get-AzResourceGroup-cmdlet gebruikt om de resourcegroep ContosoRG01 op te halen en deze vervolgens door te geven aan Remove-AzResourceGroup met behulp van de pijplijnoperator. De parameter Force onderdrukt de bevestigingsprompt.

Voorbeeld 3: Alle resourcegroepen verwijderen

Get-AzResourceGroup | Remove-AzResourceGroup

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

Voorbeeld 4: Een resourcegroep verwijderen met ForceDeletionType

Remove-AzResourceGroup -Name "ContosoRG01" -ForceDeletionType "Microsoft.Compute/virtualMachineScaleSets,Microsoft.Compute/virtualMachines,Microsoft.Databricks/workspaces"

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

Parameters

-ApiVersion

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

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-AsJob

Cmdlet op de achtergrond uitvoeren

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Confirm

Voordat u de cmdlet uitvoert, vraagt het systeem om bevestiging.

Parametereigenschappen

Type:SwitchParameter
Default value:False
Ondersteunt jokertekens:False
DontShow:False
Aliassen:Cf

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-DefaultProfile

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

Parametereigenschappen

Type:IAzureContextContainer
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:AzContext, AzureRmContext, AzureCredential

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Force

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

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-ForceDeletionType

De resourcetypen die u wilt afdwingen verwijderen. Momenteel wordt alleen het volgende ondersteund: forceDeletionTypes=Microsoft.Compute/virtualMachines,Microsoft.Compute/virtualMachineScaleSets

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Id

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

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:ResourceGroupId, ResourceId

Parametersets

RemoveByResourceGroupId
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-Name

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

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:ResourceGroupName

Parametersets

RemoveByResourceGroupName
Position:0
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-Pre

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

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-WhatIf

Toont wat er zou gebeuren wanneer de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

Parametereigenschappen

Type:SwitchParameter
Default value:False
Ondersteunt jokertekens:False
DontShow:False
Aliassen:Wi

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

CommonParameters

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

Invoerwaarden

String

Uitvoerwaarden

Boolean