Solução de problemas de migração de servidor de arquivos para OneDrive for Business em migrações em fases: arquivos perdidos

Quando você executa uma migração em fases de um servidor de arquivos para o OneDrive for Business, pode perceber que alguns arquivos nunca aparecem nas pastas de destino do OneDrive. Isso geralmente acontece porque a ferramenta de migração ignora arquivos bloqueados, com caracteres não suportados nos nomes ou que excedem os limites de comprimento do caminho. Em outros casos, a ferramenta processa os arquivos fora de ordem e posteriormente sobrescreve ou ignora arquivos que foram alterados durante a janela de migração.

Migrações em fases movem dados em lotes ao longo de dias ou semanas. Se um arquivo no servidor de origem for modificado após a verificação do lote, mas antes do upload, a ferramenta de migração pode tratar a nova versão como um novo arquivo ou ignorá-lo completamente. Este artigo explica as causas raiz específicas de arquivos perdidos em migrações em fases para o OneDrive e fornece procedimentos passo a passo para identificar e recuperar esses arquivos.

Por que as Migrações em Fases Perdem Arquivos de um Servidor de Arquivos

Migrações em fases dividem o conteúdo do servidor de arquivos de origem em vários lotes. Cada lote é verificado, copiado para o armazenamento do Azure e depois gravado no OneDrive. A API de Migração do Microsoft 365 e a Ferramenta de Migração do SharePoint dependem de um instantâneo da pasta de origem no momento da verificação. Se um arquivo estiver aberto, bloqueado por outro processo ou renomeado entre a verificação e o upload, a ferramenta o ignora.

As causas técnicas mais comuns são:

• Bloqueios de arquivo e identificadores abertos: Qualquer arquivo que esteja aberto em um aplicativo ou bloqueado pelo sistema operacional no momento da verificação é ignorado. A ferramenta não tenta novamente arquivos bloqueados no mesmo lote.
• Caracteres não suportados em nomes de arquivo: Caracteres como ~ ” # % & : < > ? / \ | não são permitidos no OneDrive ou SharePoint. Arquivos com esses caracteres no nome ou caminho são ignorados silenciosamente.
• Comprimento do caminho excedendo 400 caracteres: O OneDrive e o SharePoint têm um limite de 400 caracteres no caminho. Arquivos com caminhos mais longos são ignorados durante a migração.
• Modificação do arquivo após a verificação: Quando um arquivo é modificado após a verificação do lote, a ferramenta pode detectar uma incompatibilidade de checksum e ignorar o arquivo, ou pode sobrescrever o arquivo no OneDrive com a versão antiga e nunca fazer upload da versão mais recente.
• Pastas vazias: Algumas ferramentas de migração não criam pastas que não contêm arquivos. Se uma pasta tiver apenas subpastas que foram ignoradas, toda a árvore de pastas pode estar faltando.

Migrações em fases também introduzem um risco de tempo. Se o lote 2 for verificado na segunda-feira e enviado na quarta-feira, quaisquer arquivos adicionados à origem na terça-feira não serão incluídos no lote 2. Esses arquivos devem ser capturados em um lote posterior ou em uma passagem delta final. Sem uma passagem delta final, esses arquivos são perdidos permanentemente.

Etapas para Encontrar e Recuperar Arquivos Perdidos Após uma Migração em Fases

Siga estas etapas para identificar todos os arquivos que não foram migrados e, em seguida, copie esses arquivos para o local correto no OneDrive.

1. Abra o painel de migração do centro de administração do Microsoft 365
   Entre no centro de administração do Microsoft 365 em admin.microsoft.com. Vá para Centros de administração > Migração de conteúdo. Selecione o projeto de migração que contém os lotes do servidor de arquivos. Clique em Revisar erros para ver todos os arquivos que foram ignorados ou falharam. Exporte a lista de erros para CSV.
2. Execute uma comparação robocopy entre origem e destino
   No servidor de arquivos, abra o Prompt de Comando como administrador. Execute robocopy \\ServidorOrigem\Compartilhamento \\ServidorDestino\OneDriveMirror /L /E /NJH /NJS /NP /NS /NC /NDL /LOG:C:\migracao\comparacao.log. Isso lista todos os arquivos que existem na origem, mas não no destino. A flag /L garante que nenhum arquivo seja copiado — apenas um log é criado. Revise o log para arquivos que estão faltando no OneDrive.
3. Verifique o relatório de verificação da Ferramenta de Migração do SharePoint
   Se você usou a Ferramenta de Migração do SharePoint, abra o aplicativo de desktop SPMT. Clique em Exibir relatórios ao lado do trabalho de migração. Procure a guia Relatório de verificação. Este relatório lista arquivos que falharam na validação pré-migração devido a caracteres não suportados, caminhos longos ou bloqueios de arquivo. Exporte o relatório e cruze com o log do robocopy.
