M365Con 2027 – conférence en ligne gratuite · 11–22 Jan 2027 · 120 sessions→ m365con.net

Blog · Mirko Peters

Les modules Exchange Online et Microsoft Graph échouent ensemble dans un même runbook Azure Automation

Par ·

Chaque module fonctionne seul, mais la connexion à Exchange Online et à Microsoft Graph dans un même runbook échoue avec des erreurs de chargement de modules. Découvrez pourquoi les versions entrent en conflit et comment tester un environnement d’exécution à version figée.

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

Un runbook de test se connecte à Exchange Online avec son identité managée et lit une boîte aux lettres. Ça fonctionne. Un second runbook de test se connecte à Microsoft Graph avec la même identité et lit un utilisateur. Ça fonctionne aussi. Placez les deux dans un même runbook : l’échec se produit.

Points clés

  • Les erreurs sont des échecs de chargement de modules, et non des erreurs d’autorisation. Accorder davantage de droits ne les corrigera pas.
  • Une solution de la communauté confirmée en 2024 a identifié la cause : les deux modules chargent des versions différentes de System.Text.Json dans un même processus, et le module chargé en premier l’emporte.
  • Un fil de discussion de mars 2026 a contourné le problème à l’aide d’un nouvel environnement d’exécution PowerShell 7.4 et du module ExchangeOnlineManagement 3.5.0, mais l’auteur de la question n’avait pas encore testé le script réel.
  • Learn indique que ExchangeOnlineManagement 3.10.0 ou une version ultérieure nécessite PowerShell 7.6, alors que sa page sur les environnements d’exécution Automation répertorie 5.1 et 7.4. Figez la version du module et testez-la dans le volet Test avant de publier.

C’est le fil de discussion Microsoft Q&A de mars 2026 dont part cet article. Il recoupe un fil plus ancien de Tech Community, datant de 2024, qui avait abouti à une solution confirmée par son auteur. Cet article explique la cause, présente ce que Microsoft Learn indique sur les versions et les environnements d’exécution, et propose un plan de test. Il s’agit d’un guide de dépannage, et non d’une procédure officielle de Microsoft.

Symptômes

L’auteur de la question de mars 2026 utilisait une identité managée attribuée par le système, avec Connect-ExchangeOnline -ManagedIdentity -Organization <tenant>.onmicrosoft.com suivi de Connect-MgGraph -Identity. Le module ExchangeOnlineManagement en version 3.9.2 et plusieurs modules Microsoft.Graph avaient été importés. Les erreurs étaient les suivantes :

  • Environnement 5.1 : Connect-MgGraph a bien été trouvée dans le module Microsoft.Graph.Authentication, mais ce module n’a pas pu être chargé.
  • Environnement 7.2 : Unable to find type [Microsoft.Exchange.Management.RestApiClient.ExchangeEnvironment].

Le fil de 2024, sur un poste de bureau avec Windows PowerShell 5.1, affichait IDX12729: Unable to decode the header ... as Base64Url encoded string ainsi qu’une erreur « method not found » mentionnant System.Text.Json.Utf8JsonReader. Un autre intervenant y a obtenu Connect-MgGraph: Invalid JWT access token lorsque Connect-IPPSSession était utilisé dans la même session.

Toutes ces erreurs sont des erreurs de chargement ou d’exécution. Ce ne sont pas des messages Authorization_RequestDenied ni des refus d’accès. Cette distinction compte, car une réponse générée par IA dans le fil de mars recommandait d’accorder Exchange.ManageAsApp et le rôle Administrateur Exchange. Ce sont de véritables prérequis, mais ils concernent l’autorisation et ne peuvent pas corriger un module qui ne se charge pas.

Pourquoi cela se produit

Dans le fil de 2024, une réponse d’un membre de la communauté (un Silver Contributor, et non un collaborateur Microsoft) a été marquée comme solution. Elle expliquait que les deux modules chargent chacun leur propre copie de System.Text.Json.dll dans le même processus PowerShell. ExchangeOnlineManagement 3.5.1 livre la version 8.0.x, tandis que Microsoft.Graph.Authentication utilise une version 6.0.x. PowerShell ne conserve qu’une seule version d’un assembly par processus. Le premier module chargé l’emporte donc, et le second peut échouer.

