O Known Folder Move (KFM) do OneDrive for Business permite redirecionar as pastas Área de Trabalho, Documentos e Imagens para o OneDrive. Quando o KFM falha, os usuários veem um X vermelho na bandeja do sistema e as pastas permanecem locais. Essas falhas podem ser causadas por conflitos de Política de Grupo, limites de armazenamento ou restrições de tamanho de caminho de arquivo. Este artigo explica como auditar falhas de KFM em todos os dispositivos Windows do seu locatário usando o centro de administração do Microsoft 365, os relatórios de sincronização do OneDrive e o PowerShell. Você aprenderá a identificar a causa raiz de cada falha e tomar as medidas corretivas necessárias.
Principais Conclusões: Auditoria de Falhas de KFM em Dispositivos
- Centro de administração do Microsoft 365 > Relatórios > OneDrive > Relatórios de sincronização: Visualize o status do KFM por dispositivo, motivos de falha e hora da última sincronização.
- Cmdlet Get-SPOSyncKnownFolderMoveStatus do PowerShell: Consulte o estado do KFM para todos os usuários em lote e exporte os resultados para CSV.
- Aplicativo de sincronização do OneDrive > Configurações > Conta > Parar sincronização: Redefina manualmente o KFM em um único dispositivo após corrigir o problema subjacente.
Por que as Falhas de KFM Ocorrem e Como São Registradas
As falhas do Known Folder Move acontecem quando o aplicativo de sincronização do OneDrive não consegue redirecionar uma pasta local para a nuvem. O aplicativo de sincronização registra cada tentativa e falha no Log de Eventos do Windows, em “Applications and Services Logs > Microsoft > Windows > OneDrive-Sync”. Cada evento de falha contém um código de erro numérico, como 0x80040CA2 ou 0x80070002. Esses códigos correspondem a problemas específicos: armazenamento insuficiente, tipos de arquivo bloqueados ou conflitos de redirecionamento de pasta causados pela Política de Grupo. O centro de administração agrega esses logs em relatórios por dispositivo. Você precisa ter a função de Leitor de Relatórios ou Administrador Global para acessar esses relatórios.
Passo a Passo: Auditar Falhas de KFM Usando o Centro de Administração
- Entre no centro de administração do Microsoft 365
Acesse admin.microsoft.com e faça login com uma conta que tenha a função de Leitor de Relatórios ou Administrador Global. - Abra os relatórios de sincronização do OneDrive
Navegue até Relatórios > Uso > OneDrive. Na guia “Sincronização”, selecione Exibir relatórios. - Filtre pelo status do KFM
Clique em Adicionar filtro e escolha Status do Known Folder Move. Selecione Falhou ou Não redirecionado. - Revise os detalhes da falha para cada dispositivo
Na tabela do relatório, localize as colunas “Status do KFM” e “Motivo da falha”. Clique em uma linha de dispositivo para ver o código de erro e o timestamp da última tentativa. - Exporte os dados de auditoria
Clique em Exportar e escolha CSV. Este arquivo contém todos os dispositivos com falhas de KFM, incluindo nome principal do usuário, nome do dispositivo e código de erro.
Passo a Passo: Auditar Falhas de KFM Usando PowerShell
O PowerShell oferece mais controle para consultar o status do KFM em todos os usuários de uma só vez. Instale o SharePoint Online Management Shell antes de começar.
- Conecte-se ao SharePoint Online
ExecuteConnect-SPOService -Url https://yourtenant-admin.sharepoint.come faça login com suas credenciais de administrador. - Consulte o status do KFM para um único usuário
ExecuteGet-SPOSyncKnownFolderMoveStatus -UserPrincipalName usuario@dominio.com. A saída mostra o estado de cada pasta: Redirecionado, NãoRedirecionado ou Falhou. - Consulte o status do KFM para todos os usuários
ExecuteGet-SPOSyncKnownFolderMoveStatus -AllUsers. Isso retorna uma lista de todos os usuários e seus status de KFM. - Filtre por estados de falha
Use o pipe:Get-SPOSyncKnownFolderMoveStatus -AllUsers | Where-Object { $_.Status -eq "Failed" }. - Exporte para CSV
ExecuteGet-SPOSyncKnownFolderMoveStatus -AllUsers | Export-Csv -Path C:\KFM_Audit.csv -NoTypeInformation. Abra o CSV no Excel para classificar e analisar as falhas.
Motivos Comuns de Falha do KFM e Suas Correções
KFM falha com erro 0x80040CA2 — armazenamento insuficiente
O armazenamento do OneDrive do usuário está cheio. Libere espaço ou aumente a cota de armazenamento no centro de administração em Usuários > Usuários ativos > selecione o usuário > OneDrive > Gerenciar armazenamento.
KFM falha com erro 0x80070002 — caminho de arquivo muito longo
O caminho combinado de um arquivo na pasta Área de Trabalho ou Documentos excede 260 caracteres. Peça ao usuário para encurtar nomes de arquivo ou mover arquivos para estruturas de caminho mais curtas antes de tentar o KFM novamente.
KFM falha com erro 0x80070005 — permissão negada
O usuário não tem permissão de gravação na pasta de destino do OneDrive. Verifique se o site do OneDrive do usuário está provisionado e se o usuário é administrador da coleção de sites. No centro de administração, vá para Usuários > Usuários ativos, selecione o usuário e verifique em OneDrive se a URL do site está presente.
KFM falha silenciosamente — Política de Grupo bloqueia o redirecionamento
Um objeto de Política de Grupo impõe um redirecionamento de pasta local que entra em conflito com o KFM. Verifique as configurações de política em Configuração do Computador > Modelos Administrativos > Componentes do Windows > OneDrive > Impedir que usuários movam pastas conhecidas do Windows para o OneDrive. Defina esta política como Desabilitado ou Não configurado.
Status do Known Folder Move: Auditoria por Dispositivo vs. por Usuário
| Item | Auditoria por Dispositivo (Centro de Administração) | Auditoria por Usuário (PowerShell) |
|---|---|---|
| Escopo | Por dispositivo com aplicativo de sincronização do OneDrive | Por usuário em todos os dispositivos |
| Fonte de dados | Telemetria do aplicativo de sincronização | SharePoint Online |
| Detalhe do motivo da falha | Código de erro e descrição | Apenas código de status |
| Formato de exportação | CSV do centro de administração | CSV do PowerShell |
| Melhor caso de uso | Identificar falhas específicas de hardware | Planejamento de correção em lote |
Agora você pode auditar falhas de KFM em todos os dispositivos Windows do seu locatário usando os relatórios do centro de administração e os cmdlets do PowerShell. Comece exportando o CSV do centro de administração para identificar os códigos de erro mais comuns. Em seguida, use o script do PowerShell para obter uma lista completa de usuários com estados de falha. Para cada falha, aplique a correção correspondente da seção de problemas comuns. Como dica avançada, crie uma tarefa agendada recorrente no Azure Automation que execute o script do PowerShell semanalmente e envie o CSV por email para sua equipe de TI.