Add-AzureAccount

  • Referência
Módulo:
Azure

Adiciona a conta do Azure ao Windows PowerShell.

Observação

Os cmdlets mostrados nesta documentação são usados para gerenciar recursos herdados do Azure que usam APIs de Gerenciamento de Serviços. Confira o módulo Az PowerShell para usar cmdlets a fim de gerenciar recursos do Azure Resource Manager.

Syntax

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

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

Type:String
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 lê. 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

-ServicePrincipal

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Tenant

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