Solución de problemas de migraciones de archivos de Migration Manager

En este artículo se describe cómo resolver problemas y errores que puede experimentar al usar El Administrador de migración para la migración de recursos compartidos de archivos.

• Requisitos previos y configuración
• Mensajes de error del agente
• Problemas con la dirección URL del sitio de destino
• Mensajes de error comunes
• Error de instalación del agente
• El agente se desconectó
• La tarea está atascada en estado "en cola"
• No se puede descargar un informe de tareas
• Errores de migración en informes de tareas
• Los informes de errores de migración de Google contienen HTML
• Códigos de error
• Los administradores de ubicación geográfica no pueden acceder a la funcionalidad completa del Administrador de migración
• Los administradores de SharePoint heredados por grupos no pueden acceder a la funcionalidad completa del Administrador de migración
• La colección de sitios "XXXX" no se puede crear ni actualizar
• Tarea de examen bloqueada en estado "en cola"

Compruebe los requisitos previos y la configuración

Asegúrese de cumplir los requisitos previos para la instalación del agente y revise los puntos de conexión necesarios. Los clientes de la nube de Government deben confirmar que la configuración está establecida correctamente.

• Requisitos previos de instalación del agente.
• Puntos de conexión necesarios.
• Configuración de la nube de Government.
• Aprovisionamiento previo de cuentas de OneDrive Si va a migrar a cuentas de OneDrive, asegúrese de que las cuentas se aprovisionan antes de migrar. Para hacerlo, puede usar un script (como se muestra aquí): aprovisionar previamente OneDrive para los usuarios de su organización.

Mensajes de error del agente

Message	Acción
No se pudo instalar el agente de migración. Cierre el programa de instalación e inténtelo de nuevo.	Es posible que esté usando una versión no actualizada del archivo de configuración del agente para instalar el agente. Para obtener más información, consulte la sección Error de instalación del agente .
El usuario actual no tiene acceso al recurso compartido de archivos de origen	Asegúrese de que el recurso compartido de archivos de origen sea un recurso compartido de archivos de red. Compruebe que la cuenta de Windows asociada al agente tiene permisos de lectura para el recurso compartido de archivos que desea migrar.
El recurso compartido de archivos de origen no existe	Asegúrese de que el recurso compartido de archivos de origen sea un recurso compartido de archivos de red existente. Confirme que la cuenta de Windows asociada al agente tiene permisos de lectura para el recurso compartido de archivos que desea migrar.

Problemas con la dirección URL del sitio de destino

Message	Acción recomendada
Sitio de destino o web no existe	Confirme que el sitio de destino o el subsitio existe. Si es una cuenta de OneDrive, asegúrese de que se ha aprovisionado previamente.
No se pudo comprobar la existencia del sitio o web.	Confirme que el sitio de destino o el subsitio existe.

Mensajes de error frecuentes

Message	Acción recomendada
Carpeta de origen no válida	Confirme que la ruta de acceso especificada es correcta y sigue el formato adecuado. Confirme que tiene acceso de lectura a la carpeta.
El sitio no se puede crear ni actualizar	Asegúrese de que tiene permisos para crear el sitio y de que la dirección URL es válida. Si el sitio existe, confirme que es el administrador de la colección de sitios. Si sigue sin funcionar, cree el sitio manualmente y dirija la herramienta de migración al sitio recién creado.
Error al examinar el archivo: el nombre de la carpeta no es válido	Vea Nombres de archivo y tipos de archivo no válidos en OneDrive y SharePoint.
Error al examinar el archivo: la ruta de acceso de destino es demasiado larga	Vea Nombres de archivo y tipos de archivo no válidos en OneDrive y SharePoint. La ruta completa, incluido el nombre de archivo, debe contener menos de 400 caracteres para OneDrive y SharePoint.
Error al examinar el archivo: no hay suficiente espacio en disco para empaquetar el archivo	El espacio en disco disponible para la carpeta de trabajo de migración es demasiado pequeño para el tamaño de su archivo de origen. Amplíe el tamaño de la carpeta de trabajo e inténtelo de nuevo.
Error de empaquetado: no se puede abrir el archivo	Error de empaquetado debido a un origen inexistente. Compruebe si puede tener acceso a la carpeta raíz de origen.
Una tarea duplicada ya se ha creado.	El archivo CSV usado para realizar la migración masiva no puede tener entradas duplicadas. Quite la línea o líneas duplicadas e inténtelo de nuevo.
No se migró la carpeta primaria	No se migró la carpeta primaria, por lo que no se pueden migrar todos los elementos de la carpeta. Compruebe la carpeta principal y vuelva a intentar la migración.

