Partilhar via

Remove-AzResourceGroup

  • Referência
Módulo:
Az.Resources

Remove um grupo de recursos.

Sintaxe

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

Description

O cmdlet Remove-AzResourceGroup remove um grupo de recursos do Azure e seus recursos da assinatura atual. Para excluir um recurso, mas sair do grupo de recursos, use o cmdlet Remove-AzResource.

Exemplos

Exemplo 1: Remover um grupo de recursos

Remove-AzResourceGroup -Name "ContosoRG01"

Este comando remove o grupo de recursos ContosoRG01 da assinatura. O cmdlet solicita confirmação e não retorna nenhuma saída.

Exemplo 2: Remover um grupo de recursos sem confirmação

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

Este comando usa o cmdlet Get-AzResourceGroup para obter o grupo de recursos ContosoRG01 e o passa para Remove-AzResourceGroup usando o operador de pipeline. O parâmetro Force suprime o prompt de confirmação.

Exemplo 3: Remover todos os grupos de recursos

Get-AzResourceGroup | Remove-AzResourceGroup

Este comando usa o cmdlet Get-AzResourceGroup para obter todos os grupos de recursos e, em seguida, os passa para Remove-AzResourceGroup usando o operador de pipeline.

Parâmetros

-ApiVersion

Especifica a versão da API suportada pelo provedor de recursos. Você pode especificar uma versão diferente da versão padrão.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-AsJob

Executar cmdlet em segundo plano

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Confirm

Solicita a sua confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para comunicação com o azure

Tipo:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Force

Força o comando a ser executado sem pedir a confirmação do usuário.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Id

Especifica a ID do grupo de recursos a ser removido. Caracteres curinga não são permitidos.

Tipo:String
Aliases:ResourceGroupId, ResourceId
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-Name

Especifica os nomes dos grupos de recursos a serem removidos. Caracteres curinga não são permitidos.

Tipo:String
Aliases:ResourceGroupName
Position:0
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-Pre

Indica que esse cmdlet considera versões de API de pré-lançamento quando determina automaticamente qual versão usar.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-WhatIf

Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

Entradas

String

Saídas

Boolean