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

Blog · Mirko Peters

Modul Exchange Online dan Microsoft Graph Gagal Bersamaan dalam Satu Runbook Azure Automation

By ·

Setiap modul berfungsi sendiri-sendiri, tetapi saat menyambung ke Exchange Online dan Microsoft Graph dalam runbook yang sama, muncul kesalahan pemuatan modul. Pelajari mengapa versinya saling bertentangan dan cara menguji lingkungan runtime yang dipasang versinya (pinned).

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

Sebuah runbook uji menyambung ke Exchange Online dengan managed identity-nya dan membaca sebuah kotak surat. Ini berfungsi. Runbook uji kedua menyambung ke Microsoft Graph dengan identitas yang sama dan membaca sebuah pengguna. Ini juga berfungsi. Namun, saat keduanya digabung dalam satu runbook, proses gagal.

Poin Penting

  • Kesalahannya adalah kegagalan pemuatan modul, bukan kesalahan izin. Memberikan hak akses tambahan tidak akan memperbaikinya.
  • Perbaikan komunitas tahun 2024 yang telah dikonfirmasi menyebutkan penyebabnya: kedua modul memuat versi System.Text.Json yang berbeda ke dalam satu proses, dan modul yang dimuat lebih dulu yang menang.
  • Sebuah utas Maret 2026 mengatasinya dengan lingkungan runtime PowerShell 7.4 yang baru dan ExchangeOnlineManagement 3.5.0, tetapi penanya belum menguji skrip yang sebenarnya.
  • Learn menyatakan ExchangeOnlineManagement 3.10.0 atau yang lebih baru memerlukan PowerShell 7.6, sedangkan halaman runtime Automation-nya hanya mencantumkan 5.1 dan 7.4. Pasang versi modul secara tetap (pin) dan uji di panel Test sebelum menerbitkan.

Itulah utas Microsoft Q&A Maret 2026 tempat artikel ini bermula. Utas ini sejalan dengan utas Tech Community tahun 2024 yang mencapai perbaikan dan dikonfirmasi oleh penanyanya. Artikel ini menjelaskan penyebabnya, memaparkan apa yang dikatakan Microsoft Learn tentang versi dan runtime, serta memberikan rencana pengujian. Ini adalah panduan pemecahan masalah, bukan prosedur resmi Microsoft.

Gejala

Penanya Maret 2026 menggunakan managed identity yang ditetapkan sistem, Connect-ExchangeOnline -ManagedIdentity -Organization <tenant>.onmicrosoft.com diikuti Connect-MgGraph -Identity. ExchangeOnlineManagement versi 3.9.2 dan beberapa modul Microsoft.Graph diimpor. Kesalahannya adalah:

  • Runtime 5.1: Connect-MgGraph ditemukan dalam modul Microsoft.Graph.Authentication, tetapi modul tersebut tidak dapat dimuat.
  • Runtime 7.2: Unable to find type [Microsoft.Exchange.Management.RestApiClient.ExchangeEnvironment].

Utas 2024, pada desktop dengan Windows PowerShell 5.1, menampilkan IDX12729: Unable to decode the header ... as Base64Url encoded string serta kesalahan "method not found" yang menyebut System.Text.Json.Utf8JsonReader. Penanya lain di utas tersebut melihat Connect-MgGraph: Invalid JWT access token saat Connect-IPPSSession digunakan dalam sesi yang sama.

Semua ini adalah error saat pemuatan atau runtime. Bukan pesan Authorization_RequestDenied atau access-denied. Perbedaan ini penting, karena sebuah jawaban yang dihasilkan AI di thread Maret memberi tahu penanya untuk memberikan Exchange.ManageAsApp dan peran Exchange Administrator. Itu memang prasyarat yang nyata, tetapi keduanya mengatasi otorisasi dan tidak bisa memperbaiki modul yang gagal dimuat.

Mengapa hal ini terjadi

Di thread 2024, balasan dari anggota komunitas (seorang Silver Contributor, bukan karyawan Microsoft) ditandai sebagai solusi. Balasan itu menyatakan bahwa kedua modul memuat salinan System.Text.Json.dll masing-masing ke dalam proses PowerShell yang sama. Exchange Online 3.5.1 menyertakan versi 8.0.x, sedangkan Microsoft.Graph.Authentication menggunakan versi 6.0.x. PowerShell hanya menyimpan satu versi assembly per proses, sehingga modul yang dimuat lebih dulu yang menang, dan modul kedua bisa gagal.

