Exchange Online PowerShell에 연결

Exchange Online PowerShell V2 모듈(EXO V2 모듈로 약칭)은 최신 인증을 사용하며 Microsoft 365의 모든 Exchange 관련 PowerShell 환경에 연결하는 MFA(다단계 인증)와 함께 작동합니다(EXO Online PowerShell, 보안 및 규정 준수 PowerShell 및 독립 실행형 EOP(Exchange Online Protection) PowerShell)). EXO V2 모듈에 대한 자세한 내용은 Exchange Online PowerShell V2 모듈의 정보를 참조하세요.

이 항목에는 MFA를 사용하거나 사용하지 않고 EXO V2 모듈을 사용하여 Exchange Online PowerShell에 연결하는 방법에 대한 지침이 포함되어 있습니다.

결과적으로 사용 중단될 이전 버전의 보안 수준이 낮은 원격 PowerShell 연결 지침을 사용하려면 기본 인증 - Exchange Online PowerShell에 연결을 참조하세요.

이전 버전의 Exchange Online Remote PowerShell 모듈을 사용하여 MFA를 통해 Exchange Online PowerShell에 연결하려면 V1 모듈 - MFA를 사용하여 Exchange Online PowerShell에 연결을 참조하세요. 이전 버전의 모듈은 결과적으로 사용 종료됩니다.

시작하기 전에 알아야 할 사항은 무엇인가요?

  • EXO V2 모듈을 설치하고 사용하는 데 필요한 사항에 대한 자세한 내용은 EXO V2 모듈 설치 및 유지 관리를 참조하세요. 항목의 나머지 지침은 모듈을 이미 설치했다고 가정합니다.

  • 조직이 온-프레미스 Exchange이고 Exchange Enterprise CAL(EOP용 서비스 라이선스 포함)이 있는 경우 이 항목에 설명된 대로 EOP(Exchange Online Protection) PowerShell 연결 지침은 Exchange Online PowerShell과 동일합니다.

Tip

문제가 있나요? Exchange Online 포럼에 문의하세요.

MFA 및 최신 인증을 통해 Exchange Online PowerShell에 연결

계정에 다단계 인증을 사용하는 경우 이 섹션의 단계를 참조하세요. 그렇지 않은 경우에는 최신 인증을 사용하여 Exchange Online Protection PowerShell에 연결 섹션으로 건너뜁니다.

  1. Windows PowerShell 창에서 다음 명령을 실행하여 EXO V2 모듈을 로드합니다.

    Import-Module ExchangeOnlineManagement
    

    참고: EXO V2 모듈을 이미 설치한 경우 이전 명령은 기록된 대로 작동합니다.

  2. 실행해야 하는 명령은 다음 구문을 사용합니다.

    Connect-ExchangeOnline -UserPrincipalName <UPN> -ShowProgress $true [-ExchangeEnvironmentName <Value>] [-DelegatedOrganization <String>] [-PSSessionOption $ProxyOptions]
    
    • <UPN> 은(는) 사용자 계정 이름 형식(예: navin@contoso.com)의 계정입니다.
    • ExchangeEnvironmentName 매개 변수를 사용 하는 경우 ConnectionUri 또는 AzureADAuthorizationEndPointUrl 매개 변수를 사용 할 필요가 없습니다. 자세한 내용은 Connect-ExchangeOnline의 매개 변수 설명을 참조하세요.
    • DelegatedOrganization 매개 변수는 공인 Microsoft 파트너로서 관리하려는 고객 조직을 지정합니다. 자세한 내용은 파트너를 참조하세요.
    • 프록시 서버를 사용하는 경우 먼저 다음 명령을 실행합니다. $ProxyOptions = New-PSSessionOption -ProxyAccessType <Value>, <Value>이(가) IEConfig, WinHttpConfig 혹은 AutoDetect인 경우. 그런 다음 PSSessionOption 매개 변수와 $ProxyOptions값을 사용합니다. 자세한 내용은 New-PSSessionOption을 참조하세요.

    이 예제는 Microsoft 365 or Microsoft 365 GCC 조직의 Exchange Online PowerShell에 연결됩니다.

    Connect-ExchangeOnline -UserPrincipalName navin@contoso.com -ShowProgress $true
    

    이 예제에서는 Office 365 Germany 조직 에서 Exchange Online PowerShell에 연결 합니다.

    Connect-ExchangeOnline -UserPrincipalName lukas@fabrikam.de -ShowProgress $true -ExchangeEnvironmentName O365GermanyCloud
    

    이 예제는 Microsoft GCC High 조직의 Exchange Online PowerShell에 연결됩니다.

    Connect-ExchangeOnline -UserPrincipalName laura@blueyonderairlines.us -ShowProgress $true -ExchangeEnvironmentName O365USGovGCCHigh
    

    이 예제는 Microsoft 365 DoD 조직의 Exchange Online PowerShell에 연결됩니다.

    Connect-ExchangeOnline -UserPrincipalName julia@adatum.mil -ShowProgress $true -ExchangeEnvironmentName O365USGovDoD
    

    이 예제는 Exchange Online PowerShell에 연결하여 다른 테넌트를 관리합니다.

    Connect-ExchangeOnline -UserPrincipalName navin@contoso.com -ShowProgress $true -DelegatedOrganization adatum.onmicrosoft.com
    

