Udostępnij za pośrednictwem

Remove-AzureRmResourceGroup

  • Odwołanie
Moduł:
AzureRM.Resources

Usuwa grupę zasobów.

Ostrzeżenie

Moduł AzureRM PowerShell jest oficjalnie przestarzały od 29 lutego 2024 r. Zaleca się migrowanie użytkowników z modułu AzureRM do modułu Az programu PowerShell w celu zapewnienia ciągłej obsługi i aktualizacji.

Mimo że moduł AzureRM może nadal działać, nie jest już utrzymywany ani obsługiwany, umieszczając wszelkie dalsze zastosowania według uznania i ryzyka użytkownika. Zapoznaj się z naszymi zasobami migracji, aby uzyskać wskazówki dotyczące przejścia do modułu Az.

Składnia

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>]

Opis

Polecenie cmdlet Remove-AzureRmResourceGroup 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-AzureRmResource.

Przykłady

Przykład 1. Usuwanie grupy zasobów

PS C:\>Remove-AzureRmResourceGroup -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

PS C:\>Get-AzureRmResourceGroup -Name "ContosoRG01" | Remove-AzureRmResourceGroup -Verbose -Force

To polecenie używa polecenia cmdlet Get-AzureRmResourceGroup, aby pobrać grupę zasobów ContosoRG01, a następnie przekazuje ją do polecenia Remove-AzureRmResourceGroup przy użyciu operatora potoku. Pełny wspólny parametr pobiera informacje o stanie operacji, a parametr Force pomija monit o potwierdzenie.

Przykład 3. Usuwanie wszystkich grup zasobów

PS C:\>Get-AzureRmResourceGroup | Remove-AzureRmResourceGroup

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

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: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

-Id

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

Typ:String
Aliasy:ResourceGroupId, ResourceId
Position:0
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 po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.

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