Penanya di thread tersebut menghapus modul Graph sebelum terhubung, memperbarui kedua modul, dan menghapus cache MSAL. Tidak ada yang membantu. Setelah kembali ke ExchangeOnlineManagement 3.4.0, penanya menulis bahwa cara itu berhasil. Peserta lain melaporkan perbaikan yang sama. Satu peserta lain melaporkan adanya perbaikan dengan 3.6.0, tetapi Connect-IPPSSession berbasis sertifikat tetap gagal untuk mereka. Satu peserta melaporkan bahwa mengatur -LogLevel ke Default, bukan All, memperbaiki masalah dalam pengujian mereka. Learn tidak menyebutkan pengaturan itu, jadi anggap ini sebagai laporan komunitas.

Seorang moderator sukarelawan (seorang MVP) di thread 2026 memberikan penjelasan serupa. Modul-modul tersebut bergantung pada binary tambahan yang tidak selaras antar-tim, sehingga Anda mungkin perlu mencampur versi modul dan host PowerShell.

Learn tidak menjelaskan konflik System.Text.Json. Namun, dalam catatan rilis ExchangeOnlineManagement 3.6.0, terdapat item "Added fix for compatibility issue with the Microsoft.Graph module". Tidak ada rincian lebih lanjut.

Langkah 1: Pastikan jenis error yang Anda alami

  1. Jalankan setiap koneksi secara terpisah di runbook uji. Jika keduanya berfungsi saat dijalankan sendiri, berarti Anda menghadapi konflik, bukan masalah izin.
  2. Salin baris error pertama. Apa pun yang berkaitan dengan pemuatan modul, tipe, atau method menandakan konflik. Forbidden, Access denied, atau Authorization_RequestDenied menandakan masalah izin.
  3. Untuk masalah izin, ikuti halaman managed identity Learn untuk Exchange. Halaman itu mensyaratkan izin API Exchange.ManageAsApp ditetapkan ke identity tersebut dan peran Entra seperti Exchange Administrator. Catatan Learn menyebutkan bahwa Security Administrator tidak memiliki izin yang diperlukan untuk tugas tersebut.

Langkah 2: Lihat versi assembly yang diminta setiap modul

Thread 2024 menyarankan untuk memeriksa versi assembly yang dimuat dalam sesi baru, satu modul pada satu waktu. Ringkasan thread tidak menampilkan perintah yang tepat. Perintah di bawah ini adalah pemeriksaan .NET umum, bukan berasal dari Learn maupun thread, jadi uji di mesin cadangan. Impor satu modul, lalu jalankan:

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

Ulangi di sesi baru dengan modul lainnya. Jika versinya berbeda, berarti Anda menghadapi konflik yang dibahas di thread tersebut. Gunakan versi modul yang sama seperti di runbook.

Langkah 3: Kunci versi di lingkungan runtime terpisah

Penanya pada Maret 2026 menyelesaikan kasus uji dengan membuat lingkungan runtime baru. Thread tidak menjelaskan langkah kliknya. Halaman runtime environment Learn menjelaskannya:

  1. Di Azure portal, buka Automation account. Pada Overview, pilih Try Runtime Environment experience jika Anda belum berada di dalamnya.
  2. Di bawah Process Automation, pilih Runtime Environments, lalu Create.
  3. Pada Basics, masukkan nama, pilih PowerShell sebagai bahasa dan 7.4 sebagai versi runtime. Learn menyatakan bahwa bahasa dan versi tidak dapat diubah nantinya.
  4. Pada Packages, paket Az ditambahkan secara default. Gunakan Add from gallery untuk menambahkan ExchangeOnlineManagement dengan versi yang dikunci, serta modul Microsoft.Graph yang Anda panggil. Thread menggunakan 3.5.0 untuk Exchange Online.
  5. Pilih Create.
  6. Tautkan salinan runbook Anda. Di bawah Runbooks, pilih runbook tersebut, lalu Update Runtime Environment.
  7. Buka runbook, Edit in Portal, pilih lingkungan baru, lalu Test pane dan Start. Publikasikan hanya jika pengujian berhasil.

