Checklist do Administrador do OneDrive: migração de servidor de arquivos perde arquivos em fusões

Ao migrar dados de um servidor de arquivos para o OneDrive durante uma fusão ou aquisição, você pode descobrir que alguns arquivos sumiram após a transferência. Esse problema geralmente ocorre devido a limites de tamanho de caminho, caracteres não suportados ou conflitos de herança de permissão que a ferramenta de migração não reportou. Este artigo explica as causas raiz dos arquivos perdidos durante uma migração de fusão, fornece um checklist detalhado para verificar a integridade e descreve como localizar e recuperar manualmente itens ignorados.

Por que as Migrações de Servidor de Arquivos Perdem Arquivos Durante Fusões

As migrações de servidor de arquivos para o OneDrive falham ao copiar alguns arquivos por três motivos principais. Primeiro, caminhos de arquivo do Windows que excedem 400 caracteres são bloqueados pelos limites de sincronização do OneDrive e SharePoint. Segundo, nomes de arquivo que contêm caracteres como ~, #, % ou espaços iniciais/finais são rejeitados pelo mecanismo de armazenamento do SharePoint. Terceiro, arquivos que herdam permissões exclusivas de uma pasta pai que não foi migrada são ignorados silenciosamente pela maioria das ferramentas de migração.

Durante uma fusão, o servidor de arquivos de origem geralmente contém décadas de estruturas de pastas aninhadas, convenções de nomenclatura legadas e conjuntos de permissões personalizados. As configurações padrão de migração no SharePoint Migration Tool ou em ferramentas de terceiros podem não sinalizar cada arquivo ignorado. O resultado é um site do OneDrive que parece completo, mas está faltando documentos críticos de negócios.

Uma causa secundária é o uso do aplicativo de sincronização do OneDrive como método de migração. Arrastar pastas de um servidor de arquivos para uma pasta sincronizada do OneDrive não preserva metadados, carimbos de data/hora ou permissões. O aplicativo de sincronização também para de copiar quando encontra um único arquivo que viola as regras de sincronização, deixando o restante da pasta não transferido.

Checklist Pré-Migração para Evitar Arquivos Perdidos

Antes de iniciar a migração, execute as seguintes verificações no servidor de arquivos de origem. Cada etapa reduz a chance de arquivos ignorados.

1. Verificar violações de tamanho de caminho de arquivo
   Abra uma sessão do PowerShell como administrador e execute Get-ChildItem -Path "\\Servidor\Compartilhamento" -Recurse | Where-Object { $_.FullName.Length -gt 400 } | Export-Csv -Path "C:\caminhoslongos.csv". Revise o CSV e renomeie ou mova quaisquer arquivos que excedam 400 caracteres. O OneDrive e o SharePoint têm um limite de 400 caracteres no caminho, incluindo a URL do site.
2. Identificar caracteres inválidos em nomes de arquivo
   Use o recurso de pré-varredura do SharePoint Migration Tool. No SPMT, selecione sua origem, clique em Scan e revise o relatório em Issues. Arquivos com ~, #, %, &, {}, [] ou pontos finais aparecerão como avisos. Renomeie esses arquivos na origem antes da migração.
3. Auditar permissões de pastas
   Execute icacls "\\Servidor\Compartilhamento" /t /save "C:\perms.txt" para exportar as permissões NTFS atuais. Compare esta lista com as permissões que o SPMT mapeará. Se um arquivo herdar permissões de uma pasta que não será migrada, quebre a herança e aplique permissões explícitas ao arquivo.
4. Contar total de arquivos e pastas
   Execute Get-ChildItem -Path "\\Servidor\Compartilhamento" -Recurse -File | Measure-Object | Select-Object Count para obter a contagem de arquivos. Registre esse número. Você o comparará com a contagem de destino após a migração.

Etapas de Verificação Pós-Migração

Após a ferramenta de migração terminar, não presuma que todos os arquivos estão presentes. Complete estas etapas de verificação no site de destino do OneDrive.

