M365Con 2027 – gratis online conferentie · 11–22 Jan 2027 · 120 sessions→ m365con.net

Blog · Mirko Peters

Exchange Online- en Microsoft Graph-modules falen samen in één Azure Automation-runbook

By ·

Elke module werkt op zichzelf, maar als je in dezelfde runbook verbinding maakt met Exchange Online en Microsoft Graph, loopt het mis met fouten bij het laden van de modules. Lees waarom de versies met elkaar botsen en hoe je een vastgezette runtimeomgeving test.

Automatically translated with AI from the original post. Read the English original

Een testrunbook maakt met de beheerde identiteit verbinding met Exchange Online en leest een postvak. Dat werkt. Een tweede testrunbook maakt met dezelfde identiteit verbinding met Microsoft Graph en leest een gebruiker. Ook dat werkt. Zet je beide in één runbook, dan faalt het.

Belangrijkste punten

  • De fouten zijn laadfouten van modules, geen machtigingsfouten. Meer rechten toekennen lost ze niet op.
  • Een bevestigde oplossing uit de community uit 2024 benoemde de oorzaak: beide modules laden verschillende versies van System.Text.Json in één proces, en de module die als eerste laadt, wint.
  • Een discussie uit maart 2026 heeft het probleem omzeild met een nieuwe PowerShell 7.4-runtimeomgeving en ExchangeOnlineManagement 3.5.0, maar de vraagsteller had het echte script nog niet getest.
  • Learn zegt dat ExchangeOnlineManagement 3.10.0 of later PowerShell 7.6 nodig heeft, terwijl de runtimepagina van Automation 5.1 en 7.4 noemt. Zet de module vast en test in het testvenster voordat je publiceert.

Dit is de Microsoft Q&A-discussie uit maart 2026 waarmee dit artikel begint. Die komt overeen met een oudere Tech Community-discussie uit 2024, waarin wel een oplossing is bereikt die door de vraagsteller is bevestigd. Dit artikel legt de oorzaak uit, laat zien wat Microsoft Learn zegt over versies en runtimes, en geeft een testplan. Het is een probleemoplossingsgids, geen officiële procedure van Microsoft.

Symptomen

De vraagsteller uit maart 2026 gebruikte een door het systeem toegewezen beheerde identiteit, Connect-ExchangeOnline -ManagedIdentity -Organization <tenant>.onmicrosoft.com gevolgd door Connect-MgGraph -Identity. ExchangeOnlineManagement versie 3.9.2 en verschillende Microsoft.Graph-modules waren geïmporteerd. De fouten waren:

  • Runtime 5.1: Connect-MgGraph werd gevonden in de module Microsoft.Graph.Authentication, maar de module kon niet worden geladen.
  • Runtime 7.2: Unable to find type [Microsoft.Exchange.Management.RestApiClient.ExchangeEnvironment].

De discussie uit 2024, op een desktop met Windows PowerShell 5.1, toonde IDX12729: Unable to decode the header ... as Base64Url encoded string en een "method not found"-fout waarin System.Text.Json.Utf8JsonReader werd genoemd. Een andere deelnemer zag daar Connect-MgGraph: Invalid JWT access token wanneer Connect-IPPSSession in dezelfde sessie werd gebruikt.

Alle hiervan zijn laad- of runtimefouten. Het gaat niet om Authorization_RequestDenied- of toegangsgeweigerd-meldingen. Dat verschil is belangrijk, want in de draad van maart gaf een door AI gegenereerd antwoord de vraagsteller de opdracht om Exchange.ManageAsApp toe te kennen en de rol Exchange Administrator toe te wijzen. Dat zijn echte vereisten, maar ze gaan over autorisatie en kunnen een module die niet laadt niet repareren.

Waarom het gebeurt

