Remove-AzureAccount

  • Referência
Módulo:
Azure

Exclui uma conta do Azure do Windows PowerShell.

Nota

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 do PowerShell herdado não é recomendado ao criar novos recursos, uma vez que o ASM está agendado para desativação. Para obter mais informações, consulte Aposentadoria do Azure Service Manager.

O módulo Az PowerShell é o módulo 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 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 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.com

Este comando remove o admin@contoso.com arquivo de dados da sua assinatura. Quando o comando for concluído, a conta não estará mais disponível para o Windows PowerShell.

Parâmetros

-Confirm

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

Tipo:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Force

Suprime o prompt de confirmação. Por padrão, Remove-AzureAccount solicita antes de remover a conta do Windows PowerShell.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais: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
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Profile

Especifica o perfil do Azure a partir do qual este cmdlet é lido. Se você não especificar um perfil, esse cmdlet será lido a partir do perfil padrão local.

Tipo:AzureSMProfile
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-WhatIf

Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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.