Migra datos con la línea de comandos

Google Workspace Migration for Microsoft Exchange

Además de usar Google Workspace Migration for Microsoft Exchange (GWMME) en tu computadora de escritorio con Windows, puedes ejecutar GWMME con la interfaz de línea de comandos.

Antes de comenzar

Abre un símbolo del sistema y, luego, ingresa cd seguido de la ubicación de la instalación de GWMME entre comillas dobles, por ejemplo, cd "C:\Program Files\Google\Google Workspace Migration".

Las ubicaciones predeterminadas son las siguientes:

  • C:\Program Files\Google\Google Workspace Migration (sistema de 32 bits)
  • C:\Program Files (x86)\Google\Google Workspace Migration (sistema de 64 bits)

Es posible que se te solicite que ingreses el nombre de usuario y la contraseña del administrador de Exchange.

Comandos necesarios para la migración

Los comandos deben ingresarse en una sola línea continua. Los saltos de línea que se ven aquí son solo para facilitar la lectura.

Migración desde Exchange

Ejemplo 1: Migra con un perfil de administrador

ExchangeMigration.exe
--nouse_gui
--exchange_profile_name="Exchange admin profile"
--filename="filename containing user list"
--service_account_json_path="json file path"
--google_admin="admin email address"
--google_domain="Google domain name"

Ejemplo 2: Migra con los detalles del servidor y del administrador

ExchangeMigration.exe
--nouse_gui
--source_server="exchange-server hostname"
--exchange_admin_login="Exchange server admin account"
--filename="filename containing user list"
--service_account_json_path="json file path"
--google_admin="admin email address"
--google_domain="Google domain name"

Para obtener más información sobre la transferencia de datos de Exchange, consulta Migra datos de Exchange.

Migración desde una Cuenta de Google o un servidor IMAP

ExchangeMigration.exe
--nouse_gui
--enable_imap
--filename="filename containing user list"
--service_account_json_path="json file path"
--imap_security="security number"
--imap_port="port number"
--imap_path_prefix="path prefix"
--imap_server_type="server type"
--source_server="IMAP server hostname"
--google_admin="admin email address"
--google_domain="Google domain name"

Para las migraciones en modo de administrador desde Cyrus, también se usa lo siguiente:

--imap_admin_id="Cyrus IMAP admin"
--imap_admin_password="Cyrus admin password"

Para obtener más información sobre la transferencia de datos de correo electrónico desde cuentas de Google o basadas en IMAP, consulta Cómo migrar el correo desde Cuentas de Google o IMAP.

Migración desde archivos PST

Ejemplo 1: Migra mensajes a Gmail

ExchangeMigration.exe
--nouse_gui
--filename="filename containing user list"
--service_account_json_path="json file path"
--google_admin="admin email address"
--google_domain="Google domain name"
--pst_base_folder="PST folder name"

Ejemplo 2: Migra mensajes a Google Vault

ExchangeMigration.exe
--nouse_gui
--filename="filename containing user list"
--service_account_json_path="json file path"
--google_admin="admin email address"
--google_domain="Google domain name"
--pst_base_folder="PST folder name"
--migrate_to_vault

Para obtener más información sobre la transferencia de archivos PST, consulta Migra datos desde archivos PST.

Migración desde carpetas públicas

Ejemplo 1: Usa el modo de asignación para migrar carpetas públicas (recomendado). En este modo, se usa un archivo de asignación para asignar la carpeta pública al grupo en Grupos. Dado que las direcciones de correo electrónico de los grupos a menudo no coinciden con los nombres de las carpetas públicas, la mayoría de las organizaciones usan el modo de asignación.

ExchangeMigration.exe
--nouse_gui
--filename="filename containing user list"
--service_account_json_path="json file path"
--google_admin="admin email address"
--google_domain="Google domain name"
--public_folder_mapping_file="path to mapping file"
--enable_public_folder_migration

Ejemplo 2: Usa el modo predeterminado para migrar carpetas públicas. En este modo, no necesitas un archivo de asignación. En cambio, GWMME compara los nombres de las carpetas y los grupos. El mapeo se establece cuando el nombre de la carpeta pública coincide directamente con el nombre del grupo. Por ejemplo, los informes de TPS/tps-reports se asignan al grupo tps-reports@solarmora.com.

ExchangeMigration.exe
--nouse_gui
--exchange_profile_name="Exchange admin profile"
--service_account_json_path="json file path"
--google_admin="admin email address"
--google_domain="Google domain name"
--enable_public_folder_migration

Para obtener más información sobre la transferencia de carpetas públicas, consulta Migra desde carpetas públicas.

Todos los argumentos de GWMME

Ingresa un argumento en una sola línea y anteponle un doble guion (--). Algunos argumentos requieren parámetros adicionales. Ingresa los parámetros precedidos por un signo igual y encerrados entre comillas dobles.

