Connexion à Exchange Online PowerShell

Note

Nous vous recommandons d’utiliser le module Exchange Online PowerShell v2 pour vous connecter à Exchange Online PowerShell. Pour obtenir des instructions, voir Utiliser le module Exchange Online PowerShell v2.

Exchange Online PowerShell vous permet de gérer vos paramètres Exchange Online à partir de la ligne de commande. Vous utilisez Windows PowerShell sur votre ordinateur local pour créer une session PowerShell distante vers Exchange Online. Il s’agit d’un processus simple en trois étapes dans lequel vous entrez vos informations d’identification Microsoft 365, vous indiquez les paramètres de connexion requis, puis vous importez les cmdlets Exchange Online dans votre session Windows PowerShell locale afin de pouvoir les utiliser.

Important

Si vous souhaitez utiliser une authentification à plusieurs facteurs (MFA) pour vous connecter à Exchange Online PowerShell, vous devez télécharger et utiliser le module Exchange Online à distance Powershell. Pour plus d’informations, voir Connexion à Exchange Online PowerShell avec l’authentification à plusieurs facteurs.

Si vous êtes un client autonome Exchange Online Protection (EOP) (par exemple, vous utilisez EOP pour protéger votre environnement de courrier sur site), utilisez les instructions de connexion dans Connexion à Exchange Online Protection à l’aide du Powershell à distance. Si votre organisation Exchange locale dispose d’une licence d’accès client Exchange Enterprise avec des licences de services, EOP est l’un des services inclus et les instructions de connexion décrites dans cette rubrique s’appliquent à votre cas.

Ce qu'il faut savoir avant de commencer

  • Durée d’exécution estimée : 5 minutes

  • Vous pouvez utiliser les versions de Windows suivantes :

    • Windows 10

    • Windows 8.1

    • Windows Server 2019

    • Windows Server 2016

    • Windows Server 2012 ou Windows Server 2012 R2

    • Windows 7 Service Pack 1 (SP1)*

    • Windows Server 2008 R2 SP1*

    * Cette version de Windows a atteint la fin du support et est désormais prise en charge uniquement lors de l’exécution dans les machines virtuelles Azure. Pour utiliser cette version de Windows, vous devez installer Microsoft .NET Framework 4.5 ou une version ultérieure, puis une version mise à jour de Windows Management Framework : 3.0, 4.0 ou 5.1 (une seule). Pour plus d’informations, consultezInstallation du .NET Framework, Windows Management Framework 3.0, Windows Management Framework 4.0et Windows Management Framework 5.1.

  • Windows PowerShell doit être configuré pour exécuter des scripts, ce qui n’est pas le cas par défaut. Vous obtenez l’erreur suivante lorsque vous essayez de vous connecter :

    Files cannot be loaded because running scripts is disabled on this system. Provide a valid certificate with which to sign the files.

    Pour exiger que tous les scripts PowerShell téléchargés depuis Internet soient signés par un éditeur approuvé, exécutez la commande suivante dans une fenêtre Windows PowerShell avec élévation de privilèges (c’est-à-dire une fenêtre Windows PowerShell ouverte en sélectionnant Exécuter en tant qu’administrateur) :

    Set-ExecutionPolicy RemoteSigned
    
  • La Gestion à distance de Windows (WinRM) doit être activée (elle n’est pas activée par défaut dans Windows 7, 8.1 et 10). Pour l’activer, exécutez cette commande dans une invite de commandes :

    winrm quickconfig
    
  • WinRM doit autoriser l’authentification de base (elle est activée par défaut). Nous n’envoyons pas la combinaison nom d’utilisateur et mot de passe, mais l’en-tête d’authentification de base est requis pour transporter le jeton OAuth de la session, car l’implémentation de WinRM côté client ne prend pas en charge le protocole OAuth.

    Pour vérifier que l’authentification de base est activée pour WinRM, exécutez cette commande dans une invite de commandes :

    winrm get winrm/config/client/auth
    

    Si vous ne voyez pas la valeur Basic = true, vous devez exécuter cette commande pour activer l’authentification de base pour WinRM :

    winrm set winrm/config/client/auth @{Basic="true"}
    

    Si l’authentification de base pour WinRM est désactivée, vous obtenez l’erreur suivante lorsque vous essayez de vous connecter :

    Le client WinRM ne peut pas traiter la demande. L’authentification de base est actuellement désactivée dans la configuration du client. Modifiez la configuration du client, puis renouvelez la demande.

