Использование PowerShell для миграции IMAP в Office 365Use PowerShell to perform an IMAP migration to Office 365

Сводка. Узнайте, как выполнить IMAP-миграцию в Office 365, используя Windows PowerShell.Summary: Learn how to use Windows PowerShell to perform an IMAP migration to Office 365.

В процессе развертывания Office 365:, вы можете перенести содержимое почтовых ящиков пользователей из службы электронной почты IMAP в Office 365:. В этой статье описаны задачи, которые выполняются при миграции электронной почты IMAP с помощью Exchange Online PowerShell.As part of the process of deploying Office 365, you can choose to migrate the contents of user mailboxes from an Internet Mail Access Protocol (IMAP) email service to Office 365. This article walks you through the tasks for an email IMAP migration by using Exchange Online PowerShell.

Примечание

Для миграции IMAP можно также использовать Центр администрирования Exchange. См. статью Перенос почтовых ящиков IMAP в Office 365.You can also use the Exchange admin center to perform an IMAP migration. See Migrate your IMAP mailboxes to Office 365.

Что нужно знать перед началом работы?What do you need to know before you begin?

Предполагаемое время выполнения задачи: от 2 до 5 минут для создания пакета миграции. После запуска пакета миграции продолжительность миграции будет зависеть от количества почтовых ящиков в пакете, размера каждого почтового ящика и доступной пропускной способности сети. Подробнее о других факторах, влияющих на продолжительность миграции почтовых ящиков в Office 365:, см. в статье Производительность миграцииEstimated time to complete this task: 2-5 minutes to create a migration batch. After the migration batch is started, the duration of the migration will vary based on the number of mailboxes in the batch, the size of each mailbox, and your available network capacity. For information about other factors that affect how long it takes to migrate mailboxes to Office 365, see Migration Performance.

Для выполнения этой процедуры (процедур) необходимы соответствующие разрешения. Сведения о необходимых разрешениях см. в пункте "Миграция" статьи Разрешения получателей в соответствующей таблице.You need to be assigned permissions before you can perform this procedure or procedures. To see what permissions you need, see the "Migration" entry in a table in the Recipients Permissions topic.

Чтобы использовать командлеты Exchange Online PowerShell, вам необходимо войти в систему и импортировать командлеты в локальный сеанс Windows PowerShell. Инструкции см в статье Подключение к Exchange Online с помощью удаленной оболочки PowerShell.To use the Exchange Online PowerShell cmdlets, you need to sign in and import the cmdlets into your local Windows PowerShell session. See Connect to Exchange Online using remote PowerShell for instructions.

Полный список команд миграции см. в статье Командлеты перемещения и миграции.For a full list of migration commands, see Move and migration cmdlets.

К миграции IMAP применяются следующие ограничения.The following restrictions apply to IMAP migrations:

  • Можно перемещать только элементы из папки "Входящие" и других папок почты. Миграция контактов, элементов календаря и задач невозможна.Only items in a user's inbox or other mail folders can be migrated. You can't migrate contacts, calendar items, or tasks.

  • Из почтового ящика пользователя можно перенести не более 500 000 элементов.A maximum of 500,000 items can be migrated from a user's mailbox.

  • Максимальный размер сообщения, которое можно перенести, равен 35 МБ.The maximum message size that can be migrated is 35 MB.

Шаги миграцииMigration steps

