Share via

PowerShell을 사용하여 Microsoft 365로 IMAP 마이그레이션 수행

  • 아티클

이 문서는 Microsoft 365 Enterprise와 Office 365 Enterprise에 모두 적용됩니다.

Microsoft 365를 배포하는 프로세스의 일환으로 IMAP(인터넷 메일 액세스 프로토콜) 전자 메일 서비스에서 Microsoft 365로 사용자 사서함의 콘텐츠를 마이그레이션하도록 선택할 수 있습니다. 이 문서에서는 Exchange Online PowerShell을 사용하는 전자 메일 IMAP 마이그레이션 작업을 살펴봅니다.

참고

Exchange 관리 센터를 사용하여 IMAP 마이그레이션을 수행할 수도 있습니다. IMAP 사서함 마이그레이션을 참조하세요.

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

이 작업의 예상 완료 시간: 2-5분(마이그레이션 일괄 처리 만들기에 소요되는 시간). 마이그레이션 일괄 처리가 시작되면 마이그레이션 기간은 일괄 처리의 사서함 수, 각 사서함의 크기 및 사용 가능한 네트워크 용량에 따라 달라집니다. 사서함을 Microsoft 365로 마이그레이션하는 데 걸리는 기간에 영향을 주는 다른 요인에 대한 자세한 내용은 마이그레이션 성능을 참조하세요.

이러한 절차를 수행하려면 먼저 사용 권한을 할당받아야 합니다. 필요한 권한을 보려면 받는 사람 권한 문서의 표에 있는 "마이그레이션" 항목을 참조하세요.

Exchange Online PowerShell cmdlet을 사용하려면 로그인한 후 cmdlet을 로컬 Windows PowerShell 세션으로 가져와야 합니다. 지침은 Exchange Online PowerShell에 연결을 참조하세요.

전체 마이그레이션 명령 목록을 보려면 이동 및 마이그레이션 cmdlet을 참조하세요.

IMAP 마이그레이션에 적용되는 제한 사항은 다음과 같습니다.

  • 사용자의 받은 편지함 또는 다른 메일 폴더에 있는 항목만 마이그레이션할 수 있습니다. 연락처, 일정 항목 또는 작업은 마이그레이션할 수 없습니다.

  • 최대 500,000개 항목을 사용자 사서함에서 마이그레이션할 수 있습니다.

  • 마이그레이션할 수 있는 최대 메시지 크기는 35MB입니다.

마이그레이션 단계

1단계: IMAP 마이그레이션 준비

  • IMAP organization 대한 도메인이 있는 경우 Microsoft 365 organization 허용된 도메인으로 추가합니다. Microsoft 365 사서함에 대해 이미 소유한 동일한 도메인을 사용하려면 먼저 Microsoft 365에 허용된 도메인으로 추가해야 합니다. 추가한 후에는 Microsoft 365에서 사용자를 만들 수 있습니다. 자세한 내용은도메인 확인을 참조하세요.

  • 사서함이 있도록 Microsoft 365에 각 사용자를 추가합니다. 자세한 내용은비즈니스용 Microsoft 365에 사용자 추가를 참조하세요.

  • IMAP 서버의 FQDN을 받습니다. IMAP 마이그레이션 엔드포인트를 만들 때 사서함 데이터를 마이그레이션할 IMAP 서버의 FQDN(정규화된 도메인 이름)(전체 컴퓨터 이름이라고도 함)을 제공해야 합니다. IMAP 클라이언트나 PING 명령을 사용하여 인터넷에서 해당 FQDN으로 IMAP 서버와 통신할 수 있는지 확인합니다.

  • IMAP 연결을 허용하도록 방화벽을 구성합니다. 마이그레이션 도중에 Microsoft 데이터 센터에서 시작된 네트워크 트래픽이 IMAP 서버를 호스트하는 조직에 유입될 수 있도록 하기 위해 IMAP 서버를 호스트하는 조직의 방화벽에서 포트를 열어야 할 수도 있습니다. Microsoft 데이터 센터에서 사용하는 IP 주소 목록은 Exchange Online URL 및 IP 주소 범위를 참조하세요.

  • 관리자 계정에 IMAP 조직 내의 사서함에 액세스하기 위한 권한을 할당합니다. CSV 파일의 관리자 자격 증명을 사용하는 경우 사용하는 계정에 온-프레미스 사서함에 액세스하는 데 필요한 권한이 있어야 합니다. 사용자 사서함에 액세스하는 데 필요한 권한은 특정 IMAP 서버에 의해 결정됩니다.

  • Exchange Online PowerShell cmdlet을 사용하려면 로그인한 후 cmdlet을 로컬 Windows PowerShell 세션으로 가져와야 합니다. 지침은 Exchange Online PowerShell에 연결을 참조하세요.

    전체 마이그레이션 명령 목록을 보려면 이동 및 마이그레이션 cmdlet을 참조하세요.

  • IMAP 서버에 연결할 수 있는지 확인합니다. Exchange Online PowerShell에서 다음 명령을 실행하여 IMAP 서버에 대한 연결 설정을 테스트합니다.

    Test-MigrationServerAvailability -IMAP -RemoteServer <FQDN of IMAP server> -Port <143 or 993> -Security <None, Ssl, or Tls>

    Port 매개 변수의 값으로는 일반적으로 암호화되지 않은 연결 또는 TLS(전송 계층 보안) 연결의 경우 143을 사용하고 SSL 연결의 경우 993을 사용합니다.

