Installer le module PowerShell d'Exchange Online (étape par étape)

Par Mirko Peters · 2026-11-12

Installez le module PowerShell d'Exchange Online avec Install-Module ExchangeOnlineManagement : prérequis, portée, vérification de la version, mises à jour et correction des erreurs.

Traduit automatiquement par IA à partir de l'article original. Lire l'original en anglais

Pour installer le module PowerShell d'Exchange Online, ouvrez PowerShell en tant qu'administrateur et exécutez Install-Module -Name ExchangeOnlineManagement. Le module est alors installé pour tous les utilisateurs de l'ordinateur. Si vous ne pouvez pas l'exécuter en tant qu'administrateur, ajoutez -Scope CurrentUser : il ne sera installé que pour votre propre compte. Cet article s'adresse aux administrateurs Exchange et Microsoft 365 qui configurent un nouveau poste d'administration, un serveur de rebond ou un agent de compilation. Il couvre les prérequis, les étapes d'installation et de vérification, la mise à jour et la suppression du module, ainsi que les erreurs les plus fréquentes.

Points clés

• Installez le module PowerShell d'Exchange Online avec Install-Module -Name ExchangeOnlineManagement, dans une fenêtre PowerShell lancée en tant qu'administrateur, pour tous les utilisateurs.
• Utilisez -Scope CurrentUser si vous ne disposez pas des droits d'administrateur. Mettez le module à jour ultérieurement avec la même portée que celle utilisée lors de l'installation.
• Windows PowerShell 5.1 nécessite .NET Framework 4.7.2. La prise en charge de PowerShell 7 dépend de la version du module : la version 3.10.0 ou ultérieure nécessite PowerShell 7.6.0.
• Vérifiez le résultat avec Get-InstalledModule, qui affiche la version ainsi que l'emplacement du module (tous les utilisateurs ou utilisateur actuel).
• Le module n'a plus besoin de l'authentification de base dans WinRM, car ses connexions utilisent REST.

Ce qu'est le module et ce dont vous avez besoin au préalable

Le module s'appelle ExchangeOnlineManagement. La documentation de Microsoft le désigne sous le nom de module Exchange Online PowerShell V3. Il vous connecte à Exchange Online PowerShell, à Security & Compliance PowerShell ainsi qu'à PowerShell pour le module complémentaire de sécurité intégré destiné aux boîtes aux lettres locales. Il utilise l'authentification moderne, ce qui lui permet de fonctionner avec ou sans authentification multifacteur.

Un changement affecte les anciens scripts. Microsoft indique que, depuis octobre 2023, les connexions à l'API REST ont remplacé les anciennes connexions PowerShell distantes utilisant l'authentification de base. Les connexions du module n'ont pas besoin de l'authentification de base dans WinRM : il n'y a donc rien à activer à ce niveau.

Avant l'installation, vérifiez les prérequis suivants :

• Version de PowerShell et de .NET. Windows PowerShell 5.1 nécessite .NET Framework 4.7.2. Windows 11, Windows Server 2022 et Windows Server 2025 intègrent la version 4.8.x, vous êtes donc couvert sur ces systèmes. PowerShell 7 fonctionne également ; la version minimale dépend de la version du module, expliquée dans la section suivante.
• Stratégie d'exécution. La page de Microsoft indique que, sans stratégie d'exécution appropriée, vous obtenez l'erreur « Impossible de charger les fichiers, car l'exécution de scripts est désactivée sur ce système ». La correction documentée consiste à exécuter Set-ExecutionPolicy RemoteSigned en tant qu'administrateur. Lisez la page de Microsoft sur les stratégies d'exécution avant de la modifier, et demandez d'abord à votre équipe sécurité si le poste est géré.
• PowerShellGet et PackageManagement. Les connexions REST sous Windows nécessitent PowerShellGet, et PowerShellGet dépend de PackageManagement. Sans ces modules, vous risquez de voir une erreur indiquant que l’applet de commande Update-ModuleManifest est introuvable. Microsoft indique également que les versions préliminaires de ces deux modules peuvent provoquer des problèmes de connexion, et fournit une commande pour lister les versions installées : Get-InstalledModule PackageManagement -AllVersions; Get-InstalledModule PowerShellGet -AllVersions.
• TLS 1.2. Sous Windows PowerShell 5.1 avec une version ancienne de Windows, la PowerShell Gallery exige TLS 1.2 ou une version ultérieure. Si le téléchargement échoue avec une erreur de connexion sur un serveur ancien, c’est la première chose à vérifier.

Un système très ancien est une impasse. Windows 7 SP1 et Windows Server 2008 R2 SP1 ne peuvent utiliser que la version 2.0.3 du module, et Microsoft précise que cette version ne peut pas se connecter, car elle ne prend pas en charge REST.

Correspondance entre les versions de PowerShell et celles des modules

Windows PowerShell 5.1 fonctionne avec toutes les versions du module, sous réserve de la configuration .NET évoquée ci-dessus. Pour PowerShell 7, Microsoft propose la correspondance suivante :

