Partager via

Add-AzureAccount

  • Référence
Module:
Azure

Ajoute le compte Azure à Windows PowerShell.

Remarque

Les cmdlets mentionnées dans cette documentation servent à gérer les ressources Azure héritées qui utilisent les API Azure Service Manager (ASM). Ce module PowerShell hérité n’est pas recommandé lors de la création de ressources, car ASM est planifié pour la mise hors service. Pour plus d’informations, consultez la mise hors service d’Azure Service Manager.

Le module Az PowerShell est le module PowerShell recommandé pour la gestion des ressources Azure Resource Manager (ARM) avec PowerShell.

Syntaxe

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

Description

L’applet de commande Add-AzureAccount rend votre compte Azure et ses abonnements disponibles dans Windows PowerShell. Il s’agit de la connexion à votre compte Azure dans Windows PowerShell. Pour vous déconnecter du compte, utilisez l’applet de commande Remove-AzureAccount .

Add-AzureAccount télécharge des informations sur votre compte Azure et l’enregistre dans un fichier de données d’abonnement dans votre profil utilisateur itinérant. Il obtient également un jeton d’accès qui permet à Windows PowerShell d’accéder à votre compte Azure en votre nom. Une fois la commande terminée, vous pouvez gérer votre compte Azure dans Windows PowerShell.

Il existe deux façons différentes de rendre votre compte Azure disponible pour Windows PowerShell. Vous pouvez utiliser l’applet de commande Add-AzureAccount , qui utilise des jetons d’accès d’authentification Microsoft Entra ou Import-AzurePublishSettingsFile, qui utilise un certificat de gestion. Pour obtenir des conseils sur la méthode à utiliser, consultez Guide pratique pour se connecter à votre abonnement (https://azure.microsoft.com/documentation/articles/install-configure-powershell/#Connect).

Lorsque vous exécutez Add-AzureAccount, il affiche une fenêtre interactive qui vous invite à vous connecter à votre compte Azure. Cette connexion est valide jusqu’à l’expiration du jeton d’accès. Quand elle expire, les applets de commande qui nécessitent l’accès à votre compte vous invitent à réexécuter Add-AzureAccount .

Cette rubrique décrit l’applet de commande dans la version 0.8.10 du module Microsoft Azure PowerShell. Pour obtenir la version du module que vous utilisez, dans la console Azure PowerShell, tapez (Get-Module -Name Azure).Version.

Exemples

Exemple 1 : Ajouter un compte

PS C:\> Add-AzureAccount

Cette commande ajoute un compte Azure à Windows PowerShell. Lorsque vous exécutez la commande, une fenêtre s’affiche pour demander le nom d’utilisateur et le mot de passe du compte.

Exemple 2 : Utiliser un autre fichier de données d’abonnement

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

Cette commande utilise le paramètre SubscriptionDataFile pour diriger Add-AzureAccount pour stocker les données du compte dans le fichier C :\Testing\SDF.xml, au lieu du fichier par défaut.

Paramètres

-Credential

Type:PSCredential
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Environment

Spécifie un environnement Azure.

Un environnement Azure un déploiement indépendant de Microsoft Azure, tel qu’AzureCloud pour Azure global et AzureChinaCloud pour Azure géré par 21Vianet en Chine. Vous pouvez également créer des environnements Azure locaux à l’aide d’Azure Pack et des applets de commande WAPack. Pour plus d’informations, consultez Azure Pack.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Profile

Spécifie le profil Azure à partir duquel cette applet de commande lit. Si vous ne spécifiez pas de profil, cette applet de commande lit le profil par défaut local.

Type:AzureSMProfile
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ServicePrincipal

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Tenant

Type:String
Alias:TenantId
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

None

Vous ne pouvez pas diriger l’entrée vers cette applet de commande

Sorties

None

Cette applet de commande ne retourne aucune sortie.

Notes

  • Add-AzureAccount (et la méthode d’authentification Microsoft Entra) est prioritaire sur Import-AzurePublishSettings (et la méthode de certificat de gestion). Si vous utilisez Add-AzureAccount même une fois sur votre compte, la méthode d’authentification Microsoft Entra est utilisée et le certificat de gestion est ignoré. Pour supprimer le jeton Microsoft Entra et restaurer la méthode de certificat de gestion, utilisez l’applet de commande Remove-AzureAccount . Pour plus d’informations, tapez : Get-Help Remove-AzureAccount.
  • Erreur : « Vos informations d’identification ont expiré. Utilisez Add-AzureAccount pour vous reconnecter. » indique que votre jeton d’accès a expiré et Que Windows PowerShell ne peut pas accéder à votre compte Azure. Pour restaurer l’accès à votre compte, réexécutez Add-AzureAccount .
  • Les applets de commande de compte et d’abonnement Azure PowerShell obtiennent leurs données à partir du fichier de données d’abonnement, et non à partir du compte Azure actif. Si vous modifiez votre compte ou vos abonnements en dehors de Windows PowerShell, par exemple en utilisant le portail de gestion Azure, réexécutez Add-AzureAccount pour actualiser le fichier de données d’abonnement.