Exchange-Online- und Microsoft-Graph-Module schlagen gemeinsam in einem Azure-Automation-Runbook fehl
Von Mirko Peters ·
Jedes Modul funktioniert für sich allein. Doch die Verbindung zu Exchange Online und Microsoft Graph im selben Runbook scheitert mit Fehlern beim Laden der Module. Erfahren Sie, warum die Versionen kollidieren und wie Sie eine fixierte Laufzeitumgebung testen.
Automatisch mit KI aus dem Originalbeitrag übersetzt. Englisches Original lesen
Ein Test-Runbook verbindet sich mit seiner verwalteten Identität mit Exchange Online und liest ein Postfach. Das funktioniert. Ein zweites Test-Runbook verbindet sich mit derselben Identität mit Microsoft Graph und liest einen Benutzer. Auch das funktioniert. Führen Sie beide jedoch in einem Runbook zusammen, schlägt es fehl.
Das Wichtigste in Kürze
- Bei den Fehlern handelt es sich um Fehler beim Laden der Module, nicht um Berechtigungsfehler. Mehr Rechte zu vergeben behebt sie daher nicht.
- Eine bestätigte Lösung aus der Community von 2024 benennt die Ursache: Beide Module laden unterschiedliche Versionen von System.Text.Json in denselben Prozess, und das Modul, das zuerst geladen wird, setzt sich durch.
- Ein Thread vom März 2026 umging das Problem mit einer neuen PowerShell-7.4-Laufzeitumgebung und ExchangeOnlineManagement 3.5.0. Der Fragesteller hatte das echte Skript jedoch noch nicht getestet.
- Learn nennt für ExchangeOnlineManagement 3.10.0 oder neuer PowerShell 7.6, während die Seite zur Automation-Laufzeitumgebung 5.1 und 7.4 auflistet. Fixieren Sie das Modul und testen Sie im Testbereich, bevor Sie veröffentlichen.
Das ist der Microsoft-Q&A-Thread vom März 2026, von dem dieser Artikel ausgeht. Er deckt sich mit einem älteren Tech-Community-Thread aus dem Jahr 2024, in dem der Fragesteller eine Lösung bestätigte. Dieser Artikel erklärt die Ursache, zeigt, was Microsoft Learn zu Versionen und Laufzeitumgebungen sagt, und liefert einen Testplan. Es handelt sich um eine Anleitung zur Fehlerbehebung, nicht um ein offizielles Microsoft-Verfahren.
Symptome
Der Fragesteller vom März 2026 verwendete eine systemseitig zugewiesene verwaltete Identität, Connect-ExchangeOnline -ManagedIdentity -Organization <tenant>.onmicrosoft.com gefolgt von Connect-MgGraph -Identity. Importiert wurden ExchangeOnlineManagement in Version 3.9.2 und mehrere Microsoft.Graph-Module. Die Fehler lauteten:
- Laufzeit 5.1:
Connect-MgGraphwurde im ModulMicrosoft.Graph.Authenticationgefunden, das Modul konnte jedoch nicht geladen werden. - Laufzeit 7.2:
Unable to find type [Microsoft.Exchange.Management.RestApiClient.ExchangeEnvironment].
Der Thread von 2024 zeigte auf einem Desktop mit Windows PowerShell 5.1 die Meldung IDX12729: Unable to decode the header ... as Base64Url encoded string sowie einen Fehler „method not found“, der System.Text.Json.Utf8JsonReader nannte. Ein anderer Teilnehmer dort erhielt Connect-MgGraph: Invalid JWT access token, als in derselben Sitzung Connect-IPPSSession verwendet wurde.
Alle diese Fehler treten beim Laden eines Moduls oder zur Laufzeit auf. Es handelt sich nicht um Authorization_RequestDenied oder Meldungen zu fehlenden Zugriffsrechten. Dieser Unterschied ist wichtig, denn eine KI-generierte Antwort im Thread vom März riet dem Fragesteller, das Recht Exchange.ManageAsApp zu erteilen und die Rolle Exchange-Administrator zuzuweisen. Das sind echte Voraussetzungen, sie betreffen aber die Autorisierung und können ein Modul, das nicht geladen wird, nicht beheben.
Warum es passiert
Im Thread von 2024 wurde eine Antwort eines Community-Mitglieds (ein Silver Contributor, kein Microsoft-Mitarbeiter) als Lösung markiert. Darin hieß es, beide Module laden jeweils eine eigene Kopie von System.Text.Json.dll in denselben PowerShell-Prozess. Exchange Online 3.5.1 lieferte Version 8.0.x aus, und Microsoft.Graph.Authentication verwendete eine Version 6.0.x. PowerShell behält pro Prozess nur eine Version einer Assembly. Daher setzt sich das Modul durch, das zuerst geladen wird, und das zweite kann fehlschlagen.
Der Fragesteller in diesem Thread entfernte die Graph-Module vor der Verbindung, aktualisierte beide Module und leerte den MSAL-Cache. Nichts davon half. Nach dem Zurücksetzen auf ExchangeOnlineManagement 3.4.0 schrieb der Fragesteller, dass es funktioniere. Andere Beiträge berichteten dieselbe Lösung. Ein weiterer Beitrag meldete eine Verbesserung mit 3.6.0, bei zertifikatbasiertem Connect-IPPSSession schlug es aber weiterhin fehl. Ein Teilnehmer berichtete, dass das Setzen von -LogLevel auf Default statt All das Problem in seinem Test behoben habe. Learn erwähnt diese Einstellung nicht. Behandeln Sie sie daher als Erfahrungsbericht aus der Community.
Ein ehrenamtlicher Moderator (ein MVP) gab im Thread von 2026 eine ähnliche Erklärung. Die Module hängen von zusätzlichen Binärdateien ab, die zwischen den Teams nicht abgestimmt sind. Unter Umständen müssen Sie daher Modulversionen und PowerShell-Hosts unterschiedlich kombinieren.
Learn beschreibt den System.Text.Json-Konflikt nicht. In den Versionshinweisen zu ExchangeOnlineManagement 3.6.0 steht jedoch der Eintrag „Added fix for compatibility issue with the Microsoft.Graph module“. Weitere Details nennt Learn nicht.
Schritt 1: Die Art des Fehlers bestimmen
- Führen Sie jede Verbindung allein in einem Testrunbook aus. Funktionieren beide allein, liegt ein Konflikt vor und kein Berechtigungsproblem.
- Kopieren Sie die erste Fehlerzeile. Alles, was sich auf das Laden eines Moduls, eines Typs oder einer Methode bezieht, ist ein Konflikt.
Forbidden,Access deniedoderAuthorization_RequestDeniedweisen dagegen auf ein Berechtigungsproblem hin. - Bei Berechtigungsproblemen folgen Sie der Learn-Seite zur verwalteten Identität für Exchange. Dafür muss der Identität die API-Berechtigung
Exchange.ManageAsAppzugewiesen sein, außerdem eine Entra-Rolle wie Exchange-Administrator. Laut der Learn-Seite verfügt die Rolle Sicherheitsadministrator nicht über die benötigten Berechtigungen für diese Aufgaben.
Schritt 2: Die Assembly-Version prüfen, die jedes Modul verwendet
Der Thread von 2024 schlug vor, die geladene Assembly-Version in einer neuen Sitzung zu prüfen, jeweils für ein Modul. Die Zusammenfassung des Threads zeigt den genauen Befehl nicht. Der folgende Befehl ist eine allgemeine .NET-Prüfung. Er stammt weder von Learn noch aus dem Thread, testen Sie ihn daher auf einem Ersatzrechner. Importieren Sie ein Modul und führen Sie dann aus:
``powershell (Get-Item -Path "$([System.Text.Json.Utf8JsonReader].Assembly.Location)").VersionInfo ``
Wiederholen Sie dies in einer neuen Sitzung mit dem anderen Modul. Unterscheiden sich die Versionen, liegt der Konflikt aus dem Thread vor. Verwenden Sie dieselben Modulversionen wie im Runbook.
Schritt 3: Versionen in einer separaten Laufzeitumgebung fixieren
Der Fragesteller vom März 2026 hat den Testfall gelöst, indem er eine neue Laufzeitumgebung erstellte. Der Thread beschreibt die einzelnen Schritte nicht. Die Learn-Seite zu Laufzeitumgebungen schon:
- Öffnen Sie im Azure-Portal das Automation-Konto. Wählen Sie unter Overview die Option Try Runtime Environment experience, falls Sie sich noch nicht in dieser Ansicht befinden.
- Wählen Sie unter Process Automation die Option Runtime Environments und dann Erstellen.
- Geben Sie unter Grundlagen einen Namen ein, wählen Sie PowerShell als Sprache und 7.4 als Laufzeitversion. Laut Learn lassen sich Sprache und Version später nicht mehr ändern.
- Unter Pakete wird standardmäßig das Az-Paket hinzugefügt. Verwenden Sie Aus Galerie hinzufügen, um ExchangeOnlineManagement in einer fixierten Version sowie die aufgerufenen Microsoft.Graph-Module hinzuzufügen. Der Thread verwendete für Exchange Online die Version 3.5.0.
- Wählen Sie Erstellen.
- Verknüpfen Sie eine Kopie Ihres Runbooks. Wählen Sie es unter Runbooks aus und dann Update Runtime Environment.
- Öffnen Sie das Runbook, wählen Sie Edit in Portal, anschließend die neue Umgebung, dann Test pane und Start. Veröffentlichen Sie nur, wenn der Test erfolgreich ist.
Learn weist darauf hin, dass der Import eines Pakets mehrere Minuten dauern kann, dass Sie bis zu 10 Pakete gleichzeitig hinzufügen können und dass im neuen Erlebnis das Blatt „Module“ durch Laufzeitumgebungen ersetzt wird.
Welche Version Sie festlegen sollten, hängt von der Laufzeitumgebung ab:
- Learn nennt für ExchangeOnlineManagement ab Version 3.10.0 aufgrund von Abhängigkeiten zu .NET-10-Assemblys PowerShell 7.6.0 oder höher. Auf der Seite zu Laufzeitumgebungen werden 5.1 und 7.4 als Auswahlmöglichkeiten genannt. Eine Laufzeitumgebung 7.4 benötigt daher eine Version vor 3.10.0. Dies ist eine Schlussfolgerung aus zwei Learn-Seiten und keine Aussage einer der beiden Seiten selbst. Prüfen Sie daher, welche Version Ihr Konto tatsächlich bereitstellt.
- Learn führt für die Versionen 3.7.0 bis 3.9.2 Probleme unter Ubuntu 20.04 und 18.04 auf und nennt 3.9.2 als neueste Version für einige ältere Plattformen. Diese Hinweise betreffen Desktop-Plattformen, nicht Automation.
- Der eigene Test im März-Thread verwendete 3.5.0 auf 7.4. Der Fragesteller ergänzte in einem Kommentar, dass das eigentliche Skript noch nicht getestet wurde. Für 3.9.x auf 7.4 gibt es daher keine bestätigte Antwort.
- Runtime 5.1 hat den Konflikt im März-Thread nicht vermieden. Dort schlug der Vorgang auf 5.1 mit 3.9.2 fehl.
Testen Sie mindestens zwei Kombinationen, zum Beispiel Ihre festgelegte Exchange-Version mit den neuesten Graph-Modulen sowie mit einer älteren Graph-Version. Learn warnt, dass Vorabversionen von PackageManagement oder PowerShellGet Verbindungsprobleme verursachen können. Verwenden Sie daher die veröffentlichten Versionen.
Schritt 4: Erwägen Sie, die Aufgaben aufzuteilen
Wenn keine Kombination funktioniert, vermeiden Sie es, beide Module in einem Prozess zu laden. Lassen Sie beispielsweise ein Runbook den Exchange-Teil und ein anderes den Graph-Teil erledigen und starten Sie das zweite aus dem ersten heraus. Dieser Ansatz ergibt sich aus der Ursache, die im Thread von 2024 genannt wird. Keiner der beiden Threads hat ihn getestet. Erstellen Sie daher zuerst einen kleinen Proof of Concept.
Prüfen Sie außerdem, ob Graph die Exchange-Cmdlets in Ihrem Skript ersetzen kann. Die Exchange-Seite von Learn nennt dies für vier Cmdlets für Microsoft-365-Gruppen, etwa New-UnifiedGroup. Laut Learn lassen diese sich nicht mit einer verwalteten Identität verwenden, weshalb Learn Graph empfiehlt. Gehen Sie bei anderen Aufgaben nicht davon aus, dass Graph ein gleichwertiges Cmdlet bietet.
Überprüfen
- Im Testbereich zeigt die Auftragsausgabe beide Verbindungen und je ein Ergebnis von jedem Dienst.
- Führen Sie das veröffentlichte Runbook über einen Zeitplan oder einen manuellen Start aus und prüfen Sie die Auftragsstreams auf Warnungen zum Laden von Assemblys.
- Notieren Sie die genauen Modulversionen und die Laufzeitumgebung. Ein späteres Update in der Galerie kann ein funktionierendes Setup beschädigen. Das Festlegen von Versionen schützt Sie nur, solange Sie die Versionen nicht ändern.
Einschränkungen
- Der Thread von 2024 ist älter als üblich und verwendete die klassische Windows PowerShell auf dem Desktop. Er ist trotzdem enthalten, weil er die Ursache benennt und ein bestätigtes Ergebnis hat.
- Die Lösung im Thread von 2026 ist ein erster Test und keine geprüfte Lösung für den Produktivbetrieb.
- Die Learn-Seite zur verwalteten Identität für Exchange erwähnt beim Hinzufügen des Moduls noch die Laufzeiten 5.1 und 7.1 (Vorschau). Das weicht von der Seite zu Laufzeitumgebungen ab. Verwenden Sie für aktuelle Laufzeiten die Seite zu Laufzeitumgebungen.
- Learn dokumentiert den Konflikt selbst nicht. Die Ursache stammt von einem Community-Experten.
Weitere Informationen
Quellen
- Microsoft Learn: Exchange Online PowerShell-Modul (Versionen und Anforderungen)
- Microsoft Learn: Azure-verwaltete Identitäten für die Verbindung mit Exchange Online PowerShell verwenden
- Microsoft Learn: Laufzeitumgebungen in Azure Automation verwalten
- Microsoft Learn: Authentifizierungsbefehle für Microsoft Graph PowerShell
- Microsoft Q&A: Verbindung zu Exchange Online und Graph im selben Runbook nicht möglich (März 2026)
- Microsoft Community Hub: Exchange Online und MGGraph beeinflussen sich gegenseitig (2024)