Миграция IMAP в Microsoft 365 с помощью PowerShell

  • Статья

Эта статья относится к Microsoft 365 корпоративный и Office 365 корпоративный.

В процессе развертывания Microsoft 365 можно перенести содержимое почтовых ящиков пользователей из службы электронной почты IMAP в Microsoft 365. В этой статье описаны задачи, которые выполняются при миграции электронной почты IMAP с помощью Exchange Online PowerShell.

Примечание.

Вы также можете использовать Центр администрирования Exchange для выполнения миграции IMAP. См . раздел Перенос почтовых ящиков IMAP.

Что нужно знать перед началом работы

Предполагаемое время выполнения этой задачи: 2–5 минут для создания пакета миграции. После запуска пакета миграции продолжительность миграции будет зависеть от количества почтовых ящиков в пакете, размера каждого почтового ящика и доступной пропускной способности сети. Сведения о других факторах, влияющих на продолжительность миграции почтовых ящиков в Microsoft 365, см. в статье Производительность миграции.

Для выполнения этой процедуры (процедур) необходимы соответствующие разрешения. Сведения о необходимых разрешениях см. в записи "Миграция" в таблице статьи Разрешения получателей .

Чтобы использовать командлеты Exchange Online PowerShell, вам необходимо войти в систему и импортировать командлеты в локальный сеанс Windows PowerShell. Инструкции см. в разделе Подключение к Exchange Online PowerShell.

Полный список команд миграции см. в статье Командлеты перемещения и миграции.

К миграции IMAP применяются следующие ограничения.

  • Можно перемещать только элементы из папки "Входящие" и других папок почты. Миграция контактов, элементов календаря и задач невозможна.

  • Из почтового ящика пользователя можно перенести не более 500 000 элементов.

  • Максимальный размер сообщения, которое можно перенести, равен 35 МБ.

Шаги миграции

Шаг 1. Подготовка к миграции IMAP

  • Если у вас есть домен для организации IMAP, добавьте его в качестве принятого домена организации Microsoft 365. Если вы хотите использовать тот же домен, который вы уже владеете для почтовых ящиков Microsoft 365, сначала необходимо добавить его в качестве принятого домена в Microsoft 365. После его добавления вы можете создавать пользователей в Microsoft 365. Дополнительные сведения см. в разделеПроверка домена.

  • Добавьте каждого пользователя в Microsoft 365, чтобы у него был почтовый ящик. Инструкции см. в статьеДобавление пользователей в Microsoft 365 для бизнеса.

  • Получите полное доменное имя (FQDN) сервера IMAP. Необходимо указать полное доменное имя (FQDN) (также называемое полным именем компьютера) IMAP-сервера, с который вы будете переносить данные почтового ящика при создании конечной точки миграции IMAP. С помощью клиента IMAP или команды PING убедитесь, что это имя можно использовать для подключения к серверу IMAP через Интернет.

  • Настройте брандмауэр, разрешив подключения IMAP. Может потребоваться открыть порты в брандмауэре организации, в которой размещен сервер IMAP, чтобы сетевой трафик, исходящий из центра обработки данных корпорации Майкрософт во время миграции, смог поступать в организацию, в которой размещен сервер IMAP. Список IP-адресов, используемых центрами обработки данных Майкрософт, см. в разделе EXCHANGE ONLINE URL-адреса и диапазоны IP-адресов.

  • Предоставьте учетной записи администратора разрешения на доступа к почтовым ящикам в организации IMAP. Если в CSV-файле используются учетные данные администратора, применяемая учетная запись должна иметь необходимые разрешения на доступ к локальным почтовым ящикам. Разрешения, необходимые для доступа к почтовым ящикам пользователей, определяются конкретным сервером IMAP.

  • Чтобы использовать командлеты Exchange Online PowerShell, вам необходимо войти в систему и импортировать командлеты в локальный сеанс Windows PowerShell. Инструкции см. в разделе Подключение к Exchange Online PowerShell.

    Полный список команд миграции см. в статье Командлеты перемещения и миграции.

  • Убедитесь, что вы можете подключиться к серверу IMAP. Выполните следующую команду в Exchange Online PowerShell, чтобы проверить параметры подключения к серверу IMAP.

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

    Для параметра Port обычно устанавливается значение 143 для незашифрованных или TLS-соединений и значение 993 для SSL-соединений.

Шаг 2. Создание CSV-файла для пакета миграции IMAP.

Определите группу пользователей, миграцию чьих почтовых ящиков следует выполнить с помощью пакета миграции IMAP. Каждая строка в CSV-файле содержит сведения, необходимые для подключения к почтовому ящику в системе обмена сообщениями IMAP.

Ниже приведены обязательные атрибуты для каждого пользователя.

  • EmailAddress указывает идентификатор пользователя для почтового ящика Microsoft 365.

  • 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

If you're migrating email from the IMAP implementation for Microsoft Exchange, use the format Domain/Admin_UserName/User_UserName for the UserName attribute in the CSV file. Let's say you're migrating email from Exchange for Terry Adams, Ann Beebe, and Paul Cannon. You have a mail administrator account, where the user name is mailadmin and the password is P@ssw0rd. Here's what your CSV file would look like:

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