Le demandeur de ce fil a supprimé les modules Graph avant la connexion, mis à jour les deux modules et vidé le cache MSAL. Rien de tout cela n'a résolu le problème. Après être revenu à ExchangeOnlineManagement 3.4.0, le demandeur a indiqué que cela fonctionnait. D'autres intervenants ont signalé la même solution. Un autre intervenant a constaté une amélioration avec la version 3.6.0, mais la commande Connect-IPPSSession basée sur un certificat échouait toujours dans son cas. Un intervenant a indiqué qu'en remplaçant -LogLevel par Default au lieu de All, le problème était résolu dans son test. Learn ne mentionne pas ce paramètre : il faut donc le considérer comme un retour de la communauté.

Un modérateur bénévole (un MVP) du fil de 2026 a donné une explication similaire. Les modules dépendent de binaires supplémentaires qui ne sont pas alignés d’une équipe à l’autre. Il peut donc être nécessaire de combiner des versions de modules et des hôtes PowerShell différents.

Learn ne décrit pas le conflit System.Text.Json. Les notes de version de ExchangeOnlineManagement 3.6.0 mentionnent toutefois un élément « Added fix for compatibility issue with the Microsoft.Graph module », sans aucun détail.

Étape 1 : identifier le type d’erreur

  1. Exécutez chaque connexion seule dans un runbook de test. Si les deux fonctionnent isolément, il s’agit d’un conflit, et non d’un problème d’autorisation.
  2. Copiez la première ligne d’erreur. Tout message concernant le chargement d’un module, d’un type ou d’une méthode indique un conflit. Forbidden, Access denied ou Authorization_RequestDenied indiquent un problème d’autorisation.
  3. Pour les problèmes d’autorisation, suivez la page de Learn sur les identités managées pour Exchange. Elle exige que l’API Exchange.ManageAsApp soit attribuée à l’identité, ainsi qu’un rôle Entra tel que Administrateur Exchange. Selon Learn, le rôle Administrateur de la sécurité ne dispose pas des autorisations nécessaires pour ces tâches.

Étape 2 : vérifier la version d’assembly demandée par chaque module

Le fil de 2024 suggérait de vérifier la version de l’assembly chargé dans une session neuve, module par module. Le résumé du fil ne montre pas la commande exacte. La commande ci-dessous est une vérification .NET générique, qui ne provient ni de Learn ni du fil. Testez-la donc sur une machine de secours. Importez un module, puis exécutez :

``powershell (Get-Item -Path "$([System.Text.Json.Utf8JsonReader].Assembly.Location)").VersionInfo ``

Répétez l’opération dans une nouvelle session avec l’autre module. Si les versions diffèrent, vous êtes face au conflit décrit dans ce fil. Utilisez les mêmes versions de modules que dans le runbook.

Étape 3 : figer les versions dans un environnement d’exécution distinct

L’auteur de la question de mars 2026 a résolu le cas de test en créant un nouvel environnement d’exécution. Le fil ne détaille pas les étapes. La page de Learn sur les environnements d’exécution, elle, les décrit :

  1. Dans le portail Azure, ouvrez le compte Automation. Sous Vue d’ensemble, sélectionnez Essayer l’expérience Runtime Environment si vous n’y êtes pas déjà.
  2. Sous Process Automation, sélectionnez Environnements d’exécution, puis Créer.
  3. Sous Notions de base, saisissez un nom, choisissez PowerShell comme langage et 7.4 comme version d’exécution. Learn précise que le langage et la version ne peuvent plus être modifiés ensuite.
  4. Sous Packages, le package Az est ajouté par défaut. Utilisez Ajouter depuis la galerie pour ajouter ExchangeOnlineManagement dans une version figée, ainsi que les modules Microsoft.Graph que vous appelez. Le fil utilisait la version 3.5.0 pour Exchange Online.
  5. Sélectionnez Créer.
  6. Liez une copie de votre runbook. Sous Runbooks, sélectionnez-le, puis Mettre à jour l’environnement d’exécution.
  7. Ouvrez le runbook, puis Modifier dans le portail, choisissez le nouvel environnement, puis le Volet de test et Démarrer. Ne publiez que si le test réussit.

