Cuando un usuario informa que la sincronización de OneDrive está atascada, muestra errores o no sincroniza una biblioteca de documentos de SharePoint específica, la solución estándar de desvincular y volver a vincular OneDrive desde la cuenta puede ser demasiado agresiva. Ese método restablece la sincronización para todos los sitios y archivos personales, lo que desperdicia tiempo y conlleva riesgo de pérdida de datos. Este artículo explica cómo restablecer la sincronización para un solo sitio de SharePoint usando un comando de administrador de SharePoint, sin afectar otras ubicaciones sincronizadas.
La causa raíz suele ser una caché de sincronización local dañada, un bloqueo de archivo roto o una relación de sincronización obsoleta que el Motor de sincronización de Microsoft no puede resolver por sí solo. Al borrar solo la caché y las entradas del registro vinculadas a ese sitio, se conservan las otras conexiones de sincronización del usuario y se evita una resincronización completa de datos no relacionados.
Esta guía cubre los comandos exactos de PowerShell y los pasos manuales para restablecer la sincronización de un sitio de SharePoint, además de cómo verificar la solución y manejar patrones de error comunes.
Puntos clave: Restablecer la sincronización de OneDrive para un solo sitio de SharePoint
- SharePoint Management Shell > Stop-SPOSync: Finaliza la relación de sincronización para una URL de sitio específica sin desvincular todo el OneDrive del usuario.
- Registro de Windows > HKCU\Software\Microsoft\OneDrive\Accounts\Business1: Almacena metadatos de sincronización por sitio; eliminar la subclave correcta elimina solo el estado de sincronización de ese sitio.
- OneDrive > Configuración > Cuenta > Detener sincronización: Un botón que permite a los usuarios detener la sincronización de una sola biblioteca, pero no borra la caché local.
Por qué falla la sincronización de OneDrive para un sitio de SharePoint
La sincronización de OneDrive utiliza una base de datos local y archivos de caché almacenados en %LocalAppData%\Microsoft\OneDrive. Cuando la sincronización de un solo sitio de SharePoint encuentra corrupción, conflictos de archivos o una discrepancia en el token de sincronización, todo el motor de sincronización puede detenerse para ese sitio mientras otros sitios siguen funcionando. El Motor de sincronización de Microsoft no repara automáticamente la corrupción por sitio porque trata cada relación de sincronización como una sesión aislada.
Los desencadenantes comunes incluyen:
- Un usuario movió o eliminó una carpeta que OneDrive estaba rastreando
- Un archivo con una ruta larga o un carácter especial bloquea la cola de sincronización
- El token de sincronización almacenado en la base de datos local es más antiguo que el token actual del servidor
- El software antivirus de terceros bloquea archivos durante la sincronización
Restablecer la sincronización solo para ese sitio elimina los metadatos locales y fuerza al motor a volver a enumerar la biblioteca desde SharePoint, preservando todas las demás relaciones de sincronización.
Pasos para restablecer la sincronización de OneDrive para un sitio de SharePoint
Necesita permisos de administrador de SharePoint en el centro de administración de Microsoft 365 y acceso de administrador local en el equipo del usuario. Realice estos pasos en orden.
- Identifique la URL del sitio afectado
Abra el centro de administración de SharePoint en admin.microsoft.com/SharePoint. Vaya a Sitios activos y localice el sitio. Copie la URL de la colección de sitios, por ejemplo https://contoso.sharepoint.com/sites/ProjectAlpha. - Ejecute Stop-SPOSync desde SharePoint Management Shell
Abra SharePoint Management Shell como administrador. Conéctese a su inquilino conConnect-SPOService -Url https://contoso-admin.sharepoint.com. EjecuteStop-SPOSync -SiteUrl "https://contoso.sharepoint.com/sites/ProjectAlpha". Este comando finaliza la relación de sincronización para ese sitio en el lado del servidor. No elimina archivos ni afecta a otros sitios. - Borre la caché de sincronización local para ese sitio
En el equipo del usuario, cierre OneDrive por completo. Haga clic con el botón derecho en el icono de OneDrive en la bandeja del sistema y seleccione Pausar sincronización > Salir de OneDrive. Abra el Explorador de archivos y navegue a %LocalAppData%\Microsoft\OneDrive\settings\Business1. Busque una carpeta con el nombre del ID del sitio (una cadena alfanumérica larga). Elimine esa carpeta. Esto elimina la base de datos local y la caché solo para ese sitio. - Elimine la clave del registro para el sitio
Presione Windows + R, escriba regedit y presione Entrar. Navegue a HKEY_CURRENT_USER\Software\Microsoft\OneDrive\Accounts\Business1. En Business1, localice una subclave que contenga la URL del sitio en su nombre, por ejemplo {12345678-1234-1234-1234-123456789abc}. Haga clic con el botón derecho en esa subclave y seleccione Eliminar. Confirme la eliminación. Este paso evita que OneDrive intente reanudar una sesión de sincronización rota. - Reinicie OneDrive y vuelva a sincronizar la biblioteca
Abra OneDrive desde el menú Inicio. Inicie sesión si se le solicita. Haga clic en el icono de OneDrive en la bandeja del sistema, seleccione Configuración > Cuenta > Elegir carpetas. Busque la biblioteca del sitio que estaba atascada y marque la casilla para sincronizarla. OneDrive volverá a descargar la lista de archivos desde SharePoint y reconstruirá la caché local.
Si la sincronización de OneDrive sigue teniendo problemas después de la solución principal
OneDrive muestra “Sincronizando” pero no aparecen archivos
Si la biblioteca permanece vacía después de volver a sincronizar, el usuario puede tener una configuración de filtro o vista que oculta archivos. Abra la biblioteca en un navegador y verifique la vista actual. También verifique que el usuario tenga al menos acceso de Lectura a la biblioteca. Ejecute Test-SPOSite -Identity "https://contoso.sharepoint.com/sites/ProjectAlpha" en SharePoint Management Shell para confirmar que el sitio está en buen estado.
Los errores de sincronización persisten después de borrar la caché
Algunos nombres de archivo o rutas violan el límite de 400 caracteres de OneDrive. Ejecute la biblioteca de documentos de SharePoint a través de la herramienta “Comprobar problemas” en la configuración de la biblioteca en el navegador. Cambie el nombre o mueva los archivos con nombres que incluyan caracteres como # % & o que superen los 256 caracteres. Después de limpiar la biblioteca, repita los pasos de restablecimiento.
La sincronización de OneDrive se detiene para todos los sitios después de restablecer un sitio
Esto indica que la eliminación de la clave del registro afectó a la clave principal Business1 en lugar de a la subclave específica del sitio. Restaure el registro desde una copia de seguridad o vuelva a crear la clave Business1 cerrando sesión en OneDrive y volviendo a iniciarla. Luego, vuelva a sincronizar solo el sitio afectado usando los pasos anteriores.
| Elemento | Restablecimiento completo de OneDrive | Restablecimiento de un solo sitio |
|---|---|---|
| Alcance | Todos los sitios sincronizados y OneDrive personal | Solo un sitio de SharePoint |
| Afecta archivos personales | Sí | No |
| Requiere reautenticación | Sí | No |
| Tiempo para completar | 15–30 minutos | 5–10 minutos |
| Privilegios de administrador necesarios | Solo administrador local | Administrador de SharePoint + administrador local |
Ahora puede restablecer la sincronización de OneDrive para un solo sitio de SharePoint sin interrumpir las otras conexiones de sincronización del usuario. Use el comando Stop-SPOSync de SharePoint Management Shell como primer paso, luego limpie la caché local y la clave del registro. Para problemas recurrentes, ejecute la herramienta Comprobación de estado de SharePoint en la biblioteca de documentos para identificar archivos problemáticos antes de restablecer la sincronización nuevamente. Como sugerencia avanzada, automatice la limpieza del registro implementando un script de PowerShell a través de Microsoft Intune que elimine la subclave específica del sitio según el ID del sitio informado en los registros de OneDrive.