OneDrive: Diagnosticar e Corrigir Problemas de Sincronização

O ticket diz “o OneDrive não sincroniza” — e debaixo desse título há dez problemas diferentes: o cliente parado, a biblioteca nunca configurada offline, conflitos de ficheiro, quota de site, domínio não autorizado, um ficheiro bloqueado por carregamento a meio. Este artigo monta a sequência de diagnóstico de ponta a ponta — para sysadmin, com as ferramentas que veem a frota inteira a uma distância de olhar.

O lado do admin: o Sync Health dashboard

O dashboard OneDrive Sync health (Microsoft 365 Apps admin center) reporta a saúde da sincronização da frota: dispositivos com erros, bibliotecas com sync a atrasar, ficheiros bloqueados. O estado de cada dispositivo refresca-se a cada ~36 horas (ou ~1 hora depois de o cliente arrancar) — uma fotografia com lag, não tempo real. É a página de partida quando o problema não é um utilizador, mas uma tendência.

Pré-requisitos (segundo a documentação):

• Versão do cliente de sync 22.232 ou posterior no Windows e macOS
• Anel de actualização do cliente configurado (Insiders, Production ou Deferred)
• Papel Office Apps Administrator (ou Microsoft 365 Administrator) para configurar
• Tenant Association Key gerada no admin center (menu Setup. Se o campo está vazio, Generate new key — a primeira geração pode demorar 30 segundos)
• Nos dispositivos, o GPO EnableSyncAdminReports activado pelo Intune ou GPO (a chave antiga SyncAdminReports já não reporta ao dashboard) — depois de activar, os relatórios demoram até três dias a aparecer na primeira leitura (o timestamp de reporte de cada dispositivo actualiza-se a cada ~36 horas, ou ~1 hora após o arranque do cliente). O dispositivo tem de estar ligado pelo menos 5 horas, clientes com o utilizador com sessão terminada não reportam, os registos expiram aos 30 dias e a feature não existe para clientes 21Vianet

O custo de o ignorar: sem o dashboard, o primeiro sinal de que a frota não sincroniza chega pelo utilizador — em ticket, sem contexto, com a pasta local já divergida da cloud.

Antes do dashboard: que cliente está a correr?

Dois clientes OneDrive existem — o Next Generation Sync Client (o actual) e o antigo groove.exe (OneDrive for Business legacy). As instruções de diagnóstico diferem por completo entre eles, e a primeira pergunta do diagnóstico é qual está instalado:

# Versão do cliente de sync actual
Get-Process onedrive -ErrorAction SilentlyContinue |
    Select-Object -ExpandProperty FileVersion -First 1

# O groove.exe (cliente antigo) corre noutro processo — testar os dois:
(Get-Process onedrive).Path
Get-Process groove -ErrorAction SilentlyContinue | Select-Object -ExpandProperty FileVersion

Se o ambiente ainda corre groove.exe, o caminho é actualizar primeiro para o cliente actual (a página oficial de troubleshooting ainda documenta os dois, mas o groove está em fim de vida).

A sequência de diagnóstico (por ordem)