Error de instalación del agente

Problema: El agente de migración no se puede instalar al usar una versión anterior del archivo de configuración del agente para instalarlo.

Diagnóstico o investigación:

Un archivo clientsetup.exe obsoleto podría causar este problema.

Mitigación:

1. Vaya al Centro de migración en el Centro de administración de SharePoint e inicie sesión con una cuenta que tenga permisos de administrador para su organización.
2. Seleccione Descargue el archivo de configuración del agente.
3. Ejecute el archivo clientsetup.exe en el equipo o máquina virtual en el que desea instalar el agente. Siga las instrucciones para finalizar la instalación del agente.

Emitir: El agente de migración no se instala correctamente o el clientsetup.exe no se puede abrir.

Ejemplo:

Diagnóstico o investigación:

Si no se puede abrir el clientsetup.exe :

• Inicie sesión en Windows como administrador o proporcione el nombre de usuario y la contraseña del administrador cuando abra la aplicación. La cuenta de administrador debería haberse agregado al dominio.

Si se han producido errores durante el proceso de instalación:

• El mensaje de error debería incluir el motivo del error y las acciones adecuadas que deben realizarse si es posible.
• Si los errores no sugieren acciones para resolver, un error de red temporal podría causar este problema u otros problemas desconocidos.

Mitigación:

Si no se puede abrir el clientsetup.exe:

1. Inicie sesión en Windows como administrador.
2. Vuelva a abrir la aplicación clientsetup.exe o proporcione el nombre de usuario y la contraseña del administrador cuando abra la aplicación.

Si se produjeron errores durante el proceso de instalación:

• En caso de errores con acciones específicas indicadas, lleve a cabo la acción correspondiente y vuelva a abrir el archivo clientsetup.exe.
• Para otros errores no específicos, asegúrese de que la cuenta de administrador se agrega al dominio. Cierre la ventana de la aplicación y vuelva a intentar la instalación.

El agente se desconectó

Problema: el estado del agente muestra "Desconectado" y nunca cambia.

Diagnóstico o investigación:

• Compruebe el estado de la red en el equipo en el que está instalado el agente.
• Si se cambia la contraseña de la cuenta de administrador de inquilinos que ha iniciado sesión o se aplica cualquier otro cambio crítico similar a la cuenta Administración inquilino que requeriría que vuelva a iniciar sesión, todos los agentes se desconectarán. La reinstalación es necesaria en todas ellas.
• Si el agente no pudo cambiar automáticamente, es probable que la versión sea demasiado antigua. Vuelva a instalar el agente.
• La expiración del token también puede causar la desconexión del agente.

Mitigación:

• Si hay un problema de red, corríjalo. El agente debería reconectarse poco después.
• Si hay cambios críticos en la cuenta de Administración inquilino que requieren que vuelva a iniciar sesión: vuelva a instalar el agente en todos los equipos.
• Si no se aplica ninguna de estas opciones, empiece por volver a instalar el agente primero.

La tarea está atascada en estado En cola

Problema El estado de una tarea se queda en "En cola" y no se programa para ejecutarse en un agente.

Diagnóstico o investigación:

• Asegúrese de que hay agentes instalados para este espacio empresarial. Deberían aparecer en la lista de agentes.
• Compruebe el estado de cada agente. Deberían establecerse en "Habilitado".
• Un estado de "En uso" indica que el agente ya está procesando otra tarea. Al agente no se le pueden asignar más tareas sin finalizar la actual.
• Si un agente aparece como "Deshabilitado", habilítelo.
• Si aparece como "Desconectado" durante mucho tiempo, marque la casilla de verificación Agente desconectado.

Mitigación:

• Si hay disponibles agentes habilitados en la lista, pero las tareas no se han programado durante mucho tiempo: cree otra tarea que sea la misma. A veces se corrige el problema.

No se puede descargar un informe de tareas

Problema: el informe de tareas no se puede descargar desde el vínculo del panel de detalles de la tarea.

• El vínculo Descargar informe de tarea está deshabilitado.
• El vínculo Descargar informe de tareas se muestra activo, pero no ocurre nada después de hacer clic en él.

Diagnóstico o investigación:

