Migración de servidor de archivos a OneDrive for Business omite archivos de datos ejecutivos: guía de corrección

Al migrar archivos de un servidor de archivos a OneDrive for Business, es posible que descubra que ciertos archivos faltan después de completar la migración. Este problema suele afectar a datos ejecutivos, incluidos archivos con permisos restringidos, rutas largas o caracteres especiales en los nombres de archivo. El problema generalmente ocurre porque la herramienta de migración omite archivos que infringen las restricciones de sincronización de OneDrive o SharePoint. Esta guía explica por qué se omiten los datos ejecutivos y proporciona soluciones paso a paso para localizar y migrar esos archivos faltantes.

Por qué la migración omite archivos ejecutivos

SharePoint Migration Tool (SPMT) y otras utilidades de migración aplican las mismas reglas de nomenclatura de archivos y carpetas que se aplican a OneDrive y SharePoint Online. Los archivos que infringen estas reglas se omiten silenciosamente. Los datos ejecutivos a menudo residen en estructuras de carpetas profundamente anidadas, contienen archivos con nombres de más de 400 caracteres o utilizan caracteres como ~ " # % & : < > ? / \ { | } que están bloqueados en OneDrive. Además, los archivos con permisos únicos heredados del servidor de archivos pueden no transferirse correctamente si la herramienta de migración no tiene suficientes derechos de acceso para leer los descriptores de seguridad de los archivos.

Otra causa común es el límite de tamaño de archivo. OneDrive for Business permite archivos de hasta 250 GB por archivo. Sin embargo, si la herramienta de migración encuentra un archivo que supera este límite, falla silenciosamente. Los archivos de datos ejecutivos, los archivos de presentación grandes o las grabaciones de video pueden alcanzar este límite. El registro de migración a menudo marca estos archivos como omitidos sin un mensaje de error detallado, lo que dificulta identificar la causa exacta.

Por último, la herramienta de migración puede omitir archivos que están bloqueados por otro proceso durante la ventana de migración. Las estaciones de trabajo ejecutivas a menudo tienen archivos abiertos durante períodos prolongados, y la herramienta de migración no puede copiar archivos abiertos. Si la migración se ejecuta durante el horario comercial, estos archivos se pierden.

Pasos para encontrar y migrar archivos ejecutivos faltantes

1. Ejecutar un análisis previo con SPMT para identificar archivos bloqueados
   Abra SharePoint Migration Tool y seleccione Start fresh. Elija el origen del servidor de archivos y el destino de OneDrive. Antes de iniciar la migración, haga clic en Scan. El informe de análisis enumera cada archivo que se omitirá y el motivo. Exporte este informe como un archivo CSV para referencia.
2. Revisar el informe de la tarea de migración para elementos omitidos
   Una vez finalizada la migración, abra SPMT y vaya a Task status. Seleccione la tarea completada y haga clic en View report. Busque filas con un estado de Skipped o Failed. El informe incluye la ruta del archivo y el código de error.
3. Corregir problemas de nombres de archivo y rutas antes de reintentar
   Cambie el nombre de los archivos que contienen caracteres bloqueados. Acorte las rutas de archivo a menos de 400 caracteres moviendo los archivos a una estructura de carpetas menos profunda. Elimine los espacios iniciales o finales en los nombres de archivo. Después de corregir, ejecute la migración nuevamente solo para las carpetas afectadas.
4. Resolver conflictos de permisos con una cuenta de superusuario
   Utilice una cuenta de migración que tenga Control total en el origen del servidor de archivos. Si los archivos ejecutivos tienen permisos únicos, otorgue a la cuenta de migración permisos explícitos de Lectura y Escritura en cada carpeta afectada. En SPMT, configure la asignación de usuarios para preservar el propietario original del archivo o reasignar al usuario ejecutivo.
