Cómo comparar los registros de la herramienta de migración de OneDrive con las quejas de los usuarios

Cuando migra archivos desde una unidad local u otro servicio en la nube a OneDrive, los usuarios suelen informar archivos faltantes, vínculos rotos o permisos incorrectos. Debe verificar si estas quejas coinciden con los registros de la herramienta de migración. Este artículo explica cómo extraer las entradas de registro relevantes, cruzarlas con los informes de los usuarios e identificar falsos positivos frente a fallos de migración reales. Aprenderá un proceso repetible con el Administrador de migración de Microsoft 365, PowerShell y Excel para conciliar los registros con las quejas de los usuarios de forma eficiente.

Cómo se estructuran los registros de la herramienta de migración

El Administrador de migración de Microsoft 365 almacena los registros en dos ubicaciones. La primera es el informe en el explorador, en Administrador de migración > Informes. Este informe enumera cada elemento de origen analizado, su ruta de destino, tamaño y una columna de estado que muestra Correcto, Con error o Omitido. La segunda ubicación es el contenedor de Azure Storage que especificó al crear el agente de migración. El agente escribe registros detallados por elemento en un contenedor denominado migration-logs de forma predeterminada.

Cada entrada de registro contiene una marca de tiempo, la ruta del archivo de origen, la ruta del archivo de destino, el código de error, el mensaje de error y un identificador de correlación. El identificador de correlación vincula un único archivo a través de varios archivos de registro. Cuando un usuario se queja de un archivo específico, puede buscar ese nombre o ruta de archivo en el CSV exportado o en los registros de Azure Storage. El código de error le indica si el fallo se debió a un problema de permisos, un conflicto de nombre de archivo, un límite de tamaño o un tiempo de espera de red.

Pasos para cruzar los registros con las quejas de los usuarios

Siga estos pasos para comparar los registros de la herramienta de migración con las quejas de los usuarios de forma sistemática. Necesitará acceso al Centro de administración de Microsoft 365, a la cuenta de Azure Storage utilizada para los registros de migración y a Excel u otra aplicación de hoja de cálculo.

1. Exporte el informe del Administrador de migración
   Inicie sesión en el Centro de administración de Microsoft 365. Vaya a Administrador de migración > Informes. Haga clic en Exportar y elija CSV. Guarde el archivo en su equipo local. Este CSV contiene todos los elementos analizados con su estado final. Si ejecutó varios trabajos de migración, exporte cada trabajo por separado o use el filtro para seleccionar un ID de trabajo específico.
2. Recopile las quejas de los usuarios en una lista estructurada
   Cree una hoja de cálculo con las columnas: Nombre de usuario, Ruta de archivo informada, Problema informado, Fecha informada y Prioridad. Pida a los usuarios que proporcionen la ruta exacta del archivo desde su ubicación de OneDrive o SharePoint. Por ejemplo, Documents/Finance/Q4_Report.xlsx. Si el usuario no recuerda la ruta, busque en el registro de auditoría de OneDrive del usuario los intentos de acceso recientes a los archivos faltantes.
3. Cargue ambos conjuntos de datos en Excel
   Abra el CSV exportado en Excel. En una hoja nueva, pegue la lista de quejas de los usuarios. Asegúrese de que la columna de ruta de archivo en ambas hojas use el mismo formato. Si el registro de migración muestra rutas relativas y los usuarios proporcionan rutas absolutas, cree una columna auxiliar que quite el prefijo de la carpeta raíz.
4. Compare las entradas con VLOOKUP
   En la hoja de quejas de los usuarios, agregue una columna nueva denominada Estado del registro. Use la fórmula =VLOOKUP(B2, MigrationLogs!A:A, 1, FALSE) donde B2 es la ruta de archivo informada por el usuario y MigrationLogs!A:A es la columna que contiene las rutas de origen de la exportación. Si la fórmula devuelve una ruta, el archivo se analizó. Si devuelve #N/A, el archivo nunca se migró o la ruta es diferente.
5. Investigue las entradas coincidentes para obtener detalles del error
   Para cada archivo coincidente, observe la columna Estado correspondiente en el registro de migración. Si el estado es Con error, copie el código de error y el mensaje de error en la hoja de quejas de los usuarios. Si el estado es Correcto pero el usuario sigue informando un problema, es probable que el problema esté fuera de la herramienta de migración; por ejemplo, permisos no heredados, conflictos de versiones de archivos o falta de capacitación del usuario.
