Connexion à Microsoft 365 à l’aide de PowerShell

Cet article est valable pour Microsoft 365 Entreprise et Office 365 Entreprise.

PowerShell pour Microsoft 365 vous permet de gérer vos paramètres Microsoft 365 à partir de la ligne de commande. Pour vous connecter à PowerShell, installez le logiciel requis, puis connectez-vous à votre organisation Microsoft 365.

Il existe deux versions du module PowerShell que vous utilisez pour vous connecter à Microsoft 365 et administrer les comptes d’utilisateurs, les groupes et les licences:

  • Azure Active Directory PowerShell pour Graph dont les cmdlets incluent AzureAD dans leur nom
  • Module Microsoft Azure Active Directory pour Windows PowerShell, dont les cmdlets incluent Msol dans leur nom

À l’heure actuelle, le module Azure Active Directory PowerShell pour Graph ne remplace pas complètement la fonctionnalité du Module Microsoft Azure Active Directory pour Windows PowerShell pour l’administration des utilisateurs, des groupes et des licences. Dans certains cas, vous devez utiliser les deux versions. Vous pouvez installer en toute sécurité les deux versions sur le même ordinateur.

Notes

Vous pouvez également vous connecter à Azure Cloud Shell à partir du Centre d’administration Microsoft 365.

Ce qu’il faut savoir avant de commencer

Système d’exploitation

Vous devez utiliser une version 64 bits de Windows. La prise en charge de la version 32 bits du Module Microsoft Azure Active Directory pour Windows PowerShell a expiré en 2014.

Vous pouvez utiliser les versions de Windows suivantes :

  • Windows 10, Windows 8.1, Windows 8 ou Windows 7 Service Pack 1 (SP1)

  • Windows Server 2019, Windows Server 2016, Windows Server 2012 R2, Windows Server 2012 ou Windows Server 2008 R2 SP1

Notes

Pour Windows 8.1, Windows 8, Windows 7 Service Pack 1 (SP1), Windows Server 2012 R2, Windows Server 2012 et Windows Server 2008 R2 SP1, téléchargez et installez Windows Management Framework 5.1.

PowerShell

  • Pour le module Graph de Azure Active Directory PowerShell, vous devez utiliser PowerShell version 5.1 ou ultérieure.

  • Vous devez utiliser PowerShell version 5.1 ou ultérieure jusqu’à PowerShell version 6 pour le Module Microsoft Azure Active Directory pour Windows PowerShell. Vous ne pouvez pas utiliser PowerShell version 7.

Notes

Ces procédures sont destinées aux utilisateurs membres d'un rôle d'administrateur Microsoft 365. Pour plus d'informations, consultez À propos des rôles d'administrateur.

Se connecter avec le module PowerShell Azure Active Directory pour Graph

Le nom des cmdlets du module Azure Active Directory PowerShell pour Graph contient la chaîne de caractères AzureAD. Vous pouvez installer le module Azure Active Directory PowerShell pour Graph ou Azure PowerShell.

Si vous devez utiliser les nouvelles cmdlets dans le module Microsoft Azure Active Directory PowerShell pour Graph, veuillez suivre cette procédure pour installer le module et vous connecter à votre abonnement Microsoft 365.

Notes

Pour les informations sur la prise en charge de différentes versions de Windows, consultez le Module Microsoft Azure Active Directory PowerShell pour Graph.

Étape 1 : installez le logiciel requis

Ces étapes ne sont requises qu’une fois sur votre ordinateur. Mais vous devrez peut-être mettre à jour le logiciel régulièrement.

  1. Ouvrez une fenêtre élevée de l’invite de commandes Windows PowerShell en exécutant Windows PowerShell en tant qu’administrateur.

  2. Ensuite, exécutez la commande suivante :

    Install-Module -Name AzureAD
    

Par défaut, la galerie PowerShell (PSGallery) n'est pas configurée comme un référentiel de confiance pour PowerShellGet . La première fois que vous utilisez la PSGallery, vous verrez le message suivant :

Untrusted repository

You are installing the modules from an untrusted repository. If you trust this repository, change
its InstallationPolicy value by running the `Set-PSRepository` cmdlet.