Шаг 1. Подготовка к миграции IMAPStep 1: Prepare for an IMAP migration

  • Если у организации IMAP есть домен, добавьте его в качестве обслуживаемого домена организации Office 365. Если вы хотите использовать имеющийся домен для своих почтовых ящиков Office 365:, сначала его необходимо добавить в Office 365: в качестве обслуживаемого домена. После добавления вы можете создать пользователей в Office 365:. Дополнительные сведения см. в статьеПроверка домена в Office 365.If you have a domain for you IMAP organization, add it as an accepted domain of your Office 365 organization. If you want to use the same domain you already own for your Office 365 mailboxes, you first have to add it as an accepted domain to Office 365. After you have added it, you can create your users in Office 365. For more information, seeVerify your domain in Office 365.

  • Добавьте всех пользователей в Office 365:, чтобы у каждого из них был почтовый ящик Office 365:. Инструкции см. в статьеДобавление пользователей в Office 365 для бизнеса.Add each user to Office 365 so that they have an Office 365 mailbox. For instructions, seeAdd users to Office 365 for business.

  • Получите полное доменное имя (FQDN) сервера IMAP. Необходимо указать полное доменное имя (FQDN) (которое также называется полным именем компьютера) сервера IMAP, из которого будут переноситься данные почтовых ящиков при создании конечной точки миграции IMAP. С помощью клиента IMAP или команды PING убедитесь, что это имя можно использовать для подключения к серверу IMAP через Интернет.Obtain the FQDN of the IMAP server. You need to provide the fully qualified domain name (FQDN) (also called the full computer name) of the IMAP server that you will migrate mailbox data from when you create an IMAP migration endpoint. Use an IMAP client or the PING command to verify that you can use the FQDN to communicate with the IMAP server over the Internet.

  • Настройте брандмауэр, разрешив подключения IMAP. Может потребоваться открыть порты в брандмауэре организации, в которой размещен сервер IMAP, чтобы сетевой трафик, исходящий из центра обработки данных корпорации Майкрософт во время миграции, смог поступать в организацию, в которой размещен сервер IMAP. Список IP-адресов, используемых центрами обработки данных корпорации Майкрософт, см. в статье URL-адреса и диапазоны IP-адресов Office 365.Configure the firewall to allow IMAP connections. You might have to open ports in the firewall of the organization that hosts the IMAP server so network traffic originating from the Microsoft datacenter during the migration is allowed to enter the organization that hosts the IMAP server. For a list of IP addresses used by Microsoft datacenters, see Exchange Online URLs and IP Address Ranges.

  • Предоставьте учетной записи администратора разрешения на доступа к почтовым ящикам в организации IMAP. Если в CSV-файле используются учетные данные администратора, применяемая учетная запись должна иметь необходимые разрешения на доступ к локальным почтовым ящикам. Разрешения, необходимые для доступа к почтовым ящикам пользователей, определяются конкретным сервером IMAP.Assign the administrator account permissions to access mailboxes in your IMAP organization. If you use administrator credentials in the CSV file, the account that you use must have the necessary permissions to access the on-premises mailboxes. The permissions required to access user mailboxes is determined by the particular IMAP server.

  • Чтобы использовать командлеты Exchange Online PowerShell, вам необходимо войти в систему и импортировать командлеты в локальный сеанс Windows PowerShell. Инструкции см в статье Подключение к Exchange Online с помощью удаленной оболочки PowerShell.To use the Exchange Online PowerShell cmdlets, you need to sign in and import the cmdlets into your local Windows PowerShell session. See Connect to Exchange Online using remote PowerShell for instructions.

    Полный список команд миграции см. в статье Командлеты перемещения и миграции.For a full list of migration commands, see Move and migration cmdlets.

  • Убедитесь, что вы можете подключиться к серверу IMAP. Выполните следующую команду в Exchange Online PowerShell, чтобы проверить параметры подключения к серверу IMAP.Verify that you can connect to your IMAP server. Run the following command in Exchange Online PowerShell to test the connection settings to your IMAP server.

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

    Для параметра Port обычно устанавливается значение 143 для незашифрованных или TLS-соединений и значение 993 для SSL-соединений.For the value of the Port parameter, it's typical to use 143 for unencrypted or Transport Layer Security (TLS) connections and to use 993 for SSL connections.

Шаг 2. Создание CSV-файла для пакета миграции IMAP.Step 2: Create a CSV file for an IMAP migration batch

Определите группу пользователей, миграцию чьих почтовых ящиков следует выполнить с помощью пакета миграции IMAP. Каждая строка в CSV-файле содержит сведения, необходимые для подключения к почтовому ящику в системе обмена сообщениями IMAP.Identify the group of users whose mailboxes you want to migrate in an IMAP migration batch. Each row in the CSV file contains information necessary to connect to a mailbox in the IMAP messaging system.

Ниже приведены обязательные атрибуты для каждого пользователя.Here are the required attributes for each user:

  • EmailAddress. Задает идентификатор пользователя для его почтового ящика Office 365:.EmailAddress specifies the user ID for the user's Office 365 mailbox.

  • UserName. Задает для учетной записи имя для входа, при помощи которого будет выполняться доступ к почтовому ящику на сервере IMAP.UserName specifies the logon name for the account to use to access the mailbox on the IMAP server.

  • Password. Задает пароль для учетной записи в столбце UserName.Password specifies the password for the account in the UserName column.