A—E

Argumento y descripción Parámetro

--calendar_migration_end_date

Especifica la fecha de finalización de los eventos del calendario que deseas migrar. No se migran los eventos que tienen lugar después de esta fecha.

Ejemplo: --calendar_migration_end_date="2020-01-01"

Fecha en formato AAAA-MM-DD

--calendar_migration_start_date

Especifica la fecha de inicio de los eventos del calendario que deseas migrar. Los eventos de calendario anteriores a esta fecha no se migran.

Ejemplo: --calendar_migration_start_date="2018-01-01"

Fecha en formato AAAA-MM-DD

--custom_label_prefix

Especifica el prefijo que se adjuntará a todas las etiquetas en Gmail.

Ejemplo: --custom_label_prefix="migrated-"

Prefijo personalizado que se adjunta a las etiquetas

--email_migration_end_date

Especifica la fecha de finalización de los mensajes de correo electrónico que deseas migrar. Los mensajes posteriores a esta fecha no se migran

Ejemplo: --email_migration_end_date="2020-01-01"

Fecha en formato AAAA-MM-DD

--email_migration_start_date

Especifica la fecha de inicio de los mensajes de correo electrónico que deseas migrar. Los mensajes anteriores a esta fecha no se migran.

Ejemplo: --email_migration_start_date="2018-01-01"

Fecha en formato AAAA-MM-DD

--enable_calendar_fanout

Habilita la expansión de eventos de calendario para la migración de calendarios.

No se requiere ningún parámetro

--enable_hidden_folders_migration

Habilita la migración de carpetas ocultas de MAPI (Exchange o PST).

No se requiere ningún parámetro

--enable_imap

Habilita la migración desde un servidor IMAP en lugar de desde un servidor Exchange.

No se requiere ningún parámetro

--enable_mbox_logging

Habilita el registro de mbox. Los mensajes que no se pueden migrar debido a restricciones de tamaño o tipo de archivo de Gmail se escriben en un archivo mbox específico del usuario. El archivo mbox se encuentra en la ruta de la carpeta de registro de seguimiento de GWMME (por ejemplo, %localappdata%\Google\Google Apps Migration\Tracing\ExchangeMigration\mbox\user@domain.com.mbox).

Para obtener detalles sobre las restricciones de los mensajes de Gmail, consulta Tipos de archivo bloqueados en Gmail.

No se requiere ningún parámetro

--enable_public_folder_migration

Permite la migración de GWMME de carpetas públicas de Exchange a Grupos de Google. Para obtener más información, consulta Cómo migrar carpetas públicas.

Nota: No puedes ejecutar una migración para usuarios y carpetas públicas al mismo tiempo.

No se requiere ningún parámetro

--enable_resource_migration

Habilita la migración de recursos de calendario.

No se requiere ningún parámetro

--exchange_admin_login

Especifica el nombre de acceso para la cuenta de administrador del servidor de Exchange. Usa este argumento junto con --source_server.

Si usas este argumento, no uses --exchange_profile_name.

Ejemplo: --exchange_admin_login="administrator"

Nombre de acceso para la cuenta de administrador del servidor de Exchange

--exchange_profile_name

Especifica el nombre del perfil de Outlook que deseas usar para conectarte a tu servidor de Exchange. Especifica un perfil de administrador en la misma máquina que ejecuta GWMME. Si usas este argumento, no uses los siguientes:

  • --source_server
  • --pst_base_folder
  • --exchange_admin_login

Ejemplo: --exchange_profile_name="exch_migration_admin"

Nombre de un perfil de Outlook existente

--exclude_message_classes

Excluye mensajes según la clase de mensaje.

Este argumento es útil cuando se excluyen mensajes simulados de una solución de archivado. GWMME no admite la remigración de mensajes no reemplazados. El enfoque recomendado es excluir los mensajes con marcadores de posición y, luego, una vez que se rehidraten por completo, migrar los mensajes en una segunda ejecución de GWMME.

Ejemplo: --exclude_message_classes="ipm.note.eas,ipm.note.1"

Lista de clases excluidas separadas por comas (sin espacios entre los elementos de la lista)

--exclude_top_level_folders

Excluye las carpetas de nivel superior según el nombre de la carpeta.

Ejemplo: --exclude_top_level_folders="Deleted Items,Drafts"

Lista de carpetas de nivel superior separadas por comas (sin espacios entre los elementos de la lista)

F—M

Argumento y descripción Parámetro

--filename

Incluye los datos correspondientes a los nombres de usuario especificados en el archivo CSV. Si usas este argumento, no uses --migration_usernames.

Ejemplo: --filename="C:\Documents and Settings\users.csv"

Ruta de acceso al archivo CSV de nombres de usuario

--force_clear_google_calendar_ids_on_remigration

