Migração por fases do OneDrive for Business perde arquivos: Guia de correção

Quando você executa uma migração por fases de um servidor de arquivos para o OneDrive for Business, alguns arquivos não aparecem nas pastas de destino. Esse problema geralmente ocorre porque a ferramenta de migração não re-escaneia a origem em busca de arquivos novos ou alterados após a varredura inicial. Em uma migração por fases, você move lotes de usuários ou pastas ao longo de dias ou semanas, mas arquivos adicionados ou modificados na origem após a primeira varredura são ignorados. Este artigo explica por que a ferramenta perde arquivos em cenários de fases e fornece as etapas exatas para localizar e transferir os itens ausentes.

Por que as migrações por fases perdem arquivos no OneDrive for Business

As migrações por fases usam o Migration Manager do Microsoft 365, que escaneia o servidor de arquivos de origem uma vez quando a tarefa é criada. A ferramenta copia os arquivos escaneados para a pasta de destino do OneDrive, mas não monitora continuamente a origem em busca de arquivos novos ou alterados. Se um usuário ou administrador adicionar um arquivo à pasta de origem após a varredura inicial, esse arquivo não será incluído no lote de migração. Esse comportamento é proposital para evitar re-escaneamento de terabytes de dados a cada execução.

O problema se torna mais visível quando as migrações duram vários dias. Por exemplo, um departamento pode continuar trabalhando em arquivos compartilhados enquanto a equipe de TI migra suas pastas. Os arquivos criados ou modificados após a data da varredura permanecem no servidor de arquivos e nunca chegam ao OneDrive. O relatório de migração mostra esses arquivos como “não encontrados” ou “ignorados”, mas o relatório geralmente não os lista explicitamente.

Outro fator contribuinte é a retenção de permissões da pasta de origem. Quando o Migration Manager copia um arquivo, ele preserva as permissões NTFS. Se a pasta de origem tiver herança desabilitada ou contiver entradas DENY explícitas, a ferramenta pode ignorar o arquivo completamente sem registrar um erro. Esse comportamento não é específico de migrações por fases, mas o atraso entre as varreduras aumenta a chance de que alterações de permissão ocorram durante a janela de migração.

Como o Migration Manager escaneia pastas de origem

O Migration Manager cria uma tarefa de varredura que enumera todos os arquivos e pastas no caminho de origem especificado. A varredura registra o tamanho do arquivo, a data da última modificação e as permissões. Assim que a varredura é concluída, a ferramenta inicia a fase de cópia. Ela compara a lista escaneada com o destino e copia apenas os itens que ainda não existem no destino. Como a varredura é um instantâneo, qualquer arquivo adicionado após o instantâneo fica invisível para a ferramenta.

Exclusões de arquivos na configuração padrão

Por padrão, o Migration Manager exclui arquivos que correspondem a certos padrões: arquivos temporários que terminam em .tmp, arquivos maiores que 250 GB, arquivos com nomes com mais de 400 caracteres e arquivos com caracteres não suportados pelo OneDrive. Se um arquivo se enquadrar em uma dessas categorias, ele é ignorado silenciosamente. O relatório de migração lista esses como “ignorados devido a regras de exclusão”, mas o log é fácil de passar despercebido em migrações grandes.

Etapas para recuperar arquivos perdidos em uma migração por fases

As etapas a seguir pressupõem que você está usando o Migration Manager do Microsoft 365 para migrações de servidor de arquivos. Se você estiver usando uma ferramenta de terceiros, a mesma lógica se aplica: você deve forçar uma re-varredura da pasta de origem após a migração inicial ser concluída.

1. Abra o Migration Manager no centro de administração do Microsoft 365
   Vá para Centros de administração > Migration Manager. Selecione a tarefa de migração que corresponde à migração por fases onde os arquivos estão faltando.
2. Revise o relatório de migração em busca de arquivos ignorados
   Clique em Ver detalhes na tarefa. Procure a linha chamada “Itens ignorados”. Expanda essa linha para ver os nomes dos arquivos e o motivo da ignorância. Motivos comuns incluem “Arquivo modificado após a varredura” ou “Arquivo excluído pelo filtro”.
3. Execute uma re-varredura da pasta de origem
   No painel de detalhes da tarefa, clique em Ações > Re-varredura. A ferramenta re-enumerará a pasta de origem e detectará quaisquer arquivos que foram adicionados ou alterados desde a última varredura. Esta etapa não recopia arquivos que já existem no destino.
