Sdílet prostřednictvím

Remove-AzureRmResourceGroup

  • Reference
Modul:
AzureRM.Resources

Odebere skupinu prostředků.

Upozorňující

Modul AzureRM PowerShell je od 29. února 2024 oficiálně zastaralý. Uživatelům se doporučuje migrovat z AzureRM do modulu Az PowerShell, aby se zajistila nepřetržitá podpora a aktualizace.

I když může modul AzureRM stále fungovat, už se neudržuje ani nepodporuje, přičemž jakékoli další použití se bude umisťovat podle vlastního uvážení a rizika uživatele. Pokyny k přechodu na modul Az najdete v našich zdrojích informací o migraci.

Syntaxe

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

Description

Rutina Remove-AzureRmResourceGroup odebere skupinu prostředků Azure a její prostředky z aktuálního předplatného. Pokud chcete odstranit prostředek, ale opustit skupinu prostředků, použijte rutinu Remove-AzureRmResource.

Příklady

Příklad 1: Odebrání skupiny prostředků

PS C:\>Remove-AzureRmResourceGroup -Name "ContosoRG01"

Tento příkaz odebere skupinu prostředků ContosoRG01 z předplatného. Rutina vás vyzve k potvrzení a nevrátí žádný výstup.

Příklad 2: Odebrání skupiny prostředků bez potvrzení

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

Tento příkaz pomocí rutiny Get-AzureRmResourceGroup získá skupinu prostředků ContosoRG01 a pak ji předá rutině Remove-AzureRmResourceGroup pomocí operátoru kanálu. Podrobný běžný parametr získá informace o stavu operace a parametr Force potlačí výzvu k potvrzení.

Příklad 3: Odebrání všech skupin prostředků

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

Tento příkaz pomocí rutiny Get-AzureRmResourceGroup získá všechny skupiny prostředků a pak je předá rutině Remove-AzureRmResourceGroup pomocí operátoru kanálu.

Parametry

-ApiVersion

Určuje verzi rozhraní API podporovanou poskytovatelem prostředků. Můžete zadat jinou verzi, než je výchozí verze.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-AsJob

Spuštění rutiny na pozadí

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-DefaultProfile

Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure

Typ:IAzureContextContainer
Aliasy:AzureRmContext, AzureCredential
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Force

Vynutí spuštění příkazu bez výzvy k potvrzení uživatele.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Id

Určuje ID skupiny prostředků, která se má odebrat. Zástupné znaky nejsou povoleny.

Typ:String
Aliasy:ResourceGroupId, ResourceId
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Name

Určuje názvy skupin prostředků, které se mají odebrat. Zástupné znaky nejsou povoleny.

Typ:String
Aliasy:ResourceGroupName
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Pre

Označuje, že tato rutina bere v úvahu předběžné verze rozhraní API, když automaticky určí, kterou verzi použít.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False