Exchange Online PowerShell 모듈 설치 방법(단계별 안내)

By Mirko Peters · 2026-11-12

Install-Module ExchangeOnlineManagement로 Exchange Online PowerShell 모듈을 설치하는 방법을 정리했습니다. 요구 사항, 설치 범위, 버전 확인, 업데이트와 오류 해결 방법까지 다룹니다.

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

Exchange Online PowerShell 모듈을 설치하려면 관리자 권한으로 PowerShell을 연 뒤 Install-Module -Name ExchangeOnlineManagement를 실행합니다. 그러면 컴퓨터의 모든 사용자를 위해 모듈이 설치됩니다. 관리자 권한으로 실행할 수 없다면 -Scope CurrentUser를 추가하면 됩니다. 이 경우 본인 계정에만 설치됩니다. 이 글은 새 관리자 PC, 점프 서버 또는 빌드 에이전트를 설정하는 Exchange 및 Microsoft 365 관리자를 위한 것입니다. 요구 사항, 설치 및 확인 단계, 모듈 업데이트와 제거, 가장 자주 발생하는 오류를 다룹니다.

핵심 포인트

• 관리자 권한으로 실행한 PowerShell 창에서 모든 사용자를 위해 Install-Module -Name ExchangeOnlineManagement로 설치합니다.
• 관리자 권한을 사용할 수 없다면 -Scope CurrentUser를 사용하세요. 나중에 모듈을 업데이트할 때는 설치할 때 사용한 것과 같은 범위를 사용합니다.
• Windows PowerShell 5.1에는 .NET Framework 4.7.2가 필요합니다. PowerShell 7 지원은 모듈 버전에 따라 다르며, 3.10.0 이상은 PowerShell 7.6.0이 필요합니다.
• Get-InstalledModule로 설치 결과를 확인하세요. 버전과 함께 모듈이 모든 사용자용 위치에 있는지 현재 사용자용 위치에 있는지 보여줍니다.
• 모듈의 연결은 REST를 사용하므로 WinRM에서 기본 인증이 더 이상 필요하지 않습니다.

모듈 소개와 사전 준비 사항

모듈 이름은 ExchangeOnlineManagement입니다. Microsoft 문서에서는 Exchange Online PowerShell V3 모듈이라고 부릅니다. 이 모듈로 Exchange Online PowerShell, Security & Compliance PowerShell, 온-프레미스 사서함용 내장 보안 추가 기능의 PowerShell에 연결할 수 있습니다. 최신 인증을 사용하므로 다단계 인증 사용 여부와 관계없이 동작합니다.

기존 스크립트에 영향을 주는 변경 사항이 하나 있습니다. Microsoft는 2023년 10월 이후 REST API 연결이 기본 인증을 사용하는 기존 원격 PowerShell 연결을 대체했다고 설명합니다. 이 모듈의 연결은 WinRM에서 기본 인증을 필요로 하지 않으므로 그곳에서 따로 설정할 것은 없습니다.

설치하기 전에 다음 사전 요구 사항을 확인하세요:

• PowerShell 버전 및 .NET. Windows PowerShell 5.1에는 .NET Framework 4.7.2가 필요합니다. Windows 11, Windows Server 2022, Windows Server 2025에는 4.8.x가 포함되어 있으므로 이 환경에서는 문제없습니다. PowerShell 7도 사용할 수 있으며, 최소 버전은 모듈 버전에 따라 다릅니다. 이는 다음 섹션에서 설명합니다.
• 실행 정책. Microsoft 페이지에 따르면 적절한 실행 정책이 없으면 "Files cannot be loaded because running scripts is disabled on this system" 오류가 발생합니다. 문서에 나온 해결 방법은 관리자 권한으로 Set-ExecutionPolicy RemoteSigned를 실행하는 것입니다. 변경하기 전에 실행 정책에 관한 Microsoft 페이지를 읽어 보고, 관리되는 컴퓨터라면 먼저 보안팀에 확인하세요.
• PowerShellGet과 PackageManagement. Windows에서 REST 연결을 사용하려면 PowerShellGet이 필요하며, PowerShellGet은 PackageManagement에 의존합니다. 이들이 없으면 Update-ModuleManifest cmdlet이 없다는 오류가 나타날 수 있습니다. Microsoft는 이 두 모듈의 미리 보기 버전이 연결 문제를 일으킬 수 있다고 설명하며, 설치된 버전을 확인하는 명령도 제공합니다: Get-InstalledModule PackageManagement -AllVersions; Get-InstalledModule PowerShellGet -AllVersions.
• TLS 1.2. 이전 버전의 Windows에서 Windows PowerShell 5.1을 사용하는 경우 PowerShell Gallery는 TLS 1.2 이상을 요구합니다. 오래된 서버에서 다운로드가 연결 오류로 실패한다면 가장 먼저 확인해야 할 항목입니다.

