1 つの Azure Automation Runbook で Exchange Online と Microsoft Graph のモジュールが同時に失敗する
By Mirko Peters ·
それぞれのモジュールは単独では動作しますが、同じ Runbook で Exchange Online と Microsoft Graph に接続すると、モジュールの読み込みエラーで失敗します。バージョンが競合する理由と、バージョンを固定したランタイム環境をテストする方法を説明します。
Automatically translated with AI from the original post. Read the English original
テスト用の Runbook が、マネージド ID を使って Exchange Online に接続し、メールボックスを読み取ります。これは動作します。別のテスト用 Runbook が、同じ ID で Microsoft Graph に接続し、ユーザーを読み取ります。こちらも動作します。両方を 1 つの Runbook にまとめると、失敗します。
重要なポイント
- エラーはモジュールの読み込みに失敗しているためで、アクセス許可のエラーではありません。権限を追加しても解決しません。
- 確認された 2024 年のコミュニティの修正で原因が特定されました。両方のモジュールが異なる System.Text.Json のバージョンを 1 つのプロセスに読み込み、先に読み込まれたモジュールが優先されるというものです。
- 2026 年 3 月のスレッドでは、新しい PowerShell 7.4 のランタイム環境と ExchangeOnlineManagement 3.5.0 を使って回避されていましたが、質問者はまだ実際のスクリプトをテストしていませんでした。
- Learn では、ExchangeOnlineManagement 3.10.0 以降には PowerShell 7.6 が必要とされていますが、Automation のランタイムのページには 5.1 と 7.4 しか記載されていません。モジュールのバージョンを固定し、公開する前にテスト ウィンドウで確認してください。
これは、この記事の出発点となった 2026 年 3 月の Microsoft Q&A のスレッドです。2024 年の古い Tech Community のスレッドと内容が一致しており、そちらでは質問者が確認した修正に至っていました。この記事では、原因を説明し、バージョンとランタイムについて Microsoft Learn が何と述べているかを示したうえで、テスト計画を提示します。これは公式な Microsoft の手順ではなく、トラブルシューティング ガイドです。
兆候
2026 年 3 月の質問者は、システム割り当てのマネージド ID を使用し、Connect-ExchangeOnline -ManagedIdentity -Organization <tenant>.onmicrosoft.com を実行した後に Connect-MgGraph -Identity を実行していました。ExchangeOnlineManagement バージョン 3.9.2 と複数の Microsoft.Graph モジュールがインポートされていました。発生したエラーは次のとおりです:
- ランタイム 5.1:
Connect-MgGraphはモジュールMicrosoft.Graph.Authentication内で見つかりましたが、そのモジュールを読み込めませんでした。 - ランタイム 7.2:
Unable to find type [Microsoft.Exchange.Management.RestApiClient.ExchangeEnvironment]
2024年のスレッドでは、Windows PowerShell 5.1を使用したデスクトップ環境で、IDX12729: Unable to decode the header ... as Base64Url encoded string というエラーと、System.Text.Json.Utf8JsonReader の名前を含む「method not found」エラーが報告されていました。同じスレッドの別の投稿者は、同じセッションで Connect-IPPSSession を使用した際に Connect-MgGraph: Invalid JWT access token を確認していました。
これらはすべて読み込みまたは実行時のエラーです。Authorization_RequestDenied やアクセス拒否のメッセージではありません。この違いは重要です。3 月のスレッドでは、AI が生成した回答が質問者に Exchange.ManageAsApp の付与と Exchange Administrator ロールの割り当てを勧めていました。これらは実際に必要な前提条件ですが、認可に関するものであり、モジュールが読み込めない問題は解決できません。
発生する理由
2024 年のスレッドでは、コミュニティメンバー(Silver Contributor であり、Microsoft の社員ではありません)の返信が解決策としてマークされました。その返信によると、両方のモジュールが同じ PowerShell プロセスに System.Text.Json.dll の独自のコピーを読み込むとのことです。Exchange Online 3.5.1 はバージョン 8.0.x を含み、Microsoft.Graph.Authentication は 6.0.x のバージョンを使用していました。PowerShell はプロセスごとにアセンブリの 1 つのバージョンしか保持しないため、先に読み込まれたモジュールのバージョンが優先され、後のモジュールが失敗することがあります。
そのスレッドの質問者は、接続前に Graph モジュールを削除し、両方のモジュールを更新し、MSAL キャッシュをクリアしました。しかし、いずれも効果はありませんでした。ExchangeOnlineManagement 3.4.0 に戻したところ動作したと、質問者は書いています。他の投稿者からも同じ解決策が報告されています。3.6.0 で改善したという報告が 1 件ありましたが、証明書ベースの Connect-IPPSSession は依然として失敗したとのことです。また、テストでは All ではなく Default に -LogLevel を設定すると解決したという投稿者も 1 人いました。Learn にはこの設定についての記載がないため、コミュニティからの報告として扱ってください。
2026 年のスレッドでは、ボランティアのモデレーター(MVP)が同様の説明をしています。モジュールは、チーム間で整合していない追加のバイナリに依存しているため、モジュールのバージョンと PowerShell ホストを組み合わせて調整する必要があるかもしれない、とのことです。
Learn には System.Text.Json の競合についての説明はありません。ただし、ExchangeOnlineManagement 3.6.0 のリリースノートには「Microsoft.Graph モジュールとの互換性の問題に対する修正を追加」という項目があります。詳細は記載されていません。
手順 1: 発生しているエラーの種類を確認する
- テスト用のランブックで、各接続を単独で実行してください。両方とも単独で動作するなら、問題はアクセス許可ではなく競合です。
- 最初のエラー行をコピーします。モジュール、型、メソッドの読み込みに関するものは競合です。
Forbidden、Access denied、Authorization_RequestDeniedはアクセス許可の問題です。 - アクセス許可の問題については、Exchange のマネージド ID に関する Learn のページに従ってください。ID に
Exchange.ManageAsAppAPI アクセス許可を割り当て、Exchange Administrator などの Entra ロールを付与する必要があります。Learn には、Security Administrator はこれらの作業に必要な権限を持たないと記載されています。
手順 2: 各モジュールが要求するアセンブリのバージョンを確認する
2024 年のスレッドでは、新しいセッションで 1 つずつモジュールを確認し、読み込まれたアセンブリのバージョンをチェックすることが提案されていました。スレッドの要約には正確なコマンドは示されていません。以下のコマンドは一般的な .NET の確認方法であり、Learn やスレッドからの引用ではないため、予備のマシンでテストしてください。モジュールを 1 つ読み込んだ後、次を実行します:
``powershell (Get-Item -Path "$([System.Text.Json.Utf8JsonReader].Assembly.Location)").VersionInfo ``
新しいセッションで、もう一方のモジュールについても繰り返してください。バージョンが異なる場合、そのスレッドで見られた競合です。ランブックで使用しているものと同じモジュールバージョンを使用してください。
手順 3: 別のランタイム環境でバージョンを固定する
2026 年 3 月の質問者は、新しいランタイム環境を作成することでテストケースを解決しました。スレッドには操作手順は記載されていません。Learn のランタイム環境のページには、以下の手順が記載されています:
- Azure ポータルで Automation アカウントを開きます。概要 で、まだ Runtime Environment のエクスペリエンスを使用していない場合は、Try Runtime Environment experience を選択します。
- Process Automation の下で Runtime Environments を選択し、次に 作成 を選択します。
- 基本 で、名前を入力し、言語として PowerShell、ランタイム バージョンとして 7.4 を選択します。Learn によると、言語とバージョンは後から変更できません。
- パッケージ では、Az パッケージがデフォルトで追加されています。Add from gallery を使用して、固定したバージョンの ExchangeOnlineManagement と、呼び出す Microsoft.Graph モジュールを追加します。スレッドでは Exchange Online に 3.5.0 を使用していました。
- Create を選択します。
- ランブックのコピーをリンクします。Runbooks で該当するランブックを選択し、次に Update Runtime Environment を選択します。
- ランブックを開き、Edit in Portal を選択して新しい環境を選びます。次に Test pane と Start を選択します。テストが成功した場合にのみ発行してください。
Microsoft Learn によると、パッケージのインポートには数分かかる場合があり、一度に最大 10 個のパッケージを追加できます。新しいエクスペリエンスでは、[モジュール] ブレードはランタイム環境に置き換えられています。
どのバージョンを固定すべきかは、ランタイムによって異なります:
- Microsoft Learn では、ExchangeOnlineManagement 3.10.0 以降は .NET 10 のアセンブリ依存関係があるため、PowerShell 7.6.0 以降が必要とされています。ランタイムのページでは、選択肢として 5.1 と 7.4 が挙げられています。したがって、7.4 ランタイムでは 3.10.0 より古いバージョンが必要になります。これは 2 つの Microsoft Learn のページから導いた結論であり、どちらかのページに直接書かれた内容ではありません。お使いのアカウントで提供されているバージョンを必ず確認してください。
- Microsoft Learn には、Ubuntu 20.04 および 18.04 における 3.7.0 から 3.9.2 までの問題が挙げられており、一部の古いプラットフォームでは 3.9.2 が最新バージョンとして示されています。これらの注記はデスクトップ プラットフォームに関するものであり、Automation には当てはまりません。
- 3 月のスレッドのテストでは、7.4 上で 3.5.0 が使われていました。質問者は、実際のスクリプトはまだテストしていないとコメントしているため、7.4 上の 3.9.x について確認された回答は存在しません。
- 3 月のスレッドでは、ランタイム 5.1 でも競合を回避できませんでした。3.9.2 を使用した場合、5.1 でも失敗しています。
少なくとも 2 つの組み合わせをテストしてください。例えば、固定した Exchange バージョンと最新の Graph モジュールの組み合わせ、および古い Graph バージョンとの組み合わせです。Microsoft Learn では、PackageManagement または PowerShellGet のプレビュー版が接続の問題を引き起こす可能性があると警告しているため、リリース済みのバージョンを使用してください。
手順 4: 作業の分割を検討する
どの組み合わせでも動作しない場合は、1 つのプロセスで両方のモジュールを読み込まないようにしてください。例えば、1 つのランブックで Exchange の処理を行い、別のランブックで Graph の処理を行って、そのランブックを最初のランブックから開始します。これは 2024 年のスレッドで示された原因から導かれる方法です。どちらのスレッドもこの方法は検証していないため、まずは小さな検証を作成してください。
また、スクリプト内の Exchange コマンドレットを Graph で置き換えられないかも確認してください。Microsoft Learn の Exchange のページでは、4 つの Microsoft 365 グループ用コマンドレットについてこの点が説明されています。例えば New-UnifiedGroup はマネージド ID では使用できず、Microsoft Learn では Graph の利用が推奨されています。その他のタスクについては、Graph に同等の機能があると想定しないでください。
検証
- テスト ウィンドウで、ジョブの出力に両方の接続と、各サービスからの結果がそれぞれ 1 件ずつ表示されることを確認します。
- 公開したランブックをスケジュールまたは手動で開始し、ジョブ ストリームにアセンブリの読み込みに関する警告がないか確認します。
- 正確なモジュールのバージョンとランタイムを書き留めておいてください。後からギャラリーが更新されると、動作していた構成が壊れる可能性があります。バージョンの固定によって保護されるのは、バージョンを変更しない間だけです。
制限事項
- 2024 年のスレッドは通常の対象期間より古く、デスクトップ版の Windows PowerShell を使用していました。原因が示されており、結果も確認されているため掲載しています。
- 2026 年のスレッドの解決策は最初のテストであり、本番環境で検証された修正ではありません。
- Microsoft Learn の Exchange のマネージド ID のページでは、モジュールを追加する際にランタイム 5.1 と 7.1 (プレビュー) が記載されていますが、これはランタイム環境のページとは異なります。最新のランタイムについては、ランタイム環境のページを参照してください。
- Microsoft Learn には、この競合そのものは記載されていません。原因はコミュニティの専門家による指摘です。
関連情報
データソース
- Microsoft Learn: Exchange Online PowerShell モジュール (バージョンと要件)
- Microsoft Learn: Azure マネージド ID を使用して Exchange Online PowerShell に接続する
- Microsoft Learn: Azure Automation でランタイム環境を管理する
- Microsoft Learn: Microsoft Graph PowerShell の認証コマンド
- Microsoft Q&A: 同じランブックで Exchange Online と Graph に接続できない (2026 年 3 月)
- Microsoft Community Hub: Exchange Online と MGGraph が干渉する問題 (2024)