Ferramenta de Migração do OneDrive Ignora Caminhos Longos: Correção para OneDrive for Business

Ao migrar arquivos para o OneDrive for Business usando o Microsoft Migration Manager ou o aplicativo de sincronização do OneDrive, alguns arquivos e pastas podem não ser movidos porque seus caminhos excedem o comprimento máximo de 260 caracteres do Windows. Esse limite, também chamado de MAX_PATH, faz com que a ferramenta de migração ignore esses itens sem aviso. Este artigo explica por que a ferramenta de migração para em caminhos longos, como identificar os arquivos afetados e as etapas exatas para corrigir o problema para que todos os seus dados sejam movidos com sucesso.

Por que a Ferramenta de Migração do OneDrive Ignora Caminhos Longos

O sistema de arquivos NTFS do Windows suporta caminhos com mais de 260 caracteres, mas muitos aplicativos legados, incluindo partes da infraestrutura de migração do OneDrive, ainda impõem o antigo limite MAX_PATH. Quando a ferramenta de migração encontra um arquivo cujo caminho completo — incluindo letra da unidade, pastas, subpastas e nome do arquivo — excede 260 caracteres, ela registra o arquivo como ignorado e continua para o próximo item. Isso não bloqueia toda a migração, mas os arquivos ignorados permanecem no local de origem.

A causa raiz é quase sempre estruturas de pastas profundamente aninhadas combinadas com nomes de arquivo longos. Por exemplo, uma pasta chamada “Ativos Finais da Campanha de Marketing Q4 2024” dentro de “Arquivo Compartilhado do Drive” dentro de “Arquivos Corporativos” pode facilmente empurrar um nome de arquivo simples como “Apresentacao_Rascunho_v3_Feedbacks_Edicoes.docx” para além de 260 caracteres. A ferramenta de migração não encurta automaticamente os caminhos nem move arquivos para um local mais raso.

Onde o Limite se Aplica

O limite de 260 caracteres se aplica ao caminho absoluto no servidor de arquivos de origem ou unidade local. O OneDrive em si, uma vez que os arquivos estão na nuvem, tem um limite de 400 caracteres para o caminho completo da URL, mas a ferramenta de migração usa a resolução de caminho local primeiro. O limite não se aplica a arquivos armazenados diretamente em bibliotecas de documentos do SharePoint quando acessados via web, mas se aplica durante o processo de upload da migração.

Etapas para Identificar e Corrigir Arquivos com Caminho Longo Antes da Migração

Antes de executar a ferramenta de migração novamente, você deve localizar todos os arquivos com caminho superior a 260 caracteres e encurtar o caminho ou habilitar o suporte a caminhos longos na máquina de origem.

Método 1: Usar PowerShell para Encontrar Caminhos Longos

1. Abra o PowerShell como Administrador
   Pressione a tecla Windows, digite “PowerShell”, clique com o botão direito em Windows PowerShell e selecione Executar como administrador.
2. Execute o comando de verificação de comprimento de caminho
   Digite o seguinte comando e pressione Enter:
   Get-ChildItem -Path "C:\PastaOrigem" -Recurse -Force | Where-Object { $_.FullName.Length -gt 260 } | Select-Object FullName, Length
   Substitua “C:\PastaOrigem” pela pasta raiz real que você está migrando. Este comando lista todos os arquivos e pastas cujo caminho absoluto excede 260 caracteres. A coluna Length mostra a contagem de caracteres.
3. Exporte a lista para um arquivo CSV
   Adicione | Export-Csv -Path "CaminhosLongos.csv" -NoTypeInformation ao final do comando. Abra o CSV no Excel para revisar cada caminho e planejar a renomeação.

Método 2: Encurtar Nomes de Pastas e Arquivos

1. Renomeie pastas profundas para nomes mais curtos
   Identifique pastas com mais de cinco níveis de profundidade a partir da raiz. Renomeie-as para três ou quatro caracteres, como “Mktg” em vez de “Ativos Finais da Campanha de Marketing Q4 2024”. Use o Explorador de Arquivos ou um loop Rename-Item do PowerShell para alterações em massa.
