Compartilhar via


Remove-AzureRmResourceGroup

Remove um grupo de recursos.

Aviso

O módulo PowerShell do AzureRM foi oficialmente preterido a partir de 29 de fevereiro de 2024. Os usuários são aconselhados a migrar do AzureRM para o módulo do Az PowerShell para garantir o suporte e as atualizações contínuas.

Embora o módulo AzureRM ainda possa funcionar, ele não tem suporte ou será mantido, colocando qualquer uso contínuo a critério e risco do usuário. Consulte nossos recursos de migração para obter diretrizes sobre a transição para o módulo Az.

Sintaxe

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

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

Exemplos

Exemplo 1: Remover um grupo de recursos

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

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

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

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

Esse comando usa o cmdlet Get-AzureRmResourceGroup para obter o grupo de recursos ContosoRG01 e, em seguida, o passa para Remove-AzureRmResourceGroup usando o operador de pipeline. O parâmetro comum detalhado obtém informações de status sobre a operação e o parâmetro Force suprime o prompt de confirmação.

Exemplo 3: Remover todos os grupos de recursos

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

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

Parâmetros

-ApiVersion

Especifica a versão da API compatível com o provedor de recursos. Você pode especificar uma versão diferente da versão padrão.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-AsJob

Executar cmdlet em segundo plano

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Confirm

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

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DefaultProfile

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

Tipo:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Force

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

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Id

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

Tipo:String
Aliases:ResourceGroupId, ResourceId
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Name

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

Tipo:String
Aliases:ResourceGroupName
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Pre

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

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False