Ниже приведен пример формата CSV-файла. В этом примере выполняется миграция трех почтовых ящиков.Here's an example of the format for the CSV file. In this example, three mailboxes are migrated:

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

В качестве значения атрибута UserName кроме имени пользователя можно использовать данные учетной записи, для которой назначены необходимые разрешения на доступ к почтовым ящикам на сервере IMAP. Ниже перечислены несколько специальных форматов, используемых для некоторых серверов IMAP.For the UserName attribute, in addition to the user name, you can use the credentials of an account that has been assigned the necessary permissions to access mailboxes on the IMAP server, the following are some of the specific formats used for some of the IMAP servers:

Microsoft ExchangeMicrosoft Exchange:

При переносе электронной почты с реализации IMAP в Microsoft Exchange для атрибута UserName в CSV-файле используется формат домен/имя_администратора/имя_пользователя. Предположим, выполняется перенос электронной почты Exchange для учетных записей Terry Adams, Ann Beebe и Chris Cannon. Имеется учетная запись администратора почты с именем пользователя mailadmin и паролем P@ssw0rd. Вот как будет выглядеть CSV-файл.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

DovecotDovecot:

На серверах IMAP, поддерживающих протокол SASL, например Dovecot, используется формат имя_пользователя*имя_администратора, где звездочка (*) является настраиваемым знаком разделения. Допустим, переносится почта тех же пользователей с сервера IMAP Dovecot с использованием учетных данных администратора mailadmin и P@ssw0rd. Вот как будет выглядеть CSV-файл:For IMAP servers that support Simple Authentication and Security Layer (SASL), such as a Dovecot IMAP server, use the format User_UserName*Admin_UserName, where the asterisk ( * ) is a configurable separator character. Let's say you're migrating those same users' email from a Dovecot IMAP server using the administrator credentials mailadmin and P@ssw0rd. Here's what your CSV file would look like:

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

MirapointMirapoint:

При переносе почты с сервера Mirapoint Message Server для учетных данных администратора используется формат #пользователь@домен#имя_администратора#. Для переноса электронной почты с Mirapoint с использованием учетных данных администратора mailadmin и P@ssw0rd CSV-файл должен выглядеть следующим образом.If you're migrating email from Mirapoint Message Server, use the format #user@domain#Admin_UserName# for the administrator credentials. To migrate email from Mirapoint using the administrator credentials mailadmin and P@ssw0rd, your CSV file would look like this:

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-IMAPCourier IMAP:

Некоторые исходные системы электронной почты, такие как Courier IMAP, не поддерживают использование учетных данных администратора почтовых ящиков для переноса почтовых ящиков в Office 365:. В таком случае исходную систему электронной почты необходимо настроить на использование виртуальных общих папок. С помощью виртуальных общих папок вы можете использовать учетные данные администратора почтовых ящиков для доступа к почтовым ящикам пользователей в исходной системе электронной почты. Дополнительные сведения о настройке виртуальных общих папок для Courier IMAP см. в статье Общие папки.Some source email systems, such as Courier IMAP, don't support using mailbox admin credentials to migrate mailboxes to Office 365. Instead, you can set up your source email system to use virtual shared folders. By using virtual shared folders, you can use the mailbox admin credentials to access user mailboxes on the source email system. For more information about how to configure virtual shared folders for Courier IMAP, see Shared Folders.

Чтобы перенести почтовые ящики после настройки виртуальных общих папок в исходной системе электронной почты, в файл миграции необходимо включить необязательный атрибут UserRoot. Этот атрибут определяет расположение каждого пользовательского почтового ящика в структуре виртуальных общих папок в исходной системе электронной почты. Например, путь к почтовому ящику пользователя Terry /users/terry.adams.To migrate mailboxes after you set up virtual shared folders on your source email system, you have to include the optional attribute UserRoot in the migration file. This attribute specifies the location of each user's mailbox in the virtual shared folder structure on the source email system. For example, the path to Terry's mailbox is /users/terry.adams.