Borra los IDs de los calendarios secundarios antes de volver a migrar los datos. Cuando vuelves a migrar los datos del calendario, GWMME crea calendarios secundarios nuevos con IDs únicos. De esta manera, se evitan conflictos de eventos.

Nota: Usa este argumento antes de volver a migrar los datos. Para obtener más información, consulta Cómo volver a migrar contenido.

No se requiere ningún parámetro

--force_restart

Vuelve a ejecutar la migración en todos los elementos, en lugar de solo en los que no se migraron correctamente.

De forma predeterminada, si se interrumpe una migración, la siguiente comenzará en el punto en el que se detuvo la anterior. Puedes usar este parámetro para volver a ejecutar la migración desde el principio. Si usas esta opción, se filtrarán los correos electrónicos duplicados, se ignorarán los eventos de calendario migrados anteriormente (pero es posible que se dupliquen en algunos casos) y se duplicarán los contactos migrados anteriormente.

No se requiere ningún parámetro

--google_admin

Establece el propietario del evento para los recursos de calendario. Si un evento no tiene propietario, GWMME establece al administrador nominado como propietario del evento. El usuario debe tener acceso completo a los calendarios de recursos.

Ejemplo: --google_admin="admin@example.com"

Dirección de correo electrónico del propietario del evento nominado para los calendarios de recursos

--google_domain

Especifica el dominio de Google Workspace al que migrarás los datos.

Ejemplo: --google_domain="example.com"

Dominio de Google Workspace

--help

Muestra una lista de los argumentos de ExchangeMigration.exe.

No se requiere ningún parámetro

--id_mapping_file

Especifica el nombre del archivo que tiene la lista de asignaciones completa. Usa el archivo de asignación CSV que contiene las asignaciones de direcciones de usuarios y calendarios. Para obtener más información, consulta Crea archivos CSV para tu migración.

Ejemplos: --id_mapping_file="resources.csv"

Nombre del archivo

--imap_admin_id

Especifica el administrador de Cyrus IMAP que tiene acceso a todas las cuentas de IMAP en el servidor. Se usa con --imap_admin_password.

Ejemplo: --imap_admin_id="admin@example.com"

Dirección de correo electrónico del administrador de Cyrus

--imap_admin_password

Especifica la contraseña del administrador de Cyrus IMAP. Se usa con --imap_admin_id.

Ejemplo: --imap_admin_password="password"

Contraseña del administrador de Cyrus

--imap_path_prefix

Especifica el prefijo de ruta de acceso para las carpetas del usuario en un servidor IMAP.

Ingresa el prefijo de ruta de acceso de las carpetas IMAP que es común a todas las carpetas. Por lo general, el prefijo de ruta de acceso es el espacio de nombres de IMAP para los nombres de las carpetas. Por ejemplo, si la lista de carpetas de IMAP para un usuario es INBOX, INBOX.Sent y INBOX.Drafts, INBOX es el prefijo de ruta. Los valores típicos del prefijo de ruta son INBOX para Cyrus y Courier, o ninguno (deja el campo en blanco) para GroupWise IMAP, Gmail y Dovecot.

Ejemplo: --imap_path_prefix="INBOX"

Prefijo de ruta de las carpetas del usuario

--imap_port

Especifica el número de puerto del servidor IMAP.

Ejemplo: --imap_port="143"

Número de puerto

--imap_security

Especifica la opción de seguridad que deseas usar. Usa uno de los siguientes códigos:

  • 0 (sin seguridad)
  • 1 (SSL)
  • 2 (STARTTLS)

Ejemplo: --imap_security="1"

Código de un dígito

--imap_server_type

Especifica el tipo de servidor IMAP desde el que migrarás. Los tipos de servidores son Exchange, GroupWise, Gmail, Cyrus, Courier, Dovecot, Zimbra y no admitido. El valor predeterminado no es compatible.

Nota: Si especificas un tipo de servidor incorrecto, es posible que se vea afectado el rendimiento de la migración.

Ejemplo: --imap_server_type="Gmail"

Tipo de servidor IMAP

--migrate_to_vault

Migra el correo electrónico a Google Vault. Los mensajes se suben a la cuenta del usuario y se marcan como borrados. Las etiquetas no se crean en la carpeta Recibidos del usuario.

Ten en cuenta las siguientes restricciones:

  • Las reglas de retención de Google Vault determinan por cuánto tiempo se retiene el mensaje en Vault.
  • Si migras a Vault, debes tener activado Gmail en la Consola del administrador. Si Gmail está desactivado, verás errores 403.
  • La migración a usuarios con licencia de Vault Former Employee (VFE) fallará porque Gmail no está activado para estos usuarios.
No se requiere ningún parámetro

--migration_usernames

Especifica la lista de usuarios para la migración. Si usas este argumento, no uses --filename.

