Migração de servidor de arquivos para OneDrive for Business perde arquivos de engenharia: Guia de correção
🔍 WiseChecker

Migração de servidor de arquivos para OneDrive for Business perde arquivos de engenharia: Guia de correção

Durante a migração de um servidor de arquivos para o OneDrive for Business, arquivos de engenharia como desenhos CAD, modelos 3D, código-fonte e saídas de simulação são frequentemente ignorados ou deixados para trás. Isso acontece porque os tipos de arquivo de engenharia geralmente excedem o limite de comprimento de caminho do OneDrive, contêm caracteres não suportados ou são bloqueados pelas regras de sincronização. Este guia explica os motivos técnicos pelos quais os arquivos de engenharia são perdidos e fornece métodos passo a passo para encontrar e mover esses arquivos manualmente ou via PowerShell.

Principais conclusões: Localize e migre arquivos de engenharia travados

  • Limites de sincronização do OneDrive: Caminhos com mais de 400 caracteres e nomes de arquivo com mais de 255 caracteres causam falhas silenciosas em arquivos de engenharia.
  • Ferramentas de scanner de migração: Use a Ferramenta de Migração do SharePoint da Microsoft com a flag –EnableAllFeatures para detectar tipos de arquivo de engenharia bloqueados.
  • Realocação manual de arquivos: Encurte caminhos de pastas e renomeie arquivos para remover caracteres não suportados antes de reenviá-los.

ADVERTISEMENT

Por que os arquivos de engenharia são perdidos durante a migração para o OneDrive

Os arquivos de engenharia geralmente têm nomes de arquivo longos e estruturas de pastas profundas. Por exemplo, um arquivo de montagem CAD pode estar armazenado em Projetos\2024\Motor\V3\montagem\revisao_final_2024_12_01\bloco_motor.SLDPRT. Esse caminho pode facilmente exceder o comprimento máximo de caminho do OneDrive, que é de 400 caracteres. Além disso, as ferramentas de engenharia geram nomes de arquivo contendo colchetes, símbolos de hash ou caracteres não ASCII que o OneDrive bloqueia. Tipos de arquivo como .DLL, .EXE, .ISO, .VHDX e .VSDX são bloqueados por padrão na sincronização do OneDrive. A Ferramenta de Migração do SharePoint (SPMT) registra esses itens ignorados, mas não os move. O resultado é uma migração parcial onde arquivos críticos de engenharia permanecem no servidor de arquivos.

Restrições de comprimento de caminho e caracteres

O OneDrive for Business impõe um máximo de 400 caracteres para o caminho completo, incluindo o nome do arquivo. Projetos de engenharia frequentemente usam nomes de pastas aninhados como Documentos_Design\Modelos_CAD\Arquivos_Montagem\Rev_05\. Quando um nome de arquivo como bloco_motor_revisao_final_com_calculos_tolerancia.SLDPRT é adicionado, o caminho total excede o limite. O OneDrive ignora esses arquivos silenciosamente. Também há restrições de caracteres: os caracteres ~ " # % & : < > ? / \ { | } não são permitidos. Nomes de arquivo de engenharia contendo tags de versão como v2.1#final ou modelo_v2(revisado) falharão.

Tipos de arquivo bloqueados na sincronização do OneDrive

As regras de sincronização padrão do OneDrive bloqueiam certas extensões de arquivo por motivos de segurança. Os tipos bloqueados incluem arquivos executáveis (.EXE, .COM, .BAT, .CMD), arquivos de script (.PS1, .VBS, .JS) e arquivos de sistema (.DLL, .SYS, .VXD). O software de engenharia geralmente usa arquivos .DLL para plugins ou arquivos .EXE para ferramentas personalizadas. Esses arquivos não são sincronizados e não aparecerão no OneDrive após a migração. O administrador pode substituir alguns bloqueios no centro de administração do Microsoft 365, mas a política padrão durante a migração os deixa para trás.

Etapas para identificar e migrar arquivos de engenharia ausentes

Este processo requer acesso ao servidor de arquivos original, à Ferramenta de Migração do SharePoint e direitos de administrador global no Microsoft 365. Execute estas etapas em ordem.

Etapa 1: Execute um relatório de migração para encontrar arquivos ignorados

  1. Abra a Ferramenta de Migração do SharePoint
    Inicie o SPMT no servidor de arquivos. Selecione Iniciar sua primeira migração ou Nova migração no painel.
  2. Escolha a origem do servidor de arquivos
    Selecione Compartilhamento de arquivos como tipo de origem. Insira o caminho UNC para a pasta de engenharia, por exemplo \\SERVER\Projetos\Engenharia.
  3. Defina o destino para o OneDrive
    Selecione OneDrive for Business como destino. Insira a URL do OneDrive do usuário de destino, normalmente https://[tenant]-my.sharepoint.com/personal/[usuario].
  4. Ative o registro detalhado
    Nas Configurações avançadas, marque Ativar registro detalhado e Somente verificação. Isso executa uma varredura sem mover arquivos. Clique em Iniciar verificação.
  5. Revise os resultados da verificação
    Após a verificação, abra o arquivo de log localizado em %AppData%\Microsoft\SPMT\Logs. Procure linhas contendo Bloqueado, Ignorado ou Nome de arquivo muito longo. Exporte essas entradas para um arquivo CSV usando o botão Exportar no SPMT.