6. Use PowerShell para obtener registros por elemento de archivos no coincidentes
   Abra el Shell de administración de SharePoint Online. Ejecute Get-SPOMigrationJobProgress -Identity "JobID" para ver todos los elementos de un trabajo específico. Canalice la salida a Where-Object {$_.SourceFile -like "filename"} para encontrar un archivo específico. Este método funciona cuando el archivo se migró pero la exportación CSV se filtró o truncó.
7. Revise los registros de Azure Storage para detectar errores de red o tiempos de espera
   Vaya a su contenedor de Azure Storage. Descargue el contenido de la carpeta migration-logs. Busque el nombre de archivo informado por el usuario con cualquier editor de texto o analizador de registros. Los errores de tiempo de espera de red aparecen como System.Net.WebException: The operation has timed out. Estos suelen afectar a varios archivos del mismo lote y pueden requerir volver a ejecutar el agente de migración fuera del horario de mayor actividad.

Patrones comunes cuando los registros y las quejas no coinciden

El usuario dice que falta un archivo, el registro indica correcto

Esta es la discrepancia más frecuente. El archivo se copió correctamente, pero el usuario está buscando en la biblioteca o carpeta equivocada. Pida al usuario que le muestre la URL exacta que está examinando. Compare la ruta de destino del registro de migración con la URL del usuario. A menudo, el usuario espera un archivo en Shared Documents pero el registro muestra que se colocó en una subcarpeta llamada Team Documents. Use la vista Contenido y estructura del sitio de SharePoint para mostrar todas las ubicaciones.

El usuario dice que los permisos son incorrectos, el registro no muestra error

Las herramientas de migración copian archivos, pero no siempre copian permisos únicos. Si el origen tenía permisos personalizados, debe migrarlos por separado con la Herramienta de migración de SharePoint con el indicador -IncludeUserPermissions. Sin este indicador, el archivo hereda los permisos de la biblioteca de destino. El registro mostrará correcto porque la copia del archivo en sí no falló. Verifique la queja del usuario con la configuración de permisos de la biblioteca de destino en Configuración de la biblioteca > Permisos para esta biblioteca de documentos.

El usuario dice que el archivo está dañado, el registro no muestra error

Un archivo que parece dañado después de la migración puede haberse dañado antes de la migración. Las herramientas de migración calculan una suma de comprobación (hash MD5) durante la copia. Si la suma de comprobación coincide, el archivo es idéntico bit a bit. Pida al usuario que descargue el archivo original del origen (si aún está disponible) y compare el tamaño y el hash del archivo. En PowerShell, ejecute Get-FileHash -Path "filepath" -Algorithm MD5 en ambas copias. Si los hash coinciden, el daño existía antes de la migración.

El usuario informa un conflicto de nombre de archivo, el registro muestra omitido

Cuando existen dos archivos con el mismo nombre en el origen, la herramienta de migración omite el duplicado de forma predeterminada. El registro muestra Omitido con el código de error NameConflict. Explique al usuario que el segundo archivo no se copió porque ya existe un archivo con ese nombre en el destino. El usuario debe cambiar el nombre de uno de los archivos y ejecutar una migración incremental para copiar el archivo renombrado. Use el registro para mostrar las rutas exactas de los archivos duplicados.

Campos del registro de migración frente a campos de quejas de usuarios: tabla de asignación

Campo	Entrada del registro de migración	Entrada de queja del usuario
Identificador de archivo	SourcePath o TargetPath	Ruta o nombre de archivo proporcionado por el usuario
Estado	Correcto, Con error, Omitido	Faltante, dañado, error de permisos o vínculo roto
Código de error	Código numérico o de cadena como 0x80070002	No proporcionado; debe inferirse de la descripción del usuario
Marca de tiempo	Marca de tiempo UTC del intento de migración	Fecha en que el usuario notó el problema por primera vez
Contexto del usuario	Identidad del agente de migración o administrador del inquilino	Correo electrónico o nombre para mostrar del usuario afectado

Conclusión

Ahora puede exportar los registros de migración desde el Administrador de migración, recopilar las quejas de los usuarios en una hoja de cálculo estructurada y compararlas con VLOOKUP o consultas de PowerShell. Cuando una coincidencia muestra correcto pero el usuario sigue informando un problema, revise la herencia de permisos, los hash de archivos o la ruta de la biblioteca de destino. Para los archivos no coincidentes, use los registros del contenedor de Azure Storage para encontrar errores de tiempo de espera o de red. Un consejo avanzado es automatizar el proceso de comparación escribiendo un script de PowerShell que lea tanto el CSV exportado como un CSV de quejas de usuarios y, a continuación, genere un informe de conciliación con el estado y los detalles de error de cada archivo.