• El vínculo "Descargar informe de tarea" se deshabilita hasta que finalice la tarea. Los informes solo están disponibles después de que el estado de la tarea tenga un estado "Completado" o "Erróneo". Las tareas que no se pudieron realizar debido al tiempo de espera también tienen un vínculo de informe de tareas deshabilitado.
• Si no se puede descargar ningún informe para tareas finalizadas y sin tiempo de espera, lo más probable es que se produzcan errores durante el proceso de migración que interrumpieron la carga de los informes en SharePoint. Sin embargo, se pueden encontrar localmente siempre y cuando existan.

Mitigación:

En el equipo que ha completado la tarea, pruebe a recuperar los informes.

• En la carpeta %AppData%\Microsoft\SPMigration\Logs\Migration\MigrationTool[tenant_site], o < your-Customized-Working-Folder >\Migration\MigrationTool[tenant_site], ordene las subcarpetas por su hora de modificación. Busque la subcarpeta cuya hora modificada sea la más cercana a la hora de inicio de la tarea. Si los informes de tareas existen, se encuentra en la carpeta "Informe" de esta subcarpeta.

O bien

• Si se produjo un error en la tarea, vaya a la carpeta %AppData%\Microsoft\SPMigration\Logs y, a continuación, ordene las subcarpetas por su hora de modificación. Busque la subcarpeta cuya hora modificada sea la más cercana a la hora de inicio de la tarea. El informe de errores está en esta subcarpeta.

Errores de migración en informes de tareas

Problema: Se produce un error en las tareas de migración por varias razones y se detallan en los informes de tareas.

Diagnóstico o investigación:

• Las razones por las que se ha podido producir un error deberían estar ya escritas en detalle en los informes, junto con soluciones sugeridas.
• Si no puede descargar los informes de tareas, consulte Un informe de tareas no se puede descargar.

Mitigación:

Busque el error específico aquí para obtener más información: Códigos de error.

Si recibe un error similar al siguiente: SUBMITING FAILURE Failed to Submit the Job to Server: Unknown failed reason when submiting a job. 0x01610002, check the settings on any antivirus application installed on the agent machine. Agregue nuestras dos aplicaciones de migración como excepciones para que el tráfico de migración no se interrumpa:

• microsoft.sharepoint.migration.clientservice.exe
• microsoft.sharepoint.migration.mthost.exe

El informe de errores de Google muestra código HTML en el informe

Problema: los informes de errores generados para una migración de Google a veces tienen un código HTML incrustado en el informe.

Detalles:

Las API de Google devuelven errores HTML que se incluyen en los informes generados. Este problema puede producirse cuando se produce un error de carga del servidor de Google.

Mitigación:

Ejecute menos transacciones simultáneas.

Estado:

Este problema es un problema conocido. Tiempo estimado no establecido.

No se admiten administradores de ubicación geográfica

El Administrador de migración no admite el rol de administrador de ubicación geográfica para ciertos escenarios. En el caso de las migraciones de recursos compartidos de archivos, estos usuarios no pueden acceder a la pestaña Exámenes . En el caso de las migraciones en la nube, estos usuarios no pueden acceder a la pestaña Exámenes ni a la pestaña Migraciones .

Solución alternativa. Asigne al usuario de ubicación geográfica un rol de administrador de SharePoint o de administrador global.

Importante

Microsoft recomienda usar roles con los permisos más mínimos, lo que ayuda a mejorar la seguridad de su organización. Administrador global es un rol con muchos privilegios que debe limitarse a escenarios de emergencia cuando no se puede usar un rol existente.

1. En el Centro de administración, vaya a la página Usuarios>Usuarios activos.
2. En la página Usuarios activos, seleccione el usuario cuyo rol de administrador desea cambiar. En el panel desplegable, en Roles, seleccione Administrar roles.
3. Seleccione el rol de administrador que quiere asignar al usuario. Si no ve el rol que está buscando, seleccione Mostrar todo en la parte inferior de la lista.

Los administradores de SharePoint heredados del grupo no pueden acceder a las pestañas Exámenes y migraciones

El Administrador de migración no admite completamente los roles de administrador de SharePoint creados como resultado de unirse a un grupo de Azure. En el caso de las migraciones de recursos compartidos de archivos, estos usuarios no pueden acceder a la pestaña Exámenes . En el caso de las migraciones en la nube, estos usuarios no pueden acceder a la pestaña Exámenes ni a la pestaña Migraciones .

Solución alternativa. Asigne al usuario un rol de administrador de SharePoint o administrador global.

Importante