2단계: IMAP 마이그레이션 일괄 처리를 위한 CSV 파일 만들기

IMAP 마이그레이션 일괄 처리에서 해당 사서함을 마이그레이션할 사용자 그룹을 식별합니다. CSV 파일의 각 행에는 IMAP 메시징 시스템의 사서함에 연결하는 데 필요한 정보가 포함되어 있습니다.

각 사용자의 필수 특성은 다음과 같습니다.

  • EmailAddress 는 사용자의 Microsoft 365 사서함에 대한 사용자 ID를 지정합니다.

  • UserName 은 IMAP 서버의 사서함에 액세스하는 데 사용할 계정의 로그인 이름을 지정합니다.

  • Password 는 UserName 열에 있는 계정의 암호를 지정합니다.

다음은 CSV 파일 형식의 예입니다. 이 예에서는 다음 세 개의 사서함을 마이그레이션합니다.

EmailAddress,UserName,Password
terrya@contoso.edu,terry.adams,1091990
annb@contoso.edu,ann.beebe,2111991
paulc@contoso.edu,paul.cannon,3281986

UserName 특성의 경우, 사용자 이름 외에 IMAP 서버의 사서함에 액세스하는 데 필요한 권한이 할당된 계정의 자격 증명을 사용할 수 있습니다. 다음은 일부 IMAP 서버에 사용되는 특정 형식입니다.

Microsoft Exchange

Microsoft Exchange의 IMAP 구현에서 전자 메일을 마이그레이션하는 경우에는 CSV 파일에서 UserName 특성에 Domain/Admin_UserName/User_UserName 형식을 사용합니다. Terry Adams, Ann Beebe 및 Paul Cannon에 대해 Exchange의 전자 메일을 마이그레이션한다고 가정해 보십시오. 사용자 이름이 mailadmin 이고 암호는 P@ssw0rd 인 메일 관리자 계정이 있습니다. CSV 파일은 다음과 같이 나타납니다.

EmailAddress,UserName,Password
terrya@contoso.edu,contoso-students/mailadmin/terry.adams,P@ssw0rd
annb@contoso.edu,contoso-students/mailadmin/ann.beebe,P@ssw0rd
paulc@contoso.edu,contoso-students/mailadmin/paul.cannon,P@ssw0rd

Dovecot:

Dovecot IMAP 서버와 같이 SASL(단순 인증 및 보안 계층)을 지원하는 IMAP 서버의 경우 User_UserName*Admin_UserName 형식을 사용합니다. 여기서 별표( * )는 구성 가능한 구분 기호 문자입니다. 관리자 자격 증명 mailadmin 및 P@ssw0rd 사용하여 Dovecot IMAP 서버에서 동일한 사용자의 이메일을 마이그레이션한다고 가정해 보겠습니다. 이때 CSV 파일은 다음과 같습니다.

EmailAddress,UserName,Password
terrya@contoso.edu,terry.adams*mailadmin,P@ssw0rd
annb@contoso.edu,ann.beebe*mailadmin,P@ssw0rd
paulc@contoso.edu,paul.cannon*mailadmin,P@ssw0rd

Mirapoint:

예를 들어 Mirapoint 메시지 서버에서 전자 메일을 마이그레이션하는 경우 관리자 자격 증명에 #user@domain#Admin_UserName# 형식을 사용합니다. 관리자 계정 mailadmin 및 P@ssw0rd 를 사용하여 Mirapoint에서 전자 메일을 마이그레이션하는 경우 CSV 파일은 다음과 같습니다.

