Partilhar via

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 de Gerenciamento de Serviços. Consulte o módulo Az PowerShell para cmdlets para gerenciar recursos do Azure Resource Manager.

Syntax

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.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:AzureSMProfile
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

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.