M365Con 2027 – бесплатная онлайн-конференция · 11–22 Jan 2027 · 120 sessions→ m365con.net

Блог · Mirko Peters

Модули Exchange Online и Microsoft Graph вместе дают сбой в одном раннбуке Azure Automation

By ·

По отдельности каждый модуль работает, но подключение к Exchange Online и Microsoft Graph в одном раннбуке завершается ошибками загрузки модулей. Разберёмся, почему конфликтуют версии, и как протестировать среду выполнения с закреплённой версией.

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

Тестовый раннбук подключается к Exchange Online с помощью своего управляемого удостоверения и читает почтовый ящик. Работает. Второй тестовый раннбук подключается к Microsoft Graph с тем же удостоверением и читает пользователя. Тоже работает. Если поместить оба в один раннбук, он завершается с ошибкой.

Ключевые выводы

  • Ошибки — это сбои загрузки модулей, а не ошибки разрешений. Выдача дополнительных прав их не устранит.
  • Подтверждённое исправление сообщества 2024 года назвало причину: оба модуля загружают в один процесс разные версии System.Text.Json, и модуль, загруженный первым, побеждает.
  • В обсуждении за март 2026 года обошлись новой средой выполнения PowerShell 7.4 и ExchangeOnlineManagement 3.5.0, но автор вопроса ещё не тестировал реальный скрипт.
  • Microsoft Learn сообщает, что ExchangeOnlineManagement 3.10.0 и новее требуют PowerShell 7.6, тогда как его страница сред выполнения Automation перечисляет 5.1 и 7.4. Закрепите версию модуля и протестируйте на панели тестирования перед публикацией.

С этого обсуждения в Microsoft Q&A за март 2026 года начинается эта статья. Оно совпадает с более ранним обсуждением в Tech Community 2024 года, в котором было найдено исправление, подтверждённое автором вопроса. Статья объясняет причину, показывает, что Microsoft Learn сообщает о версиях и средах выполнения, и приводит план тестирования. Это руководство по устранению неполадок, а не официальная процедура Microsoft.

Симптомы

Автор вопроса в марте 2026 года использовал управляемое удостоверение, назначаемое системой: 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 и ошибка «method not found», в которой назывался System.Text.Json.Utf8JsonReader. Другой участник обсуждения получал Connect-MgGraph: Invalid JWT access token, когда в той же сессии использовался Connect-IPPSSession.

Все это ошибки загрузки или времени выполнения. Это не сообщения Authorization_RequestDenied или об отказе в доступе. Различие важно: в мартовской ветке обсуждения ИИ-ответ советовал автору вопроса выдать 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 хранит в процессе только одну версию сборки, поэтому тот модуль, который загрузился первым, побеждает, а второй может завершиться с ошибкой.

Автор вопроса в этой ветке удалил модули Graph перед подключением, обновил оба модуля и очистил кэш MSAL. Ничего из этого не помогло. После возврата к ExchangeOnlineManagement 3.4.0 автор написал, что всё заработало. Другие участники сообщали о том же решении. Еще один участник отметил улучшение с версией 3.6.0, но подключение Connect-IPPSSession на основе сертификата у него по-прежнему не работало. Один участник сообщил, что установка -LogLevel в значение Default вместо All исправила проблему в его тесте. Learn этот параметр не упоминает, поэтому относитесь к нему как к сообщению из сообщества.

Модератор-волонтер (MVP) в ветке 2026 года дал похожее объяснение. Модули зависят от дополнительных двоичных файлов, которые не согласованы между командами, поэтому может понадобиться подбирать сочетания версий модулей и хостов PowerShell.

Learn не описывает конфликт System.Text.Json. В примечаниях к выпуску ExchangeOnlineManagement 3.6.0 есть пункт «Added fix for compatibility issue with the Microsoft.Graph module», но без подробностей.

Шаг 1. Определите, с каким типом ошибки вы имеете дело

  1. Запустите каждое подключение отдельно в тестовом runbook. Если оба работают по отдельности, у вас конфликт, а не проблема с разрешениями.
  2. Скопируйте первую строку ошибки. Всё, что касается загрузки модуля, типа или метода, — это конфликт. Forbidden, Access denied или Authorization_RequestDenied — это проблема с разрешениями.
  3. При проблемах с разрешениями следуйте странице Learn об управляемых удостоверениях для Exchange. Удостоверению нужно назначить разрешение API Exchange.ManageAsApp и роль Entra, например Exchange Administrator. В примечании Learn сказано, что роль Security Administrator не имеет необходимых разрешений для этих задач.

Шаг 2. Выясните, какую версию сборки требует каждый модуль

В ветке 2024 года предлагалось проверять загруженную версию сборки в новой сессии, по одному модулю за раз. В сводке обсуждения точная команда не приведена. Команда ниже — общая проверка для .NET, она не взята из Learn или из обсуждения, поэтому проверьте её на запасном компьютере. Импортируйте один модуль, затем выполните:

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

