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

Ao executar uma migração por fases de um servidor de arquivos local para o OneDrive, alguns arquivos não aparecem no destino. Esse problema ocorre normalmente porque a ferramenta de migração ignora arquivos modificados após a varredura inicial ou porque as permissões de pasta impedem a leitura de determinados itens. O resultado é uma migração incompleta que deixa os usuários sem acesso a documentos importantes. Este artigo explica por que arquivos são perdidos durante migrações por fases e fornece um checklist para verificar e corrigir as lacunas.

Por que as migrações por fases perdem arquivos

As migrações por fases movem dados em lotes ao longo de vários dias ou semanas. O Migration Manager do Microsoft 365 varre o servidor de arquivos de origem no início de cada lote. Arquivos criados ou modificados após essa varredura não são incluídos no lote, a menos que o administrador acione uma nova varredura. As causas técnicas comuns incluem:

• Cache de varredura desatualizado: A ferramenta de migração armazena em cache a lista de arquivos da varredura inicial. Se você não atualizar a varredura antes do próximo lote, novos arquivos permanecem desconhecidos para a ferramenta.
• Incompatibilidade de permissões: A conta que executa a migração deve ter acesso de Leitura a todas as pastas e arquivos. Uma única pasta com herança quebrada pode fazer com que todos os arquivos dentro dela sejam ignorados.
• Bloqueios de arquivo e alças abertas: Arquivos que estão abertos em um aplicativo quando o agente de migração tenta copiá-los são ignorados. A ferramenta não tenta novamente esses arquivos automaticamente.
• Limites de tamanho de caminho: O Windows tem um limite de 260 caracteres para o caminho do servidor de arquivos de origem. Arquivos com caminhos mais longos não são migrados a menos que o administrador habilite o suporte a caminhos longos.

A ferramenta de migração registra cada arquivo ignorado no log da tarefa, mas não alerta o administrador. Você deve revisar os logs manualmente após cada lote para identificar itens ausentes.

Checklist para encontrar e corrigir arquivos perdidos em migrações por fases

Use as etapas a seguir após cada lote para verificar se todos os arquivos foram movidos. Execute essas verificações antes de iniciar o próximo lote.

Etapa 1: Atualize a varredura de origem antes de cada lote

1. Abra o Migration Manager
   Vá para o centro de administração do Microsoft 365 em admin.microsoft.com. Selecione Migration Manager na seção Centros de administração.
2. Selecione a conexão de origem
   Clique em Sources e escolha sua conexão de servidor de arquivos. Clique em Scan para atualizar o inventário de arquivos. Aguarde a conclusão da varredura antes de criar o próximo lote.
3. Compare as contagens de arquivos
   Compare o número total de arquivos da nova varredura com a contagem da varredura anterior. Um aumento significativo indica que arquivos foram perdidos anteriormente.

Etapa 2: Revise o log de falhas da tarefa para cada lote

1. Abra os detalhes do lote
   No Migration Manager, clique em Tasks. Encontre o lote que deseja revisar e clique no nome do lote.
2. Filtre por itens com falha
   Clique em Filter e selecione Failed. A lista mostra todos os arquivos que a ferramenta não conseguiu copiar.
3. Leia o motivo da falha
   Passe o mouse sobre o ícone de falha ao lado de cada arquivo. Os motivos comuns incluem “Access denied”, “File in use” e “Path too long”.
4. Exporte a lista de falhas
   Clique em Export para baixar um CSV de todos os arquivos com falha. Use esta lista para corrigir permissões ou tentar novamente os arquivos no próximo lote.

Etapa 3: Verifique as permissões na estrutura de pastas de origem

1. Verifique a conta de migração
   Confirme que a conta usada para a migração tem pelo menos permissões de Leitura e Listar Conteúdo da Pasta na pasta raiz do compartilhamento do servidor de arquivos.
2. Teste uma subpasta aleatória
   Faça login no servidor de arquivos com a conta de migração. Navegue até três subpastas aleatórias que tinham arquivos no log de falhas. Tente abrir um arquivo em cada pasta.
3. Corrija a herança quebrada
   Se não conseguir abrir um arquivo, clique com o botão direito na pasta, selecione Properties, vá para a guia Security e clique em Advanced. Ative a herança se estiver desabilitada.

Etapa 4: Tente novamente os arquivos com falha no próximo lote

1. Crie um novo lote
   No Migration Manager, clique em Create batch. Selecione a mesma origem e destino do lote anterior.
2. Importe o CSV de falhas
   Escolha Import from CSV e faça upload do CSV exportado na Etapa 2. A ferramenta tentará migrar apenas esses arquivos.
3. Execute o lote e revise
   Após a conclusão do lote, verifique o log da tarefa novamente. Quaisquer arquivos que ainda falharem precisarão de tratamento manual.

Se os arquivos ainda estiverem ausentes após o checklist

Alguns tipos de arquivo e configurações exigem etapas adicionais. Use as subseções abaixo para lidar com problemas persistentes.

Arquivos com caminhos longos (mais de 260 caracteres)

O Windows 10 e o Windows 11 suportam caminhos de arquivo longos apenas quando a configuração de Política de Grupo Enable Win32 long paths está habilitada no servidor de arquivos. Para corrigir isso:

1. Abra o Editor de Política de Grupo Local no servidor de arquivos.
2. Vá para Computer Configuration > Administrative Templates > System > Filesystem.
3. Habilite Enable Win32 long paths.
4. Reinicie o servidor de arquivos e execute uma nova varredura no Migration Manager.

Arquivos abertos em aplicativos durante a migração

O agente de migração não pode copiar um arquivo que está bloqueado por outro processo. Para minimizar arquivos ignorados:

• Agende migrações durante horários de menor movimento, quando menos usuários estiverem trabalhando em arquivos.
• Notifique os usuários para fechar os arquivos antes do início de cada lote.
• Use o serviço Volume Shadow Copy no servidor de arquivos. O Migration Manager pode ler cópias de sombra para acessar arquivos bloqueados.

Arquivos ocultos e arquivos de sistema

O Migration Manager ignora arquivos com o atributo Oculto ou Sistema por padrão. Para incluir esses arquivos:

1. No Migration Manager, vá para Settings.
2. Em Migration options, ative Include hidden and system files.
3. Execute uma nova varredura e crie um lote que tenha como alvo as pastas perdidas.

Varredura do Migration Manager vs Log da Tarefa: O que cada um relata

Item	Relatório de Varredura	Log da Tarefa
Propósito	Lista todos os arquivos e pastas na origem antes do início da migração	Mostra o resultado da operação de cópia para cada arquivo
Quando revisar	Antes de criar um lote para confirmar que o inventário de arquivos está atualizado	Após a conclusão de um lote para encontrar arquivos que falharam ao copiar
O que inclui	Nome do arquivo, caminho, tamanho, data da última modificação e permissões	Nome do arquivo, caminho, status Sucesso ou Falha e código de erro
Pode ser exportado	Sim, como CSV na página de detalhes da origem	Sim, como CSV na página de detalhes da tarefa

Migrações por fases exigem que você atualize a varredura de origem antes de cada lote e revise o log da tarefa após cada lote. Execute as etapas do checklist em ordem após cada lote para capturar arquivos perdidos. Para arquivos que ainda falharem após a tentativa, verifique o servidor de arquivos quanto a caminhos longos, alças abertas e atributos ocultos. O log de falhas no Migration Manager fornece o caminho exato do arquivo e o código de erro para cada item ignorado, permitindo corrigir a causa raiz e migrar o arquivo no próximo lote.