Remove-AzResourceGroup
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 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 sua 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 -ForceEsse comando usa o cmdlet Get-AzResourceGroup para obter o grupo de recursos ContosoRG01 e, em seguida, 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-AzResourceGroupEsse 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 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: | AzContext, 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: | Named |
| 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 |