На серверах IMAP, поддерживающих протокол SASL, например Dovecot, используется формат имя_пользователя*имя_администратора, где звездочка ( * ) является настраиваемым знаком разделения. Допустим, переносится почта тех же самых пользователей с сервера IMAP Dovecot с использованием учетных данных администратора mailadmin и P@ssw0rd. Вот как будет выглядеть 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 Message Server для учетных данных администратора используется формат #пользователь@домен#имя_администратора#. Для переноса электронной почты с Mirapoint с использованием учетных данных администратора mailadmin и P@ssw0rd 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.

Ниже приведен пример CSV-файла, содержащего атрибут 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

Шаг 3. Создание конечной точки миграции IMAP

Для успешной миграции электронной почты Microsoft 365 необходимо подключиться к исходной почтовой системе и взаимодействовать с ней. Для этого Microsoft 365 использует конечную точку миграции. Конечная точка миграции также определяет количество почтовых ящиков для одновременной миграции и для одновременной синхронизации в процессе добавочной синхронизации, которая осуществляется один раз каждые 24 часа. Чтобы создать конечную точку миграции IMAP, сначала подключитесь к Exchange Online.

Полный список команд миграции см. в статье Командлеты перемещения и миграции.

Чтобы создать конечную точку миграции IMAP с именем IMAPEndpoint в Exchange Online PowerShell, выполните следующую команду.

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

Вы также можете добавить параметры, чтобы указать одновременно выполняемые миграции (в том числе добавочные) и используемый порт. Следующая команда Exchange Online PowerShell создает конечную точку миграции IMAP с именем IMAPEndpoint, которая поддерживает 50 одновременных миграций и до 25 одновременных добавочных синхронизаций. В этом примере конечная точка также настраивается на использование порта 143 для шифрования TLS.

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

Дополнительные сведения о командлете New-MigrationEndpoint см. в статьеNew-MigrationEndpoint.

Проверка работы

Выполните следующую команду в Exchange Online PowerShell, чтобы отобразить сведения о конечной точке миграции IMAPEndpoint.

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

Шаг 4. Создание и запуск пакета миграции IMAP

Для создания пакета миграции IMAP можно использовать командлет New-MigrationBatch. Можно создать пакет миграции и запустить его обработку автоматически, включив параметр AutoStart. Кроме того, вы можете создать пакет миграции и запустить его с помощью командлета Start-MigrationBatch.

Следующая команда Exchange Online PowerShell автоматически запустит пакет миграции IMAPBatch1 с использованием конечной точки IMAP с именем IMAPEndpoint.

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

Проверка работы

Выполните командлет Get-MigrationBatch, чтобы отобразить сведения о пакете миграции IMAPBatch1.

Get-MigrationBatch -Identity IMAPBatch1 | Format-List

Вы также можете убедиться, что пакет запущен, выполнив следующую команду.

Get-MigrationBatch -Identity IMAPBatch1 | Format-List Status

Шаг 5. Маршрутизация электронной почты в Microsoft 365

Почтовые системы используют запись DNS, которая называется записью MX, чтобы определять, куда нужно доставить электронную почту. В процессе миграции электронной почты запись MX указывала на вашу исходную систему электронной почты. Теперь, когда миграция электронной почты в Microsoft 365 завершена, пришло время указать запись MX на Microsoft 365. Это помогает убедиться, что электронная почта доставлена в почтовые ящики Microsoft 365. Перемещая запись MX, вы также сможете отключить старую систему электронной почты, когда будете готовы сделать это.

Для многих поставщиков DNS предоставляются отдельные инструкции по изменению записей MX. Если вашего поставщика DNS нет в списке или вы хотите в целом понять, как выполнять этот процесс, также существуют общие инструкции по настройке записей MX.

Для того чтобы почтовые системы ваших клиентов и партнеров начали распознавать измененную запись MX, может потребоваться до 72 часов. Подождите по крайней мере 72 часа, прежде чем перейти к следующей задаче: Шаг 6. Удаление пакета миграции IMAP.

Шаг 6. Удаление пакета миграции IMAP

После того как вы измените запись MX и убедитесь, что вся электронная почта направляется в почтовые ящики Microsoft 365, уведомите пользователей о том, что их почта направляется в Microsoft 365. Затем можно удалить пакет миграции IMAP. Убедитесь в следующем, прежде чем удалить пакет миграции.

  • Все пользователи используют почтовые ящики Microsoft 365. После удаления пакета почта, отправленная в почтовые ящики в локальной Exchange Server, не копируется в соответствующие почтовые ящики Microsoft 365.

  • Почтовые ящики Microsoft 365 были синхронизированы по крайней мере один раз после отправки почты непосредственно в них. Для этого убедитесь, что значение в поле Время последней синхронизации для пакета миграции является более поздним, чем при начале маршрутизации почты непосредственно в почтовые ящики Microsoft 365.

Чтобы удалить пакет миграции IMAPBatch1 в Exchange Online PowerShell, выполните следующую команду.

Remove-MigrationBatch -Identity IMAPBatch1

Дополнительные сведения о командлете Remove-MigrationBatch см. в статьеRemove-MigrationBatch.

Проверка работы

Выполните следующую команду в Exchange Online PowerShell, чтобы отобразить сведения о пакете миграции IMAPBatch1.

Get-MigrationBatch IMAPBatch1"

Команда либо вернет пакет миграции с состоянием Удаление, либо вернет ошибку (не удалось найти пакет миграции), что подтверждает удаление пакета миграции.

Дополнительные сведения о командлете Get-MigrationBatch см. в статьеGet-MigrationBatch.

См. также

Средство устранения неполадок миграции IMAP