Learn mencatat bahwa mengimpor paket bisa memakan waktu beberapa menit, bahwa Anda dapat menambahkan hingga 10 paket sekaligus, dan bahwa blade Modules digantikan oleh lingkungan runtime di pengalaman baru.

Versi mana yang perlu dikunci bergantung pada runtime:

  • Learn menyebutkan bahwa ExchangeOnlineManagement 3.10.0 dan yang lebih baru memerlukan PowerShell 7.6.0 atau yang lebih baru karena dependensi assembly .NET 10. Halaman runtime-nya menyebut 5.1 dan 7.4 sebagai pilihan. Dengan demikian, runtime 7.4 memerlukan versi yang lebih lama dari 3.10.0. Ini adalah kesimpulan yang ditarik dari dua halaman Learn, bukan pernyataan dari salah satunya, jadi pastikan versi apa yang tersedia di akun Anda.
  • Learn mencantumkan masalah untuk 3.7.0 hingga 3.9.2 pada Ubuntu 20.04 dan 18.04, dan menyebut 3.9.2 sebagai versi terbaru untuk beberapa platform lama. Catatan tersebut berkaitan dengan platform desktop, bukan Automation.
  • Pengujian yang dilakukan sendiri dalam utas Maret menggunakan 3.5.0 pada 7.4. Penanya menambahkan komentar bahwa skrip yang sebenarnya belum diuji, sehingga belum ada jawaban yang terkonfirmasi untuk 3.9.x pada 7.4.
  • Runtime 5.1 tidak menghindari konflik dalam utas Maret, yang gagal pada 5.1 dengan 3.9.2.

Uji setidaknya dua kombinasi, misalnya versi Exchange yang Anda kunci dengan modul Graph terbaru, dan dengan versi Graph yang lebih lama. Learn memperingatkan bahwa versi preview dari PackageManagement atau PowerShellGet dapat menyebabkan masalah koneksi, jadi gunakan versi yang sudah dirilis.

Langkah 4: Pertimbangkan untuk memisahkan pekerjaan

Jika tidak ada kombinasi yang berhasil, hindari memuat kedua modul dalam satu proses. Misalnya, biarkan satu runbook menangani bagian Exchange dan runbook lain menangani bagian Graph, lalu jalankan runbook kedua dari runbook pertama. Pendekatan ini mengikuti penyebab yang dijelaskan dalam utas 2024. Tidak ada utas yang mengujinya, jadi buat bukti konsep kecil terlebih dahulu.

Periksa juga apakah Graph dapat menggantikan cmdlet Exchange dalam skrip Anda. Halaman Exchange di Learn menyoroti hal ini untuk empat cmdlet Microsoft 365 Group, seperti New-UnifiedGroup, yang menurut Learn tidak dapat digunakan dengan managed identity dan untuk itu Learn merekomendasikan Graph. Untuk tugas lain, jangan berasumsi Graph memiliki padanannya.

Verifikasi

  1. Di panel Test, output job menampilkan kedua koneksi dan satu hasil dari masing-masing layanan.
  2. Jalankan runbook yang sudah dipublikasikan melalui jadwal atau dengan memulai secara manual, lalu periksa aliran job untuk peringatan terkait pemuatan assembly.
  3. Catat versi modul yang tepat dan runtime-nya. Pembaruan galeri di kemudian hari dapat merusak pengaturan yang sudah berfungsi. Penguncian versi hanya melindungi Anda selama Anda tidak mengubah versinya.

Batasan

  • Utas 2024 lebih lama dari rentang waktu yang biasa dan menggunakan Windows PowerShell desktop. Utas ini tetap disertakan karena menyebutkan penyebabnya dan memiliki hasil yang terkonfirmasi.
  • Solusi dalam utas 2026 merupakan pengujian awal, bukan perbaikan produksi yang terverifikasi.
  • Halaman managed identity Exchange di Learn masih menyebutkan runtime 5.1 dan 7.1 (Preview) saat Anda menambahkan modul, yang berbeda dengan halaman lingkungan runtime. Gunakan halaman lingkungan runtime untuk runtime terkini.
  • Learn tidak mendokumentasikan konflik itu sendiri. Penyebabnya berasal dari seorang pakar komunitas.

Terkait

Sumber

Entities in this article

Azure Automation Exchange Online PowerShell Microsoft Graph PowerShell Managed identity

Related articles

RSS