Ejemplo: --migration_usernames="user1,user2,user3"

Lista de usuarios separados por comas (sin espacios entre los elementos)

N–Z

Argumento y descripción Parámetro

--noenable_calendar_migration

Ejecuta la migración sin incluir datos del calendario.

No se requiere ningún parámetro

--noenable_contact_migration

Ejecuta la migración sin incluir datos de contacto.

No se requiere ningún parámetro

--noenable_email_migration

Ejecuta la migración sin incluir datos de correo electrónico.

No se requiere ningún parámetro

--noenable_error_reports

Evita que GWMME genere informes de migración, que muestran los errores de mensajes que se producen durante una migración. Omitir los informes de migración puede mejorar el rendimiento de una migración.

Para obtener más información sobre los informes de migración, consulta la sección sobre cómo revisar los informes de migración en la Guía para administradores de GWMME.

No se requiere ningún parámetro

--noenable_id_mapping

Ejecuta la migración sin necesidad de un archivo de asignación. Todos los datos de asignación se definen en la lista de usuarios si usas el argumento --id_mapping_file.

No se requiere ningún parámetro

--noenable_label_prefix

Especifica que no se agregará un prefijo a las etiquetas cuando se migre desde archivos PST. De forma predeterminada, el nombre del archivo PST se agrega como prefijo a las etiquetas y los calendarios creados durante la migración.

No se requiere ningún parámetro

--nouse_gui

Ejecuta GWMME con la línea de comandos. El modo de interfaz gráfica de usuario (GUI) es el predeterminado.

No se requiere ningún parámetro

--nowait

Cierra GWMME sin que tengas que presionar la tecla Intro cuando se ejecuta la migración desde la línea de comandos.

No se requiere ningún parámetro

--num_threads

Especifica la cantidad de usuarios que deseas migrar de forma simultánea. Se abre un subproceso independiente para cada usuario. El valor predeterminado es de 25 subprocesos.

Ejemplo: --num_threads="20"

Cantidad de usuarios

--pst_base_folder

Especifica el directorio que contiene los archivos PST para la migración. GWMME migra todos los archivos PST de las subcarpetas de la carpeta especificada.

Si usas este argumento, no uses los siguientes:

  • --source_server
  • --exchange_profile_name

Ejemplo: --pst_base_folder="C:\pst"

Directorio que contiene archivos PST

--public_folder_mapping_file

Especifica el nombre del archivo de asignación. El archivo de asignación asigna las rutas de carpetas públicas de Exchange a las direcciones de correo electrónico de Grupos de Google. Para obtener más información, consulta Cómo migrar carpetas públicas.

Ejemplo: --public_folder_mapping_file="public_folder_mapping.csv"

Nombre del archivo de asignación en formato CSV

--retry_count

Especifica la cantidad de reintentos si se produce una falla temporal, como un tiempo de espera del servidor ocupado. El valor predeterminado es 10.

Ejemplo: --retry_count="5"

Cantidad de reintentos

--run_diagnostics

Ejecuta el diagnóstico exhaustivo previo a la migración, que valida la conectividad del servidor, la autenticación, el acceso a las cuentas y la lista completa de usuarios.

No se requiere ningún parámetro

--service_account_json_path

Especifica la ruta de acceso al archivo de credenciales de la cuenta de servicio. Para obtener instrucciones sobre cómo obtener este archivo, consulta Autoriza GWMME para tu cuenta.

Ejemplo: --service_account_json_path ="C:\Users\admin\privatekey.json"

Ruta de acceso al archivo de credenciales de la cuenta de servicio

--source_server

Especifica la dirección IP o el nombre de dominio completamente calificado del servidor de Exchange o IMAP.

En las migraciones de Exchange, usa este parámetro junto con --exchange_admin_login. Si usas este argumento, no uses --exchange_profile_name.

Ejemplo: --source_server="mailserver.example.com"

Dirección IP del servidor o nombre de dominio completamente calificado

--strip_user_labels

Especifica que los mensajes se migran sin etiquetas.

No se requiere ningún parámetro

--translate_conflicting_events

Indica a GWMME que consulte los eventos existentes que ya se migraron al Calendario de Google y los modifica traduciendo la dirección de correo electrónico del recurso de Exchange a la del recurso de Google Workspace correspondiente.

Muchos administradores eligen migrar primero a los usuarios y, luego, los recursos de calendario. Si eliges migrar los recursos de calendario en segundo lugar, configura GWMME para que vuelva a migrar los datos de calendario de los usuarios. Para ello, usa --translate_conflicting_events.

No se requiere ningún parámetro


Google, Google Workspace y las marcas y los logotipos relacionados son marcas comerciales de Google LLC. Todos los demás nombres de productos y empresas son marcas comerciales de las empresas con las que se encuentran asociados.