Remove-AzureRmResourceGroup
Remove um grupo de recursos.
Aviso
O módulo AzureRM PowerShell 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 Az PowerShell para garantir suporte e atualizações contínuos.
Embora o módulo AzureRM ainda possa funcionar, ele não é mais mantido ou suportado, colocando qualquer uso continuado a critério e risco do usuário. Consulte nossos recursos de migração para obter orientação sobre a transição para o módulo Az.
Syntax
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"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
PS C:\>Get-AzureRmResourceGroup -Name "ContosoRG01" | Remove-AzureRmResourceGroup -Verbose -ForceEste comando usa o cmdlet Get-AzureRmResourceGroup para obter o grupo de recursos ContosoRG01 e o passa para Remove-AzureRmResourceGroup usando o operador de pipeline. O parâmetro Verbose common 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-AzureRmResourceGroupEste comando usa o cmdlet Get-AzureRmResourceGroup para obter todos os grupos de recursos e, em seguida, passa-os para Remove-AzureRmResourceGroup 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.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AsJob
Executar cmdlet em segundo plano
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
Solicita a sua confirmação antes de executar o cmdlet.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DefaultProfile
As credenciais, a conta, o locatário e a assinatura usados para comunicação com o azure
| Type: | IAzureContextContainer |
| Aliases: | AzureRmContext, AzureCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Force
Força o comando a ser executado sem pedir a confirmação do usuário.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Id
Especifica a ID do grupo de recursos a ser removido. Caracteres curinga não são permitidos.
| Type: | String |
| Aliases: | ResourceGroupId, ResourceId |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Name
Especifica os nomes dos grupos de recursos a serem removidos. Caracteres curinga não são permitidos.
| Type: | String |
| Aliases: | ResourceGroupName |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Pre
Indica que esse cmdlet considera versões de API de pré-lançamento quando determina automaticamente qual versão usar.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |