Remove-AzResourceGroup
Hiermee verwijdert u een resourcegroep.
Syntax
RemoveByResourceGroupName (Standaard)
Remove-AzResourceGroup
[-Name] <String>
[-ForceDeletionType <String>]
[-Force]
[-AsJob]
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[-AcquirePolicyToken]
[-ChangeReference <String>]
[<CommonParameters>]
RemoveByResourceGroupId
Remove-AzResourceGroup
-Id <String>
[-ForceDeletionType <String>]
[-Force]
[-AsJob]
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[-AcquirePolicyToken]
[-ChangeReference <String>]
[<CommonParameters>]
Description
De cmdlet Remove-AzResourceGroup verwijdert 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 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 Forceren 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
-AcquirePolicyToken
Een Azure Policy token automatisch verkrijgen voor deze resourcebewerking.
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
-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
-ChangeReference
De wijzigingsresource-id voor deze resourcebewerking.
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
-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. Op dit moment 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: Resourcegroep-ID, 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_CommonParameters voor meer informatie.
Uitvoerwaarden