Remove-AzureAccount
Exclui uma conta do Azure do Windows PowerShell.
Observação
Os cmdlets referenciados nesta documentação são para gerenciar recursos herdados do Azure que usam APIs do Azure Service Manager (ASM). Este módulo herdado do PowerShell não é recomendado ao criar novos recursos, pois o ASM está agendado para desativação. Para obter mais informações, confira a desativação do Azure Service Manager.
O módulo do Az PowerShell é o módulo recomendado do PowerShell para gerenciar recursos do Azure Resource Manager (ARM) com o PowerShell.
Sintaxe
Remove-AzureAccount
-Name <String>
[-Force]
[-PassThru]
[-Profile <AzureSMProfile>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
O cmdlet Remove-AzureAccount exclui uma conta do Azure e suas assinaturas do arquivo de dados de assinatura em seu perfil de usuário móvel. Ele não exclui a conta do Microsoft Azure nem altera a conta real de forma alguma.
Usar esse cmdlet é muito parecido com fazer logoff da sua conta do Azure. E, se você quiser fazer logon na conta novamente, use Add-AzureAccount ou Import-AzurePublishSettingsFile para adicionar a conta ao Windows PowerShell novamente.
Você também pode usar o cmdlet Remove-AzureAccount para alterar a maneira como os cmdlets do Azure PowerShell entram em sua conta do Azure. Se sua conta tiver um certificado de gerenciamento de Import-AzurePublishSettingsFile e um token de acesso de Add-AzureAccount, os cmdlets do Azure PowerShell usarão apenas o token de acesso; eles ignorarão o certificado de gerenciamento. Para usar o certificado de gerenciamento, execute Remove-AzureAccount. Quando Remove-AzureAccount encontra um certificado de gerenciamento e um token de acesso, ele exclui apenas o token de acesso, em vez de excluir a conta. O certificado de gerenciamento ainda está lá, portanto, a conta ainda está disponível para o Windows PowerShell.
Este tópico descreve o cmdlet na versão 0.8.10 do módulo do Microsoft Azure PowerShell.
Para obter a versão do módulo que você está usando, no console do Azure PowerShell, digite (Get-Module -Name Azure).Version.
Exemplos
Exemplo 1: Remover uma conta
PS C:\> Remove-AzureAccount -Name admin@contoso.comEsse comando remove o admin@contoso.com do arquivo de dados da assinatura. Quando o comando for concluído, a conta não estará mais disponível para o Windows PowerShell.
Parâmetros
-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 |
-Force
Suprime o prompt de confirmação. Por padrão, Remove-AzureAccount avisa antes de remover a conta do Windows PowerShell.
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Name
Especifica o nome da conta a ser removida. O valor do parâmetro diferencia maiúsculas de minúsculas. Não há suporte para caracteres curinga.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | False |
-PassThru
Retorna $True se o comando for bem-sucedido e $False se falhar. Por padrão, esse cmdlet não retorna nenhuma saída.
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Profile
Especifica o perfil do Azure do qual esse cmdlet é lido. Se você não especificar um perfil, esse cmdlet lerá o perfil padrão local.
| Tipo: | AzureSMProfile |
| 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 |
Entradas
None
Você pode canalizar a entrada para esse cmdlet por nome de propriedade, mas não por valor.
Saídas
None or System.Boolean
Se você usar o parâmetro PassThru , esse cmdlet retornará um valor booliano. Caso contrário, ele não retorna nenhuma saída.