Compartilhar via

Remove-AzResourceGroup

Módulo:
Az.Resources Module

Remove um grupo de recursos.

Sintaxe

RemoveByResourceGroupName (Padrão) 

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

RemoveByResourceGroupId 

Remove-AzResourceGroup
    -Id <String>
    [-ForceDeletionType <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 deixar o grupo de recursos, use o cmdlet Remove-AzResource.

Exemplos

Exemplo 1: remover um grupo de recursos

Remove-AzResourceGroup -Name "ContosoRG01"

Esse 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

Esse comando usa o cmdlet Get-AzResourceGroup para obter o grupo de recursos ContosoRG01 e, em seguida, passa-o 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

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

Exemplo 4: remover um grupo de recursos usa ForceDeletionType

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

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

Parâmetros

-ApiVersion

Especifica a versão da API com suporte do provedor de recursos. Você pode especificar uma versão diferente da versão padrão.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-AsJob

Executar cmdlet em segundo plano

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Confirm

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

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:False
Dá suporte a curingas:False
DontShow:False
Aliases:cf

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-DefaultProfile

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

Propriedades do parâmetro

Tipo:IAzureContextContainer
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:AzContext, AzureRmContext, AzureCredential

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Force

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

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ForceDeletionType

Os tipos de recurso que você deseja forçar a exclusão. Atualmente, há suporte apenas para o seguinte: forceDeletionTypes=Microsoft.Compute/virtualMachines,Microsoft.Compute/virtualMachineScaleSets

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Id

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

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:ResourceGroupId, ResourceId

Conjuntos de parâmetros

RemoveByResourceGroupId
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-Name

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

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:NomeDoGrupoDeRecursos

Conjuntos de parâmetros

RemoveByResourceGroupName
Cargo:0
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-Pre

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

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-WhatIf

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

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:False
Dá suporte a curingas:False
DontShow:False
Aliases:wi

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Entradas

String

Saídas

Boolean