La herramienta de migración de OneDrive omite rutas largas: solución para OneDrive for Business

Cuando migras archivos a OneDrive for Business mediante el Administrador de migración de Microsoft o la aplicación de sincronización de OneDrive, algunos archivos y carpetas pueden no moverse porque sus rutas superan el límite máximo de longitud de ruta de Windows de 260 caracteres. Este límite, también llamado MAX_PATH, hace que la herramienta de migración omita esos elementos sin previo aviso. Este artículo explica por qué la herramienta de migración se detiene en rutas largas, cómo identificar los archivos afectados y los pasos exactos para solucionar el problema y que todos tus datos se muevan correctamente.

Por qué la herramienta de migración de OneDrive omite rutas de archivo largas

El sistema de archivos NTFS de Windows admite rutas de más de 260 caracteres, pero muchas aplicaciones heredadas, incluidas partes de la infraestructura de migración de OneDrive, aún aplican el antiguo límite MAX_PATH. Cuando la herramienta de migración encuentra un archivo cuya ruta completa (incluyendo letra de unidad, carpetas, subcarpetas y nombre de archivo) supera los 260 caracteres, registra el archivo como omitido y continúa con el siguiente elemento. No bloquea toda la migración, pero los archivos omitidos permanecen en la ubicación de origen.

La causa raíz casi siempre es una estructura de carpetas profundamente anidada combinada con nombres de archivo largos. Por ejemplo, una carpeta llamada “Marketing Campaign Q4 2024 Final Assets” dentro de “Shared Drive Archive” dentro de “Corporate Files” puede fácilmente llevar un nombre de archivo simple como “Presentation_Draft_v3_Feedback_Edits.docx” a más de 260 caracteres. La herramienta de migración no acorta rutas automáticamente ni mueve archivos a una ubicación menos profunda.

Dónde se aplica el límite

El límite de 260 caracteres se aplica a la ruta absoluta en el servidor de archivos de origen o en la unidad local. OneDrive en sí, una vez que los archivos están en la nube, tiene un límite de 400 caracteres para la ruta URL completa, pero la herramienta de migración primero usa la resolución de ruta local. El límite no se aplica a los archivos almacenados directamente en bibliotecas de documentos de SharePoint cuando se accede a través de la web, pero sí se aplica durante el proceso de carga de la migración.

Pasos para identificar y corregir archivos con rutas largas antes de la migración

Antes de volver a ejecutar la herramienta de migración, debes localizar cada archivo con una ruta de más de 260 caracteres y acortar la ruta o habilitar el soporte de rutas largas en la máquina de origen.

Método 1: Usar PowerShell para encontrar rutas largas

1. Abrir PowerShell como administrador
   Presiona la tecla de Windows, escribe “PowerShell”, haz clic derecho en Windows PowerShell y selecciona Ejecutar como administrador.
2. Ejecutar el comando de escaneo de longitud de ruta
   Escribe el siguiente comando y presiona Enter:
   Get-ChildItem -Path "C:\SourceFolder" -Recurse -Force | Where-Object { $_.FullName.Length -gt 260 } | Select-Object FullName, Length
   Reemplaza “C:\SourceFolder” con la carpeta raíz real que estás migrando. Este comando lista cada archivo y carpeta cuya ruta absoluta supera los 260 caracteres. La columna Length muestra el número de caracteres.
3. Exportar la lista a un archivo CSV
   Agrega | Export-Csv -Path "LongPaths.csv" -NoTypeInformation al final del comando. Abre el CSV en Excel para revisar cada ruta y planificar el cambio de nombre.

Método 2: Acortar nombres de carpetas y archivos

1. Renombrar carpetas profundas con nombres más cortos
   Identifica carpetas a más de cinco niveles desde la raíz. Renómbralas con tres o cuatro caracteres, como “Mktg” en lugar de “Marketing Campaign Q4 2024 Final Assets”. Usa el Explorador de archivos o un bucle de Rename-Item en PowerShell para cambios masivos.