In de draad uit 2024 werd een antwoord van een communitylid (een Silver Contributor, geen medewerker van Microsoft) als oplossing gemarkeerd. Daarin stond dat beide modules hun eigen kopie van System.Text.Json.dll in hetzelfde PowerShell-proces laden. ExchangeOnlineManagement 3.5.1 leverde versie 8.0.x, en Microsoft.Graph.Authentication gebruikte een 6.0.x-versie. PowerShell houdt per proces maar één versie van een assembly bij, dus de module die als eerste laadt wint, en de tweede kan falen.

De vraagsteller in die draad verwijderde de Graph-modules vóór het verbinden, werkte beide modules bij en wiste de MSAL-cache. Niets daarvan hielp. Na terugschakelen naar ExchangeOnlineManagement 3.4.0 schreef de vraagsteller dat het werkte. Andere reageerders meldden dezelfde oplossing. Eén reageerder meldde een verbetering met 3.6.0, maar voor hem bleef Connect-IPPSSession met certificaat mislukken. Eén reageerder meldde dat het instellen van -LogLevel op Default in plaats van All het in zijn test oploste. Learn vermeldt die instelling niet, dus behandel dit als een melding uit de community.

Een vrijwillige moderator (een MVP) gaf in de draad van 2026 een vergelijkbare verklaring. De modules zijn afhankelijk van aanvullende binaries die tussen de teams niet op elkaar zijn afgestemd, dus het kan nodig zijn om modulversies en PowerShell-hosts te combineren.

Learn beschrijft het conflict rond System.Text.Json niet. Wel staat in de releasenotes van ExchangeOnlineManagement 3.6.0 een item "Added fix for compatibility issue with the Microsoft.Graph module". Verdere details ontbreken.

Stap 1: bepaal welk type fout je hebt

  1. Voer elke verbinding afzonderlijk uit in een testrunbook. Werken beide apart, dan is er sprake van een conflict en niet van een machtigingsprobleem.
  2. Kopieer de eerste foutregel. Alles over het laden van een module, type of methode is een conflict. Forbidden, Access denied of Authorization_RequestDenied is een machtigingsprobleem.
  3. Bij machtigingsproblemen volg je de pagina over managed identities voor Exchange van Learn. Daarvoor moet de API-machtiging Exchange.ManageAsApp aan de identiteit zijn toegekend, plus een Entra-rol zoals Exchange Administrator. Volgens Learn heeft de rol Security Administrator niet de benodigde machtigingen voor die taken.

Stap 2: bekijk welke assemblyversie elke module vraagt

In de draad uit 2024 werd voorgesteld de geladen assemblyversie in een nieuwe sessie te controleren, één module per keer. De samenvatting van de draad toont het exacte commando niet. Het onderstaande commando is een algemene .NET-controle, niet van Learn of uit de draad, dus test het op een reservemachine. Importeer één module en voer daarna uit:

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

Herhaal dit in een nieuwe sessie met de andere module. Verschillen de versies, dan heb je het conflict uit die draad. Gebruik dezelfde modulversies als in de runbook.

Stap 3: pin versies in een aparte runtimeomgeving

De vraagsteller van maart 2026 loste de testcase op door een nieuwe runtimeomgeving aan te maken. De draad geeft de klikstappen niet. De pagina over runtimeomgevingen van Learn wel:

  1. Open in de Azure-portal het Automation-account. Selecteer op Overview de optie Try Runtime Environment experience als je er nog niet in zit.
  2. Selecteer onder Process Automation de optie Runtime Environments en daarna Create.
  3. Voer op Basics een naam in, kies PowerShell als taal en 7.4 als runtimeversie. Learn zegt dat taal en versie later niet meer te wijzigen zijn.
  4. Op Packages wordt het Az-pakket standaard toegevoegd. Gebruik Add from gallery om ExchangeOnlineManagement toe te voegen op een vastgezette versie, samen met de Microsoft.Graph-modules die je aanroept. De draad gebruikte 3.5.0 voor Exchange Online.
  5. Selecteer Maken.
  6. Koppel een kopie van je runbook. Selecteer die onder Runbooks en kies daarna Update Runtime Environment.
  7. Open de runbook, kies Edit in Portal, selecteer de nieuwe omgeving en klik daarna op Test pane en Start. Publiceer alleen als de test slaagt.

