Compartilhar via

Add-AzureAccount

  • Referência
Módulo:
Azure

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

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 fazer login em sua conta do Azure no Windows PowerShell. Para fazer logoff 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 diretrizes sobre qual método usar, consulte Como se conectar à 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. Essa entrada é válida até que o token de acesso expire. Quando ele expirar, os cmdlets que exigem acesso à sua conta solicitarão que você execute Add-AzureAccount novamente.

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

PS C:\> Add-AzureAccount

Esse 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 a senha da conta.

Exemplo 2: Usar um arquivo de dados de assinatura alternativo

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

Esse 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
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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 Azure Pack.

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

-ServicePrincipal

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Tenant

Tipo:String
Aliases:TenantId
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

None

Você não pode canalizar a entrada para este cmdlet

Saídas

None

Este cmdlet não retorna nenhuma saída.

Observações

  • Add-AzureAccount (e o método de autenticação do 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 da 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.