EmailAddress,UserName,Password
terrya@contoso.edu,#terry.adams@contoso-students.edu#mailadmin#,P@ssw0rd
annb@contoso.edu,#ann.beebe@contoso-students.edu#mailadmin#,P@ssw0rd
paulc@contoso.edu,#paul.cannon@contoso-students.edu#mailadmin#,P@ssw0rd

Courier IMAP:

Courier IMAP와 같은 일부 원본 전자 메일 시스템은 사서함 관리자 자격 증명을 사용하여 사서함을 Microsoft 365로 마이그레이션하는 것을 지원하지 않습니다. 대신, 가상 공유 폴더를 사용하도록 원본 전자 메일 시스템을 설정할 수 있습니다. 가상 공유 폴더를 사용하여 사서함 관리자 자격 증명을 통해 원본 전자 메일 시스템의 사용자 사서함에 액세스할 수 있습니다. Courier IMAP에 대한 가상 공유 폴더를 구성하는 방법에 대한 자세한 내용은 공유 폴더를 참조하세요.

원본 전자 메일 시스템에서 가상 공유 폴더를 설정한 뒤 사서함을 마이그레이션하려면 선택적 특성인 UserRoot 를 마이그레이션 파일에 포함해야 합니다. 이 특성은 원본 전자 메일 시스템의 가상 공유 폴더 구조에서 각 사용자의 사서함 위치를 지정합니다. 예를 들어 Terry 사서함의 경로는 /users/terry.adams입니다.

다음은 UserRoot 특성을 포함하는 CSV 파일의 예입니다.

EmailAddress,UserName,Password,UserRoot
terrya@contoso.edu,mailadmin,P@ssw0rd,/users/terry.adams
annb@contoso.edu,mailadmin,P@ssw0rd,/users/ann.beebe
paulc@contoso.edu,mailadmin,P@ssw0rd,/users/paul.cannon

3단계: IMAP 마이그레이션 끝점 만들기

전자 메일을 성공적으로 마이그레이션하려면 Microsoft 365가 원본 전자 메일 시스템에 연결하고 통신해야 합니다. 이를 위해 Microsoft 365는 마이그레이션 엔드포인트를 사용합니다. 또한 마이그레이션 끝점은 동시에 마이그레이션할 사서함의 수와 24시간마다 수행되는 증분 동기화 중에 동시에 동기화할 사서함 수도 정의합니다. IMAP 마이그레이션용 마이그레이션 끝점을 만들려면 먼저 Exchange Online에 연결합니다.

전체 마이그레이션 명령 목록을 보려면 이동 및 마이그레이션 cmdlet을 참조하세요.

Exchange Online PowerShell에서 "IMAPEndpoint"라는 IMAP 마이그레이션 끝점을 만들려면 다음 명령을 실행합니다.

New-MigrationEndpoint -IMAP -Name IMAPEndpoint -RemoteServer imap.contoso.com -Port 993 -Security Ssl

동시 마이그레이션, 동시 증분 마이그레이션 및 사용할 포트를 지정하기 위한 매개 변수를 추가할 수도 있습니다. 다음 Exchange Online PowerShell 명령은 50개의 동시 마이그레이션과 최대 25개의 동시 증분 동기화를 지원하는 "IMAPEndpoint"라는 IMAP 마이그레이션 끝점을 만듭니다. 또한 TLS 암호화를 위해 포트 143을 사용하도록 끝점을 구성합니다.

New-MigrationEndpoint -IMAP -Name IMAPEndpoint -RemoteServer imap.contoso.com -Port 143 -Security Tls -MaxConcurrentMigrations
50 -MaxConcurrentIncrementalSyncs 25

New-MigrationEndpoint cmdlet에 대한 자세한 내용은New-MigrationEndpoint를 참조하세요.

작동하는지 확인

Exchange Online PowerShell에서 다음 명령을 실행하여 "IMAPEndpoint"에 대한 정보를 표시합니다.

Get-MigrationEndpoint IMAPEndpoint | Format-List EndpointType,RemoteServer,Port,Security,Max*

4단계: IMAP 마이그레이션 일괄 처리 만들기 및 시작

New-MigrationBatch cmdlet을 사용하여 IMAP 마이그레이션용 마이그레이션 일괄 처리를 만들 수 있습니다. AutoStart 매개 변수를 포함하면 마이그레이션 일괄 처리를 만들고 자동으로 시작할 수 있습니다. 아니면Start-MigrationBatch cmdlet을 사용해 마이그레이션 일괄 처리를 만든 다음 나중에 일괄 처리를 시작할 수도 있습니다.

