Używanie programu PowerShell do wykonywania migracji IMAP do platformy Microsoft 365
Ten artykuł dotyczy zarówno Microsoft 365 Enterprise, jak i Office 365 Enterprise.
W ramach procesu wdrażania platformy Microsoft 365 można zmigrować zawartość skrzynek pocztowych użytkowników z usługi poczty e-mail protokołu Internet Mail Access Protocol (IMAP) na platformę Microsoft 365. W tym artykule przedstawiono zadania migracji protokołu IMAP w wiadomości e-mail przy użyciu Exchange Online programu PowerShell.
Uwaga
Możesz również użyć centrum administracyjnego programu Exchange do przeprowadzenia migracji IMAP. Zobacz Migrowanie skrzynek pocztowych IMAP.
Co należy wiedzieć przed rozpoczęciem?
Szacowany czas wykonania tego zadania: 2–5 minut na utworzenie partii migracji. Po uruchomieniu partii migracji czas trwania migracji będzie się różnić w zależności od liczby skrzynek pocztowych w partii, rozmiaru każdej skrzynki pocztowej i dostępnej pojemności sieciowej. Aby uzyskać informacje o innych czynnikach wpływających na czas migrowania skrzynek pocztowych na platformę Microsoft 365, zobacz Wydajność migracji.
Do wykonania tych procedur musisz mieć przypisane uprawnienia. Aby zobaczyć, jakich uprawnień potrzebujesz, zobacz wpis "Migracja" w tabeli w artykule Uprawnienia adresatów .
Aby użyć poleceń cmdlet programu PowerShell Exchange Online, musisz zalogować się i zaimportować polecenia cmdlet do lokalnej sesji Windows PowerShell. Aby uzyskać instrukcje, zobacz Nawiązywanie połączenia z Exchange Online programu PowerShell.
Aby uzyskać pełną listę poleceń migracji, zobacz Przenoszenie i migracja poleceń cmdlet.
Migracje IMAP mają zastosowanie do następujących ograniczeń:
Można migrować tylko elementy w skrzynce odbiorczej użytkownika lub w innych folderach poczty. Nie można migrować kontaktów, elementów kalendarza ani zadań.
Z poziomu skrzynki pocztowej użytkownika można migrować maksymalnie 500 000 elementów.
Maksymalny rozmiar komunikatu, który można zmigrować, wynosi 35 MB.
Kroki migracji
Krok 1. Przygotowanie do migracji IMAP
Jeśli masz domenę dla swojej organizacji IMAP, dodaj ją jako zaakceptowaną domenę organizacji platformy Microsoft 365. Jeśli chcesz użyć tej samej domeny, którą już posiadasz dla skrzynek pocztowych platformy Microsoft 365, musisz najpierw dodać ją jako zaakceptowaną domenę do platformy Microsoft 365. Po dodaniu można utworzyć użytkowników na platformie Microsoft 365. Aby uzyskać więcej informacji, zobaczWeryfikowanie domeny.
Dodaj każdego użytkownika do platformy Microsoft 365, aby miał skrzynkę pocztową. Aby uzyskać instrukcje, zobaczDodawanie użytkowników do platformy Microsoft 365 dla firm.
Uzyskaj nazwę FQDN serwera IMAP. Musisz podać w pełni kwalifikowaną nazwę domeny (FQDN) (nazywaną również pełną nazwą komputera) serwera IMAP, z którego będą migrowane dane skrzynki pocztowej podczas tworzenia punktu końcowego migracji IMAP. Użyj klienta IMAP lub polecenia PING, aby sprawdzić, czy ta nazwa FQDN umożliwia komunikację z serwerem IMAP przez Internet.
Skonfiguruj zaporę tak, aby zezwalała na połączenia IMAP. Może być konieczne otwarcie portów w zaporze organizacji hostującej serwer IMAP, aby ruch sieciowy pochodzący z centrum danych firmy Microsoft podczas migracji mógł wejść do organizacji hostującej serwer IMAP. Aby uzyskać listę adresów IP używanych przez centra danych firmy Microsoft, zobacz Exchange Online adresów URL i zakresów adresów IP.
Przypisz uprawnienia konta administratora do uzyskiwania dostępu do skrzynek pocztowych w organizacji IMAP. Jeśli użyjesz poświadczeń administratora w pliku CSV, konto, z którego korzystasz, musi mieć uprawnienia niezbędne do uzyskania dostępu do wszystkich lokalnych skrzynek pocztowych. Uprawnienia wymagane do uzyskiwania dostępu do skrzynek pocztowych użytkowników są określane przez konkretny serwer IMAP.
Aby użyć poleceń cmdlet programu PowerShell Exchange Online, musisz zalogować się i zaimportować polecenia cmdlet do lokalnej sesji Windows PowerShell. Aby uzyskać instrukcje, zobacz Nawiązywanie połączenia z Exchange Online programu PowerShell.
Aby uzyskać pełną listę poleceń migracji, zobacz Przenoszenie i migracja poleceń cmdlet.
Sprawdź, czy możesz nawiązać połączenie z serwerem IMAP. Uruchom następujące polecenie w programie Exchange Online programu PowerShell, aby przetestować ustawienia połączenia z serwerem IMAP.
Test-MigrationServerAvailability -IMAP -RemoteServer <FQDN of IMAP server> -Port <143 or 993> -Security <None, Ssl, or Tls>W przypadku wartości parametru Port typowe jest użycie wartości 143 dla połączeń nieszyfrowanych lub TLS (Transport Layer Security) oraz użycie wartości 993 dla połączeń SSL.
Krok 2. Tworzenie pliku CSV dla partii migracji IMAP
Zidentyfikuj grupę użytkowników, których skrzynki pocztowe mają być migrowane w partii migracji IMAP. Każdy wiersz w pliku CSV zawiera informacje niezbędne do nawiązania połączenia ze skrzynką pocztową w systemie komunikatów IMAP.
Opisano tutaj wymagane atrybuty dla poszczególnych użytkowników:
EmailAddress określa identyfikator użytkownika dla skrzynki pocztowej platformy Microsoft 365 użytkownika.
UserName określa nazwę logowania dla konta do użycia w celu uzyskania dostępu do skrzynki pocztowej na serwerze IMAP.
Hasło określa hasło dla konta w kolumnie UserName .
Poniżej przedstawiono przykładowy format pliku CSV. W tym przykładzie migrowane są trzy skrzynki pocztowe:
EmailAddress,UserName,Password
terrya@contoso.edu,terry.adams,1091990
annb@contoso.edu,ann.beebe,2111991
paulc@contoso.edu,paul.cannon,3281986
W przypadku atrybutu UserName oprócz nazwy użytkownika można użyć poświadczeń konta, do którego przypisano uprawnienia niezbędne do uzyskiwania dostępu do skrzynek pocztowych na serwerze IMAP, poniżej przedstawiono niektóre z określonych formatów używanych dla niektórych serwerów IMAP:
Microsoft Exchange:
Jeśli poczta e-mail jest migrowana z implementacji serwera IMAP dla programu Microsoft Exchange, należy w pliku CSV użyć dla atrybutu UserName formatu Domain/Admin_UserName/User_UserName. Można na przykład założyć, że z programu Exchange migrowana jest poczta e-mail użytkowników Terry Adams, Ann Beebe i Paul Cannon. Masz konto administratora poczty, gdzie nazwa użytkownika to mailadmin , a hasło jest P@ssw0rd. Plik CSV będzie wyglądał następująco:
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:
W przypadku serwerów IMAP, które obsługują uwierzytelnianie proste i warstwę zabezpieczeń (SASL), takich jak serwer IMAP aplikacji Dovecot, użyj formatu User_UserName*Admin_UserName, gdzie gwiazdka ( * ) jest konfigurowalnym znakiem separatora. Załóżmy, że migrujesz wiadomości e-mail tych samych użytkowników z serwera IMAP aplikacji Dovecot przy użyciu poświadczeń administratora mailadmin i P@ssw0rd. Plik CSV będzie wyglądał następująco:
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:
Jeśli przeprowadzasz migrację poczty e-mail z serwera wiadomości Mirapoint, użyj dla poświadczeń administratora formatu #user@domain#Admin_UserName#. Aby przeprowadzić migrację wiadomości e-mail z programu Mirapoint przy użyciu poświadczeń administratora mailadmin i P@ssw0rd, plik CSV będzie wyglądać następująco:
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:
Niektóre źródłowe systemy poczty e-mail, takie jak Courier IMAP, nie obsługują korzystania z poświadczeń administratora skrzynki pocztowej w celu migrowania skrzynek pocztowych na platformę Microsoft 365. Możesz jednak skonfigurować źródłowy system poczty e-mail tak, aby korzystał z wirtualnych folderów udostępnionych. Korzystając z wirtualnych folderów udostępnionych, możesz użyć poświadczeń administratora skrzynki pocztowej, aby uzyskać dostęp do skrzynek pocztowych użytkowników w źródłowym systemie poczty e-mail. Aby uzyskać więcej informacji na temat sposobu konfigurowania wirtualnych folderów udostępnionych w systemie Courier IMAP, zobacz Foldery udostępnione.
Aby przeprowadzić migrację skrzynek pocztowych po skonfigurowaniu wirtualnych folderów udostępnionych w źródłowym systemie poczty e-mail, wprowadź w pliku migracji opcjonalny atrybut UserRoot (katalog główny). Ten atrybut określa lokalizację skrzynek pocztowych poszczególnych użytkowników w strukturze wirtualnych folderów udostępnionych w źródłowym systemie poczty e-mail. Na przykład ścieżka do skrzynki pocztowej Terry'ego to /users/terry.adams.
Poniżej przedstawiono przykładowy plik CSV zawierający atrybut UserRoot:
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
Krok 3. Tworzenie punktu końcowego migracji IMAP
Aby pomyślnie przeprowadzić migrację poczty e-mail, platforma Microsoft 365 musi nawiązać połączenie ze źródłowym systemem poczty e-mail i komunikować się z nią. W tym celu platforma Microsoft 365 używa punktu końcowego migracji. Punkt końcowy migracji definiuje również liczbę skrzynek pocztowych do jednoczesnej migracji oraz liczbę skrzynek pocztowych do jednoczesnej synchronizacji podczas synchronizacji przyrostowej, która występuje raz na 24 godziny. Aby utworzyć punkt końcowy migracji dla migracji IMAP, najpierw połącz się z Exchange Online.
Aby uzyskać pełną listę poleceń migracji, zobacz Przenoszenie i migracja poleceń cmdlet.
Aby utworzyć punkt końcowy migracji IMAP o nazwie "IMAPEndpoint" w programie Exchange Online programie PowerShell, uruchom następujące polecenie:
New-MigrationEndpoint -IMAP -Name IMAPEndpoint -RemoteServer imap.contoso.com -Port 993 -Security Ssl
Można również dodać parametry określające migracje współbieżne, współbieżne migracje przyrostowe i port do użycia. Następujące polecenie Exchange Online programu PowerShell tworzy punkt końcowy migracji IMAP o nazwie "IMAPEndpoint", który obsługuje 50 równoczesnych migracji i maksymalnie 25 współbieżnych synchronizacji przyrostowych. Konfiguruje również punkt końcowy do używania portu 143 na potrzeby szyfrowania TLS.
New-MigrationEndpoint -IMAP -Name IMAPEndpoint -RemoteServer imap.contoso.com -Port 143 -Security Tls -MaxConcurrentMigrations
50 -MaxConcurrentIncrementalSyncs 25
Aby uzyskać więcej informacji na temat polecenia cmdlet New-MigrationEndpoint , zobaczNew-MigrationEndpoint.
Sprawdź, czy to zadziałało
Uruchom następujące polecenie w programie Exchange Online programu PowerShell, aby wyświetlić informacje o "IMAPEndpoint":
Get-MigrationEndpoint IMAPEndpoint | Format-List EndpointType,RemoteServer,Port,Security,Max*
Krok 4. Tworzenie i uruchamianie partii migracji IMAP
Aby utworzyć partię migracji dla migracji IMAP, możesz użyć polecenia cmdlet New-MigrationBatch . Możesz utworzyć partię migracji i uruchomić ją automatycznie, dołączając parametr AutoStart . Alternatywnie możesz utworzyć partię migracji, a następnie uruchomić ją później za pomocą polecenia cmdletStart-MigrationBatch .
Następujące polecenie Exchange Online programu PowerShell automatycznie uruchomi partię migracji o nazwie "IMAPBatch1" przy użyciu punktu końcowego IMAP o nazwie "IMAPEndpoint":
New-MigrationBatch -Name IMAPBatch1 -SourceEndpoint IMAPEndpoint -CSVData ([System.IO.File]::ReadAllBytes("C:\Users\Administrator\Desktop\IMAPmigration_1.csv")) -AutoStart
Sprawdź, czy to zadziałało
Uruchom polecenie cmdlet Get-MigrationBatch , aby wyświetlić informacje o "IMAPBatch1":
Get-MigrationBatch -Identity IMAPBatch1 | Format-List
Możesz również sprawdzić, czy partia została uruchomiona, uruchamiając następujące polecenie:
Get-MigrationBatch -Identity IMAPBatch1 | Format-List Status
Krok 5. Kierowanie wiadomości e-mail na platformę Microsoft 365
Systemy poczty e-mail ustalają lokalizację, do której należy dostarczać wiadomości e-mail, na podstawie rekordu DNS nazywanego rekordem MX. W trakcie procesu migracji poczty e-mail rekord MX wskazywał źródłowy system poczty e-mail. Po zakończeniu migracji poczty e-mail na platformę Microsoft 365 nadszedł czas, aby wskazać rekord MX na platformie Microsoft 365. Pomaga to upewnić się, że wiadomość e-mail jest dostarczana do skrzynek pocztowych platformy Microsoft 365. Przenosząc rekord MX, możesz również wyłączyć stary system poczty e-mail, gdy wszystko będzie gotowe.
W przypadku wielu dostawców hostingu DNS dostępne są szczegółowe instrukcje dotyczące zmieniania rekordu MX. Jeśli Twojego dostawcy hostingu DNS nie ma na liście lub jeśli chcesz zapoznać się z ogólnymi wskazówkami, dostępne są również ogólne instrukcje dotyczące rekordów MX.
Rozpoznanie zmienionego rekordu MX przez systemy poczty e-mail Twoich klientów i partnerów może potrwać do 72 godzin. Poczekaj co najmniej 72 godziny, zanim przejdziesz do następnego zadania: Krok 6. Usuwanie partii migracji IMAP.
Krok 6. Usuwanie partii migracji IMAP
Po zmianie rekordu MX i sprawdzeniu, czy wszystkie wiadomości e-mail są kierowane do skrzynek pocztowych platformy Microsoft 365, powiadom użytkowników, że ich poczta trafia na platformę Microsoft 365. Następnie możesz usunąć partię migracji IMAP. Przed usunięciem partii migracji sprawdź, czy są spełnione poniższe wymagania.
Wszyscy użytkownicy korzystają ze skrzynek pocztowych platformy Microsoft 365. Po usunięciu partii poczta wysłana do skrzynek pocztowych w lokalnym Exchange Server nie jest kopiowana do odpowiednich skrzynek pocztowych platformy Microsoft 365.
Skrzynki pocztowe platformy Microsoft 365 były synchronizowane co najmniej raz po tym, jak poczta zaczęła być wysyłana bezpośrednio do nich. W tym celu upewnij się, że wartość w polu Czas ostatniej synchronizacji dla partii migracji jest nowsza niż wtedy, gdy poczta zaczęła być kierowana bezpośrednio do skrzynek pocztowych platformy Microsoft 365.
Aby usunąć partię migracji "IMAPBatch1" z programu Exchange Online programu PowerShell, uruchom następujące polecenie:
Remove-MigrationBatch -Identity IMAPBatch1
Aby uzyskać więcej informacji na temat polecenia cmdlet Remove-MigrationBatch , zobaczRemove-MigrationBatch.
Sprawdź, czy to zadziałało
Uruchom następujące polecenie w programie Exchange Online programu PowerShell, aby wyświetlić informacje o "IMAPBatch1":
Get-MigrationBatch IMAPBatch1"
Polecenie zwróci partię migracji ze stanem Usuwanie lub zwróci błąd informujący, że nie można odnaleźć partii migracji, sprawdzając, czy partia została usunięta.
Aby uzyskać więcej informacji na temat polecenia cmdlet Get-MigrationBatch , zobaczGet-MigrationBatch.