Microsoft recomienda usar roles con los permisos más mínimos, lo que ayuda a mejorar la seguridad de su organización. Administrador global es un rol con muchos privilegios que debe limitarse a escenarios de emergencia cuando no se puede usar un rol existente.

1. En el Centro de administración, vaya a la página Usuarios>Usuarios activos.
2. En la página Usuarios activos, seleccione el usuario cuyo rol de administrador desea cambiar. En el panel desplegable, en Roles, seleccione Administrar roles.
3. Seleccione el rol de administrador que quiere asignar al usuario. Si no ve el rol que está buscando, seleccione Mostrar todo en la parte inferior de la lista.

La colección de sitios "XXXX" no se puede crear ni actualizar

El nombre principal de usuario (UPN) al que se hace referencia no es válido. Para crear o actualizar una colección de sitios de OneDrive, Microsoft Entra ID debe contener el UPN al que se hace referencia. Compruebe la dirección URL de destino y valide que el usuario existe en Microsoft Entra ID.

Tarea de examen bloqueada en estado "en cola"

Problema: el estado de un examen del recurso compartido de archivos permanece en "En cola" y nunca se programa en que se ejecute un agente.

Diagnóstico / Investigación

• Compruebe la columna Grupo del agente para ver las tareas de examen. Solo se pueden programar los agentes del grupo Agente predeterminado .

Mitigación

• Si no hay ningún agente en el grupo Agente predeterminado , cambie el grupo del agente existente a Predeterminado. Las tareas de examen que estaban bloqueadas ahora deben salir de este estado.

Códigos de error

Código de error	Acción recomendada
0x00000000	Error inesperado.
0x01110001	Motivo desconocido.
0x0111000B	La ruta de acceso es demasiado larga.
0x0111000F	No se ha migrado la carpeta primaria. Compruebe el informe de error para determinar el archivo y vuelva a intentarlo.
0x01110003	No se puede acceder a la carpeta de origen.
0x01110009	No se pueden recuperar los metadatos del archivo.
0x01110010	Caracteres no válidos en el nombre de archivo Compruebe los nombres de archivos del informe con <>:"?*/,
0x01110011	No se admite el elemento "tiempo de creación" o "tiempo de modificación".
0x0201000D	Compruebe si existe la lista o si puede acceder a ella en el sitio de origen y el sitio de destino.
0x02050008	No se puede acceder al almacenamiento local. Reinicie la migración.
0x02010023	No se admite la plantilla de lista de origen. Pruebe con otro.
0x0201000C	Compruebe sus credenciales y, a continuación, vuelva a escribir su nombre de usuario y contraseña.
0x02010017	Debe ser administrador de la colección de sitios.
0x02060009	1- No se puede crear la colección de sitios porque la dirección URL ya está en uso o una dirección URL no válida.
	2- No se puede crear la colección de sitios porque la dirección URL contiene un carácter no válido.
	3- La colección de sitios no se puede crear ni actualizar.
0x02060007	1- No se puede crear la colección de sitios porque la dirección URL ya está en uso o una dirección URL no válida.
	2- No se puede crear la colección de sitios porque la dirección URL contiene un carácter no válido.
0x02010018	1. Compruebe sus credenciales y vuelva a intentarlo.
	2. Se ha producido un error al acceder a SharePoint.   Compruebe sus credenciales y vuelva a intentarlo.
	3. Se ha producido un error de acceso a SharePoint. Compruebe las credenciales y su conexión de red y vuelva a intentarlo.
	4. Se ha producido un error de acceso a SharePoint. Compruebe las credenciales y la dirección URL del sitio y vuelva a intentarlo.
	5. Se ha producido un error de acceso a SharePoint. Compruebe sus credenciales y el formato de la dirección URL. Vuelva a intentarlo.
	6. Se ha producido un error de acceso a SharePoint.   Compruebe sus credenciales y vuelva a intentarlo. Si el problema continúa, cree un caso de soporte técnico.
	7. Se ha producido un error de acceso a SharePoint.   Compruebe las credenciales e intente abrir el sitio en un explorador.
0x0204000A	No se puede crear el archivo de paquete. Deben cerrarse todos los archivos y carpetas de la carpeta de trabajo del Administrador de migración, %appdata%\Microsoft\SPMigration\Logs\Migration\MigrationToolStorage. Reinicie la migración.
0x02030001	1. Compruebe sus credenciales. Reinicie la migración.
	2. Compruebe sus credenciales. Reinicie la migración.
	3. Compruebe las credenciales y su conexión de red. Reinicie la migración.
	4. Compruebe las credenciales y la dirección URL del sitio. Reinicie la migración.
	5. Compruebe sus credenciales y el formato de la dirección URL. Reinicie la migración.
	6. Compruebe las credenciales y reinicie la migración. Si este problema continúa, cree un caso de soporte técnico.
	7. Compruebe las credenciales e intente abrir el sitio en un explorador. Reinicie la migración.
