Quando um usuário relata que a sincronização do OneDrive está travada, exibindo erros ou falhando ao sincronizar uma biblioteca de documentos específica do SharePoint, a correção padrão de desvincular e vincular novamente o OneDrive da conta pode ser agressiva demais. Esse método redefine a sincronização de todos os sites e arquivos pessoais, o que perde tempo e arrisca perda de dados. Este artigo explica como redefinir a sincronização de um único site do SharePoint usando um comando de administrador do SharePoint, sem afetar outros locais sincronizados.
A causa raiz geralmente é um cache de sincronização local corrompido, um bloqueio de arquivo quebrado ou uma relação de sincronização desatualizada que o Mecanismo de Sincronização da Microsoft não consegue resolver sozinho. Ao limpar apenas o cache e as entradas do registro vinculadas a esse site, você preserva as outras conexões de sincronização do usuário e evita uma ressincronização completa de dados não relacionados.
Este guia aborda os comandos exatos do PowerShell e as etapas manuais para redefinir a sincronização de um site do SharePoint, além de como verificar a correção e lidar com padrões de falha comuns.
Principais Conclusões: Redefinir Sincronização do OneDrive para um Único Site do SharePoint
- SharePoint Management Shell > Stop-SPOSync: Encerra a relação de sincronização para uma URL de site específica sem desvincular todo o OneDrive do usuário.
- Registro do Windows > HKCU\Software\Microsoft\OneDrive\Accounts\Business1: Armazena metadados de sincronização por site; excluir a subchave correta remove apenas o estado de sincronização desse site.
- OneDrive > Configurações > Conta > Parar Sincronização: Um botão que permite aos usuários parar a sincronização de uma única biblioteca, mas não limpa o cache local.
Por que a Sincronização do OneDrive Falha para um Site do SharePoint
A sincronização do OneDrive usa um banco de dados local e arquivos de cache armazenados em %LocalAppData%\Microsoft\OneDrive. Quando a sincronização de um único site do SharePoint encontra corrupção, conflitos de arquivo ou uma incompatibilidade de token de sincronização, todo o mecanismo de sincronização pode travar para esse site, enquanto outros sites continuam funcionando. O Mecanismo de Sincronização da Microsoft não repara automaticamente a corrupção por site porque trata cada relação de sincronização como uma sessão isolada.
Os gatilhos comuns incluem:
- Um usuário moveu ou excluiu uma pasta que o OneDrive estava rastreando
- Um arquivo com caminho longo ou caractere especial bloqueia a fila de sincronização
- O token de sincronização armazenado no banco de dados local é mais antigo que o token atual do servidor
- Software antivírus de terceiros bloqueia arquivos durante a sincronização
Redefinir a sincronização apenas para esse site remove os metadados locais e força o mecanismo a reenumerar a biblioteca do SharePoint, preservando todas as outras relações de sincronização.
Etapas para Redefinir a Sincronização do OneDrive para um Site do SharePoint
Você precisa de permissões de administrador do SharePoint no centro de administração do Microsoft 365 e acesso de administrador local na máquina do usuário. Execute estas etapas em ordem.
- Identifique a URL do site afetado
Abra o centro de administração do SharePoint em admin.microsoft.com/SharePoint. Vá para Sites ativos e localize o site. Copie a URL da coleção de sites, por exemplo https://contoso.sharepoint.com/sites/ProjetoAlpha. - Execute Stop-SPOSync no SharePoint Management Shell
Abra o SharePoint Management Shell como administrador. Conecte-se ao seu locatário comConnect-SPOService -Url https://contoso-admin.sharepoint.com. ExecuteStop-SPOSync -SiteUrl "https://contoso.sharepoint.com/sites/ProjetoAlpha". Este comando encerra a relação de sincronização para esse site no lado do servidor. Ele não exclui arquivos nem afeta outros sites. - Limpe o cache de sincronização local para esse site
Na máquina do usuário, feche o OneDrive completamente. Clique com o botão direito no ícone do OneDrive na bandeja do sistema e selecione Pausar sincronização > Sair do OneDrive. Abra o Explorador de Arquivos e navegue até %LocalAppData%\Microsoft\OneDrive\settings\Business1. Procure uma pasta com o nome do ID do site (uma longa string alfanumérica). Exclua essa pasta. Isso remove o banco de dados local e o cache apenas para esse site. - Remova a chave do registro para o site
Pressione a tecla Windows + R, digite regedit e pressione Enter. Navegue até HKEY_CURRENT_USER\Software\Microsoft\OneDrive\Accounts\Business1. Em Business1, localize uma subchave que contenha a URL do site em seu nome, por exemplo {12345678-1234-1234-1234-123456789abc}. Clique com o botão direito nessa subchave e selecione Excluir. Confirme a exclusão. Esta etapa impede que o OneDrive tente retomar uma sessão de sincronização quebrada. - Reinicie o OneDrive e ressincronize a biblioteca
Abra o OneDrive pelo menu Iniciar. Faça login se solicitado. Clique no ícone do OneDrive na bandeja do sistema, selecione Configurações > Conta > Escolher pastas. Encontre a biblioteca do site que estava travada e marque a caixa para sincronizá-la. O OneDrive baixará novamente a listagem de arquivos do SharePoint e reconstruirá o cache local.
Se a Sincronização do OneDrive Ainda Tiver Problemas Após a Correção Principal
OneDrive Mostra “Sincronizando” mas Nenhum Arquivo Aparece
Se a biblioteca permanecer vazia após a ressincronização, o usuário pode ter um filtro ou configuração de exibição que oculta arquivos. Abra a biblioteca em um navegador e verifique a exibição atual. Verifique também se o usuário tem pelo menos acesso de Leitura à biblioteca. Execute Test-SPOSite -Identity "https://contoso.sharepoint.com/sites/ProjetoAlpha" no SharePoint Management Shell para confirmar que o site está saudável.
Erros de Sincronização Persistem Após Limpar o Cache
Alguns nomes de arquivo ou caminhos violam o limite de 400 caracteres do OneDrive. Execute a biblioteca de documentos do SharePoint através da ferramenta “Verificar problemas” nas configurações da biblioteca no navegador. Renomeie ou mova quaisquer arquivos com nomes que incluam caracteres como # % & ou que excedam 256 caracteres. Após limpar a biblioteca, repita as etapas de redefinição.
A Sincronização do OneDrive Para para Todos os Sites Após Redefinir um Site
Isso indica que a exclusão da chave do registro afetou a chave pai Business1 em vez da subchave específica do site. Restaure o registro a partir de um backup ou recrie a chave Business1 saindo do OneDrive e entrando novamente. Em seguida, ressincronize apenas o site afetado usando as etapas acima.
| Item | Redefinição Completa do OneDrive | Redefinição de Site Único |
|---|---|---|
| Escopo | Todos os sites sincronizados e OneDrive pessoal | Apenas um site do SharePoint |
| Afeta arquivos pessoais | Sim | Não |
| Requer reautenticação | Sim | Não |
| Tempo para concluir | 15–30 minutos | 5–10 minutos |
| Privilégios de administrador necessários | Apenas administrador local | Administrador do SharePoint + administrador local |
Agora você pode redefinir a sincronização do OneDrive para um único site do SharePoint sem interromper as outras conexões de sincronização do usuário. Use o comando Stop-SPOSync do SharePoint Management Shell como primeira etapa, depois limpe o cache local e a chave do registro. Para problemas recorrentes, execute a ferramenta de Verificação de Integridade do SharePoint na biblioteca de documentos para identificar arquivos problemáticos antes de redefinir a sincronização novamente. Como dica avançada, automatize a limpeza do registro implantando um script PowerShell via Microsoft Intune que exclui a subchave específica do site com base no ID do site relatado nos logs do OneDrive.