Guia de correção: migração de servidor de arquivos para OneDrive for Business ignora dados executivos

Ao migrar arquivos de um servidor de arquivos para o OneDrive for Business, você pode descobrir que alguns arquivos estão faltando após a conclusão da migração. Esse problema geralmente afeta dados executivos, incluindo arquivos com permissões restritas, caminhos longos ou caracteres especiais nos nomes. O problema ocorre porque a ferramenta de migração ignora arquivos que violam as restrições de sincronização do OneDrive ou SharePoint. Este guia explica por que os dados executivos são ignorados e fornece correções passo a passo para localizar e migrar esses arquivos ausentes.

Por que a migração ignora arquivos executivos

A Ferramenta de Migração do SharePoint (SPMT) e outros utilitários de migração aplicam as mesmas regras de nomenclatura de arquivos e pastas que se aplicam ao OneDrive e ao SharePoint Online. Arquivos que violam essas regras são ignorados silenciosamente. Dados executivos geralmente residem em estruturas de pastas profundamente aninhadas, contêm arquivos com nomes maiores que 400 caracteres ou usam caracteres como ~ " # % & : < > ? / \ { | } que são bloqueados no OneDrive. Além disso, arquivos com permissões exclusivas herdadas do servidor de arquivos podem não ser transferidos corretamente se a ferramenta de migração não tiver direitos de acesso suficientes para ler os descritores de segurança do arquivo.

Outra causa comum é o limite de tamanho de arquivo. O OneDrive for Business permite arquivos de até 250 GB por arquivo. No entanto, se a ferramenta de migração encontrar um arquivo que exceda esse limite, ela falha silenciosamente. Arquivos executivos, apresentações grandes ou gravações de vídeo podem acionar esse limite. O log de migração geralmente marca esses arquivos como ignorados sem uma mensagem de erro detalhada, dificultando a identificação da causa exata.

Por fim, a ferramenta de migração pode ignorar arquivos que estão bloqueados por outro processo durante a janela de migração. As estações de trabalho executivas geralmente têm arquivos abertos por longos períodos, e a ferramenta de migração não pode copiar arquivos abertos. Se a migração for executada durante o horário comercial, esses arquivos serão perdidos.

Etapas para localizar e migrar arquivos executivos ausentes

1. Execute uma pré-verificação com o SPMT para identificar arquivos bloqueados
   Abra a Ferramenta de Migração do SharePoint e selecione Começar do zero. Escolha a origem do servidor de arquivos e o destino do OneDrive. Antes de iniciar a migração, clique em Verificar. O relatório de verificação lista todos os arquivos que serão ignorados e o motivo. Exporte este relatório como um arquivo CSV para referência.
2. Verifique o relatório de tarefa de migração para itens ignorados
   Após a conclusão da migração, abra o SPMT e vá para Status da tarefa. Selecione a tarefa concluída e clique em Ver relatório. Procure linhas com status Ignorado ou Falhou. O relatório inclui o caminho do arquivo e o código de erro.
3. Corrija problemas de nome e caminho de arquivo antes de tentar novamente
   Renomeie arquivos que contenham caracteres bloqueados. Encurte caminhos de arquivo para menos de 400 caracteres movendo os arquivos para uma estrutura de pastas mais rasa. Remova espaços iniciais ou finais nos nomes dos arquivos. Após corrigir, execute a migração novamente apenas para as pastas afetadas.
4. Resolva conflitos de permissão com uma conta de superusuário
   Use uma conta de migração que tenha Controle Total na origem do servidor de arquivos. Se os arquivos executivos tiverem permissões exclusivas, conceda à conta de migração permissões explícitas de Leitura e Gravação em cada pasta afetada. No SPMT, defina o mapeamento de usuário para preservar o proprietário original do arquivo ou reatribuir ao usuário executivo.
