Cómo solucionar errores de caracteres no admitidos en el informe de migración

Cuando ejecuta una migración de SharePoint mediante la Herramienta de migración de SharePoint (SPMT) o la API de migración, el informe de migración puede mostrar elementos como fallidos debido a caracteres no admitidos en nombres de archivo, nombres de carpeta o metadatos. SharePoint Online aplica reglas de nomenclatura estrictas que rechazan caracteres como #, %, &, {, ~ y espacios al final. Estos fallos pueden impedir que la migración se complete o causar pérdida parcial de datos. Este artículo explica por qué los caracteres no admitidos causan fallos, cómo identificarlos en el informe de migración y los pasos exactos para corregir los nombres de archivo para que la migración pueda realizarse correctamente.

Por qué los caracteres no admitidos causan fallos en la migración

SharePoint Online utiliza las convenciones de nomenclatura del sistema de archivos de Windows más restricciones adicionales para el acceso basado en web. Cuando un nombre de archivo o carpeta contiene un carácter no permitido, la Herramienta de migración de SharePoint no puede crear el elemento en la biblioteca de destino. El motor de migración registra el archivo como Fallido con un código de error como UnsupportedFileNameCharacters o InvalidFolderName.

La lista completa de caracteres no admitidos en nombres de archivo y carpeta en SharePoint Online incluye:

• ~ tilde
• " comillas dobles
• # signo de número
• % porcentaje
• & ampersand
• asterisco
• : dos puntos
• < menor que
• > mayor que
• ? signo de interrogación
• / barra diagonal
• \ barra invertida
• { llave izquierda
• | barra vertical
• } llave derecha
• Espacios al principio o al final
• Puntos al final

Estas restricciones se aplican a nombres de archivo, nombres de carpeta y campos de metadatos como título o descripción. La herramienta de migración no renombra archivos automáticamente. Debe corregir los nombres antes o después del intento de migración.

Pasos para identificar y corregir caracteres no admitidos en el informe de migración

1. Abra el informe de migración
   Después de que un trabajo de migración se complete, abra la Herramienta de migración de SharePoint. Vaya a Administrador de migración y seleccione el trabajo que falló. Haga clic en Ver informe para descargar el archivo CSV. El informe contiene columnas para Source Path, Destination Path, Status y Error. Filtre la columna Status para mostrar solo las filas Fallido.
2. Identifique los caracteres no admitidos
   En el informe CSV, mire la columna Error. Si el mensaje de error contiene UnsupportedFileNameCharacters o InvalidFolderName, anote la ruta de origen completa. Copie el nombre del archivo o carpeta en un editor de texto. Use la lista de caracteres anterior para encontrar el carácter problemático. Los culpables comunes son # en nombres de archivo de números de versión, & en nombres de proyecto y espacios al final de la entrada del usuario.
3. Renombre los archivos o carpetas en el origen
   En su servidor de archivos local o recurso compartido de red, navegue a la carpeta de origen. Renombre cada archivo o carpeta que contenga caracteres no admitidos. Reemplace cada carácter no válido con una alternativa válida. Por ejemplo, reemplace # con No, reemplace & con and y elimine los espacios al final. Mantenga el nombre corto y legible. No use caracteres que sigan siendo no válidos.
4. Use PowerShell para escanear y renombrar automáticamente
   Si tiene muchos archivos, use un script de PowerShell para encontrarlos y renombrarlos. Abra PowerShell como administrador y ejecute este script que reemplaza caracteres no válidos con un guion:

   
Get-ChildItem -Path "C:\SourceFolder\" -Recurse | Where-Object { $_.Name -match '[~"#%&:<>?/\\{|} ]' } | ForEach-Object {
  $newName = $_.Name -replace '[~"#%&:<>?/\\{|} ]', '-';
  Rename-Item -Path $_.FullName -NewName $newName
}

   Reemplace C:\SourceFolder con su ruta de origen real. Este script reemplaza cualquier carácter no válido con un guion. Pruébelo primero en una carpeta pequeña.

5. Vuelva a ejecutar el trabajo de migración
   Después de renombrar los archivos, regrese a la Herramienta de migración de SharePoint. Seleccione el mismo origen y destino. La herramienta escaneará el origen nuevamente. Dado que los nombres ahora son válidos, la migración debería completarse sin el error de caracteres no admitidos. Supervise el nuevo informe para confirmar que todos los elementos pasen.
6. Verifique los archivos en SharePoint
   Después de que la migración termine, abra la biblioteca de documentos de SharePoint en un navegador. Compruebe que todos los archivos aparezcan con los nuevos nombres. Abra algunos archivos para confirmar que el contenido esté intacto. Si usó un script, verifique que ningún nombre de archivo se haya truncado o duplicado.

Si la migración aún muestra fallos después de renombrar

"El nombre de archivo contiene un punto o espacio al final"

SharePoint no permite nombres de archivo que terminen con un punto o un espacio. Por ejemplo, Report..docx o Draft .docx. Estos caracteres son invisibles en muchos exploradores de archivos. Para corregirlo, use PowerShell para eliminar puntos y espacios al final. El script anterior reemplazará espacios con guiones pero no eliminará puntos al final. Agregue esta línea después del comando de renombrado:

Rename-Item -Path $_.FullName -NewName ($_.BaseName.TrimEnd('. ') + $_.Extension)

"El nombre de archivo es demasiado largo"

SharePoint Online tiene una longitud máxima de ruta de 400 caracteres. Si su ruta de archivo (incluidos los nombres de carpeta) excede este límite, la migración falla. El mensaje de error puede decir PathTooLong. Acorte los nombres de carpeta o elimine carpetas anidadas innecesarias. Mueva archivos profundos más cerca de la raíz de la biblioteca.

"El informe de migración no muestra errores pero faltan algunos archivos"

Si el informe dice que todos los elementos se realizaron correctamente pero faltan archivos, verifique la columna Skipped en el informe CSV. Los archivos pueden omitirse si el destino ya tiene un archivo con el mismo nombre. Elimine el archivo existente o use la opción Sobrescribir en la configuración de migración.

Corrección manual vs. automatizada: diferencias clave

Elemento	Corrección manual	Corrección automatizada con PowerShell
Tiempo requerido	Alto para muchos archivos	Bajo después de configurar el script
Riesgo de error humano	Alto	Bajo si el script se prueba
Control sobre los nuevos nombres	Control total por archivo	Usa una regla de reemplazo consistente
Mejor para	Pocos archivos con necesidades de nomenclatura complejas	Cientos o miles de archivos

Después de corregir todos los caracteres no admitidos, su informe de migración debería mostrar cero fallos para esa categoría. Vuelva a ejecutar el trabajo de migración para los archivos corregidos. Si aún ve fallos, verifique otros errores como nombres duplicados o problemas de permisos. La Herramienta de migración de SharePoint registra cada error con un código específico, que puede buscar en la documentación de Microsoft. Use la función Exportar informe para mantener un registro de migraciones exitosas para auditoría.