Compartir a través de


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.

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.

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.

Pantalla de error de instalación del agente

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:

Captura de pantalla de error de instalación del agente de Migration Manager.

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.

El agente se desconectó

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.

Tarea bloqueada en estado en cola.

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.

No se puede descargar la captura de pantalla del informe de tareas.

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.

Error del Administrador de migración

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.

El informe de errores de Google incluye código HTML.

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.

Problema de la tarea de examen bloqueada en la fase en cola.

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 .

Solución de problemas de la tarea de examen.

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.

Examine los agentes de edición de problemas de tareas.

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.