매우 오래된 시스템은 지원이 어렵습니다. Windows 7 SP1과 Windows Server 2008 R2 SP1에서는 모듈 2.0.3 버전만 사용할 수 있으며, Microsoft에 따르면 이 버전은 REST를 지원하지 않아 연결할 수 없습니다.

PowerShell 버전별 적합한 모듈 버전

Windows PowerShell 5.1은 위에서 언급한 .NET 요구 사항만 충족하면 모든 모듈 버전과 함께 작동합니다. PowerShell 7의 경우 Microsoft는 다음과 같은 대응 관계를 제시합니다.

• 모듈 3.10.0 이상은 .NET 10을 사용하는 PowerShell 7.6.0 이상이 필요합니다.
• 모듈 3.5.0부터 3.9.2까지는 .NET 8을 사용하는 PowerShell 7.4.0 이상이 필요합니다.
• 모듈 3.0.0부터 3.4.0까지는 .NET 6을 사용하는 PowerShell 7.2.0 이상이 필요합니다.
• 2.x 라인의 모듈 2.0.4 이상 버전은 PowerShell 7.0.3이 필요합니다.

따라서 PowerShell 7.4가 설치된 장비에 최신 모듈을 설치했다면 문제가 생길 수 있습니다. PowerShell을 업데이트하거나 -RequiredVersion을 사용해 이전 모듈 버전을 설치하십시오. 이 글을 작성하는 시점에 Microsoft는 3.10.1을 현재 버전으로 안내하고 있습니다. 글을 읽는 시점에 적용되는 버전 번호는 모듈 페이지에서 확인하십시오.

Microsoft는 Linux와 macOS에서도 이 모듈을 지원합니다. Linux에서 프록시를 통해 연결하려면 모듈 3.0.0 이상이 필요합니다. 두 시스템 모두 PowerShell 7에서는 Connect-IPPSSession, 그리고 이를 사용하는 Security & Compliance PowerShell을 사용할 수 없습니다. Mac에서 Exchange Online을 관리한다면 도구를 계획하기 전에 알아야 할 유일한 제약 사항입니다.

Windows 10에 대해서도 짧게 짚고 넘어가겠습니다. 일반 사용자용 에디션은 2025년 10월에 지원이 종료되었으며, Microsoft는 이 에디션이 .NET 8.0 및 .NET 10.0을 지원하지 않는다고 밝혔습니다. PowerShell 7.4 이상과 함께 모듈 3.5.0 이상을 사용하는 경우, 지원 기간이 남아 있는 Enterprise 및 IoT LTSC 에디션만 작동합니다.

설치 전에 PowerShell 버전을 확인하십시오

2분만 투자하면 나중에 추측하느라 시간을 낭비하지 않아도 됩니다. 작업할 창에서 $PSVersionTable.PSVersion을 실행하여 사용 중인 PowerShell 버전을 확인하십시오. 그 결과를 위의 대응표와 비교하십시오. Windows PowerShell 5.1을 사용하는 경우에는 PowerShellGet 버전도 알아야 하므로 Get-InstalledModule PowerShellGet -AllVersions를 실행하십시오. 이 명령 결과에 미리 보기 버전이 나타나면 제거하거나 안정 버전으로 업데이트한 후 진행하십시오. Microsoft 모듈 페이지에서도 PowerShellGet과 PackageManagement의 미리 보기 빌드를 연결 문제의 원인으로 언급하고 있습니다.

