Remove-AzResourceGroup
Syntax
RemoveByResourceGroupName (Standard)
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
Cmdleten Remove-AzResourceGroup tar bort en Azure resursgrupp och dess resurser från den aktuella prenumerationen.
Om du vill ta bort en resurs, men lämna resursgruppen, använder du cmdleten Remove-AzResource.
Exempel
Exempel 1: Ta bort en resursgrupp
Remove-AzResourceGroup -Name "ContosoRG01"
Det här kommandot tar bort resursgruppen ContosoRG01 från prenumerationen.
Cmdleten uppmanar dig att bekräfta och returnerar inga utdata.
Exempel 2: Ta bort en resursgrupp utan bekräftelse
Get-AzResourceGroup -Name "ContosoRG01" | Remove-AzResourceGroup -Force
Det här kommandot använder cmdleten Get-AzResourceGroup för att hämta resursgruppen ContosoRG01 och skickar den sedan till Remove-AzResourceGroup med hjälp av pipelineoperatorn. Parametern Force undertrycker bekräftelseprompten.
Exempel 3: Ta bort alla resursgrupper
Get-AzResourceGroup | Remove-AzResourceGroup
Det här kommandot använder cmdleten Get-AzResourceGroup för att hämta alla resursgrupper och skickar dem sedan till Remove-AzResourceGroup med hjälp av pipelineoperatorn.
Exempel 4: Ta bort en resursgrupp med ForceDeletionType
Remove-AzResourceGroup -Name "ContosoRG01" -ForceDeletionType "Microsoft.Compute/virtualMachineScaleSets,Microsoft.Compute/virtualMachines,Microsoft.Databricks/workspaces"
Det här kommandot tar bort resursgruppen ContosoRG01 med hjälp av ForceDeletionType.
Cmdleten uppmanar dig att bekräfta och returnerar inga utdata.
Parametrar
-ApiVersion
Anger den API-version som stöds av resursprovidern.
Du kan ange en annan version än standardversionen.
Parameteregenskaper
Typ: String
Standardvärde: None Stöder jokertecken: False DontShow: False
Parameteruppsättningar
(All)
Position: Named Obligatorisk: False Värde från pipeline: False Värde från pipeline efter egenskapsnamn: False Värde från återstående argument: False
-AsJob
Kör cmdlet i bakgrunden
Parameteregenskaper
Typ: SwitchParameter
Standardvärde: None Stöder jokertecken: False DontShow: False
Parameteruppsättningar
(All)
Position: Named Obligatorisk: False Värde från pipeline: False Värde från pipeline efter egenskapsnamn: False Värde från återstående argument: False
-Confirm
Uppmanar dig att bekräfta innan du kör cmdleten.
Parameteregenskaper
Typ: SwitchParameter
Standardvärde: False Stöder jokertecken: False DontShow: False Alias: jfr
Parameteruppsättningar
(All)
Position: Named Obligatorisk: False Värde från pipeline: False Värde från pipeline efter egenskapsnamn: False Värde från återstående argument: False
-DefaultProfile
Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure
Parameteregenskaper
Typ: IAzureContextContainer
Standardvärde: None Stöder jokertecken: False DontShow: False Alias: AzContext, AzureRmContext, AzureCredential
Parameteruppsättningar
(All)
Position: Named Obligatorisk: False Värde från pipeline: False Värde från pipeline efter egenskapsnamn: False Värde från återstående argument: False
-Force
Tvingar kommandot att köras utan att be om användarbekräftelse.
Parameteregenskaper
Typ: SwitchParameter
Standardvärde: None Stöder jokertecken: False DontShow: False
Parameteruppsättningar
(All)
Position: Named Obligatorisk: False Värde från pipeline: False Värde från pipeline efter egenskapsnamn: False Värde från återstående argument: False
-ForceDeletionType
De resurstyper som du vill framtvinga borttagning. För närvarande stöds endast följande: forceDeletionTypes=Microsoft.Compute/virtualMachines,Microsoft.Compute/virtualMachineScaleSets
Parameteregenskaper
Typ: String
Standardvärde: None Stöder jokertecken: False DontShow: False
Parameteruppsättningar
(All)
Position: Named Obligatorisk: False Värde från pipeline: False Värde från pipeline efter egenskapsnamn: False Värde från återstående argument: False
-Id
Anger ID för resursgruppen som ska tas bort.
Jokertecken tillåts inte.
Parameteregenskaper
Typ: String
Standardvärde: None Stöder jokertecken: False DontShow: False Alias: ResursgruppId, ResourceId
Parameteruppsättningar
RemoveByResourceGroupId
Position: Named Obligatorisk: True Värde från pipeline: False Värde från pipeline efter egenskapsnamn: True Värde från återstående argument: False
-Name
Anger namnen på resursgrupper som ska tas bort.
Jokertecken tillåts inte.
Parameteregenskaper
Typ: String
Standardvärde: None Stöder jokertecken: False DontShow: False Alias: ResourceGroupName
Parameteruppsättningar
RemoveByResourceGroupName
Position: 0 Obligatorisk: True Värde från pipeline: False Värde från pipeline efter egenskapsnamn: True Värde från återstående argument: False
-Pre
Anger att den här cmdleten tar hänsyn till förhandsversioner av API:et när den automatiskt avgör vilken version som ska användas.
Parameteregenskaper
Typ: SwitchParameter
Standardvärde: None Stöder jokertecken: False DontShow: False
Parameteruppsättningar
(All)
Position: Named Obligatorisk: False Värde från pipeline: False Värde från pipeline efter egenskapsnamn: False Värde från återstående argument: False
-WhatIf
Visar vad som skulle hända om kommandot körs.
Cmdleten körs inte.
Parameteregenskaper
Typ: SwitchParameter
Standardvärde: False Stöder jokertecken: False DontShow: False Alias: Wi
Parameteruppsättningar
(All)
Position: Named Obligatorisk: False Värde från pipeline: False Värde från pipeline efter egenskapsnamn: False Värde från återstående argument: False
CommonParameters
Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.
Utdata