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

테스트 런북 하나는 관리 ID로 Exchange Online에 연결하여 사서함을 읽으며, 정상적으로 동작합니다. 두 번째 테스트 런북은 같은 ID로 Microsoft Graph에 연결하여 사용자를 읽으며, 이 역시 정상적으로 동작합니다. 그러나 두 작업을 하나의 런북에 넣으면 실패합니다.

핵심 포인트

  • 이 오류는 권한 오류가 아니라 모듈 로드 실패입니다. 권한을 더 부여해도 해결되지 않습니다.
  • 확인된 2024년 커뮤니티 해결책이 원인을 밝혔습니다. 두 모듈이 서로 다른 System.Text.Json 버전을 하나의 프로세스에 로드하며, 먼저 로드된 모듈의 버전이 적용된다는 것입니다.
  • 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]

데스크톱 Windows PowerShell 5.1 환경에서 진행된 2024년 스레드에서는 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 관리자 역할을 할당하라고 안내했습니다. 이는 실제 필수 조건이지만, 권한 부여와 관련된 것이며 로드되지 않는 모듈을 해결하지는 못합니다.

발생 원인

2024년 스레드에서 커뮤니티 구성원(Microsoft 직원이 아닌 Silver Contributor)의 답변이 해결책으로 표시되었습니다. 이 답변은 두 모듈이 같은 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을 All 대신 Default로 설정하자 문제가 해결되었다고 보고했습니다. Learn에는 이 설정이 언급되어 있지 않으므로, 커뮤니티의 보고로 취급하시기 바랍니다.

2026년 스레드의 자원봉사 모더레이터(MVP)도 비슷한 설명을 했습니다. 모듈이 팀 간에 맞춰지지 않은 추가 바이너리에 의존하기 때문에, 모듈 버전과 PowerShell 호스트를 조합해야 할 수도 있다는 것입니다.

Learn에는 System.Text.Json 충돌에 대한 설명이 없습니다. 다만 ExchangeOnlineManagement 3.6.0 릴리스 노트에 "Microsoft.Graph 모듈과의 호환성 문제에 대한 수정 추가"라는 항목이 있습니다. 자세한 내용은 제공되지 않습니다.

1단계: 오류 유형 확인

  1. 테스트 런북에서 각 연결을 단독으로 실행하십시오. 둘 다 단독으로 작동한다면 권한 문제가 아니라 충돌입니다.
  2. 첫 번째 오류 줄을 복사하십시오. 모듈, 형식 또는 메서드 로드와 관련된 내용이면 충돌입니다. Forbidden, Access denied 또는 Authorization_RequestDenied는 권한 문제입니다.
  3. 권한 문제라면 Exchange의 관리 ID에 대한 Learn 페이지를 따르십시오. 여기에는 ID에 할당된 Exchange.ManageAsApp API 권한과 Exchange 관리자 같은 Entra 역할이 필요합니다. Learn에서는 보안 관리자는 이러한 작업에 필요한 권한이 없다고 설명합니다.

2단계: 모듈별로 원하는 어셈블리 버전 확인

2024년 스레드에서는 새 세션에서 모듈을 한 번에 하나씩 로드된 어셈블리 버전을 확인하라고 제안했습니다. 스레드 요약에는 정확한 명령이 나와 있지 않습니다. 아래 명령은 Learn이나 스레드에서 가져온 것이 아닌 일반적인 .NET 확인 명령이므로, 여분의 컴퓨터에서 테스트하십시오. 모듈 하나를 가져온 다음 다음을 실행하십시오.

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

새 세션에서 다른 모듈로 반복하십시오. 버전이 다르면 해당 스레드의 충돌이 발생한 것입니다. 런북에서 사용한 것과 같은 모듈 버전을 사용하십시오.

3단계: 별도의 런타임 환경에서 버전 고정

2026년 3월 질문자는 새 런타임 환경을 구성하여 테스트 사례를 해결했습니다. 스레드에는 클릭 순서가 나와 있지 않습니다. 하지만 Learn의 런타임 환경 페이지에는 나와 있습니다.

  1. Azure Portal에서 Automation 계정을 여십시오. 개요에서 아직 해당 환경에 있지 않다면 Try Runtime Environment experience를 선택하십시오.
  2. Process Automation 아래에서 Runtime Environments를 선택한 다음 만들기를 선택하십시오.
  3. 기본 사항에서 이름을 입력하고, 언어로 PowerShell을, 런타임 버전으로 7.4를 선택하십시오. Learn에 따르면 언어와 버전은 나중에 변경할 수 없습니다.
  4. 패키지에서는 기본적으로 Az 패키지가 추가됩니다. 갤러리에서 추가를 사용하여 고정된 버전의 ExchangeOnlineManagement와 호출하는 Microsoft.Graph 모듈을 추가하십시오. 스레드에서는 Exchange Online에 3.5.0을 사용했습니다.
  5. Create를 선택합니다.
  6. 런북의 사본을 연결하십시오. Runbooks에서 해당 런북을 선택한 다음 Update Runtime Environment를 선택하십시오.
  7. 런북을 열고 Edit in Portal을 선택하여 새 환경을 선택한 다음 Test pane과 Start를 선택하십시오. 테스트가 통과한 경우에만 게시하십시오.