Ниже приведен пример CSV-файла, содержащего атрибут UserRoot.Here's an example of a CSV file that contains the UserRoot attribute:

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. Создание конечной точки миграции IMAPStep 3: Create an IMAP migration endpoint

Для успешного переноса электронной почты решение Office 365: должно обмениваться данными с исходной системой электронной почты. Для этого в Office 365: используется конечная точка миграции. Конечная точка миграции также определяет количество почтовых ящиков для одновременной миграции и для одновременной синхронизации в процессе добавочной синхронизации, которая осуществляется один раз каждые 24 часа. Чтобы создать конечную точку миграции IMAP, сначала подключитесь к Exchange Online.To migrate email successfully, Office 365 needs to connect to and communicate with the source email system. To do this, Office 365 uses a migration endpoint. The migration endpoint also defines the number of mailboxes to migrate simultaneously and the number of mailboxes to synchronize simultaneously during incremental synchronization, which occurs once every 24 hours. To create a migration end point for IMAP migration, first connect to Exchange Online.

Полный список команд миграции см. в статье Командлеты перемещения и миграции.For a full list of migration commands, see Move and migration cmdlets.

Чтобы создать конечную точку миграции IMAP с именем IMAPEndpoint в Exchange Online PowerShell, выполните следующую команду.To create the IMAP migration endpoint called "IMAPEndpoint" in Exchange Online PowerShell, run the following command:

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

Вы также можете добавить параметры, чтобы указать одновременно выполняемые миграции (в том числе добавочные) и используемый порт. Следующая команда Exchange Online PowerShell создает конечную точку миграции IMAP с именем IMAPEndpoint, которая поддерживает 50 одновременных миграций и до 25 одновременных добавочных синхронизаций. В этом примере конечная точка также настраивается на использование порта 143 для шифрования TLS.You can also add parameters to specify concurrent migrations, concurrent incremental migrations, and the port to use. The following Exchange Online PowerShell command creates an IMAP migration endpoint called "IMAPEndpoint" that supports 50 concurrent migrations and up to 25 concurrent incremental synchronizations. It also configures the endpoint to use port 143 for TLS encryption.

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

Дополнительные сведения о командлете New-MigrationEndpoint см. в статьеNew-MigrationEndpoint.For more information about the New-MigrationEndpoint cmdlet, seeNew-MigrationEndpoint.

Проверка работыVerify it worked

Выполните следующую команду в Exchange Online PowerShell, чтобы отобразить сведения о конечной точке миграции IMAPEndpoint.Run the following command in Exchange Online PowerShell to display information about the "IMAPEndpoint":

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

Шаг 4. Создание и запуск пакета миграции IMAPStep 4: Create and start an IMAP migration batch

Для создания пакета миграции IMAP можно использовать командлет New-MigrationBatch. Можно создать пакет миграции и запустить его обработку автоматически, включив параметр AutoStart. Кроме того, вы можете создать пакет миграции и запустить его с помощью командлета Start-MigrationBatch.You can use the New-MigrationBatch cmdlet to create a migration batch for an IMAP migration. You can create a migration batch and start it automatically by including the AutoStart parameter. Alternatively, you can create the migration batch and then start it afterwards by using theStart-MigrationBatch cmdlet.

Следующая команда Exchange Online PowerShell автоматически запустит пакет миграции IMAPBatch1 с использованием конечной точки IMAP с именем IMAPEndpoint.The following Exchange Online PowerShell command will automatically start the migration batch called "IMAPBatch1" using the IMAP endpoint called "IMAPEndpoint":

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

Проверка работыVerify it worked

Выполните командлет Get-MigrationBatch, чтобы отобразить сведения о пакете миграции IMAPBatch1.Run the Get-MigrationBatch cmdlet to display information about the "IMAPBatch1":

Get-MigrationBatch -Identity IMAPBatch1 | Format-List

Вы также можете убедиться, что пакет запущен, выполнив следующую команду.You can also verify that the batch has started by running the following command:

Get-MigrationBatch -Identity IMAPBatch1 | Format-List Status

Шаг 5. Маршрутизация электронной почты в Office 365Step 5: Route your email to Office 365

