Remove-AzureAccount
Exclui uma conta do Azure do Windows PowerShell.
Observação
Os cmdlets mencionados 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, já que o ASM está programado para desativação. Para obter mais informações, consulte Aposentadoria do Azure Service Manager.
O módulo Az PowerShell é o módulo do PowerShell recomendado 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 qualquer forma.
Usar esse cmdlet é muito parecido com sair da sua conta do Azure. E, se você quiser fazer logon na conta novamente, use o 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 PowerShell do Azure usarão apenas o token de acesso, ignorando 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 PowerShell do Microsoft Azure.
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 a partir do qual este cmdlet lê. Se você não especificar um perfil, esse cmdlet será lido a partir do 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 pelo nome da propriedade, mas não pelo valor.
Saídas
None or System.Boolean
Se você usar o parâmetro PassThru , esse cmdlet retornará um valor booleano. Caso contrário, ele não retorna nenhuma saída.