관리하는 서버가 몇 대 이상이라면 장비 이름 옆에 결과를 기록해 두십시오. 3개월 후 동료가 연결 실패를 보고하더라도 몇 초 만에 버전을 비교할 수 있습니다.

Exchange Online PowerShell 모듈 설치 단계별 안내

아래 단계는 Windows PowerShell 5.1과 PowerShell 7 모두에서 작동합니다.

1. PowerShell을 엽니다. 모든 사용자를 대상으로 설치하려면 관리자 권한으로 실행을 선택하십시오. 현재 사용자에게만 설치할 계획이라면 이 단계는 건너뛰어도 됩니다.
2. 장비에 처음 설치하는 모듈이라면 먼저 PowerShellGet을 업데이트한 다음 PowerShell을 닫았다가 다시 여십시오. Microsoft는 처음 설치하기 전에 이 순서를 권장합니다.
3. 모든 사용자를 대상으로 하려면 Install-Module -Name ExchangeOnlineManagement를 실행하십시오. 본인 계정에만 설치하려면 Install-Module -Name ExchangeOnlineManagement -Scope CurrentUser를 실행하십시오.
4. 설치 중 PowerShell이 표시하는 프롬프트에 응답하십시오. 다운로드가 되려면 조직에서 PowerShell Gallery에 대한 접근을 허용해야 합니다.
5. Get-InstalledModule ExchangeOnlineManagement | Format-List Name,Version,InstalledLocation로 설치를 확인하십시오.
6. InstalledLocation 줄을 확인하십시오. 경로가 %ProgramFiles%\WindowsPowerShell\Modules\ 아래에 있으면 모든 사용자를 대상으로 설치된 것입니다. 문서 폴더 아래의 경로라면 현재 사용자에게만 설치된 것입니다.
7. 새 창에서 Connect-ExchangeOnline -UserPrincipalName admin@contoso.com로 연결을 테스트합니다. 연결 세부 정보는 Connect to Exchange Online PowerShell 문서를 참고하십시오.

미리 보기 빌드를 사용하고 싶으신가요? -AllowPrerelease를 추가하십시오. 특정 미리 보기 버전을 선택하려면 -RequiredVersion과 함께 사용하면 됩니다. Find-Module ExchangeOnlineManagement -AllVersions -AllowPrerelease를 실행하면 사용 가능한 버전이 나열되고, -AllowPrerelease를 생략하면 공개 버전만 나열됩니다. 특별한 이유가 없다면 미리 보기 빌드를 프로덕션 관리 서버에 설치하지 마십시오. 먼저 여유 있는 장비에서 테스트하십시오.

모듈 업데이트 및 제거

Microsoft는 새 모듈 버전을 정기적으로 게시하며, 모듈 페이지의 릴리스 정보에서 변경 사항을 확인할 수 있습니다. 예를 들어 3.7.0 버전부터는 명령줄 도움말이 기본적으로 로드되지 않으며, 3.9.2 버전에서는 UseRpsSession 매개 변수가 더 이상 사용되지 않게 되었습니다. 업데이트는 한 줄이면 됩니다. Update-Module -Name ExchangeOnlineManagement. 현재 사용자용으로 설치했다면 -Scope CurrentUser를 추가하십시오. Microsoft는 설치할 때 사용한 것과 같은 범위를 사용하라고 안내합니다. 범위가 일치하지 않으면 두 위치에 모두 설치되어 PowerShell이 어느 쪽을 사용하는지 명확하지 않을 수 있습니다.

그래서 업데이트 전후에 4단계의 Get-InstalledModule 확인을 실행하는 것이 중요합니다. 두 개의 버전이 보인다면 각 버전이 어느 범위에 속하는지 확인하십시오.

모듈을 제거하려면 Uninstall-Module -Name ExchangeOnlineManagement를 실행합니다. 모든 사용자를 위해 설치했다면 관리자 권한으로 실행하십시오. 작업이 끝나면 열려 있는 PowerShell 창을 모두 닫으십시오. 이미 로드된 모듈은 세션이 끝날 때까지 메모리에 남아 있기 때문입니다.

일반적인 설치 오류 해결

Microsoft 모듈 페이지에는 몇 가지 구체적인 오류와 해결 방법이 나와 있습니다.