2. Encurte nomes de arquivos
   Reduza os nomes de arquivos para 20 caracteres ou menos. Por exemplo, renomeie “Apresentacao_Rascunho_v3_Feedbacks_Edicoes.docx” para “Apres_v3_fb.docx”. Evite caracteres especiais que aumentem o comprimento.
3. Simplifique a estrutura de pastas
   Mova arquivos de subpastas profundamente aninhadas para uma pasta pai com um nome curto. Isso reduz o comprimento do caminho sem renomear todos os arquivos.
4. Execute novamente a verificação de caminho
   Execute o comando PowerShell novamente para confirmar que nenhum caminho excede 260 caracteres antes de iniciar a migração.

Método 3: Habilitar Suporte a Caminhos Longos via Política de Grupo

1. Abra o Editor de Política de Grupo Local
   Pressione a tecla Windows + R, digite gpedit.msc e pressione Enter.
2. Navegue até a configuração de caminho longo
   Vá para Configuração do Computador > Modelos Administrativos > Sistema > Sistema de Arquivos. Clique duas vezes em “Habilitar caminhos longos Win32”.
3. Habilite a política
   Selecione Habilitado e clique em OK. Essa configuração permite que o Windows e aplicativos que suportam o prefixo de caminho estendido lidem com caminhos de até 32.767 caracteres.
4. Reinicie a máquina
   Reinicie o computador para que a política entre em vigor. A ferramenta de migração do OneDrive também deve ser reiniciada para reconhecer o novo limite.

Se a Ferramenta de Migração Ainda Ignorar Arquivos Após Corrigir os Caminhos

Ferramenta de Migração do OneDrive Relata “Caminho Muito Longo” Mesmo Após Renomeação

Se a ferramenta ainda ignorar os mesmos arquivos, o problema pode ser uma pasta oculta ou um atributo de arquivo de sistema. Execute o comando PowerShell com o parâmetro -Force para incluir itens ocultos e do sistema. Se uma pasta oculta tiver um caminho longo, remova a ocultação temporariamente, renomeie-a e oculte-a novamente após a migração.

O Aplicativo de Sincronização do OneDrive Para Durante o Upload de um Arquivo com Caminho Longo

O aplicativo de sincronização do OneDrive tem um limite de 400 caracteres para o caminho completo da URL, mas o mecanismo de sincronização local ainda pode impor o limite de 260 caracteres para o caminho do cache local. Se você estiver usando o aplicativo de sincronização como método de migração, habilite o suporte a caminhos longos no Windows usando o método de Política de Grupo acima e reinicie o aplicativo de sincronização. Se o arquivo ainda falhar, use a Ferramenta de Migração do SharePoint (SPMT), que lida com caminhos longos de forma mais confiável.

Ferramenta de Migração do OneDrive vs PowerShell Rename-Item: Principais Diferenças para Caminhos Longos

Item	Ferramenta de Migração do OneDrive	PowerShell Rename-Item
Tratamento de limite de caminho	Ignora arquivos acima de 260 caracteres por padrão; sem renomeação automática	Pode renomear arquivos com caminhos de até 32.767 caracteres se o suporte a caminhos longos estiver habilitado
Operação em lote	Migra arquivos em paralelo; relata itens ignorados em um log	Processa um arquivo por vez; requer um loop para ações em massa
Risco de perda de dados	Baixo; arquivos ignorados permanecem na origem	Moderado; renomeação incorreta pode quebrar referências de arquivos se usada sem teste
Melhor caso de uso	Migração inicial de grandes compartilhamentos de arquivos	Limpeza pré-migração para reduzir comprimentos de caminho

Agora você pode identificar arquivos com caminhos maiores que 260 caracteres, renomeá-los ou reestruturá-los e executar novamente a ferramenta de migração do OneDrive sem ignorar itens. Em seguida, verifique o relatório de conclusão da migração no centro de administração do Microsoft 365 para confirmar que nenhum arquivo foi deixado para trás. Como dica avançada, agende um script semanal do PowerShell que verifique seus compartilhamentos de arquivos em busca de caminhos próximos a 250 caracteres para corrigi-los antes do próximo ciclo de migração.