5. Usar PowerShell para comparar los recuentos de archivos de origen y destino
   Abra SharePoint Online Management Shell. Ejecute Get-PnPFilesInFolder -FolderSiteRelativeUrl "Documents/Executive" -Connection $conn | Measure-Object para contar los archivos en el destino de OneDrive. Compare ese recuento con el recuento de la carpeta del servidor de archivos. Si los números difieren, identifique los archivos faltantes ejecutando un script de comparación recursiva.
6. Migrar archivos bloqueados fuera del horario laboral
   Programe la migración para que se ejecute fuera del horario comercial. Utilice la opción Schedule en SPMT para establecer una hora de inicio. Alternativamente, use el cmdlet de PowerShell Start-SPFileMigration con el parámetro -StartTime para especificar una hora en la que los archivos no estén en uso.

Si los archivos ejecutivos aún tienen problemas después de la corrección principal

OneDrive informa un error 404 para un archivo ejecutivo migrado

Un error 404 significa que el archivo existe en el servidor de archivos pero no se cargó en OneDrive. Esto ocurre cuando el nombre del archivo contiene un carácter no seguro para URL que la herramienta de migración no puede codificar. Abra la carpeta del servidor de archivos, cambie el nombre del archivo para eliminar caracteres como & o #, y ejecute la migración nuevamente en esa carpeta específica. Utilice la opción de migración incremental de SPMT para cargar solo archivos nuevos o modificados.

Los archivos ejecutivos aparecen en OneDrive pero no se pueden abrir

Si el archivo está presente pero muestra un error al abrirlo, es posible que se haya dañado durante la transferencia. Esto sucede a menudo con archivos muy grandes de más de 10 GB. Descargue el archivo original del servidor de archivos, verifique su integridad abriéndolo localmente y luego cárguelo manualmente mediante la interfaz web de OneDrive. No utilice la herramienta de migración para archivos que fallen de esta manera.

La herencia de permisos se rompe después de la migración

OneDrive for Business no admite el mismo modelo de permisos NTFS que un servidor de archivos. Después de la migración, todos los archivos en una carpeta de OneDrive heredan permisos de la carpeta principal. Si los archivos ejecutivos requieren permisos únicos, debe establecerlos individualmente en OneDrive. Utilice la opción Manage access en cada archivo para otorgar permisos de usuario específicos. Alternativamente, cree una biblioteca de OneDrive separada para datos ejecutivos y aplique permisos a nivel de biblioteca.

SharePoint Migration Tool vs carga manual para datos ejecutivos: Diferencias clave

Elemento	SharePoint Migration Tool (SPMT)	Carga manual a través de la web de OneDrive
Límite de tamaño de archivo	250 GB por archivo	250 GB por archivo
Límite de longitud de ruta	400 caracteres	400 caracteres
Caracteres bloqueados	Omite archivos con caracteres bloqueados	Bloquea la carga con un mensaje de error claro
Manejo de permisos	Puede omitir archivos sin acceso explícito de la cuenta de migración	El cargador debe tener permiso de escritura en el destino
Comportamiento con archivos bloqueados	Omite archivos abiertos silenciosamente	Falla con error de archivo en uso
Migración incremental	Compatible	No compatible

Para datos ejecutivos, SPMT es el método preferido para la migración masiva porque admite ejecuciones incrementales y genera registros detallados. La carga manual es mejor para archivos individuales que SPMT omite sistemáticamente debido a problemas de ruta o caracteres.

Ahora puede identificar por qué faltan archivos ejecutivos después de una migración de servidor de archivos y aplicar correcciones específicas para problemas de longitud de ruta, caracteres, permisos y archivos bloqueados. A continuación, revise el informe de análisis previo de SPMT para todas las carpetas restantes a fin de detectar problemas similares antes de la próxima ola de migración. Para la gestión continua de datos ejecutivos, considere configurar una directiva de sincronización de OneDrive que excluya los tipos de archivo bloqueados y aplique reglas de nomenclatura en el origen.