1. Cliente activo e actualizado — o cliente de sync actualiza-se frequentemente e uma versão desactualizada é por si só causa de problemas. Verificar a versão e actualizar antes de diagnosticar mais fundo.
2. A biblioteca está configurada como offline? — uma biblioteca com Offline Client Availability desligada nunca sincroniza para o disco: ver as definições da biblioteca no SharePoint (Available offline).
3. Conflitos de ficheiro — o ícone de conflito no Explorer nem sempre é um conflito: aparece também enquanto o ficheiro sincroniza. O teste é esperar pela conclusão: se o ícone persiste num ficheiro inactivo, há conflito. Em ficheiros Office, abrir o documento resolve na maior parte das vezes (a app Office oferece Save a Copy / Discard). Em não-Office, o OneDrive guarda até 5 versões de conflito com o nome do dispositivo anexado (Report-JOHNS-SURFACE.txt).
4. Cache do cliente — o Microsoft Office Upload Center pode bloquear a sincronização com bibliotecas SharePoint: limpar os ficheiros em cache é parte das resoluções oficiais.
5. Quota e limites — a Microsoft recomenda não sincronizar mais de 300.000 itens no total de todo o armazenamento cloud (recomendação de desempenho, não um bloqueio: não há limite rígido de ficheiros). Em Windows há um public preview de 1.000.000 itens por instância de sync (22/04/2026, sem VDI, exige Win11/Server 2022, 16 GB RAM, SSD e CPU recente — quem não cumpre continua nos 300.000). Bibliotecas com mais de 100.000 itens já não permitem quebrar/re-herdar permissões (o limite suportado de permissões únicas é 50.000, recomendado 5.000). Uma frota acima dos 300.000 comporta-se como sync quebrado: os sintomas aparecem mesmo com o cliente a dizer “Up to date”.
6. Domínio do utilizador — a política AllowTenantList (“Allow syncing OneDrive accounts for only specific organizations”) restringe o sync às organizações da lista. Uma conta fora da lista fica parada em silêncio. (A lista por PC/máquina do AD é outro mecanismo, distinto deste.)

Erros típicos e o que significam

A política que resolve metade dos tickets

Muito do “OneDrive não sincroniza” em PME nasce de decisões de tenant: a AllowTenantList (“Allow syncing OneDrive accounts for only specific organizations”) falha silenciosamente quando o utilizador entra com uma conta fora das organizações autorizadas. O KFM (Known Folder Move) desactivado deixa os Desktop/Documents fora do OneDrive, que os utilizadores esperam ver sincronizados (neste site: KFM passo a passo no 19720). Antes de mexer no cliente, confirme que a política central permite o que o utilizador tenta fazer.

Para VDI e máquinas partilhadas, a Microsoft documenta os cenários de sync em VDI: as mesmas políticas Intune/GPO da secção anterior aplicam-se, com restrições adicionais no modo multi-sessão.

Quando escalar (e com quê)

Se o diagnóstico acima não resolve, a doc do Sync health pede que o ticket leve:

• A data/hora em que o EnableSyncAdminReports foi activado no dispositivo
• O email do utilizador ou o OneDrive device ID no cliente (Help & Settings → Settings → About)
• Versão do cliente de sync (Get-Process onedrive) e caminho do executável — distingue OneDrive.exe de groove.exe
• Screenshot da pasta OneDrive e dos ícones de estado
• Do dashboard: a linha do dispositivo com erros Sync health (e a contagem de erros por tipo)

Checklist

• [ ] Cliente 22.232+ na frota (report do Sync Health ou query via Intune)
• [ ] Tenant Association Key presente no admin center
• [ ] EnableSyncAdminReports activado nos dispositivos (Intune/GPO) — validado com reg.exe query HKLM\Software\Policies\Microsoft\OneDrive /v EnableSyncAdminReports, os três dias de espera respeitados na primeira leitura
• [ ] Bibliotecas críticas não acima dos limites oficiais de sync
• [ ] AllowTenantList alinhado com as organizações autorizadas (domínios de email em produção)
• [ ] Runbook de conflito: o utilizador abre o ficheiro Office antes de qualquer suporte manual

Artigos Relacionados

• OneDrive Known Folder Move: Desktop e Documentos na Cloud
• Gerir o Espaço no OneDrive: Alterar o Default de 1 TB
• OneDrive: Sincronização, Partilha e Quotas (curso dia 16)
• Agent 365: Governação de Agentes de IA no M365

Fontes Oficiais

1. OneDrive sync overview (Microsoft Learn)
2. OneDrive sync health dashboard (Microsoft Learn)
3. Resolve sync issues in OneDrive for work or school (Microsoft Learn)
4. OneDrive troubleshooting welcome page (Microsoft Learn)