구문과 매개 변수에 대한 자세한 내용은 Connect-ExchangeOnline을 참조합니다.

Note

작업을 마치면 원격 PowerShell 세션 연결을 반드시 끊어야 합니다. 세션 연결을 끊지 않고 Windows PowerShell 창을 닫으면 사용 가능한 모든 원격 PowerShell 세션이 사용될 수 있으며 세션이 만료될 때까지 기다려야 합니다. 원격 PowerShell 세션 연결을 끊으려면 다음 명령을 실행합니다.

Disconnect-ExchangeOnline

최신 인증을 통해 Exchange Online PowerShell에 연결

계정에서 다단계 인증을 사용하지 않는 경우 이 섹션에 있는 단계를 사용합니다.

  1. Windows PowerShell 창에서 다음 명령을 실행하여 EXO V2 모듈을 로드합니다.

    Import-Module ExchangeOnlineManagement
    

    참고: EXO V2 모듈을 이미 설치한 경우 이전 명령은 기록된 대로 작동합니다.

  2. 다음 명령을 실행합니다.

    Note

    Connect-ExchangeOnline 명령을 실행한 후 사용자 이름과 암호를 입력하라는 메시지가 표시될 때까지 이 단계를 건너뛰고 다음 단계에서 Credential 매개 변수를 생략할 수 있습니다. Credential 매개 변수를 생략하고 다음 단계에서 UserPrincipalName 매개 변수를 포함하는 경우, Connect-ExchangeOnline 명령을 실행한 후에만 암호를 입력하라는 메시지가 표시됩니다.

    $UserCredential = Get-Credential
    

    표시되는 Windows PowerShell 자격 증명 요청 대화 상자에서 회사 또는 학교 계정 사용자 이름과 비밀번호를 입력한 다음, 확인 을 클릭합니다.

  3. 실행해야 하는 마지막 명령은 다음 구문을 사용합니다.

    Connect-ExchangeOnline [-Credential $UserCredential] -ShowProgress $true [-ShowBanner:$false] [-ExchangeEnvironmentName <Value>] [-DelegatedOrganization <String>] [-PSSessionOption $ProxyOptions]
    
    • ExchangeEnvironmentName 매개 변수를 사용하는 경우, ConnectionUri 또는 AzureADAuthorizationEndPointUrl 매개 변수를 사용할 필요가 없습니다. 자세한 내용은 Connect-ExchangeOnline의 매개 변수 설명을 참조하세요.
    • DelegatedOrganization 매개 변수는 공인 Microsoft 파트너로서 관리하려는 고객 조직을 지정합니다. 자세한 내용은 파트너를 참조하세요.
    • 프록시 서버 뒤에 New-PSSessionOption cmdlet의 출력을 변수에 저장합니다(예: $ProxyOptions = New-PSSessionOption -ProxyAccessType <Value> [-ProxyAuthentication <Value>] [-ProxyCredential <Value>]). 그런 다음 해당 변수($ProxyOptions)를 PSSessionOption 의 매개 변수 값으로 사용합니다.

    Microsoft 365 또는 Microsoft 365 GCC 조직에서 Exchange Online PowerShell에 연결:

    Connect-ExchangeOnline -Credential $UserCredential -ShowProgress $true
    

    Office 365 Germany 조직의 Exchange Online PowerShell에 연결:

    Connect-ExchangeOnline -Credential $UserCredential -ShowProgress $true -ExchangeEnvironmentName O365GermanyCloud
    

    21Vianet 조직에서 운영하는 Office 365의 Exchange Online PowerShell에 연결:

    Connect-ExchangeOnline -Credential $UserCredential -ShowProgress $true -ExchangeEnvironmentName O365China
    

    Microsoft 365 GCC High 조직의 Exchange Online PowerShell에 연결:

    Connect-ExchangeOnline -Credential $UserCredential -ShowProgress $true -ExchangeEnvironmentName O365USGovGCCHigh
    

    Microsoft 365 DoD 조직의 Exchange Online PowerShell에 연결:

    Connect-ExchangeOnline -Credential $UserCredential -ShowProgress $true -ExchangeEnvironmentName O365USGovDoD
    