0x02010008	Confirme la ruta y el formato del archivo de asignación de usuarios y que tiene permiso para acceder a él.
0x02050001	Deben cerrarse todos los archivos y carpetas de la carpeta de trabajo del Administrador de migración, %appdata%\Microsoft\SPMigration\Logs\Migration\MigrationToolStorage. Reinicie la migración.
0x02010002	Compruebe el estado de la red. Si puede acceder a los sitios de origen desde un explorador, cree un caso de soporte técnico.
0x02010010	Asegúrese de que las listas de origen y destino tienen la misma plantilla.
0x0204000D	Durante la migración, deben cerrarse todos los archivos y carpetas de la carpeta de trabajo del Administrador de migración, %appdata%\Microsoft\SPMigration\Logs\Migration\MigrationToolStorage. Reinicie la migración.
0x02040012	El almacenamiento temporal en su equipo local es demasiado bajo. El Administrador de migración almacena en caché el paquete en la carpeta de trabajo. Expanda el almacenamiento temporal y vuelva a intentarlo.
0x02030003	Hay demasiados elementos con permisos exclusivos. Simplifique la lista de permisos reduciendo el número de permisos exclusivos. Reinicie la migración.
0x02050001	El archivo de almacenamiento local está dañado. La carpeta de trabajo se ha modificado o cambiado durante la migración. Vuelva a intentar la migración.
0x02080001	El archivo del paquete se ha cambiado o eliminado durante la carga. Deben cerrarse todos los archivos y carpetas de la carpeta de trabajo del Administrador de migración, %appdata%\Microsoft\SPMigration\Logs\Migration\MigrationToolStorage. Reinicie la migración.
0x02040009	No se puede crear el paquete porque no se encuentra el directorio. Deben cerrarse todos los archivos y carpetas de la carpeta de trabajo del Administrador de migración, %appdata%\Microsoft\SPMigration\Logs\Migration\MigrationToolStorage. Reinicie la migración.
0x02010020	Deshabilite la migración del historial de versiones en la configuración del Administrador de migración o habilite el control de versiones en SharePoint.
0x0201000E	Compruebe si la configuración global filtra caracteres especiales en la ruta de acceso de destino o si la ruta de acceso tiene caracteres no admitidos.
0X0201000F	URL del sitio no válida. Compruebe si la URL del sitio es válida. Intente acceder a la URL a través de un navegador. Si esta cuenta es una cuenta de OneDrive, asegúrese de que está aprovisionada previamente antes de migrar.
0x0207001	No tiene acceso a la carpeta de tareas. Compruebe si puede acceder a %appdata%\Microsoft\SPMigration\Logs\Migration\MigrationToolStorage.
0x01410010	Se ha producido un fallo debido a la falta de dependencias en los elementos de la lista. Compruebe los detalles en FailureSummaryReport.csv. Compruebe si las dependencias están incluidas en el ámbito de migración.
0x01510001	Los paquetes no se han podido cargar. Si tiene un almacenamiento de Azure personalizado, compruebe si puede acceder a Azure Storage y compruebe si puede acceder al sitio de destino. Intente migrar de nuevo.
0x01510001	No se cargó el trabajo en el servidor: error al cargar el archivo durante la migración.
0x02070009	Varios paquetes no se han podido cargar. Detenga la tarea y compruebe la conexión de red.
0x01710009	Se ha producido un error debido a fallos al final del trabajo; algunos elementos han fallado en el paquete. Reinicie la migración.
0x01710009	Errores o tiempo de espera para el servidor que procesa el archivo: no se migraron todos los elementos del paquete.
0x01610001	El contenedor de Azure expiró. Vuelva a intentar la tarea de migración.
0x01710006	Errores o tiempo de espera para el servidor que procesa el archivo: Error irrecuperable del trabajo.
0x01710004	Errores o tiempo de espera para el servidor que procesa el archivo. Error al buscar el nombre de la carpeta. Puede que el elemento exista en otra lista o sitio en la misma colección de sitios. O el elemento está en la papelera de reciclaje
0x0131000F	No se pudo leer el archivo. El archivo ha sido revisado.