Tip

Vous rencontrez des difficultés ? Demandez de l’aide en participant aux forums Exchange. Visitez le forum à l'adresse : Exchange Server, Exchange Online ou Exchange Online Protection.

Se connecter à Exchange Online

  1. Sur votre ordinateur local, ouvrez Windows PowerShell et exécutez la commande suivante.

    $UserCredential = Get-Credential
    

    Dans la boîte de dialogue Demande d’informations d’identification Windows PowerShell, saisissez vos nom d’utilisateur et mot de passe, puis cliquez sur OK.

  2. Exécutez la commande suivante :

    $Session = New-PSSession -ConfigurationName Microsoft.Exchange -ConnectionUri https://outlook.office365.com/powershell-liveid/ -Credential $UserCredential -Authentication Basic -AllowRedirection
    

    Remarques :

    • Pour Office 365 géré par 21Vianet, utilisez la valeur_ConnectionUri_: https://partner.outlook.cn/PowerShell

    • Pour Office 365 Allemagne, utilisez la valeur_ConnectionUri_: https://outlook.office.de/powershell-liveid/

    • Pour Microsoft 365 secteur public Communauté Cloud élevé (GCC élevé), utilisez la valeur_ConnectionUri_ : https://outlook.office365.us/powershell-liveid/

    • Si vous êtes derrière un serveur proxy, exécutez cette commande en premier : $ProxyOptions = New-PSSessionOption -ProxyAccessType <Value>, où la valeur_ProxyAccessType_ estIEConfig, WinHttpConfig, ou AutoDetect.

      Ensuite, ajoutez le paramètre suivant et la valeur à la fin de la $Session =... commande : -SessionOption $ProxyOptions.

      Pour plus d’informations, voir Nouveau-PSSessionOption.

  3. Exécutez la commande suivante :

    Import-PSSession $Session -DisableNameChecking
    

Note

N’oubliez pas de déconnecter la session PowerShell distante dès que vous avez terminé. Si vous fermez la fenêtre Windows PowerShell sans déconnecter la session, vous pourriez épuiser toutes les sessions PowerShell distantes à votre disposition et vous devrez attendre l’expiration des sessions. Pour déconnecter la session PowerShell distante, exécutez la commande suivante.

Remove-PSSession $Session

Comment savoir si cela a fonctionné ?

Après l'étape 3, les cmdlets Exchange Online sont importées dans votre session Windows PowerShell locale comme indiqué par une barre de progression. Si vous ne recevez aucune erreur, la connexion est établie. Un test rapide consiste à exécuter une cmdlet Exchange Online (par exemple, Get-Mailbox ) et à consulter les résultats.

Si vous recevez des erreurs, vérifiez les conditions requises suivantes :

  • Un mot de passe incorrect est un problème courant. Exécutez à nouveau les trois étapes et portez une attention particulière au nom d’utilisateur et au mot de passe que vous entrez à l’étape 1.

  • Pour éviter les attaques par déni de service, vous ne pouvez ouvrir que trois sessions Windows Powershell à distance vers votre organisation Exchange Online.

  • Le compte que vous utilisez pour vous connecter à Exchange Online doit être activé pour PowerShell à distance. Pour plus d’informations, reportez-vous à l’article sur la gestion de l’accès à PowerShell à distance dans Exchange Online.

  • Le trafic du port TCP 80 doit être ouvert entre votre ordinateur local et Microsoft 365. Il est probablement ouvert, mais vous devez y penser si votre organisation a une stratégie restrictive d’accès à Internet.

  • Si votre organisation utilise l’authentification fédérée et que votre fournisseur d’identité (IDP) et/ou le service d’émission de jeton de sécurité (STS) n’est pas disponible publiquement, vous ne pouvez pas utiliser un compte fédéré pour vous connecter à Exchange Online PowerShell. Au lieu de cela, créez et utilisez un compte non fédéré dans Microsoft 365 pour vous connecter à Exchange Online PowerShell.

Voir aussi

Les cmdlets que vous utilisez dans cette rubrique sont des cmdlets Windows PowerShell. Pour plus d’informations à propos de ces cmdlets, consultez les rubriques suivantes.

Pour plus d’informations sur la gestion de Microsoft 365, voir Gérer Microsoft 365 et Office 365.