Ao implantar o OneDrive em PCs Windows gerenciados na sua organização, os usuários frequentemente relatam que uma biblioteca compartilhada exibe o status ‘Pendente’ e nunca sincroniza os arquivos. Esse sintoma ocorre porque o mecanismo de sincronização do OneDrive não consegue resolver a URL do site do SharePoint ou não tem as permissões, configurações de política de grupo ou acesso de rede necessários. Este artigo explica as cinco causas raiz mais comuns e fornece um checklist passo a passo que os administradores de TI podem usar para resolver o estado pendente em bibliotecas compartilhadas.
Principais Conclusões: Checklist para Resolução de Sincronização Pendente de Biblioteca Compartilhada
- Central de administração do OneDrive > Sincronização > Permitir sincronização apenas para domínios específicos: Verifique se o domínio do site do SharePoint está permitido na política de sincronização do locatário.
- Política de Grupo: Definir o tamanho máximo de um OneDrive que pode ser baixado automaticamente: Se a biblioteca exceder esse limite, o mecanismo de sincronização a deixa em estado pendente.
- Chave do Registro HKCU\Software\Microsoft\OneDrive\Accounts\Business1\TenantId: Confirme se a conta do usuário está conectada ao locatário correto e não a uma conta pessoal da Microsoft.
Por que uma Biblioteca Compartilhada Exibe ‘Pendente’ em Vez de Sincronizando
O OneDrive for Business usa o mesmo mecanismo de sincronização da versão para consumidores, mas autentica-se no Microsoft Entra ID (antigo Azure AD) e comunica-se com o SharePoint Online. Quando um usuário clica em Sincronizar em uma biblioteca de documentos compartilhada, o mecanismo de sincronização envia uma solicitação ao SharePoint Online, baixa os metadados dos arquivos e inicia a transferência. Se alguma etapa dessa cadeia falhar, a biblioteca permanece no estado ‘Pendente’.
O motivo técnico mais comum é que o mecanismo de sincronização não consegue autenticar o token do usuário para o site específico do SharePoint. Isso acontece quando as credenciais em cache do usuário são de uma conta pessoal da Microsoft em vez de uma conta corporativa ou de estudante. Outra causa frequente é uma política de grupo que bloqueia a sincronização de bibliotecas maiores que um tamanho definido. O mecanismo de sincronização verifica o tamanho da biblioteca antes de iniciar o download e, se o tamanho exceder o limite da política, marca a biblioteca como ‘Pendente’ indefinidamente.
Restrições de rede também desempenham um papel. Se o PC Windows estiver atrás de um proxy que não permite conexões WebSocket ou bloqueia os endpoints do SharePoint Online, o mecanismo de sincronização não consegue estabelecer uma conexão persistente e recorre a um modo de polling que frequentemente resulta em status pendente. Por fim, a versão do aplicativo de sincronização do OneDrive é importante. Versões mais antigas do aplicativo de sincronização não oferecem suporte a bibliotecas compartilhadas que fazem parte de um Grupo do Microsoft 365 ou de um site de comunicação.
Checklist Passo a Passo para o Administrador Resolver a Sincronização Pendente de Biblioteca Compartilhada
Use o checklist a seguir na ordem mostrada. Após cada etapa, peça ao usuário para reiniciar o OneDrive ou sair e entrar novamente para acionar uma nova tentativa de sincronização.
- Verifique se o usuário está conectado com a conta corporativa ou de estudante correta
Abra as configurações do OneDrive clicando com o botão direito no ícone do OneDrive na área de notificação e selecionando Configurações. Vá para a guia Conta. A conta listada em Você está conectado como deve corresponder ao UPN do Microsoft Entra ID do usuário. Se mostrar uma conta pessoal como usuario@outlook.com, clique em Desvincular este PC e faça login novamente com a conta corporativa. - Verifique a política de sincronização do locatário para restrições de domínio
Vá para a central de administração do Microsoft 365, depois Configurações > Configurações da organização > OneDrive. Em Sincronização, confirme se a opção Permitir sincronização apenas para domínios específicos não está habilitada ou inclui o domínio do site do SharePoint onde a biblioteca reside. Se o domínio estiver bloqueado, o mecanismo de sincronização deixa a biblioteca pendente. - Revise as políticas de grupo que controlam o comportamento de sincronização
No PC Windows gerenciado, abra o Editor de Política de Grupo Local ou verifique o GPO baseado em domínio. Navegue até Configuração do Computador > Modelos Administrativos > OneDrive. Verifique a política Definir o tamanho máximo de um OneDrive que pode ser baixado automaticamente. Se esta política estiver habilitada e a biblioteca compartilhada exceder o limite de tamanho em megabytes, a biblioteca não será sincronizada. Aumente o limite para um valor maior que a biblioteca ou desabilite a política. - Garanta que a URL da biblioteca compartilhada esteja acessível a partir do cliente
Abra um navegador da web no PC afetado e navegue até a URL do site do SharePoint. Se o site carregar, confirme que o usuário tem pelo menos permissões de Leitura na biblioteca. Se o site não carregar, verifique a configuração do proxy de rede. Adicione os endpoints do SharePoint Online e do OneDrive à lista de bypass do proxy. A Microsoft publica a lista completa de endpoints em docs.microsoft.com/microsoft-365/enterprise/urls-and-ip-address-ranges. - Atualize o OneDrive para a versão de produção mais recente
No PC gerenciado, clique com o botão direito no ícone do OneDrive, selecione Configurações, vá para a guia Sobre e anote o número da versão. Compare com a versão mais recente listada na central de administração do Microsoft 365 em Saúde > Status do serviço. Se a versão for mais antiga que a compilação de produção atual, baixe e instale o aplicativo de sincronização do OneDrive mais recente da central de administração do Microsoft 365 ou implante via Microsoft Intune. - Limpe o cache de sincronização do OneDrive para a biblioteca específica
Feche o OneDrive completamente. Abra o Explorador de Arquivos e navegue até %LocalAppData%\Microsoft\OneDrive\settings\Business1. Exclua a pasta que contém o ID do site do SharePoint para a biblioteca afetada. Reinicie o OneDrive. O mecanismo de sincronização reenumerará a biblioteca e deve tirá-la do estado pendente. - Redefina o OneDrive se todas as etapas anteriores falharem
Pressione a tecla Windows + R, digite %localappdata%\Microsoft\OneDrive\onedrive.exe /reset e pressione Enter. Aguarde 30 segundos. Abra o OneDrive novamente pesquisando por OneDrive no menu Iniciar. Faça login com a conta corporativa. Isso redefine todas as relações de sincronização sem excluir arquivos locais.
Quando a Biblioteca Compartilhada Ainda Exibe ‘Pendente’ Após o Checklist
OneDrive Pendente em uma Biblioteca Compartilhada que Usa Metadados ou Tipos de Conteúdo
Algumas bibliotecas compartilhadas têm colunas de metadados personalizadas, tipos de conteúdo ou políticas de gerenciamento de informações que exigem que o mecanismo de sincronização baixe informações de esquema adicionais. Se o download do esquema falhar, a biblioteca fica pendente. Para corrigir isso, peça ao proprietário do site para simplificar a biblioteca removendo colunas ou tipos de conteúdo desnecessários. Alternativamente, crie uma nova biblioteca com configurações padrão e teste a sincronização novamente.
OneDrive Pendente em uma Biblioteca com Nomes de Arquivo que Excedem o Limite de Comprimento do Caminho
O sistema de arquivos do Windows tem um comprimento máximo de caminho de 260 caracteres. Se algum arquivo ou pasta na biblioteca compartilhada tiver um caminho completo maior que 260 caracteres, o OneDrive não consegue criar o arquivo local e marca a biblioteca como pendente. Use o SharePoint Online Management Shell para executar Get-PnPFolder e identificar arquivos com caminhos longos. Peça aos usuários para renomear ou mover esses arquivos para um caminho mais curto.
OneDrive Pendente em uma Biblioteca que Faz Parte de um Grupo do Microsoft 365
Bibliotecas compartilhadas que pertencem a um Grupo do Microsoft 365 exigem que o usuário seja membro do grupo. Se o usuário foi adicionado ao grupo após a biblioteca ter sido sincronizada, o mecanismo de sincronização pode não reconhecer a associação. Peça ao usuário para deixar de seguir a biblioteca nas configurações do OneDrive e sincronizá-la novamente a partir do site do SharePoint. A verificação de associação será executada novamente e resolverá o estado pendente.
Comparação de Comportamento de Sincronização: Biblioteca Compartilhada vs OneDrive Pessoal
| Item | Sincronização de Biblioteca Compartilhada | Sincronização do OneDrive Pessoal |
|---|---|---|
| Fonte de autenticação | Token do site do SharePoint Online | Token do Microsoft Entra ID do usuário |
| Limite de tamanho da política de grupo | Aplica-se ao tamanho total da biblioteca | Aplica-se a todo o OneDrive do usuário |
| Requisitos de endpoint de rede | URLs do SharePoint Online mais WebSocket | URLs do OneDrive para consumidores mais WebSocket |
| Dependência de permissão | Permissões em nível de site ou biblioteca | Licença e cota de armazenamento do próprio usuário |
| Método de redefinição de cache | Excluir pasta específica do site em Business1 | Redefinir o OneDrive via linha de comando |
Use esta tabela para decidir qual caminho de solução de problemas seguir. Se o OneDrive pessoal do usuário sincroniza corretamente, mas uma biblioteca compartilhada fica pendente, o problema é quase sempre um problema de permissão ou política específica do site, e não um problema de configuração do cliente.
Após concluir o checklist, você agora pode resolver a sincronização pendente de bibliotecas compartilhadas em qualquer PC Windows gerenciado. Em seguida, revise os relatórios de sincronização do OneDrive na central de administração do Microsoft 365 para identificar outros usuários com bibliotecas pendentes. Como dica avançada, habilite a auditoria de log para o SharePoint Online para que você possa ver quando uma solicitação de sincronização falha e o código de erro HTTP exato retornado ao cliente.