Learn indique que l’importation d’un package peut prendre plusieurs minutes, que vous pouvez en ajouter jusqu’à 10 à la fois, et que le volet Modules est remplacé par les environnements d’exécution dans la nouvelle expérience.

La version à épingler dépend de l’environnement d’exécution :

  • Learn indique que ExchangeOnlineManagement 3.10.0 et les versions ultérieures nécessitent PowerShell 7.6.0 ou ultérieur, en raison des dépendances d’assemblages .NET 10. Sa page sur les environnements d’exécution cite 5.1 et 7.4 comme choix. Un environnement 7.4 nécessite donc une version antérieure à 3.10.0. Il s’agit d’une conclusion tirée de deux pages Learn, et non d’une affirmation figurant dans l’une ou l’autre. Vérifiez donc ce que votre compte propose.
  • Learn signale des problèmes pour les versions 3.7.0 à 3.9.2 sur Ubuntu 20.04 et 18.04, et indique 3.9.2 comme dernière version pour certaines anciennes plateformes. Ces remarques concernent les plateformes de bureau, et non Automation.
  • Le test réalisé dans le fil de mars utilisait la version 3.5.0 sur 7.4. L’auteur de la question a ajouté un commentaire indiquant que le script réel n’était pas encore testé ; il n’existe donc aucune réponse confirmée pour 3.9.x sur 7.4.
  • L’environnement d’exécution 5.1 n’a pas évité le conflit du fil de mars, qui a échoué sur 5.1 avec 3.9.2.

Testez au moins deux combinaisons, par exemple la version d’Exchange épinglée avec les modules Graph les plus récents, puis avec une version plus ancienne de Graph. Learn avertit que les versions en préversion de PackageManagement ou de PowerShellGet peuvent provoquer des problèmes de connexion ; utilisez donc les versions publiées.

Étape 4 : envisagez de répartir le travail

Si aucune combinaison ne fonctionne, évitez de charger les deux modules dans un même processus. Par exemple, laissez un runbook gérer la partie Exchange et un autre la partie Graph, puis démarrez le second depuis le premier. Cela découle de la cause indiquée dans le fil de 2024. Aucun des deux fils ne l’a testé ; réalisez donc d’abord une petite preuve de concept.

Vérifiez aussi si Graph peut remplacer les applets Exchange de votre script. La page Exchange de Learn le précise pour quatre applets de groupes Microsoft 365, comme New-UnifiedGroup, qui, selon elle, ne peuvent pas être utilisées avec une identité managée et pour lesquelles elle recommande Graph. Pour les autres tâches, ne supposez pas qu’un équivalent existe dans Graph.

Vérification

  1. Dans le volet Test, la sortie du travail affiche les deux connexions et un résultat pour chaque service.
  2. Exécutez le runbook publié via une planification ou un démarrage manuel, et vérifiez les flux du travail pour détecter d’éventuels avertissements liés au chargement des assemblages.
  3. Notez les versions exactes des modules et l’environnement d’exécution. Une mise à jour ultérieure de la galerie peut casser une configuration qui fonctionne. L’épinglage ne vous protège que tant que vous ne modifiez pas les versions.

Limites

  • Le fil de 2024 est plus ancien que la période habituelle et utilisait Windows PowerShell de bureau. Il est retenu parce qu’il nomme la cause et qu’il présente un résultat confirmé.
  • La solution du fil de 2026 constitue un premier test, et non une correction de production vérifiée.
  • La page de Learn sur l’identité managée d’Exchange mentionne encore les environnements 5.1 et 7.1 (préversion) lors de l’ajout du module, ce qui diffère de la page sur les environnements d’exécution. Utilisez la page sur les environnements d’exécution pour les versions actuelles.
  • Learn ne documente pas le conflit lui-même. La cause provient d’un expert de la communauté.

Ressources associées

Sources

Entités dans cet article

Azure Automation Exchange Online PowerShell Microsoft Graph PowerShell Managed identity

Articles associés

RSS