다음 Exchange Online PowerShell 명령은 "IMAPEndpoint"라는 IMAP 끝점을 사용하여 "IMAPBatch1"이라는 마이그레이션 일괄 처리를 자동으로 시작합니다.

New-MigrationBatch -Name IMAPBatch1 -SourceEndpoint IMAPEndpoint -CSVData ([System.IO.File]::ReadAllBytes("C:\Users\Administrator\Desktop\IMAPmigration_1.csv")) -AutoStart

작동하는지 확인

Get-MigrationBatch cmdlet을 실행하여 "IMAPBatch1"에 대한 정보를 표시합니다.

Get-MigrationBatch -Identity IMAPBatch1 | Format-List

다음 명령을 실행하여 일괄 처리가 시작되었는지 확인할 수도 있습니다.

Get-MigrationBatch -Identity IMAPBatch1 | Format-List Status

5단계: 전자 메일을 Microsoft 365로 라우팅

전자 메일 시스템은 MX 레코드라는 DNS 레코드를 사용하여 전자 메일을 배달할 위치를 확인합니다. 전자 메일 마이그레이션 프로세스 중에는 MX 레코드가 원본 전자 메일 시스템을 가리켰습니다. 이제 Microsoft 365로의 전자 메일 마이그레이션이 완료되었으므로 이제 Microsoft 365에서 MX 레코드를 가리킬 차례입니다. 이렇게 하면 전자 메일이 Microsoft 365 사서함으로 배달되도록 할 수 있습니다. MX 레코드를 이동하여 준비가 되었을 때 이전 전자 메일 시스템을 해제할 수도 있습니다.

DNS 공급자가 많이 있으므로 MX 레코드를 변경하기 위한 특정 지침이 제공됩니다. DNS 공급자가 포함되지 않았거나 일반적인 지침을 파악하려는 경우 일반 MX 레코드 지침 도 제공됩니다.

고객 및 파트너의 전자 메일 시스템이 변경된 MX 레코드를 인식하는 데 최대 72시간이 걸릴 수 있습니다. 다음 작업인 6단계: IMAP 마이그레이션 일괄 처리 삭제로 진행하기 전에 72시간 이상 기다립니다.

6단계: IMAP 마이그레이션 일괄 처리 삭제

MX 레코드를 변경하고 모든 전자 메일에 Microsoft 365 사서함으로 라우팅되는 것을 확인한 후에는 해당 메일이 Microsoft 365로 이동될 것임을 사용자에게 알립니다. 그런 후에는 IMAP 마이그레이션 일괄 처리를 삭제해도 됩니다. 마이그레이션 일괄 처리를 삭제하기 전에 다음을 확인합니다.

  • 모든 사용자가 Microsoft 365 사서함을 사용하고 있습니다. 일괄 처리가 삭제된 후 온-프레미스 Exchange Server 사서함으로 전송된 메일은 해당 Microsoft 365 사서함에 복사되지 않습니다.

  • Microsoft 365 사서함은 메일이 직접 전송되기 시작한 후 적어도 한 번 동기화되었습니다. 이렇게 하려면 메일이 Microsoft 365 사서함으로 직접 라우팅되기 시작한 시점보다 마이그레이션 일괄 처리에 대한 마지막 동기화 시간 상자의 값이 최신인지 확인합니다.

Exchange Online PowerShell에서 "IMAPBatch1" 마이그레이션 일괄 처리를 삭제하려면 다음 명령을 실행합니다.

Remove-MigrationBatch -Identity IMAPBatch1

Remove-MigrationBatch cmdlet에 대한 자세한 내용은Remove-MigrationBatch를 참조하세요.

작동하는지 확인

Exchange Online PowerShell에서 다음 명령을 실행하여 "IMAPBatch1"에 대한 정보를 표시합니다.

Get-MigrationBatch IMAPBatch1"

이 명령을 실행하면 상태가 제거 중 인 마이그레이션 일괄 처리가 반환되거나, 마이그레이션 일괄 처리를 찾을 수 없다는 오류가 반환됩니다. 이 경우 해당 일괄 처리가 삭제되었음을 확인할 수 있습니다.

Get-MigrationBatch cmdlet에 대한 자세한 내용은Get-MigrationBatch를 참조하세요.

참고 항목

IMAP 마이그레이션 문제 해결사