Exchange Online PowerShell에 연결Connect to Exchange Online PowerShell

Exchange Online PowerShell을 사용하면 명령줄에서 Exchange Online 설정을 관리할 수 있습니다.Exchange Online PowerShell allows you to manage your Exchange Online settings from the command line. 로컬 컴퓨터에서 Windows PowerShell을 사용하여 Exchange Online에 대한 원격 PowerShell 셸 세션을 만듭니다.You use Windows PowerShell on your local computer to create a remote PowerShell session to Exchange Online. 3단계로 구성된 간단한 프로세스를 통해 Office 365 자격 증명을 입력하고 필수 연결 설정을 제공한 다음 Exchange Online cmdlet을 사용할 수 있도록 로컬 Windows PowerShell 세션으로 가져옵니다.It's a simple three-step process where you enter your Office 365 credentials, provide the required connection settings, and then import the Exchange Online cmdlets into your local Windows PowerShell session so that you can use them.

Important

MFA(Multi-Factor Authentication)를 사용하여 Exchange Online PowerShell에 연결하려는 경우 Exchange Online Remote PowerShell Module을 다운로드한 후 사용해야 합니다.If you want to use multi-factor authentication (MFA) to connect to Exchange Online PowerShell, you need to download and use the Exchange Online Remote PowerShell Module. 자세한 내용은 다단계 인증을 사용하여 Exchange Online PowerShell에 연결을 참조하세요.For more information, see Connect to Exchange Online PowerShell using multi-factor authentication. EOP(Exchange Online Protection) 독립 실행형 고객이며 이 서비스를 사용하여 온-프레미스 사서함을 보호하려는 경우 Exchange Online Protection에 연결 항목의 연결 지침을 사용하세요.If you're an Exchange Online Protection (EOP) standalone customer, and you're using the service to protect on-premises mailboxes, use the connection instructions in the topic Connect to Exchange Online Protection PowerShell. EOP 구독이 Exchange Enterprise CAL with Services[DLP(데이터 손실 방지)를 웹 서비스를 사용하는 보고 포함]인 경우 이 항목의 연결 지침을 따릅니다.If your EOP subscription is Exchange Enterprise CAL with Services (includes data loss prevention (DLP) and reporting using web services), the connection instructions in this topic will work for you.

시작하기 전에 알아야 할 내용What do you need to know before you begin?

  • 예상 완료 시간: 5분Estimated time to complete: 5 minutes

  • 다음 Windows 버전을 사용할 수 있습니다.You can use the following versions of Windows:

  • Windows_PowerShell이 스크립트를 실행하도록 구성되어야 합니다. 기본값은 이렇게 구성되지 않는 것입니다. 연결하려고 하면 다음 오류가 표시됩니다.Windows PowerShell needs to be configured to run scripts, and by default, it isn't. You'll get the following error when you try to connect:

    Files cannot be loaded because running scripts is disabled on this system. Provide a valid certificate with which to sign the files.

    인터넷에서 다운로드하는 모든 PowerShell 스크립트를 신뢰할 수 있는 게시자가 서명하도록 하려면 관리자 권한 Windows PowerShell 창(관리자 권한으로 실행을 선택하면 열리는 Windows PowerShell 창)에서 다음 명령을 실행합니다.To require all PowerShell scripts that you download from the internet are signed by a trusted publisher, run the following command in an elevated Windows PowerShell window (a Windows PowerShell window you open by selecting Run as administrator):

    Set-ExecutionPolicy RemoteSigned
    

    이 설정은 연결할 때마다 구성하는 것이 아니라 컴퓨터에서 한 번만 구성하면 됩니다.You need to configure this setting only once on your computer, not every time you connect.

Tip

문제가 있습니까?Having problems? Exchange 포럼에서 도움을 요청하세요.Ask for help in the Exchange forums. 포럼 주소는 다음과 같습니다. Exchange Online, 또는 Exchange Online ProtectionVisit the forums at: Exchange Online, or Exchange Online Protection.