Повторите в новой сессии с другим модулем. Если версии различаются, у вас тот самый конфликт из этой ветки. Используйте те же версии модулей, что и в runbook.

Шаг 3. Зафиксируйте версии в отдельной среде выполнения

Автор вопроса в марте 2026 года решил тестовый случай, создав новую среду выполнения. В обсуждении не описаны действия в интерфейсе. Страница Learn о средах выполнения их описывает:

  1. В портале Azure откройте учетную запись Automation. На вкладке Overview выберите Try Runtime Environment experience, если вы еще не в этом режиме.
  2. В разделе Process Automation выберите Runtime Environments, затем Create.
  3. На вкладке Basics введите имя, выберите PowerShell в качестве языка и 7.4 в качестве версии среды выполнения. Learn указывает, что язык и версию нельзя изменить позже.
  4. На вкладке Packages пакет Az добавляется по умолчанию. Используйте Add from gallery, чтобы добавить ExchangeOnlineManagement с зафиксированной версией и модули Microsoft.Graph, которые вы вызываете. В обсуждении для Exchange Online использовалась версия 3.5.0.
  5. Нажмите Create.
  6. Свяжите копию вашего runbook. В разделе Runbooks выберите его, затем Update Runtime Environment.
  7. Откройте runbook, выберите Edit in Portal, укажите новую среду, затем Test pane и Start. Публикуйте, только если тест пройден.

Learn указывает, что импорт пакета может занять несколько минут, что за один раз можно добавить до 10 пакетов и что в новом интерфейсе раздел «Модули» заменён средами выполнения (runtime environments).

Какую версию зафиксировать, зависит от среды выполнения:

  • Learn сообщает, что ExchangeOnlineManagement 3.10.0 и новее требуют PowerShell 7.6.0 или новее из-за зависимостей сборок .NET 10. На его странице о средах выполнения в качестве вариантов названы 5.1 и 7.4. Значит, для среды 7.4 нужна версия старше 3.10.0. Это вывод, сделанный на основе двух страниц Learn, а не утверждение одной из них, поэтому проверьте, что предлагает ваша учётная запись.
  • Learn перечисляет проблемы с версиями от 3.7.0 до 3.9.2 в Ubuntu 20.04 и 18.04 и называет 3.9.2 последней версией для некоторых старых платформ. Эти замечания относятся к настольным платформам, а не к Automation.
  • Собственный тест из мартовской темы использовал 3.5.0 на 7.4. Автор вопроса добавил комментарий, что реальный скрипт ещё не проверен, поэтому подтверждённого ответа для 3.9.x на 7.4 не существует.
  • Среда 5.1 не позволила избежать конфликта в мартовской теме: там сбой возникал на 5.1 с версией 3.9.2.

Проверьте как минимум две комбинации, например закреплённую версию Exchange с новейшими модулями Graph и с более старой версией Graph. Learn предупреждает, что предварительные версии PackageManagement или PowerShellGet могут вызывать проблемы с подключением, поэтому используйте выпущенные (released) версии.

Шаг 4: подумайте о разделении задачи

Если ни одна комбинация не работает, не загружайте оба модуля в одном процессе. Например, пусть один runbook выполняет часть для Exchange, а другой — часть для Graph, и запускайте второй из первого. Это следует из причины, указанной в теме 2024 года. Ни в одной из тем это не проверялось, поэтому сначала создайте небольшой прототип.

Также проверьте, может ли Graph заменить командлеты Exchange в вашем скрипте. Страница Learn об Exchange делает это утверждение для четырёх командлетов групп Microsoft 365, например New-UnifiedGroup. Там сказано, что их нельзя использовать с управляемым удостоверением, и рекомендуется Graph. Для других задач не предполагайте, что у Graph есть эквивалент.

Проверка

  1. В области «Test» вывод задания показывает оба подключения и по одному результату от каждого сервиса.
  2. Запустите опубликованный runbook по расписанию или вручную и проверьте потоки заданий на наличие предупреждений о загрузке сборок.
  3. Запишите точные версии модулей и среды выполнения. Более поздние обновления в галерее могут нарушить работающую конфигурацию. Фиксация версий защищает вас только до тех пор, пока вы не меняете версии.

Ограничения

  • Тема 2024 года старше обычного периода и использовала настольную версию Windows PowerShell. Она включена, потому что называет причину и имеет подтверждённый результат.
  • Решение из темы 2026 года — это первая проверка, а не проверенное исправление для продуктивной среды.
  • Страница Learn об управляемом удостоверении для Exchange при добавлении модуля всё ещё упоминает среды выполнения 5.1 и 7.1 (Preview), что отличается от страницы о средах выполнения. Актуальные среды берите со страницы о средах выполнения.
  • Learn не описывает сам конфликт. Причина указана community-экспертом.

Связанные материалы

Источники

Entities in this article

Azure Automation Exchange Online PowerShell Microsoft Graph PowerShell Managed identity

Related articles

RSS