Are you sure you want to install the modules from 'PSGallery'?
[Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"):

Répondez Oui ou Oui à Tout pour continuer l'installation.

Étape 2 : connectez-vous à Azure AD avec votre abonnement Microsoft 365

Pour vous connecter à Azure AD avec une authentification multifacteur ou les identifiants d’un compte de votre abonnement Microsoft 365, exécutez l’une des commandes suivantes à partir d’une invite de commandes Windows PowerShell. (elle ne nécessite pas d’élévation de privilèges).

Office 365 dans le cloud Commande
Office 365 dans le monde (+GCC) Connect-AzureAD
Office 365 géré par 21 ViaNet Connect-AzureAD -AzureEnvironmentName AzureChinaCloud
Office 365 Allemagne Connect-AzureAD -AzureEnvironmentName AzureGermanyCloud
Office 365 U.S. Government DoD et Office 365 U.S. Government GCC High Connect-AzureAD -AzureEnvironmentName AzureUSGovernment

Dans la boîte de dialogue Connectez-vous à votre compte, tapez le nom d’utilisateur et le mot de passe de votre compte professionnel ou scolaire Microsoft 365, puis sélectionnez OK.

Si vous utilisez une authentification multifacteur, suivez les instructions pour fournir des informations d’authentification supplémentaires telles que le code de vérification.

Une fois connecté, vous pouvez utiliser les cmdlets du module Azure Active Directory PowerShell pour Graph.

Se connecter au Module Microsoft Azure Active Directory pour Windows PowerShell

Notes

Les cmdlets du Module Microsoft Azure Active Directory pour Windows PowerShell ont MSol dans leur nom.

PowerShell version 7 et ultérieures ne prennent pas en charge le Module Microsoft Azure Active Directory pour Windows PowerShell et les cmdlets incluant Msol dans leur nom. Pour PowerShell version 7 ou ultérieure, vous devez utiliser le module Azure Active Directory PowerShell pour Graph ou Azure PowerShell.

PowerShell Core ne prend pas en charge le Module Microsoft Azure Active Directory pour Windows PowerShell et les applets de commande avec Msol dans leur nom. Exécutez ces applets de commande à partir de Windows PowerShell.

Étape 1 : installez le logiciel requis

Ces étapes ne sont requises qu’une fois sur votre ordinateur. Mais vous devrez peut-être mettre à jour le logiciel régulièrement.

  1. Si vous n’exécutez pas Windows 10, installez la version 32 bits de l’Assistant de Connexion Microsoft Online Services : Assistant de connexion Microsoft Online Services pour les professionnels des Technologies de l'Information RTW.

  2. Installez le Module Microsoft Azure Active Directory pour Windows PowerShell en suivant ces étapes:

    1. Ouvrez une invite de commandes Windows PowerShell avec élévation de privilèges (exécutez Windows PowerShell en tant qu’administrateur).
    2. Exécutez la commande Install-Module MSOnline.
    3. Si vous êtes invité à installer le fournisseur NuGet, tapez Y, puis appuyez sur Entrée.
    4. Si vous êtes invité à installer le module à partir de PSGallery, tapez Y, puis appuyez sur Entrée.

Étape 2 : connectez-vous à Azure AD avec votre abonnement Microsoft 365

Pour vous connecter à Azure AD avec une authentification multifacteur ou les identifiants d’un compte de votre abonnement Microsoft 365, exécutez l’une des commandes suivantes à partir d’une invite de commandes Windows PowerShell. (Elle ne nécessite pas d’élévation de privilèges).

Office 365 dans le cloud Commande
Office 365 dans le monde (+GCC) Connect-MsolService
Office 365 géré par 21 ViaNet Connect-MsolService -AzureEnvironment AzureChinaCloud
Office 365 Allemagne Connect-MsolService -AzureEnvironment AzureGermanyCloud
Office 365 U.S. Government DoD et Office 365 U.S. Government GCC High Connect-MsolService -AzureEnvironment USGovernment

Dans la boîte de dialogue Connectez-vous à votre compte, tapez le nom d’utilisateur et le mot de passe de votre compte professionnel ou scolaire Microsoft 365, puis sélectionnez OK.

Si vous utilisez une authentification multifacteur, suivez les instructions pour fournir des informations d’authentification supplémentaires telles que le code de vérification.

Vérification du bon fonctionnement

Si vous ne recevez pas de message d’erreur, alors vous vous êtes connecté. Pour effectuer un test rapide, exécutez une cmdlet Microsoft 365 telle que, Get-MsolUser, et consultez les résultats.

Si vous recevez un message d’erreur, vérifiez les problèmes suivants:

  • Un problème courant est un mot de passe incorrect. Exécutez à nouveau l'étape 2 et portez une attention particulière au nom d'utilisateur et au mot de passe que vous saisissez.

  • Le Module Microsoft Azure Active Directory pour Windows PowerShell nécessite que Microsoft .NET Framework 3.5. x est activé sur votre ordinateur**. Il est probable qu'une version plus récente est installée sur votre ordinateur (par exemple, 4 ou 4.5.* x*). Mais la compatibilité descendante avec les anciennes versions du .NET Framework peut être activée ou désactivée. Pour plus d'informations, consultez les articles suivants :

  • Votre version du Module Microsoft Azure Active Directory pour Windows PowerShell est peut-être obsolète. Pour vérifier cela, exécutez la commande suivante dans PowerShell pour Microsoft 365 ou le Module Microsoft Azure Active Directory pour Windows PowerShell :

    (Get-Item C:\Windows\System32\WindowsPowerShell\v1.0\Modules\MSOnline\Microsoft.Online.Administration.Automation.PSModule.dll).VersionInfo.FileVersion
    

    Si le numéro de version renvoyé est inférieur à la valeur 1.0.8070.2, désinstallez le Module Microsoft Azure Active Directory pour Windows PowerShell, puis installez-le à partir de l’Etape 1 ci-dessus.

  • Si un message d’erreur de connexion s’affiche, consultez Erreur « Connect-MsolService: Une exception de type a été levée ».

  • Si vous recevez un message d’erreur «Get-Item : Chemin introuvable», exécutez cette commande:

       (dir "C:\Program Files\WindowsPowerShell\Modules\MSOnline").Name
    

Se connecter à Azure Cloud Shell

Pour vous connecter et utiliser Azure Cloud Shell à partir du centre d'administration Microsoft 365, sélectionnez l'icône de la fenêtre PowerShell dans le coin supérieur droit de la barre des tâches. Dans le volet Bienvenue dans Azure Cloud Shell , sélectionnez PowerShell.

Vous aurez besoin d’un abonnement Azure actif pour votre organisation lié à votre abonnement Microsoft 365. Si vous n’en avez pas encore, vous pouvez en créer un. Une fois que vous disposez d’un abonnement Azure, une fenêtre PowerShell s’ouvre à partir de laquelle vous pouvez exécuter des commandes et des scripts PowerShell.

Pour plus d’informations, consultez Azure Cloud Shell.

Voir aussi