4. Ajuste o filtro de origem para incluir modificações recentes
   Antes de executar a re-varredura, defina o filtro para incluir arquivos modificados nos últimos 7 dias. Vá para Configurações da tarefa > Filtros de origem e altere Última modificação para Nos últimos 7 dias. Isso reduz o escopo da varredura e acelera o processo.
5. Copie manualmente quaisquer arquivos que a re-varredura ainda perca
   Se a re-varredura não capturar todos os arquivos perdidos, use uma ferramenta de cópia de arquivos como o Robocopy com a opção /MIR para espelhar a pasta de origem para um local temporário e, em seguida, faça upload desses arquivos para o OneDrive usando o aplicativo de sincronização do OneDrive. Exemplo de comando: robocopy \\servidor\compartilhamento \\temp\migracao /MIR /COPY:DAT /R:3 /W:5
6. Verifique se a pasta de destino do OneDrive tem espaço suficiente
   Verifique a cota de armazenamento do OneDrive para o usuário de destino. Se o usuário excedeu a cota, novos arquivos não serão sincronizados. Vá para Centro de administração do Microsoft 365 > Usuários > Usuários ativos > Configurações do OneDrive e aumente o limite de armazenamento, se necessário.

Se o OneDrive ainda tiver arquivos perdidos após a re-varredura

Arquivos excluídos devido ao nome ou comprimento do caminho

O OneDrive for Business não suporta nomes de arquivo com mais de 256 caracteres ou caminhos com mais de 400 caracteres. O Migration Manager ignora esses arquivos sem erro. Para corrigir isso, encurte o nome do arquivo ou o caminho da pasta no servidor de origem e execute a re-varredura. Use um script do PowerShell para identificar arquivos com caminhos longos: Get-ChildItem -Path \\servidor\compartilhamento -Recurse | Where-Object { $_.FullName.Length -gt 400 }

Arquivos com caracteres não suportados

O OneDrive não permite os seguintes caracteres em nomes de arquivo: " : < > ? / \ |. O Migration Manager ignora arquivos que contenham esses caracteres. Renomeie os arquivos no servidor de origem, substituindo os caracteres não suportados por um hífen ou sublinhado. Em seguida, execute a re-varredura.

Erros de permissão causando falhas silenciosas

Se a conta de migração não tiver acesso de leitura a um arquivo ou pasta, a ferramenta o ignora. Verifique as permissões NTFS na pasta de origem. A conta de migração deve ter pelo menos Ler e executar e Listar conteúdo da pasta. Use a guia Acesso efetivo nas propriedades da pasta para verificar.

Migração por fases vs. Migração completa única: Principais diferenças

Item	Migração por fases	Migração completa única
Frequência de varredura	Varredura única na criação da tarefa; re-varredura manual necessária para novos arquivos	Varredura única, copiada em um lote
Melhor para	Grandes conjuntos de dados onde os usuários não podem parar de trabalhar	Conjuntos de dados pequenos a médios onde a origem pode ser congelada
Risco de perder arquivos	Alto, porque arquivos adicionados após a varredura são ignorados	Baixo, porque a origem é congelada antes da varredura
Experiência do usuário	Os usuários podem continuar trabalhando; a TI lida com lacunas depois	Os usuários devem pausar o trabalho durante a migração

Migrações por fases exigem monitoramento contínuo e re-varreduras periódicas. Uma migração completa única é mais simples, mas força uma data de corte em que todos os usuários param de modificar arquivos no servidor de origem.

Após concluir a re-varredura e copiar os arquivos perdidos, verifique se todos os itens aparecem na pasta de destino do OneDrive. Abra o OneDrive no Explorador de Arquivos, clique com o botão direito na pasta e selecione Verificar atualizações. Se algum arquivo ainda mostrar um X vermelho, confirme se o usuário tem o aplicativo de sincronização do OneDrive em execução e se o status da sincronização está saudável.

Para futuras migrações por fases, agende uma re-varredura a cada 24 horas durante a janela de migração. Isso captura arquivos adicionados durante a noite. Você pode automatizar a re-varredura usando o cmdlet Start-MigrationTask do PowerShell com o parâmetro -ReScan. Isso reduz a chance de arquivos perdidos e elimina verificações manuais.