4. Identifique arquivos que mudaram durante a janela de migração
   No servidor de arquivos, use o PowerShell para listar arquivos com LastWriteTime entre a data de início do lote 1 e a data de conclusão do lote final. Execute Get-ChildItem -Path \\ServidorOrigem\Compartilhamento -Recurse | Where-Object {$_.LastWriteTime -ge '2025-01-01' -and $_.LastWriteTime -le '2025-01-15'} | Export-Csv C:\migracao\arquivos-alterados.csv. Compare esta lista com os arquivos que existem no OneDrive. Qualquer arquivo que foi modificado durante a migração, mas está faltando no OneDrive, precisa ser copiado manualmente.
5. Copie os arquivos perdidos para o OneDrive usando o aplicativo de sincronização do OneDrive
   Instale o aplicativo de sincronização do OneDrive em uma máquina Windows que tenha acesso ao servidor de arquivos. Faça login com a conta de usuário de destino. Mapeie a pasta do OneDrive como uma unidade de rede ou acesse-a através do Explorador de Arquivos. Para cada arquivo identificado nas etapas anteriores, copie-o do servidor de arquivos para a subpasta correta do OneDrive. O aplicativo de sincronização faz o upload do arquivo para o OneDrive automaticamente.
6. Execute um lote de migração delta final
   No painel de migração do centro de administração do Microsoft 365, crie um novo lote que inclua apenas o caminho do servidor de arquivos que foi migrado anteriormente. Defina o lote para o modo Migração delta. Isso verifica apenas arquivos que foram alterados desde a última data de migração. Execute este lote após toda a atividade do servidor de arquivos ter cessado. Isso captura arquivos que foram adicionados ou modificados após as verificações do lote original.

Se os Arquivos Ainda Estiverem Faltando Após as Etapas de Recuperação

Mesmo após seguir as etapas de recuperação, alguns arquivos podem permanecer ausentes. As seções a seguir cobrem os problemas residuais mais comuns e suas correções específicas.

Arquivos com caracteres não suportados no nome

O OneDrive e o SharePoint não permitem os caracteres ~ ” # % & : < > ? / \ | em nomes de arquivo ou pasta. Se o relatório de verificação mostrar esses caracteres, renomeie o arquivo no servidor de origem para remover ou substituir o caractere não suportado. Use um hífen ou sublinhado como substituto. Após renomear, copie o arquivo para o OneDrive usando o aplicativo de sincronização do OneDrive.

Arquivos com caminho maior que 400 caracteres

A Ferramenta de Migração do SharePoint ignora arquivos cujo caminho completo excede 400 caracteres. Para corrigir isso, encurte a estrutura de pastas no servidor de origem. Renomeie subpastas profundas para nomes de um único caractere ou mova os arquivos para mais perto da raiz. Após o caminho ficar abaixo de 400 caracteres, copie os arquivos para o OneDrive manualmente.

Arquivos que estavam abertos durante a verificação do lote

Se um arquivo estava aberto em um aplicativo no momento da verificação do lote, a ferramenta de migração o ignorou. Após o aplicativo ser fechado, o arquivo fica livre. Execute o lote de migração delta novamente. A verificação delta captura arquivos que estavam anteriormente bloqueados porque seu LastWriteTime ou checksum mudou quando o bloqueio foi liberado.

Pastas vazias não foram criadas

A Ferramenta de Migração do SharePoint não cria pastas vazias por padrão. Se você precisar que a estrutura de pastas seja idêntica, crie as pastas vazias manualmente no OneDrive através do Explorador de Arquivos ou do site do OneDrive. Use o aplicativo de sincronização do OneDrive para criar pastas na máquina local, e as pastas serão sincronizadas com a nuvem.

Item	Migração completa (passagem única)	Migração em fases (vários lotes)
Descrição	Todos os dados são verificados e enviados em uma operação contínua	Os dados são divididos em lotes processados ao longo de dias ou semanas
Risco de alteração de arquivo	Baixo — a janela de migração é curta e os arquivos raramente mudam durante o upload	Alto — arquivos modificados entre verificações e uploads de lotes podem ser perdidos
Passagem delta necessária	Opcional — recomendada se a origem ainda estiver ativa	Obrigatória — sem uma passagem delta final, arquivos alterados ou adicionados são perdidos permanentemente
Tratamento de bloqueio de arquivo	Ignora arquivos bloqueados — requer uma passagem de repetição	Ignora arquivos bloqueados por lote — requer uma passagem delta após os bloqueios serem liberados
Melhor para	Servidores de arquivos pequenos a médios com menos de 1 TB e baixa taxa de alteração	Servidores de arquivos grandes com mais de 1 TB ou servidores que não podem ser colocados offline

Agora você pode identificar todos os arquivos que foram ignorados durante uma migração em fases para o OneDrive e recuperá-los usando os logs de comparação, lote de migração delta e etapas de cópia manual. Para migrações futuras, execute uma verificação pré-migração com a Ferramenta de Migração do SharePoint para detectar caracteres não suportados e caminhos longos antes do primeiro lote começar. Como dica avançada, agende um trabalho de comparação robocopy para ser executado semanalmente durante a janela de migração para detectar arquivos perdidos imediatamente, em vez de após a conclusão do projeto.