Condividi tramite

Add-AzureAccount

  • Riferimento
Modulo:
Azure

Aggiunge l'account Azure a Windows PowerShell.

Nota

I cmdlet a cui si fa riferimento in questa documentazione sono per la gestione delle risorse di Azure legacy che usano le API di Azure Service Manager (ASM). Questo modulo di PowerShell legacy non è consigliato durante la creazione di nuove risorse perché ASM è pianificato per il ritiro. Per altre informazioni, vedere Ritiro di Azure Service Manager.

Il modulo Az PowerShell è il modulo PowerShell consigliato per la gestione delle risorse di Azure Resource Manager (ARM) con PowerShell.

Sintassi

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

Descrizione

Il cmdlet Add-AzureAccount rende disponibile l'account Azure e le relative sottoscrizioni in Windows PowerShell. È come accedere all'account Azure in Windows PowerShell. Per disconnettersi dall'account, usare il cmdlet Remove-AzureAccount .

Add-AzureAccount scarica informazioni sull'account Azure e lo salva in un file di dati della sottoscrizione nel profilo utente mobile. Ottiene anche un token di accesso che consente a Windows PowerShell di accedere all'account Azure per conto dell'utente. Al termine del comando, è possibile gestire l'account Azure in Windows PowerShell.

Esistono due modi diversi per rendere disponibile l'account Azure per Windows PowerShell. È possibile usare il cmdlet Add-AzureAccount , che usa i token di accesso all'autenticazione di Microsoft Entra o Import-AzurePublishSettingsFile, che usa un certificato di gestione. Per indicazioni sul metodo da usare, vedere Procedura: Connettersi alla sottoscrizione (https://azure.microsoft.com/documentation/articles/install-configure-powershell/#Connect).

Quando si esegue Add-AzureAccount, viene visualizzata una finestra interattiva che richiede di accedere all'account Azure. Questo accesso è valido fino alla scadenza del token di accesso. Alla scadenza, i cmdlet che richiedono l'accesso all'account richiedono di eseguire di nuovo Add-AzureAccount .

Questo argomento descrive il cmdlet nella versione 0.8.10 del modulo Microsoft Azure PowerShell. Per ottenere la versione del modulo in uso, nella console di Azure PowerShell digitare (Get-Module -Name Azure).Version.

Esempio

Esempio 1: Aggiungere un account

PS C:\> Add-AzureAccount

Questo comando aggiunge un account Azure a Windows PowerShell. Quando si esegue il comando, viene visualizzata una finestra per richiedere il nome utente e la password dell'account.

Esempio 2: Usare un file di dati di sottoscrizione alternativo

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

Questo comando usa il parametro SubscriptionDataFile per indirizzare Add-AzureAccount a archiviare i dati dell'account nel file C:\Testing\SDF.xml anziché nel file predefinito.

Parametri

-Credential

Tipo:PSCredential
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Environment

Specifica un ambiente di Azure.

Un ambiente Azure una distribuzione indipendente di Microsoft Azure, ad esempio AzureCloud per Azure globale e AzureChinaCloud per Azure gestito da 21Vianet in Cina. È anche possibile creare ambienti di Azure locali usando Azure Pack e i cmdlet WAPack. Per altre informazioni, vedere Azure Pack.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Profile

Specifica il profilo di Azure da cui viene letto questo cmdlet. Se non si specifica un profilo, questo cmdlet legge dal profilo predefinito locale.

Tipo:AzureSMProfile
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ServicePrincipal

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Tenant

Tipo:String
Alias:TenantId
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

None

Non è possibile inviare tramite pipe l'input a questo cmdlet

Output

None

Questo cmdlet non restituisce alcun output.

Note

  • Add-AzureAccount (e il metodo di autenticazione Di Microsoft Entra) ha la precedenza su Import-AzurePublishSettings (e il metodo del certificato di gestione). Se si usa Add-AzureAccount anche una volta nell'account, viene usato il metodo di autenticazione Microsoft Entra e il certificato di gestione viene ignorato. Per rimuovere il token Microsoft Entra e ripristinare il metodo del certificato di gestione, usare il cmdlet Remove-AzureAccount . Per altre informazioni, digitare Get-Help Remove-AzureAccount.
  • L'errore "Le credenziali sono scadute. Usare Add-AzureAccount per accedere di nuovo." indica che il token di accesso è scaduto e Windows PowerShell non può accedere all'account Azure. Per ripristinare l'accesso all'account, eseguire di nuovo Add-AzureAccount .
  • I cmdlet dell'account e della sottoscrizione di Azure PowerShell ottengono i dati dal file di dati della sottoscrizione, non dall'account Azure attivo. Se si modifica l'account o le sottoscrizioni all'esterno di Windows PowerShell, ad esempio usando il portale di gestione di Azure, eseguire di nuovo Add-AzureAccount per aggiornare il file di dati della sottoscrizione.