• Le module 3.10.0 ou une version ultérieure nécessite PowerShell 7.6.0 ou une version ultérieure, qui utilise .NET 10.
• Les modules 3.5.0 à 3.9.2 nécessitent PowerShell 7.4.0 ou une version ultérieure, qui utilise .NET 8.
• Les modules 3.0.0 à 3.4.0 nécessitent PowerShell 7.2.0 ou une version ultérieure, qui utilise .NET 6.
• Le module 2.0.4 et les versions ultérieures de la branche 2.x nécessitent PowerShell 7.0.3.

Si vous avez installé la dernière version du module sur une machine dotée de PowerShell 7.4, attendez-vous à des problèmes. Mettez à jour PowerShell, ou installez une version antérieure du module avec -RequiredVersion. Au moment de la rédaction, Microsoft indique que la version 3.10.1 est la version actuelle. Vérifiez la page du module pour connaître le numéro applicable au moment de votre lecture.

Microsoft prend également en charge le module sous Linux et macOS. Sous Linux, la connexion via un proxy nécessite la version 3.0.0 du module ou une version ultérieure. Sur ces deux systèmes, Connect-IPPSSession, et donc Security & Compliance PowerShell, n’est pas disponible dans PowerShell 7. Si vous gérez Exchange Online depuis un Mac, c’est la seule limite à connaître avant de planifier vos outils.

Windows 10 mérite une brève remarque. Les éditions grand public ont atteint la fin du support en octobre 2025, et Microsoft indique qu’elles ne prennent pas en charge .NET 8.0 ni .NET 10.0. Pour le module 3.5.0 et les versions ultérieures avec PowerShell 7.4 ou une version ultérieure, seules les éditions Enterprise et IoT LTSC encore supportées fonctionnent.

Vérifiez votre version de PowerShell avant l’installation

Une vérification de deux minutes vous évite bien des suppositions par la suite. Dans la fenêtre où vous comptez travailler, exécutez $PSVersionTable.PSVersion pour connaître la version de PowerShell que vous utilisez. Comparez le résultat avec la correspondance indiquée ci-dessus. Sous Windows PowerShell 5.1, il est également utile de connaître la version de PowerShellGet : exécutez pour cela Get-InstalledModule PowerShellGet -AllVersions. Si cette commande liste une version préliminaire, supprimez-la ou passez à une version stable avant de continuer. La page du module Microsoft mentionne les versions préliminaires de PowerShellGet et de PackageManagement comme source de problèmes de connexion.

Notez le résultat à côté du nom de la machine si vous gérez plus d’une poignée de serveurs. Lorsqu’un collègue signale une connexion échouée trois mois plus tard, vous pourrez comparer les versions en quelques secondes.

Comment installer le module PowerShell d’Exchange Online étape par étape

Ces étapes fonctionnent dans Windows PowerShell 5.1 comme dans PowerShell 7.

1. Ouvrez PowerShell. Choisissez Exécuter en tant qu’administrateur si vous souhaitez installer le module pour tous les utilisateurs. Ignorez cette étape si vous prévoyez une installation pour l’utilisateur actuel uniquement.
2. Si c’est le premier module que vous installez sur la machine, mettez d’abord à jour PowerShellGet, puis fermez et rouvrez PowerShell. Microsoft recommande cet ordre avant la première installation.
3. Exécutez Install-Module -Name ExchangeOnlineManagement pour tous les utilisateurs. Pour votre seul compte, exécutez Install-Module -Name ExchangeOnlineManagement -Scope CurrentUser.
4. Répondez à toute invite affichée par PowerShell pendant l’installation. Votre organisation doit autoriser l’accès à la PowerShell Gallery pour que le téléchargement aboutisse.
5. Vérifiez l’installation avec Get-InstalledModule ExchangeOnlineManagement | Format-List Name,Version,InstalledLocation.
6. Lisez la ligne InstalledLocation. Un chemin sous %ProgramFiles%\WindowsPowerShell\Modules\ signifie que le module est installé pour tous les utilisateurs. Un chemin dans votre dossier Documents signifie qu’il est installé uniquement pour l’utilisateur actuel.
7. Testez-le dans une nouvelle fenêtre avec Connect-ExchangeOnline -UserPrincipalName admin@contoso.com. Pour les détails de connexion, consultez l’article Se connecter à Exchange Online PowerShell.

Vous voulez une version de préversion ? Ajoutez -AllowPrerelease. Pour choisir une version de préversion précise, combinez-le avec -RequiredVersion. Find-Module ExchangeOnlineManagement -AllVersions -AllowPrerelease liste les versions disponibles, tandis que sans -AllowPrerelease, seules les versions publiques sont listées. Ne déployez pas une version de préversion sur un serveur d’administration de production sans raison valable. Testez-la d’abord sur une machine de test.

Mettre à jour et désinstaller le module

