Usar PowerShell para realizar una migración de IMAP a Microsoft 365

Este artículo afecta tanto a Office 365 Enterprise como a Microsoft 365 Enterprise

Como parte del proceso de implementación de Microsoft 365, puede optar por migrar el contenido de los buzones de correo de usuario de un servicio de correo electrónico del Protocolo de acceso a correo electrónico (IMAP) de Internet a Microsoft 365. Este artículo le guiará a través de las tareas para migrar el correo electrónico IMAP con Exchange Online PowerShell.

Nota:

También puede usar el Centro de administración de Exchange para realizar una migración IMAP. Consulte Migración de buzones IMAP.

¿Qué necesita saber antes de empezar?

Tiempo estimado para finalizar esta tarea: entre 2 y 5 minutos para crear un lote de migración. Después de que haya iniciado el lote de migración, la duración de la migración variará según la cantidad de buzones del lote, el tamaño de cada buzón y la capacidad de red disponible. Para obtener información sobre otros factores que afectan al tiempo que se tarda en migrar buzones a Microsoft 365, consulte Rendimiento de la migración.

Deberá tener permisos asignados para poder llevar a cabo estos procedimientos. Para ver qué permisos necesita, consulte la entrada "Migración" de una tabla en el artículo Permisos de destinatarios .

Para usar los cmdlets de Exchange Online PowerShell, deberá iniciar sesión e importar los cmdlets en la sesión local de Windows PowerShell. Consulte Conexión a Exchange Online PowerShell para obtener instrucciones.

Para obtener una lista completa de los comandos de migración, consulte Cmdlets de movimiento y migración.

En las migraciones IMAP existen las restricciones siguientes:

• Solo es posible migrar elementos de la bandeja de entrada o de otras carpetas de correo de un usuario. No se pueden migrar los contactos, los elementos de calendario ni las tareas.

• Es posible migrar un máximo de 500.000 elementos desde el buzón de un usuario.

• El tamaño máximo de un mensaje que se puede migrar es de 35 MB.

Pasos de la migración

Paso 1: Preparar una migración IMAP

• Si tiene un dominio para su organización IMAP, agréguelo como un dominio aceptado de su organización de Microsoft 365. Si desea usar el mismo dominio que ya posee para sus buzones de Microsoft 365, primero debe agregarlo como un dominio aceptado a Microsoft 365. Después de agregarlo, puede crear los usuarios en Microsoft 365. Para obtener más información, consulteComprobación del dominio.

• Agregue cada usuario a Microsoft 365 para que tenga un buzón. Para obtener instrucciones, consulteAgregar usuarios a Microsoft 365 para empresas.

• Obtenga el FQDN del servidor IMAP. Debe proporcionar el nombre de dominio completo (FQDN) (también denominado nombre completo del equipo) del servidor IMAP desde el que migrará los datos del buzón al crear un punto de conexión de migración IMAP. Use un cliente IMAP o el comando PING para comprobar si puede usar el FQDN para comunicarse a través de Internet con el servidor IMAP.

• Configure el servidor de seguridad para permitir las conexiones IMAP. Es posible que deba abrir puertos en el servidor de seguridad de la organización que hospeda el servidor IMAP para que el tráfico de red con origen en el centro de datos de Microsoft durante la migración pueda entrar en la organización que hospeda el servidor IMAP. Para obtener una lista de direcciones IP utilizadas por los centros de datos de Microsoft, consulte Direcciones URL e intervalos de direcciones IP de Exchange Online.

• Asigne al administrador permisos de cuenta para tener acceso a los buzones de su organización IMAP. Si utiliza credenciales de administrador en el archivo CSV, la cuenta que utilice debe tener los permisos necesarios para tener acceso a los buzones locales. Cada servidor IMAP determina los permisos necesarios para tener acceso a los buzones de usuario.

• Para usar los cmdlets de Exchange Online PowerShell, deberá iniciar sesión e importar los cmdlets en la sesión local de Windows PowerShell. Consulte Conexión a Exchange Online PowerShell para obtener instrucciones.

  Para obtener una lista completa de los comandos de migración, consulte Cmdlets de movimiento y migración.