Learn에 따르면 패키지를 가져오는 데 몇 분이 걸릴 수 있으며, 한 번에 최대 10개의 패키지를 추가할 수 있습니다. 또한 새 환경에서는 Modules 블레이드가 런타임 환경으로 대체됩니다.

고정할 버전은 런타임에 따라 달라집니다.

  • Learn에서는 ExchangeOnlineManagement 3.10.0 이상이 .NET 10 어셈블리 종속성 때문에 PowerShell 7.6.0 이상을 필요로 한다고 설명합니다. 런타임 페이지에서는 5.1과 7.4를 선택 가능한 옵션으로 제시합니다. 따라서 7.4 런타임에서는 3.10.0보다 이전 버전이 필요합니다. 이는 두 개의 Learn 페이지를 종합한 결론이며, 어느 한 페이지의 명시적 설명은 아닙니다. 따라서 계정에서 어떤 버전을 제공하는지 반드시 확인하십시오.
  • 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 환경에서도 실패했습니다.

고정한 Exchange 버전과 최신 Graph 모듈의 조합, 그리고 이전 Graph 버전과의 조합처럼 최소 두 가지 조합을 테스트하십시오. Learn은 PackageManagement 또는 PowerShellGet의 미리 보기 버전이 연결 문제를 일으킬 수 있다고 경고하므로, 정식 릴리스 버전을 사용하십시오.

4단계: 작업 분리를 고려하십시오

어떤 조합으로도 작동하지 않는다면, 두 모듈을 같은 프로세스에서 로드하지 마십시오. 예를 들어 한 런북은 Exchange 부분을, 다른 런북은 Graph 부분을 담당하고, 첫 번째 런북에서 두 번째 런북을 시작하도록 구성할 수 있습니다. 이 방법은 2024년 스레드에서 제시된 원인에 근거합니다. 다만 두 스레드 모두 이를 테스트하지는 않았으므로, 먼저 작은 증명 실험을 진행하십시오.

또한 스크립트의 Exchange cmdlet을 Graph로 대체할 수 있는지도 확인하십시오. Learn의 Exchange 페이지는 managed identity로는 사용할 수 없으며 Graph 사용을 권장하는 New-UnifiedGroup 등 Microsoft 365 그룹 cmdlet 네 가지를 이 점에서 설명합니다. 그 밖의 작업에 대해서는 Graph에 대응 기능이 있다고 가정하지 마십시오.

검증

  1. 테스트 창에서 작업 출력에 두 연결이 모두 표시되고, 각 서비스에서 결과가 하나씩 나오는지 확인하십시오.
  2. 예약 또는 수동 시작으로 게시된 런북을 실행하고, 어셈블리 로드 관련 경고가 있는지 작업 스트림을 확인하십시오.
  3. 정확한 모듈 버전과 런타임을 기록해 두십시오. 이후 갤러리 업데이트로 정상 작동하던 환경이 깨질 수 있습니다. 버전 고정은 버전을 변경하지 않는 동안에만 보호 효과가 있습니다.

한계

  • 2024년 스레드는 일반적인 기간보다 오래되었고 데스크톱 Windows PowerShell을 사용했습니다. 원인을 명시하고 결과가 확인되었다는 점 때문에 포함했습니다.
  • 2026년 스레드의 해결책은 첫 번째 테스트이며, 검증된 운영 환경용 수정안이 아닙니다.
  • Learn의 Exchange managed identity 페이지는 모듈을 추가할 때 여전히 런타임 5.1과 7.1(미리 보기)을 언급하고 있으며, 이는 런타임 환경 페이지와 다릅니다. 최신 런타임 정보는 런타임 환경 페이지를 참고하십시오.
  • Learn은 이 충돌 자체를 문서화하고 있지 않습니다. 원인은 커뮤니티 전문가의 설명에서 나온 것입니다.

관련 자료

데이터 원본

Entities in this article

Azure Automation Exchange Online PowerShell Microsoft Graph PowerShell Managed identity

Related articles

RSS