Чтобы выяснить, куда доставлять сообщения электронной почты, системы электронной почты используют DNS-запись, которая называется записью MX. В процессе миграции электронной почты запись MX указывала на вашу исходную систему электронной почты. Теперь, когда перенос электронной почты в Office 365: завершен, запись MX должна указывать на Office 365:. Это обеспечит доставку электронной почты в ваши почтовые ящики Office 365:. Перемещая запись MX, вы также сможете отключить старую систему электронной почты, когда будете готовы сделать это.Email systems use a DNS record called an MX record to figure out where to deliver emails. During the email migration process, your MX record was pointing to your source email system. Now that the email migration to Office 365 is complete, it's time to point your MX record at Office 365. This helps make sure that email is delivered to your Office 365 mailboxes. By moving the MX record, you can also turn off your old email system when you're ready.

Многим поставщикам DNS следует придерживаться инструкций по изменению записи MX. Если ваш поставщик DNS не включен в этот список, или если вы хотите получить представление об общих указаниях, см. статью с общими инструкции в отношении записи MX.For many DNS providers, there are specific instructions to change your MX record. If your DNS provider isn't included, or if you want to get a sense of the general directions, general MX record instructions are provided as well.

Системам электронной почты клиентов и партнеров может потребоваться до 72 часов, чтобы распознать измененную запись MX. Подождите по крайней мере 72 часа, прежде чем перейти к следующей задаче: Шаг 6. Удаление пакета миграции IMAP.It can take up to 72 hours for the email systems of your customers and partners to recognize the changed MX record. Wait at least 72 hours before you proceed to the next task: Step 6: Delete IMAP migration batch.

Шаг 6. Удаление пакета миграции IMAPStep 6: Delete IMAP migration batch

После того как вы измените запись MX и убедитесь, что вся электронная почта направляется в почтовые ящики Office 365:, уведомите пользователей о том, что их сообщения доставляются в Office 365. Затем можно удалить пакет миграции IMAP. Убедитесь в следующем, прежде чем удалить пакет миграции.After you change the MX record and verify that all email is being routed to Office 365 mailboxes, notify the users that their mail is going to Office 365. After this, you can delete the IMAP migration batch. Verify the following before you delete the migration batch.

  • Все пользователи используют почтовые ящики Office 365:. После удаления пакета почта, отправляемая в почтовые ящики на локальном сервере Exchange Server, не копируется в соответствующие почтовые ящики Office 365:.All users are using Office 365 mailboxes. After the batch is deleted, mail sent to mailboxes on the on-premises Exchange Server isn't copied to the corresponding Office 365 mailboxes.

  • Почтовые ящики Office 365: синхронизированы по крайней мере один раз после того, как почта стала доставляться непосредственно в них. Для этого убедитесь, что значение в поле "Время последней синхронизации" для пакета миграции позже даты и времени, когда почта стала направляться непосредственно в почтовые ящики Office 365:.Office 365 mailboxes were synchronized at least once after mail began being sent directly to them. To do this, make sure that the value in the Last Synced Time box for the migration batch is more recent than when mail started being routed directly to Office 365 mailboxes.

Чтобы удалить пакет миграции IMAPBatch1 в Exchange Online PowerShell, выполните следующую команду.To delete the "IMAPBatch1" migration batch from Exchange Online PowerShell, run the following command:

Remove-MigrationBatch -Identity IMAPBatch1

Дополнительные сведения о командлете Remove-MigrationBatch см. в статьеRemove-MigrationBatch.For more information about the Remove-MigrationBatch cmdlet, seeRemove-MigrationBatch.

Проверка работыVerify it worked

Выполните следующую команду в Exchange Online PowerShell, чтобы отобразить сведения о пакете миграции IMAPBatch1.Run the following command in Exchange Online PowerShell to display information about the "IMAPBatch1":

Get-MigrationBatch IMAPBatch1"

Команда либо вернет пакет миграции с состоянием Удаление, либо вернет ошибку (не удалось найти пакет миграции), что подтверждает удаление пакета миграции.The command will return either the migration batch with a status of Removing, or it will return an error stating that migration batch couldn't be found, verifying that the batch was deleted.

Дополнительные сведения о командлете Get-MigrationBatch см. в статьеGet-MigrationBatch.For more information about the Get-MigrationBatch cmdlet, seeGet-MigrationBatch.

См. такжеSee also

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