Etapa 2: Corrija problemas de comprimento de caminho e nome de arquivo

  1. Identifique caminhos que excedem 400 caracteres
    Abra o CSV exportado. Filtre a coluna Erro para PathTooLong ou FileNameTooLong. Anote os caminhos completos.
  2. Encurte estruturas de pastas profundas
    No servidor de arquivos, mova arquivos de pastas profundamente aninhadas para uma estrutura mais plana. Por exemplo, altere Projetos\2024\Motor\V3\montagem\revisao_final\ para Projetos\Motor_V3\montagem\. Use o Windows File Explorer ou o robocopy com a flag /MOVE.
  3. Renomeie arquivos com caracteres não suportados
    Substitua os caracteres ~ " # % & : < > ? / \ { | } por sublinhados ou hífens. Por exemplo, renomeie modelo_v2#final.SLDPRT para modelo_v2_final.SLDPRT. Use PowerShell: Get-ChildItem -Recurse | Where-Object { $_.Name -match '[~"#%&:<>?/\\{|}]' } | Rename-Item -NewName { $_.Name -replace '[~"#%&:<>?/\\{|}]', '_' }
  4. Execute novamente a verificação de migração
    No SPMT, crie uma nova verificação para a mesma pasta de origem. Confirme que os arquivos anteriormente ignorados agora aparecem na lista Pronto para migrar.

Etapa 3: Migre tipos de arquivo bloqueados alterando a política de sincronização

  1. Abra o centro de administração do Microsoft 365
    Vá para Centros de administração > SharePoint > Políticas > Controle de acesso > Tipos de arquivo bloqueados.
  2. Remova os tipos de arquivo de engenharia da lista de bloqueio
    Localize as extensões .DLL, .EXE, .ISO, .VHDX e .VSDX na lista. Clique em Remover para cada uma. Essa alteração se aplica a todo o locatário e pode levar até 15 minutos para ser propagada.
  3. Execute a migração completa
    No SPMT, selecione Migrar em vez de Somente verificação. Escolha a mesma origem e destino. Monitore o progresso no painel do SPMT. Após a conclusão, verifique se os arquivos aparecem na biblioteca do OneDrive de destino.

ADVERTISEMENT

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

Alguns arquivos de engenharia permanecem teimosos mesmo após seguir as etapas acima. Os três problemas residuais mais comuns e suas soluções estão listados abaixo.

Arquivos com # ou % no nome ainda falham

O OneDrive trata o símbolo de hash # como um identificador de fragmento de URL. Mesmo após renomear, o arquivo pode não sincronizar se o nome da pasta ainda contiver #. Verifique todos os nomes de pastas pai. Renomeie qualquer pasta que contenha #, % ou & usando o Windows File Explorer ou PowerShell: Get-ChildItem -Directory -Recurse | Where-Object { $_.Name -match '[#%&]' } | Rename-Item -NewName { $_.Name -replace '[#%&]', '_' }

Arquivos grandes de engenharia excedem o limite de 250 GB por arquivo

O OneDrive for Business tem um tamanho máximo de arquivo de 250 GB. Arquivos de engenharia como saídas de simulação ou dados de digitalização 3D podem exceder isso. Verifique o tamanho do arquivo no Windows File Explorer. Se o arquivo for maior que 250 GB, compacte-o usando 7-Zip ou WinRAR em partes de 200 GB. Envie cada parte separadamente. Como alternativa, armazene o arquivo em um contêiner do Azure Blob Storage e vincule-o a partir do OneDrive.

A sincronização do OneDrive relata arquivos bloqueados após a migração

Se os arquivos foram migrados, mas depois bloqueados para sincronização no dispositivo do usuário, o problema é a política de sincronização do lado do cliente. Abra as configurações do OneDrive > Sincronizar e backup > Configurações avançadas > Arquivos. Certifique-se de que Bloquear tipos de arquivo não esteja ativado. Se estiver, limpe a lista ou remova extensões específicas de engenharia. Reinicie o OneDrive clicando com o botão direito no ícone da nuvem e selecionando Pausar sincronização e depois Retomar sincronização.

Verificação de migração vs Migração completa: Principais diferenças

Item Verificação de migração (SPMT Somente verificação) Migração completa (SPMT Migrar)
Propósito Identificar arquivos que serão ignorados ou bloqueados Mover arquivos da origem para o OneDrive
Transferência de arquivos Nenhum arquivo é movido Todos os arquivos elegíveis são copiados para o destino
Detalhamento do registro Lista detalhada de erros para cada arquivo bloqueado Registro resumido com status da transferência
Impacto na origem Nenhuma alteração na estrutura de pastas de origem Os arquivos permanecem na origem, a menos que você ative a exclusão
Quando usar Antes de qualquer migração para visualizar problemas Após corrigir todos os problemas detectados

Execute primeiro uma verificação de migração para capturar todos os problemas de comprimento de caminho, caracteres e tipos bloqueados. Corrija-os e, em seguida, execute a migração completa. Essa abordagem reduz o número de arquivos de engenharia ausentes para quase zero.

ADVERTISEMENT