Exchange Online PowerShell에 연결Connect to Exchange Online PowerShell

  1. 로컬 컴퓨터에서 Windows PowerShell을 열고 다음 명령을 실행합니다.On your local computer, open Windows PowerShell and run the following command.

    $UserCredential = Get-Credential
    

    Windows PowerShell 자격 증명 요청 대화 상자에서 회사 또는 학교 계정 사용자 이름과 암호를 입력한 다음 확인을 클릭합니다.In the Windows PowerShell Credential Request dialog box, type your work or school account and password, and then click OK.

  2. 다음 명령을 실행합니다.Run the following command.

    $Session = New-PSSession -ConfigurationName Microsoft.Exchange -ConnectionUri https://outlook.office365.com/powershell-liveid/ -Credential $UserCredential -Authentication Basic -AllowRedirection
    

    참고:Notes:

    • 21Vianet에서 운영하는 Office 365의 경우 다음의 ConnectionUri 값을 사용합니다. https://partner.outlook.cn/PowerShellFor Office 365 operated by 21Vianet, use the ConnectionUri value: https://partner.outlook.cn/PowerShell

    • Office 365 Germany의 경우 다음의 ConnectionUri 값을 사용합니다. https://outlook.office.de/powershell-liveid/For Office 365 Germany, use the ConnectionUri value: https://outlook.office.de/powershell-liveid/

    • Office 365 GCC High(Government Community Cloud High)의 경우 다음의 ConnectionUri 값을 사용합니다. https://outlook.office365.us/powershell-liveid/For Office 365 Government Community Cloud High (GCC High), use the ConnectionUri value: https://outlook.office365.us/powershell-liveid/

    • 프록시 서버를 사용하는 경우 먼저 다음 명령을 실행합니다. ProxyAccessType 값이 IEConfig, WinHttpConfig 또는 AutoDetect인 경우 $ProxyOptions = New-PSSessionOption -ProxyAccessType <Value>.If you're behind a proxy server, run this command first: $ProxyOptions = New-PSSessionOption -ProxyAccessType <Value>, where the ProxyAccessType value is IEConfig, WinHttpConfig, or AutoDetect.

      그런 다음 $Session = ... 명령의 끝에 다음 매개 변수 및 값을 추가합니다. -SessionOption $ProxyOptionsThen, add the following parameter and value to the end of the $Session = ... command: -SessionOption $ProxyOptions.

      자세한 내용은 New-PSSessionOption을 참조하세요.For more information, see New-PSSessionOption.

  3. 다음 명령을 실행합니다.Run the following command.

    Import-PSSession $Session -DisableNameChecking
    

Note

작업을 마치면 원격 PowerShell 세션 연결을 반드시 끊어야 합니다. 세션 연결을 끊지 않고 Windows PowerShell 창을 닫으면 사용 가능한 모든 원격 PowerShell 세션이 사용될 수 있으며 세션이 만료될 때까지 기다려야 합니다. 원격 PowerShell 세션 연결을 끊으려면 다음 명령을 실행합니다.Be sure to disconnect the remote PowerShell session when you're finished. If you close the Windows PowerShell window without disconnecting the session, you could use up all the remote PowerShell sessions available to you, and you'll need to wait for the sessions to expire. To disconnect the remote PowerShell session, run the following command.

Remove-PSSession $Session

작동 여부는 어떻게 확인하나요?How do you know this worked?

3단계를 수행하고 나면 Exchange Online cmdlet이 로컬 Windows PowerShell 세션으로 가져오기되고 진행률 표시줄을 통해 추적됩니다.After Step 3, the Exchange Online cmdlets are imported into your local Windows PowerShell session and tracked by a progress bar. 오류가 발생하지 않으면 정상적으로 연결된 것입니다.If you don't receive any errors, you connected successfully. 빠르게 테스트하려면 Exchange Online cmdlet(예: Get-Mailbox)을 실행하여 결과를 확인합니다.A quick test is to run an Exchange Online cmdlet, for example, Get-Mailbox, and see the results.

오류가 발생하면 다음 요구 사항을 확인합니다.If you receive errors, check the following requirements:

  • 가장 흔한 문제는 암호를 잘못 입력한 경우입니다. 세 단계를 다시 실행하고 1단계에서 사용자 이름과 암호를 입력할 때 신중하게 확인하세요.A common problem is an incorrect password. Run the three steps again and pay close attention to the user name and password you enter in Step 1.

  • DoS(서비스 거부) 공격을 방지하려면 Exchange Online 조직에 세 개의 개방형 원격 PowerShell 연결만을 사용해야 합니다.To help prevent denial-of-service (DoS) attacks, you're limited to three open remote PowerShell connections to your Exchange Online organization.

  • Exchange Online에 연결하는 데 사용하는 계정은 원격 PowerShell에 대해 사용할 수 있어야 합니다. 자세한 내용은 Exchange Online PowerShell에 대한 액세스 사용 또는 사용 안 함을 참조하세요.The account you use to connect to Exchange Online must be enabled for remote PowerShell. For more information, see Enable or disable access to Exchange Online PowerShell.

  • 로컬 컴퓨터와 Office 365 간에 TCP 포트 80 트래픽을 열어야 합니다.TCP port 80 traffic needs to be open between your local computer and Office 365. 이 포트는 이미 열려 있을 수도 있지만 조직에서 제한적인 인터넷 액세스 정책을 사용하는 경우에는 열려 있는지를 고려해야 합니다.It's probably open, but it's something to consider if your organization has a restrictive internet access policy.

참고 항목See also

이 항목에서 사용하는 cmdlet은 Windows PowerShell cmdlet입니다.The cmdlets that you use in this topic are Windows PowerShell cmdlets. 이러한 cmdlet에 대한 자세한 내용은 다음 항목을 참조하세요.For more information about these cmdlets, see the following topics.

Office 365 관리에 대한 자세한 내용은 Manage Office 365을 참조하세요.For more information about managing Office 365, see Manage Office 365.