Durante um corte de fim de semana de um servidor de arquivos legado para o OneDrive, os administradores frequentemente descobrem que um subconjunto de arquivos não migrou. Isso acontece quando os usuários têm arquivos abertos, clientes de sincronização são deixados em execução ou ocorrem interrupções de rede durante a janela de migração. O resultado é uma incompatibilidade entre o servidor de arquivos de origem e o locatário do OneDrive de destino. Este artigo explica as causas raiz dos arquivos perdidos e fornece um checklist prático para prevenir e recuperar essas lacunas.
Principais Conclusões: Migração de Servidor de Arquivos para OneDrive em Corte de Fim de Semana
- Relatório de validação da ferramenta de migração: Execute uma varredura delta após o corte para identificar arquivos que não foram copiados devido a bloqueios ou violações de tamanho de caminho.
- Verificação do status de sincronização do OneDrive: Verifique se o Known Folder Move e as relações de sincronização estão ativos para todas as contas de usuário afetadas antes do corte.
- Logs de auditoria do servidor de arquivos: Revise o Event ID 4663 do Windows para confirmar quais arquivos foram acessados ou alterados durante a janela de migração.
Por que as Migrações de Servidor de Arquivos Perdem Arquivos Durante Cortes de Fim de Semana
Cortes de fim de semana impõem um prazo apertado. Ferramentas de migração como a Microsoft SharePoint Migration Tool ou produtos de terceiros como Quest ou AvePoint copiam arquivos em lotes. Se um arquivo está bloqueado por um usuário ou aplicativo, a ferramenta o ignora e registra um aviso. Muitos administradores não revisam esses avisos até após o corte, quando os usuários relatam arquivos faltando.
Outra causa comum é o uso de caminhos de arquivo que excedem o limite de 400 caracteres no OneDrive e SharePoint. Arquivos aninhados profundamente na hierarquia do servidor de arquivos são ignorados silenciosamente. Além disso, se o cliente de sincronização do OneDrive está em execução na máquina do usuário, ele pode manter identificadores de arquivo que impedem a ferramenta de migração de ler o arquivo. A ferramenta interpreta o identificador como um bloqueio e segue em frente.
A instabilidade de rede durante a janela de migração também contribui. Quando uma ferramenta perde a conectividade com o servidor de arquivos, ela pode marcar o lote como concluído mesmo que alguns arquivos não tenham sido transferidos. O log da ferramenta mostra um erro de transferência, mas os administradores frequentemente perdem isso no ruído de uma migração grande.
Bloqueio de Arquivos e Identificadores Abertos
Servidores de arquivos Windows usam bloqueio oportunista. Quando um usuário abre um arquivo, o servidor concede um bloqueio que impede que outros processos leiam ou escrevam. Ferramentas de migração tentam abrir arquivos com acesso de leitura. Se o bloqueio for exclusivo, a ferramenta tenta novamente algumas vezes e então ignora o arquivo. O número padrão de tentativas em muitas ferramentas é três tentativas com um intervalo de 30 segundos. Um usuário que deixa um arquivo aberto durante a noite faz com que a ferramenta ignore esse arquivo.
Tamanho do Caminho e Caracteres Especiais
OneDrive e SharePoint têm um limite de tamanho de caminho de 400 caracteres. Caminhos de servidor de arquivos mais longos que isso são truncados ou ignorados. Caracteres especiais como e comercial, ponto de interrogação e espaços iniciais também causam ignoramentos. A ferramenta de migração registra esses como erros, mas o arquivo de log frequentemente não é verificado até após o corte.
Checklist para Prevenir Arquivos Perdidos Durante Cortes de Fim de Semana
- Execute uma varredura de inventário pré-migração
Use uma ferramenta como o modo de varredura da Microsoft SharePoint Migration Tool ou TreeSize para listar todos os arquivos, seus caminhos e tamanhos. Exporte a lista para um CSV. Isso cria uma linha de base para comparar com o inventário pós-migração. - Notifique os usuários para fechar todos os arquivos 24 horas antes do corte
Envie um e-mail obrigatório e uma transmissão no Teams. Instrua os usuários a fazer logoff de suas máquinas. Para unidades de rede compartilhadas, peça ao TI para agendar uma reinicialização do servidor de arquivos para liberar todos os identificadores de arquivo. - Desabilite o cliente de sincronização do OneDrive nas máquinas dos usuários
Use Política de Grupo ou Intune para parar o serviço do cliente de sincronização do OneDrive antes do início da janela de migração. Um cliente de sincronização em execução mantém identificadores de arquivo em qualquer pasta que esteja sincronizando, incluindo locais do Known Folder Move. - Execute uma migração delta após a cópia inicial
A maioria das ferramentas de migração suporta uma passagem delta que copia apenas arquivos que mudaram ou foram perdidos. Agende uma passagem delta imediatamente após a cópia completa. Configure a passagem delta para executar com tentativas ilimitadas e um intervalo de 10 segundos entre tentativas. - Revise o relatório de erros da ferramenta de migração
Abra o relatório gerado pela ferramenta. Filtre por erros com código 0x80070020, que indica um bloqueio de arquivo. Também filtre por erros com código 0x8007007B, que indica uma violação de tamanho de caminho. Execute novamente a migração para esses arquivos específicos. - Compare as contagens de arquivos entre origem e destino
Use PowerShell para contar arquivos na pasta de origem e na biblioteca de documentos do OneDrive ou SharePoint de destino. Execute este comando na origem: Get-ChildItem -Recurse -File | Measure-Object. Execute este comando no destino: Get-PnPFolderItem -FolderSiteRelativeUrl -ItemType File | Measure-Object. As contagens devem corresponder. - Habilite o log detalhado na ferramenta de migração
Defina o nível de log como Detalhado antes do corte. Isso captura cada tentativa de arquivo e o motivo de qualquer ignoramento. Use o log para identificar padrões, como uma pasta específica onde todos os arquivos falharam. - Teste um corte simulado em uma pasta representativa
Selecione uma pasta com mais de 500 arquivos e subpastas aninhadas. Execute o processo completo de migração nesta pasta. Verifique o resultado. Se arquivos estiverem faltando, ajuste as configurações de tentativas, manipulação de caminho ou processo de notificação ao usuário antes do corte real.
Se os Arquivos Ainda Estiverem Faltando Após o Corte de Fim de Semana
OneDrive mostra menos arquivos que o servidor de arquivos
Execute uma migração delta novamente com a ferramenta de migração configurada no modo Sobrescrever. Este modo substitui arquivos existentes no OneDrive pela versão de origem. Use isso apenas para arquivos que foram perdidos, não para todos os arquivos. Para direcionar arquivos específicos, exporte o relatório de erros da migração inicial, extraia os caminhos dos arquivos e crie um arquivo CSV de entrada para a ferramenta.
Usuários relatam arquivos faltando que estavam presentes antes do corte
Verifique o log de auditoria do servidor de arquivos para o event ID 4663. Este evento registra cada tentativa de acesso. Se o evento mostrar um acesso de leitura por uma conta de usuário durante a janela de migração, o arquivo provavelmente estava bloqueado. Pergunte ao usuário se ele tinha o arquivo aberto. Em seguida, copie o arquivo manualmente de um backup ou da máquina local do usuário.
Ferramenta de migração relata sucesso, mas os arquivos não estão no OneDrive
Isso pode acontecer quando os arquivos são carregados em uma pasta diferente da esperada. Verifique o arquivo de mapeamento da ferramenta de migração. O mapeamento pode ter redirecionado arquivos para uma biblioteca de documentos ou subpasta diferente. Use o centro de administração do SharePoint > Explorador de conteúdo para localizar os arquivos pelo hash de conteúdo. Se os arquivos estiverem no local errado, mova-os usando a migração do SharePoint ou o PowerShell Move-PnPFile.
Migração de Servidor de Arquivos vs Sincronização do OneDrive: Principais Diferenças
| Item | Ferramenta de Migração de Servidor de Arquivos | Cliente de Sincronização do OneDrive |
|---|---|---|
| Manipulação de arquivos | Copia arquivos em lote, ignora arquivos bloqueados | Sincroniza arquivos individualmente, tenta novamente em caso de bloqueio |
| Limite de tamanho de caminho | 400 caracteres para destino do OneDrive | 400 caracteres para destino do OneDrive |
| Suporte a delta | Sim, com agendamento manual | Automático, contínuo |
| Relatório de erros | Log CSV com códigos de erro | Central de atividades do OneDrive e status de sincronização |
| Envolvimento do usuário | Baixo, o TI executa o processo | Alto, o usuário deve fazer login e aceitar a sincronização |
| Melhor caso de uso | Migração única em massa | Sincronização contínua de arquivos |
Usar uma ferramenta de migração para a cópia inicial em massa e o cliente de sincronização do OneDrive para atualizações contínuas oferece a melhor cobertura. A ferramenta de migração cuida do trabalho pesado, e o cliente de sincronização captura quaisquer arquivos que foram perdidos durante o corte.
Após o corte, você pode executar uma migração delta final usando a Microsoft SharePoint Migration Tool com a flag -SkipFileLockCheck. Essa flag força a ferramenta a tentar ler arquivos bloqueados. Use-a apenas durante uma janela de manutenção quando os usuários estiverem desconectados. Esta etapa geralmente recupera os últimos 1 a 2 por cento dos arquivos perdidos.
Para migrações futuras, considere usar a política Known Folder Move para redirecionar Área de Trabalho, Documentos e Imagens para o OneDrive antes do corte. Isso reduz o número de arquivos que precisam ser migrados do servidor de arquivos e oferece aos usuários uma experiência de sincronização familiar desde o primeiro dia.