• "No match was found for the specified search criteria and module name 'ExchangeOnlineManagement'". Register-PSRepository -Default를 실행하여 PowerShell 갤러리를 다시 리포지토리로 등록하십시오. 그런 다음 설치를 다시 시도하십시오.
• PowerShellGetFormatVersion 관련 오류, 또는 공급자를 다운로드할 수 없다는 오류. PowerShellGet을 업데이트하고 PowerShell을 다시 시작하십시오.
• 이전 버전인 Windows PowerShell 5.1 장비에서 다운로드가 실패합니다. PowerShell 갤러리는 TLS 1.2 이상을 필요로 합니다. 자세한 내용은 Microsoft가 링크한 갤러리의 TLS 지원에 관한 블로그 게시물을 참고하십시오.
• "Files cannot be loaded because running scripts is disabled on this system". 위에서 설명한 대로 관리자 권한으로 실행 정책을 설정하십시오.
• 연결 시 "Cannot find a cmdlet Update-Manifest" 또는 Update-ModuleManifest와 관련된 유사한 메시지가 나타나는 경우. PowerShellGet 또는 PackageManagement가 없는 상태입니다. 두 모듈을 모두 설치하고 PowerShell을 다시 시작하십시오.

설치는 성공했지만 이후 연결 시 이상한 어셈블리 오류가 발생한다면, 대부분 같은 세션에 있는 다른 모듈이 원인입니다. 새 창을 열고 먼저 연결하십시오.

흔한 실수

• 범위 혼용. 한 번은 모든 사용자용으로 설치하고, 나중에 -Scope CurrentUser로 업데이트하면 장비에 두 개의 버전이 남습니다. 하나의 범위를 정해 일관되게 사용하십시오.
• 모듈에 맞지 않는 PowerShell 버전 사용. 최신 모듈을 이전 버전의 PowerShell 7에서 실행하면 연결 오류처럼 보이는 문제가 발생합니다. 위 표와 버전을 비교해 보십시오.
• 프로덕션 호스트에 미리 보기 버전 설치. 미리 보기 버전은 테스트용입니다. 일상적인 작업에는 공개 버전을 사용하십시오.
• PowerShellGet 무시. PowerShellGet이 없거나 미리 보기 버전이면 Microsoft 페이지에서 설명하는 것처럼 REST 연결이 실패할 수 있습니다. 새로 설치했는데도 연결되지 않으면 이것부터 확인하십시오.
• 오래된 튜토리얼 따라 하기. WinRM에서 기본 인증을 사용하도록 설정하라고 안내하는 가이드는 이미 지원이 종료된 원격 PowerShell 방식을 설명합니다. 이 설정은 필요하지 않습니다.

함께 살펴볼 관련 항목

• 모듈로 연결하기: 모듈을 설치한 뒤에는 MFA 사용 여부와 관계없이 로그인하는 방법을 알아야 합니다. 이는 Exchange Online PowerShell 모듈 문서와 연결 관련 문서에서 다룹니다.
• 앱 전용 인증: 예약된 스크립트에는 입력한 암호가 아니라 인증서 또는 관리 ID가 필요합니다.
• PowerShell 7을 Linux와 macOS에서 사용하는 방법: 지원되는 버전은 운영 체제마다 다르므로 먼저 호환성 목록을 확인하십시오.
• PowerShell 사용 대상 제어: Exchange 관리자는 사용자별로 Exchange Online PowerShell 액세스를 사용하도록 설정하거나 사용하지 않도록 설정할 수 있습니다.
• 모듈을 최신 상태로 유지하기: Microsoft가 PowerShell의 최소 버전을 주기적으로 올리므로, 새 모듈 버전을 확인하도록 정기 알림을 설정하십시오.

다음 단계

Exchange Online PowerShell 모듈을 설치하려면 Install-Module -Name ExchangeOnlineManagement를 실행하고, Get-InstalledModule로 설치를 확인한 다음, 이후 모든 업데이트에서 범위(scope)를 동일하게 유지하십시오. 그런 다음 새 창에서 Connect-ExchangeOnline으로 연결하고 Get-AcceptedDomain을 실행하여 설정이 제대로 작동하는지 확인하십시오.