• Compruebe que puede conectarse a su servidor IMAP. Ejecute el siguiente comando en Exchange Online PowerShell para probar la configuración de conexión al servidor IMAP.

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

  Para el valor del parámetro Puerto, es normal usar 143 para las conexiones no cifradas o de Seguridad de la capa de transporte (TLS) y 993 para las conexiones SSL.

Paso 2: Crear un archivo CSV para un lote de migración IMAP

Identifique el grupo de usuarios cuyos buzones de correo quiere migrar en un lote de migración de IMAP. Cada fila del archivo CSV contiene la información necesaria para conectar a un buzón del sistema de mensajería de IMAP.

Los siguientes son los atributos necesarios para cada usuario:

• EmailAddress especifica el identificador de usuario del buzón de Microsoft 365 del usuario.

• UserName especifica el nombre de inicio de sesión de la cuenta que se usará para acceder al buzón en el servidor IMAP.

• Password especifica la contraseña de la cuenta en la columna UserName.

A continuación, se muestra un ejemplo del formato del archivo CSV. En este ejemplo, se migran tres buzones:

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

Para el atributo UserName, además del nombre de usuario, puede usar las credenciales de una cuenta a la que se hayan asignado los permisos necesarios para tener acceso a los buzones en el servidor IMAP. A continuación, se enumeran algunos de los formatos específicos usados para algunos servidores IMAP:

Microsoft Exchange:

Si va a migrar correo electrónico desde la implementación IMAP de Microsoft Exchange, use el formato Domain/Admin_UserName/User_UserName para el atributo UserName del archivo CSV. Supongamos que desea migrar el correo electrónico de Exchange de Terry Adams, Ann Beebe y Paul Cannon. Tiene una cuenta de administrador de correo, cuyo nombre de usuario es mailadmin y cuya contraseña es P@ssw0rd. Este es el aspecto que tendría el archivo 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:

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

Mirapoint:

Si va a migrar el correo electrónico desde el servidor de mensajes Mirapoint, utilice el formato #user@domain#Admin_UserName# para las credenciales de administrador. Para migrar el correo electrónico desde Mirapoint utilizando las credenciales de administrador mailadmin y P@ssw0rd, el archivo CSV tendría este aspecto:

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:

Algunos sistemas de correo electrónico de origen, como Courier IMAP, no admiten el uso de credenciales de administrador de buzones para migrar buzones a Microsoft 365. En su lugar, puede configurar el sistema de correo electrónico de origen para usar carpetas compartidas virtuales. Si usa carpetas compartidas virtuales, puede usar las credenciales de administrador de buzón para tener acceso a los buzones de usuario en el sistema de correo electrónico de origen. Para obtener más información acerca de cómo configurar las carpetas compartidas virtuales para Courier IMAP, consulte Carpetas compartidas.

Para migrar los buzones después de configurar las carpetas compartidas virtuales en su sistema de correo electrónico de origen tiene que incluir el atributo opcional UsuarioRaíz en el archivo de migración. Este atributo especifica la ubicación del buzón de cada usuario en la estructura de carpetas compartidas virtuales del sistema de correo electrónico de origen. Por ejemplo, la ruta de acceso al buzón de Terry es /users/terry.adams.

Este es un ejemplo de un archivo CSV que contiene el atributo 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

Paso 3: Crear un extremo de migración IMAP

Para migrar el correo electrónico correctamente, Microsoft 365 debe conectarse al sistema de correo electrónico de origen y comunicarse con él. Para ello, Microsoft 365 usa un punto de conexión de migración. El extremo de migración también define el número de buzones que se migrará simultáneamente y el número de buzones que se sincronizará simultáneamente durante la sincronización incremental, que se hace una vez cada 24 horas. Para crear un extremo de migración para la migración IMAP, primero debe Conectarse a Exchange Online.

Para obtener una lista completa de los comandos de migración, consulte Cmdlets de movimiento y migración.

Para crear el extremo de migración IMAP denominado "IMAPEndpoint" en Exchange Online PowerShell, ejecute el comando siguiente:

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

También puede agregar parámetros para especificar las migraciones simultáneas, las migraciones incrementales simultáneas y el puerto que se va a usar. El siguiente comando de Exchange Online PowerShell crea un extremo de migración IMAP denominado "IMAPEndpoint" que admite 50 migraciones simultáneas y hasta 25 sincronizaciones incrementales simultáneas. También configura el extremo para que use el puerto 143 para el cifrado TLS.

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