Learn meldt dat het importeren van een pakket enkele minuten kan duren, dat je tot 10 pakketten tegelijk kunt toevoegen en dat het Modules-blade in de nieuwe ervaring wordt vervangen door runtimeomgevingen.

Welke versie je vastzet, hangt af van de runtime:

  • Learn zegt dat ExchangeOnlineManagement 3.10.0 en later PowerShell 7.6.0 of hoger nodig hebben vanwege afhankelijkheden van .NET 10-assembly's. De runtimepagina noemt 5.1 en 7.4 als keuzes. Een 7.4-runtime heeft dus een versie nodig die ouder is dan 3.10.0. Dit is een conclusie uit twee Learn-pagina's, geen uitspraak van een van beide. Controleer dus wat je account aanbiedt.
  • Learn beschrijft problemen voor 3.7.0 tot en met 3.9.2 op Ubuntu 20.04 en 18.04, en noemt 3.9.2 als de nieuwste versie voor sommige oudere platforms. Die opmerkingen gaan over desktopplatforms, niet over Automation.
  • De eigen test in de draad van maart gebruikte 3.5.0 op 7.4. De vraagsteller voegde een reactie toe dat het echte script nog niet getest was, dus er bestaat geen bevestigd antwoord voor 3.9.x op 7.4.
  • Runtime 5.1 voorkwam het conflict in de draad van maart niet; die mislukte op 5.1 met 3.9.2.

Test minstens twee combinaties, bijvoorbeeld je vastgezette Exchange-versie met de nieuwste Graph-modules, en met een oudere Graph-versie. Learn waarschuwt dat previewversies van PackageManagement of PowerShellGet verbindingsproblemen kunnen veroorzaken, dus gebruik de uitgebrachte versies.

Stap 4: overweeg het werk te splitsen

Als geen enkele combinatie werkt, laad dan niet beide modules in hetzelfde proces. Laat bijvoorbeeld het ene runbook het Exchange-deel doen en een ander runbook het Graph-deel, en start het tweede vanuit het eerste. Dit volgt uit de oorzaak die in de draad uit 2024 wordt genoemd. Geen van beide draden heeft dit getest, dus bouw eerst een kleine proof of concept.

Controleer ook of Graph de Exchange-cmdlets in je script kan vervangen. De Exchange-pagina van Learn maakt dit punt voor vier Microsoft 365 Group-cmdlets, zoals New-UnifiedGroup. Volgens Learn kunnen die niet met managed identity worden gebruikt, en adviseert Learn daar Graph. Voor andere taken moet je niet aannemen dat Graph een equivalent heeft.

Verifiëren

  1. In het deelvenster Test toont de taakuitvoer beide verbindingen en één resultaat van elke service.
  2. Voer het gepubliceerde runbook uit via een schema of een handmatige start, en controleer de taakstreams op waarschuwingen over het laden van assembly's.
  3. Noteer de exacte modulversies en de runtime. Een latere update in de galerie kan een werkende opzet breken. Vastzetten beschermt je alleen zolang je de versies niet wijzigt.

Beperkingen

  • De draad uit 2024 is ouder dan het gebruikelijke tijdvenster en gebruikte desktop-Windows PowerShell. Hij is opgenomen omdat hij de oorzaak noemt en een bevestigde uitkomst heeft.
  • De oplossing in de draad uit 2026 is een eerste test, geen geverifieerde oplossing voor productie.
  • De Learn-pagina over managed identity voor Exchange noemt bij het toevoegen van de module nog runtime 5.1 en 7.1 (preview), wat afwijkt van de pagina over runtimeomgevingen. Gebruik voor actuele runtimes de pagina over runtimeomgevingen.
  • Learn documenteert het conflict zelf niet. De oorzaak komt van een expert uit de community.

Gerelateerd

Bronnen

Entities in this article

Azure Automation Exchange Online PowerShell Microsoft Graph PowerShell Managed identity

Related articles

RSS