Add-AzureAccount
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 Gestion des services. Pour ce qui est des cmdlets permettant de gérer des ressources Azure Resource Manager, consultez le Module Az PowerShell.
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
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-AzurePublish Paramètres File, qui utilise un certificat de gestion. Pour obtenir des conseils sur la méthode à utiliser, consultez Comment : 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 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
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 |
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-AzurePublish Paramètres (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.