Para obtener más información acerca del cmdlet New-MigrationEndpoint, consulteNew-MigrationEndpoint

Compruebe que ha funcionado

Ejecute el siguiente comando en Exchange Online PowerShell para visualizar la información acerca de "IMAPEndpoint":

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

Paso 4: Crear e iniciar un lote de migración IMAP

Puede usar el cmdlet New-MigrationBatch para crear un lote de migración para una migración IMAP. Puede crear un lote de migración e iniciarlo automáticamente mediante la inclusión del parámetro AutoStart. Como alternativa, puede crear el lote de migración y, luego, iniciarlo posteriormente con el cmdlet Start-MigrationBatch.

El siguiente comando de Exchange Online PowerShell iniciará automáticamente el lote de migración denominado "IMAPBatch1" usando el extremo IMAP denominado"IMAPEndpoint":

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

Compruebe que ha funcionado

Ejecute el Get-MigrationBatch para ver información acerca de la "IMAPBatch1":

Get-MigrationBatch -Identity IMAPBatch1 | Format-List

También puede comprobar que el lote se ha iniciado ejecutando el comando siguiente:

Get-MigrationBatch -Identity IMAPBatch1 | Format-List Status

Paso 5: Enrutar el correo electrónico a Microsoft 365

Los sistemas de correo electrónico utilizan un registro DNS denominado registro MX para averiguar dónde entregar los correos electrónicos. Durante el proceso de migración del correo electrónico, el registro MX apuntaba al sistema de correo electrónico de origen. Ahora que se ha completado la migración de correo electrónico a Microsoft 365, es el momento de apuntar el registro MX a Microsoft 365. Esto ayuda a asegurarse de que el correo electrónico se entrega a los buzones de Microsoft 365. Al mover el registro MX, también puede desactivar el sistema de correo electrónico antiguo cuando esté listo.

Para muchos proveedores de DNS, hay instrucciones específicas para Cambiar el registro MX. Si su proveedor de DNS no está incluido o si desea hacerse una idea de las orientaciones generales, también ofrecemos las instrucciones generales de registro MX.

Pueden pasar hasta 72 horas antes de que el sistema de correo electrónico de los clientes y socios reconozca el cambio del registro MX. Espere al menos 72 horas antes de continuar con la tarea siguiente: Paso 6: Eliminar el lote de migración IMAP.

Paso 6: Eliminar el lote de migración IMAP

Después de cambiar el registro MX y comprobar que todo el correo electrónico se enruta a Microsoft 365 buzones, notifique a los usuarios que su correo va a Microsoft 365. Después, puede eliminar el lote de migración IMAP. Compruebe lo siguiente antes de eliminar el lote de migración.

• Todos los usuarios usan buzones de Microsoft 365. Una vez eliminado el lote, el correo enviado a los buzones del Exchange Server local no se copia en los buzones de Microsoft 365 correspondientes.

• Los buzones de Microsoft 365 se sincronizaron al menos una vez después de que el correo empezara a enviarse directamente a ellos. Para ello, asegúrese de que el valor del cuadro Hora de última sincronización del lote de migración es más reciente que cuando el correo comenzó a enrutarse directamente a buzones de Microsoft 365.

Para eliminar el lote de migración "IMAPBatch1" de Exchange Online PowerShell, ejecute el comando siguiente:

Remove-MigrationBatch -Identity IMAPBatch1

Para obtener más información sobre el cmdlet Remove-MigrationBatch, consulteRemove-MigrationBatch.

Compruebe que ha funcionado

Ejecute el comando siguiente en Exchange Online PowerShell para visualizar la información sobre "IMAPBatch1":

Get-MigrationBatch IMAPBatch1"

El comando devolverá el lote de migración con un estado Quitando o devolverá un error indicando que el lote de migración no se ha encontrado, lo que demuestra que el lote se ha eliminado.

Para obtener más información sobre el cmdlet Get-MigrationBatch, consulteGet-MigrationBatch.

Consulte también

Solucionador de problemas de migración IMAP