Udostępnij za pośrednictwem


Remove-AzResourceGroup

Usuwa grupę zasobów.

Składnia

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

Opis

Polecenie cmdlet Remove-AzResourceGroup usuwa grupę zasobów platformy Azure i jej zasoby z bieżącej subskrypcji. Aby usunąć zasób, ale pozostaw grupę zasobów, użyj polecenia cmdlet Remove-AzResource.

Przykłady

Przykład 1. Usuwanie grupy zasobów

Remove-AzResourceGroup -Name "ContosoRG01"

To polecenie usuwa grupę zasobów ContosoRG01 z subskrypcji. Polecenie cmdlet wyświetla monit o potwierdzenie i nie zwraca żadnych danych wyjściowych.

Przykład 2. Usuwanie grupy zasobów bez potwierdzenia

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

To polecenie używa polecenia cmdlet Get-AzResourceGroup, aby uzyskać grupę zasobów ContosoRG01, a następnie przekazuje ją do Remove-AzResourceGroup przy użyciu operatora potoku. Parametr Force pomija monit o potwierdzenie.

Przykład 3. Usuwanie wszystkich grup zasobów

Get-AzResourceGroup | Remove-AzResourceGroup

To polecenie używa polecenia cmdlet Get-AzResourceGroup, aby pobrać wszystkie grupy zasobów, a następnie przekazuje je do Remove-AzResourceGroup za pomocą operatora potoku.

Przykład 4. Usuwanie grup zasobów przy użyciu elementu ForceDeletionType

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

To polecenie usuwa grupę zasobów ContosoRG01 przy użyciu właściwości ForceDeletionType. Polecenie cmdlet wyświetla monit o potwierdzenie i nie zwraca żadnych danych wyjściowych.

Parametry

-ApiVersion

Określa wersję interfejsu API obsługiwaną przez dostawcę zasobów. Możesz określić inną wersję niż domyślna.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-AsJob

Uruchamianie polecenia cmdlet w tle

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-DefaultProfile

Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure

Typ:IAzureContextContainer
Aliasy:AzContext, AzureRmContext, AzureCredential
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Force

Wymusza uruchomienie polecenia bez monitowania o potwierdzenie użytkownika.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ForceDeletionType

Typy zasobów, które chcesz wymusić usunięcie. Obecnie obsługiwane są tylko następujące elementy: forceDeletionTypes=Microsoft.Compute/virtualMachines,Microsoft.Compute/virtualMachineScaleSets

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Id

Określa identyfikator grupy zasobów do usunięcia. Symbole wieloznaczne nie są dozwolone.

Typ:String
Aliasy:ResourceGroupId, ResourceId
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Name

Określa nazwy grup zasobów do usunięcia. Symbole wieloznaczne nie są dozwolone.

Typ:String
Aliasy:ResourceGroupName
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Pre

Wskazuje, że to polecenie cmdlet uwzględnia wersje interfejsu API wersji wstępnej, gdy automatycznie określa wersję do użycia.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-WhatIf

Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Polecenie cmdlet nie jest uruchamiane.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

String

Dane wyjściowe

Boolean