Add-AzureAccount

  • Referência
Módulo:
Azure

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

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 logon em sua conta do Azure no Windows PowerShell. Para fazer 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. Essa entrada é válida até que o token de acesso expire. 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 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 o AzureCloud para Azure global e o AzureChinaCloud para Azure operado pela 21Vianet na China. Você também pode criar ambientes locais do Azure usando o Pacote do Azure e os cmdlets WAPack. Para obter mais informações, consulte Pacote do Azure.

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 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

-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

Não é possível 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 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 de assinatura.