5. Use o PowerShell para comparar contagens de arquivos de origem e destino
   Abra o SharePoint Online Management Shell. Execute Get-PnPFilesInFolder -FolderSiteRelativeUrl "Documents/Executive" -Connection $conn | Measure-Object para contar arquivos no destino do OneDrive. Compare essa contagem com a contagem da pasta do servidor de arquivos. Se os números diferirem, identifique os arquivos ausentes executando um script de comparação recursiva.
6. Migre arquivos bloqueados após o expediente
   Agende a migração para ser executada fora do horário comercial. Use a opção Agendar no SPMT para definir uma hora de início. Como alternativa, use o cmdlet PowerShell Start-SPFileMigration com o parâmetro -StartTime para especificar um horário em que os arquivos não estão em uso.

Se os arquivos executivos ainda apresentarem problemas após a correção principal

OneDrive relata erro 404 para um arquivo executivo migrado

Um erro 404 significa que o arquivo existe no servidor de arquivos, mas não foi enviado para o OneDrive. Isso ocorre quando o nome do arquivo contém um caractere não seguro para URL que a ferramenta de migração não consegue codificar. Abra a pasta do servidor de arquivos, renomeie o arquivo para remover caracteres como & ou # e execute a migração novamente nessa pasta específica. Use a opção de migração incremental do SPMT para enviar apenas arquivos novos ou alterados.

Arquivos executivos aparecem no OneDrive, mas não podem ser abertos

Se o arquivo estiver presente, mas mostrar um erro ao abrir, o arquivo pode ter sido corrompido durante a transferência. Isso geralmente acontece com arquivos muito grandes, acima de 10 GB. Baixe o arquivo original do servidor de arquivos, verifique sua integridade abrindo-o localmente e, em seguida, faça o upload manualmente usando a interface web do OneDrive. Não use a ferramenta de migração para arquivos que falham dessa forma.

A herança de permissão é interrompida após a migração

O OneDrive for Business não oferece suporte ao mesmo modelo de permissão NTFS de um servidor de arquivos. Após a migração, todos os arquivos em uma pasta do OneDrive herdam permissões da pasta pai. Se os arquivos executivos exigirem permissões exclusivas, você deve defini-las individualmente no OneDrive. Use a opção Gerenciar acesso em cada arquivo para conceder permissões específicas ao usuário. Como alternativa, crie uma biblioteca separada do OneDrive para dados executivos e aplique permissões no nível da biblioteca.

Ferramenta de Migração do SharePoint vs Upload manual para dados executivos: principais diferenças

Item	Ferramenta de Migração do SharePoint (SPMT)	Upload manual via web do OneDrive
Limite de tamanho de arquivo	250 GB por arquivo	250 GB por arquivo
Limite de comprimento do caminho	400 caracteres	400 caracteres
Caracteres bloqueados	Ignora arquivos com caracteres bloqueados	Bloqueia upload com mensagem de erro clara
Tratamento de permissões	Pode ignorar arquivos sem acesso explícito da conta de migração	O uploader deve ter permissão de gravação no destino
Comportamento de arquivo bloqueado	Ignora arquivos abertos silenciosamente	Falha com erro de arquivo em uso
Migração incremental	Suportada	Não suportada

Para dados executivos, o SPMT é o método preferido para migração em massa, pois suporta execuções incrementais e gera logs detalhados. O upload manual é melhor para arquivos individuais que o SPMT ignora consistentemente devido a problemas de caminho ou caractere.

Agora você pode identificar por que os arquivos executivos estão ausentes após uma migração de servidor de arquivos e aplicar correções direcionadas para problemas de comprimento de caminho, caractere, permissão e arquivo bloqueado. Em seguida, revise o relatório de pré-verificação do SPMT para todas as pastas restantes para detectar problemas semelhantes antes da próxima onda de migração. Para o gerenciamento contínuo de dados executivos, considere configurar uma política de sincronização do OneDrive que exclua tipos de arquivo bloqueados e imponha regras de nomenclatura na origem.