구문과 매개 변수에 대한 자세한 내용은 Connect-ExchangeOnline을 참조합니다.

Note

작업을 마치면 원격 PowerShell 세션 연결을 반드시 끊어야 합니다. 세션 연결을 끊지 않고 Windows PowerShell 창을 닫으면 사용 가능한 모든 원격 PowerShell 세션이 사용될 수 있으며 세션이 만료될 때까지 기다려야 합니다. 원격 PowerShell 세션 연결을 끊으려면 다음 명령을 실행합니다.

Disconnect-ExchangeOnline

작동 여부는 어떻게 확인하나요?

Exchange Online cmdlet이 로컬 Windows PowerShell 세션으로 가져오기되고 진행률 표시줄을 통해 추적됩니다. 오류가 발생하지 않으면 정상적으로 연결된 것입니다. 빠르게 테스트하려면 Exchange Online PowerShell cmdlet(예: Get-Mailbox)을 실행하여 결과를 확인합니다.

오류가 발생하면 다음 요구 사항을 확인합니다.

  • 일반적인 문제는 부정확한 암호입니다. 세 단계를 다시 실행하고 사용하는 사용자 이름과 암호를 주의해서 입력합니다.

  • DoS(서비스 거부) 공격을 방지하려면 다섯 개의 개방형 원격 PowerShell 연결만을 Exchange Online에 사용해야 합니다.

  • 연결하는 데 사용하는 계정에서 원격 PowerShell을 사용할 수 있어야 합니다. 자세한 내용은 Exchange Online PowerShell에 대한 액세스 설정 또는 해제를 참조하세요.

  • 로컬 컴퓨터와 Microsoft 365 간에 TCP 포트 80 트래픽이 열려 있어야 합니다. 이 포트는 이미 열려 있을 수도 있지만 조직에서 제한적인 인터넷 액세스 정책을 사용하는 경우에는 열려 있는지를 고려해야 합니다.

  • 조직에서 페더레이션 인증을 사용하고 IDP(ID 공급자) 및/또는 STS(보안 토큰 서비스)를 공개적으로 사용할 수 없는 경우 페더레이션 계정을 사용하여 Exchange Online PowerShell에 연결할 수 없습니다. 대신 Microsoft 365에서 페더레이션되지 않은 계정을 만들어 Exchange Online PowerShell에 연결하는 데 사용하세요.