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.

Remarque

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

Ce qu’il faut savoir avant de commencer

Remarque

Le module Azure Active Directory est remplacé par le SDK PowerShell Microsoft Graph. Vous pouvez utiliser le kit de développement logiciel (SDK) PowerShell Microsoft Graph pour accéder à toutes les API Microsoft Graph. Pour plus d’informations, consultez Démarrage avec le kit de développement logiciel (SDK) PowerShell Microsoft Graph.

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

Remarque

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 Azure Active Directory PowerShell pour Graph, vous devez utiliser PowerShell version 5.1.

  • 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.

Remarque

Ces procédures sont destinées aux utilisateurs qui sont membres d’un groupe de rôles 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.

Remarque

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 d’invite de commandes Windows PowerShell.

  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.

  1. Exécutez cette commande pour importer le module :

    Import-Module  AzureAD
    

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

Pour vous connecter à Azure AD de votre abonnement Microsoft 365 avec un nom et mot de passe de compte ou une authentification multifacteur, exécutez l’une de ces commandes à partir de l’invite de commandes Windows PowerShell. (L’élévation n’est pas exigée.)

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électionnezOK.

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

Remarque

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 et ultérieures, vous devez utiliser le SDK Microsoft Graph PowerShell.

PowerShell Core ne prend pas en charge le module Microsoft Azure Active Directory pour le module Windows PowerShell et les cmdlets incluant Msol dans leur nom. Exécutez ces cmdlets à 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 de votre abonnement Microsoft 365 avec un nom et mot de passe de compte ou une authentification multifacteur, exécutez l’une de ces commandes à partir d’une invite de commandes Windows PowerShell. (L’élévation n’est pas exigée.)

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électionnezOK.

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 un test rapide, exécutez une applet de commande Microsoft 365, telle que Get-MsolUser, et consultez les résultats.

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

  • L’inexactitude du mot de passe est un problème courant. Exécutez L’étape 2à nouveau et entrez attentivement le nom et le mot de passe.

  • Le module Microsoft Azure Active Directory pour Windows PowerShell nécessite Microsoft .NET Framework 3.5. x est activé sur votre ordinateur. Il est probable que votre ordinateur dispose d’une version plus récente installée (par exemple, 4 ou 4.5. x). Mais la rétrocompatibilité avec les versions antérieures du .NET Framework peut être activée ou désactivée. Pour plus d’informations, voir 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, consultezErreur « 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 à Azure Cloud Shell et l’utiliser à partir du Centre d’administration Microsoft 365, sélectionnez l’icône de 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