2. Acortar nombres de archivo
   Reduce los nombres de archivo a 20 caracteres o menos. Por ejemplo, renombra “Presentation_Draft_v3_Feedback_Edits.docx” a “Pres_v3_fb.docx”. Evita caracteres especiales que añadan longitud.
3. Aplanar la estructura de carpetas
   Mueve archivos de subcarpetas profundamente anidadas a una carpeta principal con un nombre corto. Esto reduce la longitud de la ruta sin renombrar cada archivo.
4. Volver a ejecutar el escaneo de ruta
   Ejecuta el comando de PowerShell nuevamente para confirmar que ninguna ruta supere los 260 caracteres antes de iniciar la migración.

Método 3: Habilitar soporte de rutas largas mediante Directiva de grupo

1. Abrir el Editor de directivas de grupo local
   Presiona la tecla de Windows + R, escribe gpedit.msc y presiona Enter.
2. Navegar a la configuración de rutas largas
   Ve a Configuración del equipo > Plantillas administrativas > Sistema > Sistema de archivos. Haz doble clic en “Habilitar rutas largas de Win32”.
3. Habilitar la directiva
   Selecciona Habilitada y haz clic en Aceptar. Esta configuración permite que Windows y las aplicaciones que admiten el prefijo de ruta extendida manejen rutas de hasta 32,767 caracteres.
4. Reiniciar la máquina
   Reinicia el equipo para que la directiva surta efecto. La herramienta de migración de OneDrive también debe reiniciarse para reconocer el nuevo límite.

Si la herramienta de migración aún omite archivos después de corregir las rutas

La herramienta de migración de OneDrive informa “Ruta demasiado larga” incluso después de renombrar

Si la herramienta aún omite los mismos archivos, el problema puede ser una carpeta oculta o un atributo de archivo de sistema. Ejecuta el comando de PowerShell con el parámetro -Force para incluir elementos ocultos y del sistema. Si una carpeta oculta tiene una ruta larga, muéstrala temporalmente, renómbrala y vuelve a ocultarla después de la migración.

La aplicación de sincronización de OneDrive se detiene durante la carga de un archivo con ruta larga

La aplicación de sincronización de OneDrive en sí tiene un límite de 400 caracteres para la ruta URL completa, pero el motor de sincronización local puede seguir aplicando el límite de 260 caracteres para la ruta de caché local. Si estás usando la aplicación de sincronización como método de migración, habilita el soporte de rutas largas en Windows usando el método de Directiva de grupo anterior y luego reinicia la aplicación de sincronización. Si el archivo aún falla, usa la Herramienta de migración de SharePoint (SPMT) en su lugar, que maneja rutas largas de manera más confiable.

Herramienta de migración de OneDrive vs PowerShell Rename: diferencias clave para rutas largas

Elemento	Herramienta de migración de OneDrive	PowerShell Rename-Item
Manejo del límite de ruta	Omite archivos por encima de 260 caracteres por defecto; sin renombrado automático	Puede renombrar archivos con rutas de hasta 32,767 caracteres si el soporte de rutas largas está habilitado
Operación masiva	Migra archivos en paralelo; informa elementos omitidos en un registro	Procesa un archivo a la vez; requiere un bucle para acciones masivas
Riesgo de pérdida de datos	Bajo; los archivos omitidos permanecen en el origen	Moderado; un renombrado incorrecto puede romper referencias de archivos si se usa sin pruebas
Mejor caso de uso	Migración inicial de recursos compartidos de archivos grandes	Limpieza previa a la migración para reducir la longitud de las rutas

Ahora puedes identificar archivos con rutas de más de 260 caracteres, renombrarlos o reestructurarlos, y volver a ejecutar la herramienta de migración de OneDrive sin omitir elementos. A continuación, revisa el informe de finalización de la migración en el Centro de administración de Microsoft 365 para verificar que no se haya dejado ningún archivo atrás. Como consejo avanzado, programa un script de PowerShell semanal que escanee tus recursos compartidos de archivos en busca de rutas que se acerquen a 250 caracteres para que puedas corregirlas antes del próximo ciclo de migración.