Add-AzureAccount

  • Referência
Módulo:
Azure

Adiciona a conta do Azure ao 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

Add-AzureAccount
   [-Environment <String>]
   [-Credential <PSCredential>]
   [-Tenant <String>]
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]
Add-AzureAccount
   [-Environment <String>]
   -Credential <PSCredential>
   [-ServicePrincipal]
   -Tenant <String>
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]

Description

O cmdlet Add-AzureAccount disponibiliza sua conta do Azure e suas assinaturas no Windows PowerShell. É como iniciar sessão na sua conta do Azure no Windows PowerShell. Para efetuar logout da conta, use o cmdlet Remove-AzureAccount .

Add-AzureAccount baixa informações sobre sua conta do Azure e as salva em um arquivo de dados de assinatura em seu perfil de usuário móvel. Ele também obtém um token de acesso que permite que o Windows PowerShell acesse sua conta do Azure em seu nome. Quando o comando for concluído, você poderá gerenciar sua conta do Azure no Windows PowerShell.

Há duas maneiras diferentes de disponibilizar sua conta do Azure para o Windows PowerShell. Você pode usar o cmdlet Add-AzureAccount, que usa tokens de acesso de autenticação do Microsoft Entra, ou Import-AzurePublishSettingsFile, que usa um certificado de gerenciamento. Para obter orientação sobre qual método usar, consulte Como conectar-se à sua assinatura (https://azure.microsoft.com/documentation/articles/install-configure-powershell/#Connect).

Quando você executa Add-AzureAccount, ele exibe uma janela interativa que solicita que você entre em sua conta do Azure. Este início de sessão é válido até o token de acesso expirar. Quando ele expirar, os cmdlets que exigem acesso à sua conta solicitam que você execute Add-AzureAccount novamente.

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: Adicionar uma conta

PS C:\> Add-AzureAccount

Este comando adiciona uma conta do Azure ao Windows PowerShell. Quando você executa o comando, uma janela aparece para solicitar o nome de usuário e senha da conta.

Exemplo 2: Usar um arquivo de dados de assinatura alternativo

PS C:\> Add-AzureAccount -SubscriptionDataFile C:\Testing\SDF.xml

Este comando usa o parâmetro SubscriptionDataFile para direcionar Add-AzureAccount para armazenar os dados da conta no arquivo C:\Testing\SDF.xml, em vez do arquivo padrão.

Parâmetros

-Credential

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

-Environment

Especifica um ambiente do Azure.

Um ambiente do Azure uma implantação independente do Microsoft Azure, como AzureCloud para Azure global e AzureChinaCloud para Azure operado pela 21Vianet na China. Você também pode criar ambientes locais do Azure usando o Azure Pack e os cmdlets WAPack. Para obter mais informações, consulte Pacote do Azure.

Tipo:String
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

-ServicePrincipal

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

-Tenant

Tipo:String
Aliases:TenantId
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

Entradas

None

Não é possível canalizar a entrada para este cmdlet

Saídas

None

Este cmdlet não retorna nenhuma saída.

Notas

  • Add-AzureAccount (e o método de autenticação Microsoft Entra) tem precedência sobre Import-AzurePublishSettings (e o método de certificado de gerenciamento). Se você usar Add-AzureAccount mesmo uma vez em sua conta, o método de autenticação do Microsoft Entra será usado e o certificado de gerenciamento será ignorado. Para remover o token do Microsoft Entra e restaurar o método de certificado de gerenciamento, use o cmdlet Remove-AzureAccount . Para obter mais informações, digite: Get-Help Remove-AzureAccount.
  • O erro, "Suas credenciais expiraram. Use Add-AzureAccount para fazer logon novamente." indica que seu token de acesso expirou e o Windows PowerShell não pode acessar sua conta do Azure. Para restaurar o acesso à sua conta, execute Add-AzureAccount novamente.
  • A conta do Azure PowerShell e os cmdlets de assinatura obtêm seus dados do arquivo de dados de assinatura, não da conta ativa do Azure. Se você alterar sua conta ou assinaturas fora do Windows PowerShell, como usando o Portal de Gerenciamento do Azure, execute Add-AzureAccount novamente para atualizar o arquivo de dados da assinatura.