Moduły Exchange Online i Microsoft Graph nie działają razem w jednym runbooku Azure Automation
By Mirko Peters ·
Każdy moduł działa osobno, ale połączenie z Exchange Online i Microsoft Graph w tym samym runbooku kończy się błędami ładowania modułów. Dowiesz się, dlaczego wersje się ze sobą kłócą i jak przetestować przypięte środowisko uruchomieniowe.
Automatically translated with AI from the original post. Read the English original
Testowy runbook łączy się z Exchange Online przy użyciu swojej tożsamości zarządzanej i odczytuje skrzynkę pocztową. Działa. Drugi testowy runbook łączy się z Microsoft Graph tą samą tożsamością i odczytuje użytkownika. Też działa. Umieść oba w jednym runbooku, a zacznie się błąd.
Najważniejsze wnioski
- Błędy to niepowodzenia ładowania modułów, a nie błędy uprawnień. Nadanie większych uprawnień ich nie naprawi.
- Potwierdzona poprawka społeczności z 2024 roku wskazała przyczynę: oba moduły ładują do jednego procesu różne wersje System.Text.Json, a moduł załadowany jako pierwszy wygrywa.
- W wątku z marca 2026 roku obejście polegało na utworzeniu nowego środowiska uruchomieniowego PowerShell 7.4 i użyciu ExchangeOnlineManagement 3.5.0, ale autor pytania nie przetestował jeszcze rzeczywistego skryptu.
- Microsoft Learn podaje, że ExchangeOnlineManagement 3.10.0 lub nowszy wymaga PowerShell 7.6, a jego strona o środowiskach Automation wymienia 5.1 i 7.4. Przypnij moduł i przetestuj w panelu testowym, zanim opublikujesz runbook.
To właśnie wątek Microsoft Q&A z marca 2026 roku, od którego zaczyna się ten artykuł. Pasuje do starszego wątku Tech Community z 2024 roku, który doprowadził do poprawki potwierdzonej przez autora pytania. Ten artykuł wyjaśnia przyczynę, pokazuje, co Microsoft Learn mówi o wersjach i środowiskach uruchomieniowych, i przedstawia plan testów. To poradnik rozwiązywania problemów, a nie oficjalna procedura Microsoft.
Objawy
Autor z marca 2026 roku używał tożsamości zarządzanej przypisanej do systemu, Connect-ExchangeOnline -ManagedIdentity -Organization <tenant>.onmicrosoft.com, a następnie Connect-MgGraph -Identity. Zaimportowano ExchangeOnlineManagement w wersji 3.9.2 oraz kilka modułów Microsoft.Graph. Pojawiły się następujące błędy:
- Środowisko 5.1:
Connect-MgGraphznaleziono w moduleMicrosoft.Graph.Authentication, ale nie udało się załadować tego modułu. - Środowisko 7.2:
Unable to find type [Microsoft.Exchange.Management.RestApiClient.ExchangeEnvironment].
Wątek z 2024 roku, dotyczący pulpitu z Windows PowerShell 5.1, pokazywał błąd IDX12729: Unable to decode the header ... as Base64Url encoded string oraz komunikat „method not found” wskazujący na System.Text.Json.Utf8JsonReader. Inny uczestnik tego wątku zobaczył Connect-MgGraph: Invalid JWT access token, gdy w tej samej sesji użyto Connect-IPPSSession.
Wszystkie te błędy dotyczą ładowania modułu lub działania w czasie wykonania. Nie są to komunikaty Authorization_RequestDenied ani odmowy dostępu. Ta różnica ma znaczenie, ponieważ odpowiedź wygenerowana przez AI w wątku z marca instruowała pytającego, aby przydzielił uprawnienie Exchange.ManageAsApp oraz rolę Exchange Administrator. To rzeczywiste wymagania wstępne, ale dotyczą autoryzacji i nie naprawią modułu, który się nie wczytuje.
Dlaczego to się dzieje
W wątku z 2024 roku odpowiedź członka społeczności (Silver Contributor, nie pracownik Microsoftu) została oznaczona jako rozwiązanie. Wskazywała, że oba moduły ładują własną kopię pliku System.Text.Json.dll do tego samego procesu PowerShell. Exchange Online 3.5.1 zawierał wersję 8.0.x, a Microsoft.Graph.Authentication używał wersji 6.0.x. PowerShell przechowuje w jednym procesie tylko jedną wersję zestawu, więc ten moduł, który wczyta się jako pierwszy, wygrywa, a drugi może zakończyć się błędem.
Pytający w tym wątku usunął moduły Graph przed połączeniem, zaktualizował oba moduły i wyczyścił pamięć podręczną MSAL. Nic z tego nie pomogło. Po powrocie do ExchangeOnlineManagement 3.4.0 pytający napisał, że działa. Inni uczestnicy zgłaszali to samo rozwiązanie. Jeden z nich zauważył poprawę przy wersji 3.6.0, ale połączenie Connect-IPPSSession oparte na certyfikacie nadal kończyło się błędem. Jeden z uczestników zgłosił, że ustawienie -LogLevel na Default zamiast All naprawiło problem w jego teście. Dokumentacja Learn nie wspomina o tym ustawieniu, więc traktuj to jako zgłoszenie społeczności.
Moderator-wolontariusz (MVP) w wątku z 2026 roku przedstawił podobne wyjaśnienie. Moduły zależą od dodatkowych plików binarnych, które nie są zgodne między zespołami, więc być może trzeba będzie łączyć wersje modułów i hostów PowerShell.
Learn nie opisuje konfliktu System.Text.Json. Wymienia natomiast w informacjach o wydaniu ExchangeOnlineManagement 3.6.0 pozycję "Added fix for compatibility issue with the Microsoft.Graph module" (dodano poprawkę problemu ze zgodnością z modułem Microsoft.Graph). Nie podaje żadnych szczegółów.
Krok 1: Ustal, jakiego rodzaju masz błąd
- Uruchom każde połączenie osobno w testowym runbooku. Jeśli oba działają osobno, masz konflikt, a nie problem z uprawnieniami.
- Skopiuj pierwszy wiersz błędu. Wszystko, co dotyczy ładowania modułu, typu lub metody, oznacza konflikt.
Forbidden,Access deniedlubAuthorization_RequestDeniedoznaczają problem z uprawnieniami. - W przypadku problemów z uprawnieniami postępuj zgodnie ze stroną Learn o tożsamościach zarządzanych dla Exchange. Wymaga ona przydzielenia tożsamości uprawnienia API
Exchange.ManageAsApporaz roli Entra, takiej jak Exchange Administrator. Learn zaznacza, że rola Security Administrator nie ma wymaganych uprawnień do tych zadań.
Krok 2: Sprawdź, jaką wersję zestawu wymaga każdy moduł
Wątek z 2024 roku sugerował sprawdzenie wersji załadowanego zestawu w nowej sesji, po jednym module naraz. Podsumowanie wątku nie pokazuje dokładnego polecenia. Poniższe polecenie to ogólne sprawdzenie platformy .NET, a nie polecenie z Learn ani z wątku, więc przetestuj je na zapasowym komputerze. Zaimportuj jeden moduł, a następnie uruchom:
``powershell (Get-Item -Path "$([System.Text.Json.Utf8JsonReader].Assembly.Location)").VersionInfo ``
Powtórz w nowej sesji z drugim modułem. Jeśli wersje się różnią, masz konflikt opisany w tym wątku. Używaj tych samych wersji modułów co w runbooku.
Krok 3: Przypnij wersje w osobnym środowisku uruchomieniowym
Pytający z marca 2026 roku rozwiązał przypadek testowy, tworząc nowe środowisko uruchomieniowe. Wątek nie podaje kroków klikania. Strona Learn o środowiskach uruchomieniowych już tak:
- W portalu Azure otwórz konto Automation. Na stronie Przegląd wybierz Wypróbuj środowisko uruchomieniowe, jeśli nie jesteś już w tym widoku.
- W sekcji Process Automation wybierz Środowiska uruchomieniowe, a następnie Utwórz.
- Na karcie Podstawy wpisz nazwę, wybierz PowerShell jako język i 7.4 jako wersję środowiska uruchomieniowego. Learn podaje, że język i wersji nie można zmienić później.
- Na karcie Pakiety pakiet Az jest dodawany domyślnie. Użyj Dodaj z galerii, aby dodać ExchangeOnlineManagement w przypisanej wersji oraz moduły Microsoft.Graph, których używasz. W wątku dla Exchange Online użyto wersji 3.5.0.
- Wybierz Utwórz.
- Połącz kopię swojego runbooka. W sekcji Runbooki zaznacz go, a następnie wybierz Zaktualizuj środowisko uruchomieniowe.
- Otwórz runbook, wybierz Edytuj w portalu, wskaż nowe środowisko, a następnie Panel testowy i Uruchom. Publikuj tylko wtedy, gdy test się powiedzie.
Learn zaznacza, że import pakietu może potrwać kilka minut, że można dodać naraz do 10 pakietów oraz że w nowym środowisku okno Modules jest zastąpione przez środowiska uruchomieniowe.
Wybór wersji do przypięcia zależy od środowiska uruchomieniowego:
- Learn podaje, że ExchangeOnlineManagement w wersji 3.10.0 i nowszych wymaga PowerShell 7.6.0 lub nowszego ze względu na zależności zestawów .NET 10. Na jego stronie o środowiskach uruchomieniowych jako możliwe wybory wymienione są 5.1 i 7.4. Środowisko 7.4 wymaga więc wersji starszej niż 3.10.0. Jest to wniosek wyciągnięty z dwóch stron Learn, a nie stwierdzenie zawarte na żadnej z nich, dlatego warto sprawdzić, co oferuje Twoje konto.
- Learn wymienia problemy dla wersji od 3.7.0 do 3.9.2 w systemach Ubuntu 20.04 i 18.04 oraz wskazuje 3.9.2 jako najnowszą wersję dla niektórych starszych platform. Uwagi te dotyczą systemów desktopowych, a nie usługi Automation.
- Test przeprowadzony w wątku z marca korzystał z wersji 3.5.0 na 7.4. Autor pytania dodał komentarz, że właściwy skrypt nie był jeszcze testowany, więc nie istnieje potwierdzona odpowiedź dotycząca wersji 3.9.x na 7.4.
- Środowisko 5.1 nie uniknęło konfliktu w wątku z marca, gdzie na 5.1 z wersją 3.9.2 wystąpił błąd.
Przetestuj co najmniej dwie kombinacje, na przykład przypiętą wersję Exchange z najnowszymi modułami Graph oraz z pewną starszą wersją Graph. Learn ostrzega, że wersje preview modułów PackageManagement lub PowerShellGet mogą powodować problemy z połączeniem, dlatego używaj wersji opublikowanych.
Krok 4: rozważ podział pracy
Jeśli żadna kombinacja nie działa, unikaj ładowania obu modułów w jednym procesie. Na przykład niech jeden runbook wykonuje część dotyczącą Exchange, a inny część dotyczącą Graph, i uruchamiaj drugi z pierwszego. Wynika to z przyczyny podanej we wątku z 2024 roku. Żaden z wątków tego nie testował, więc najpierw przygotuj mały dowód koncepcji.
Sprawdź też, czy Graph może zastąpić polecenia Exchange w Twoim skrypcie. Strona Learn o Exchange podkreśla to dla czterech poleceń dotyczących grup Microsoft 365, na przykład New-UnifiedGroup, które według niej nie mogą być używane z tożsamością zarządzaną, i gdzie zaleca się Graph. W przypadku pozostałych zadań nie zakładaj, że Graph ma odpowiednik.
Weryfikacja
- W panelu Test dane wyjściowe zadania pokazują oba połączenia oraz po jednym wyniku z każdej usługi.
- Uruchom opublikowany runbook według harmonogramu lub ręcznie i sprawdź strumienie zadania pod kątem ostrzeżeń dotyczących ładowania zestawów.
- Zapisz dokładne wersje modułów oraz środowisko uruchomieniowe. Późniejsza aktualizacja w galerii może zepsuć działającą konfigurację. Przypinanie wersji chroni Cię tylko wtedy, gdy nie zmieniasz wersji.
Ograniczenia
- Wątek z 2024 roku jest starszy niż zwykle brane pod uwagę okno czasowe i dotyczy klasycznego Windows PowerShell na komputerze. Uwzględniono go, ponieważ wskazuje przyczynę i ma potwierdzony wynik.
- Rozwiązanie z wątku z 2026 roku jest pierwszym testem, a nie zweryfikowaną poprawką produkcyjną.
- Strona Learn o uwierzytelnianiu tożsamością zarządzaną dla Exchange nadal wymienia środowiska uruchomieniowe 5.1 i 7.1 (Preview) podczas dodawania modułu, co różni się od strony o środowiskach uruchomieniowych. Aktualne środowiska sprawdzaj na stronie o środowiskach uruchomieniowych.
- Learn nie dokumentuje samego konfliktu. Przyczynę podaje ekspert ze społeczności.
Powiązane
Źródła
- Microsoft Learn: moduł Exchange Online PowerShell (wersje i wymagania)
- Microsoft Learn: Używanie tożsamości zarządzanych platformy Azure do łączenia się z programem Exchange Online PowerShell
- Microsoft Learn: Zarządzanie środowiskami uruchomieniowymi w usłudze Azure Automation
- Microsoft Learn: Microsoft Graph PowerShell authentication commands
- Microsoft Q&A: Brak możliwości połączenia z usługami Exchange Online i Graph w tym samym runbooku (marzec 2026)
- Microsoft Community Hub: Exchange Online i MGGraph zakłócają swoje działanie (2024)