Microsoft publie régulièrement de nouvelles versions du module, et les notes de version sur sa page dédiée indiquent ce qui a changé. La version 3.7.0, par exemple, a cessé de charger l’aide de l’interface de ligne de commande par défaut, et la version 3.9.2 a rendu obsolète le paramètre UseRpsSession. La mise à jour se fait en une seule ligne : Update-Module -Name ExchangeOnlineManagement. Pour une installation pour l’utilisateur actuel, ajoutez -Scope CurrentUser. Microsoft recommande d’utiliser la même étendue que celle utilisée pour l’installation. Une incohérence peut vous laisser avec une installation à deux endroits et sans savoir clairement laquelle PowerShell utilise.

C’est la raison pour laquelle il vaut la peine d’exécuter la vérification Get-InstalledModule de l’étape 5 avant et après une mise à jour. Si vous voyez deux versions, déterminez à quelle étendue appartient chacune d’elles.

Pour supprimer le module, exécutez Uninstall-Module -Name ExchangeOnlineManagement. S’il a été installé pour tous les utilisateurs, procédez en tant qu’administrateur. Fermez ensuite vos fenêtres PowerShell ouvertes, car un module déjà chargé reste en mémoire jusqu’à la fin de sa session.

Corriger les erreurs d’installation courantes

La page du module de Microsoft répertorie quelques erreurs spécifiques et leurs corrections.

• « No match was found for the specified search criteria and module name 'ExchangeOnlineManagement' ». Exécutez Register-PSRepository -Default, ce qui enregistre à nouveau la PowerShell Gallery comme référentiel. Essayez ensuite de relancer l’installation.
• Erreurs concernant PowerShellGetFormatVersion, ou impossibilité de télécharger les fournisseurs. Mettez à jour PowerShellGet et redémarrez PowerShell.
• Le téléchargement échoue sur un ordinateur équipé de l’ancien Windows PowerShell 5.1. La PowerShell Gallery exige TLS 1.2 ou une version ultérieure. Microsoft renvoie vers un billet de blog sur la prise en charge de TLS par la galerie pour plus de détails.
• « Files cannot be loaded because running scripts is disabled on this system ». Définissez la stratégie d’exécution comme décrit ci-dessus, en tant qu’administrateur.
• « Cannot find a cmdlet Update-Manifest » ou un message similaire concernant Update-ModuleManifest lors de la connexion. PowerShellGet ou PackageManagement est absent. Installez les deux, puis redémarrez PowerShell.

Si une installation réussit mais que la connexion échoue ensuite avec une étrange erreur d’assembly, la cause est généralement un autre module dans la même session. Ouvrez une nouvelle fenêtre et connectez-vous en premier.

Erreurs courantes

• Mélanger les étendues. Installer le module pour tous les utilisateurs, puis le mettre à jour avec -Scope CurrentUser, laisse deux versions sur la machine. Choisissez une étendue et conservez-la.
• Utiliser une version de PowerShell inadaptée au module. Le module le plus récent ne fonctionne pas avec une version plus ancienne de PowerShell 7, et les erreurs obtenues ressemblent à des erreurs de connexion. Comparez vos versions avec le tableau ci-dessus.
• Installer une version de préversion sur un hôte de production. Les versions de préversion sont destinées aux tests. Utilisez la version publique pour le travail quotidien.
• Ignorer PowerShellGet. Une version absente ou de préversion de PowerShellGet peut casser les connexions REST, comme le décrit la page de Microsoft. Vérifiez-la en premier lorsqu’une installation récente ne parvient pas à se connecter.
• Suivre d’anciens tutoriels. Les guides qui vous demandent d’activer l’authentification de base dans WinRM décrivent l’ancienne méthode PowerShell à distance, désormais retirée. Vous n’en avez pas besoin.

Sujets connexes à explorer

• Se connecter avec le module : une fois celui-ci installé, la question suivante est de savoir comment vous connecter, avec ou sans MFA, sujet traité dans l’article sur le module Exchange Online PowerShell et son article complémentaire sur la connexion.
• Authentification sans utilisateur (app-only) : les scripts planifiés nécessitent un certificat ou une identité managée, et non un mot de passe saisi.
• Utiliser le module dans PowerShell 7 sous Linux et macOS : les versions prises en charge varient selon le système d’exploitation, vérifiez donc d’abord la liste de compatibilité.
• Contrôler qui peut utiliser PowerShell : un administrateur Exchange peut activer ou désactiver l’accès à Exchange Online PowerShell utilisateur par utilisateur.
• Maintenir les modules à jour : programmez un rappel régulier pour vérifier la disponibilité de nouvelles versions du module, car Microsoft relève de temps à autre la version minimale de PowerShell requise.

Prochaine étape

Pour installer le module Exchange Online PowerShell, exécutez Install-Module -Name ExchangeOnlineManagement, vérifiez l’installation avec Get-InstalledModule, et conservez le même périmètre d’installation pour toutes les mises à jour ultérieures. Connectez-vous ensuite avec Connect-ExchangeOnline dans une nouvelle fenêtre et exécutez Get-AcceptedDomain pour vérifier que la configuration fonctionne.