1. Comparar contagens de arquivos no Centro de Administração do SharePoint
   Vá para Centro de administração do Microsoft 365 > Relatórios > Uso > Arquivos do OneDrive. Localize o site de destino e anote o número total de arquivos. Compare-o com a contagem de origem registrada anteriormente. Uma discrepância superior a 1% indica arquivos ignorados.
2. Executar uma varredura delta com o SPMT
   No SharePoint Migration Tool, crie um novo trabalho de migração com o mesmo caminho de origem. Selecione o modo Scan only. O SPMT comparará a origem com o destino e listará quaisquer arquivos ausentes ou com datas de modificação diferentes.
3. Verificar o relatório JSON da migração
   O SPMT gera um relatório JSON em C:\Users\[Admin]\AppData\Local\Microsoft\SPMT\Reports\[JobId]\ScanResult.json. Abra este arquivo em um editor de texto e pesquise por "Status":"Skipped". Cada entrada ignorada inclui um campo "SkippedReason" que explica por que o arquivo não foi copiado.

Se o OneDrive Ainda Tiver Problemas Após a Correção Principal

Arquivos estão presentes, mas mostram um ícone de sincronização cinza

Um ícone cinza significa que o arquivo está somente online e não sincronizado com o dispositivo local. Isso não é um arquivo perdido. Instrua os usuários a clicar com o botão direito no arquivo e selecionar Always keep on this device se precisarem de acesso offline. O arquivo está armazenado no OneDrive e acessível via web.

Arquivos estão listados na interface web, mas não no File Explorer

Isso ocorre quando o aplicativo de sincronização ainda não baixou a estrutura de pastas. Abra as configurações do OneDrive, selecione Sync and backup > Manage backup e confirme se a pasta está incluída no escopo de sincronização. Se a pasta estiver excluída, adicione-a e aguarde a sincronização ser concluída.

Ferramenta de migração relata sucesso, mas arquivos ainda estão faltando

Algumas ferramentas de terceiros marcam uma migração como bem-sucedida quando a transferência é concluída no nível raiz, mesmo que subpastas tenham sido ignoradas. Use o método de varredura delta do SPMT descrito acima para encontrar os arquivos exatos. Uma vez identificados, copie-os manualmente usando o recurso de upload web do OneDrive ou um novo trabalho do SPMT com a opção Replace definida como Skip para evitar sobrescrever arquivos existentes.

Servidor de Arquivos vs OneDrive for Business: Principais Diferenças para Fusões

Item	Servidor de Arquivos	OneDrive for Business
Tamanho máximo do caminho do arquivo	32.767 caracteres (Windows 10/11)	400 caracteres (incluindo URL do site)
Caracteres inválidos em nomes de arquivo	Apenas \ / : ? " < > | são bloqueados	Bloqueia ~ # % & { } [ ] e espaços iniciais/finais
Herança de permissão	Herança NTFS de pastas pai	Permissões exclusivas do SharePoint; herança deve ser explícita
Limite de tamanho de arquivo	Determinado pela capacidade do disco	250 GB por arquivo
Histórico de versões	Shadow Copies (VSS) ou backup de terceiros	500 versões por arquivo automaticamente
Suporte a ferramentas de migração	N/A	SPMT, Mover.io, ShareGate, Metalogix

Durante uma fusão, as restrições de tamanho de caminho e caracteres no OneDrive causam a maioria dos arquivos ignorados. Planeje pelo menos duas semanas de tempo de correção para renomear ou realocar arquivos que violam esses limites.

Após concluir o checklist de migração e verificar as contagens de arquivos, você pode ter confiança de que o site de destino do OneDrive contém todos os dados de negócios necessários. Para fusões futuras, execute a pré-varredura do SPMT no início do projeto e agende uma varredura delta uma semana após a migração inicial para capturar quaisquer arquivos que foram modificados durante a janela de corte. Como dica avançada, use o cmdlet Set-SPOTenantSyncClientRestriction do PowerShell para bloquear a sincronização de tipos de arquivo conhecidos por causar falhas na migração, como arquivos .tmp e .bak, antes do início da migração.