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 gestione dei servizi. Vedere il modulo Az PowerShell per i cmdlet per gestire le risorse di Azure Resource Manager.

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-AzurePublish Impostazioni File, che usa un certificato di gestione. Per indicazioni sul metodo da usare, vedere Procedura: Connessione 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 all'archiviazione dei dati dell'account nel file C:\Testing\SDF.xml anziché nel file predefinito.

Parametri

-Credential

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

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

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

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-AzurePublish Impostazioni (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.