Por que a migração de compartilhamento de arquivos cria pastas duplicadas

Pastas duplicadas aparecem no SharePoint após uma migração de compartilhamento de arquivos quando a ferramenta de migração copia o conteúdo das pastas para uma nova pasta em vez de mesclá-las com a estrutura de pastas existente. Esse problema ocorre com mais frequência quando o compartilhamento de arquivos de origem tem subpastas com nomes que correspondem a pastas já criadas na biblioteca de destino do SharePoint ou quando a ferramenta de migração executa várias passagens sobre os mesmos dados. Este artigo explica as causas raiz da criação de pastas duplicadas durante migrações de compartilhamento de arquivos e fornece etapas para prevenir e corrigir o problema.

Por que pastas duplicadas aparecem durante a migração de compartilhamento de arquivos

Migrações de compartilhamento de arquivos para o SharePoint geralmente usam ferramentas como a Ferramenta de Migração do SharePoint, ShareGate ou Metalogix. Essas ferramentas copiam arquivos e pastas de um compartilhamento de arquivos de rede para uma biblioteca de documentos do SharePoint. Pastas duplicadas ocorrem quando a ferramenta de migração não mapeia corretamente o caminho da pasta de origem para o caminho da pasta de destino. A ferramenta cria uma nova pasta no SharePoint que contém os arquivos copiados em vez de colocar esses arquivos em uma pasta existente com um nome correspondente.

A causa raiz é uma incompatibilidade entre como o compartilhamento de arquivos de origem organiza as pastas e como a biblioteca de destino do SharePoint está estruturada. Por exemplo, se o compartilhamento de arquivos de origem tem uma pasta chamada “Relatórios Financeiros” e a biblioteca de destino já tem uma pasta chamada “Relatórios Financeiros,” a ferramenta de migração pode criar uma segunda pasta chamada “Relatórios Financeiros 1” ou colocar os arquivos copiados em uma nova pasta com o mesmo nome sob um pai diferente. Isso acontece porque a ferramenta não realiza uma mesclagem de pastas por padrão.

Sensibilidade a maiúsculas/minúsculas no nome da pasta

Compartilhamentos de arquivos do Windows são insensíveis a maiúsculas/minúsculas, mas preservam a capitalização. O SharePoint também é insensível a maiúsculas/minúsculas. No entanto, algumas ferramentas de migração de terceiros tratam nomes de pastas como sensíveis a maiúsculas/minúsculas durante o processo de mapeamento. Se a pasta de origem se chama “Marketing” e o destino já tem uma pasta chamada “marketing,” a ferramenta pode criar uma segunda pasta chamada “Marketing” porque vê os nomes como diferentes. Isso cria duas pastas com conteúdo idêntico na mesma biblioteca.

Múltiplas passagens de migração sem mesclagem incremental

Muitas ferramentas de migração suportam migração incremental, ou seja, copiam apenas arquivos novos ou alterados após a passagem inicial. Se a ferramenta não usar mesclagem incremental, cada passagem cria uma nova estrutura de pastas no destino. Por exemplo, a primeira passagem cria uma pasta chamada “Projetos.” A segunda passagem, executada um dia depois para capturar novos arquivos, pode criar uma pasta chamada “Projetos 2025-03-21” em vez de adicionar arquivos à pasta “Projetos” existente.

Etapas para prevenir pastas duplicadas durante a migração

Siga estas etapas para configurar sua ferramenta de migração e estrutura de origem para evitar pastas duplicadas.

1. Examine o compartilhamento de arquivos de origem em busca de conflitos de nomes de pastas
   Execute um inventário de nomes de pastas no compartilhamento de arquivos de origem. Use o PowerShell para listar todos os nomes de pastas e verificar variantes de maiúsculas/minúsculas. Por exemplo, execute Get-ChildItem -Recurse -Directory | Group-Object { $_.Name.ToLower() } | Where-Object { $_.Count -gt 1 }. Renomeie quaisquer pastas que diferem apenas por maiúsculas/minúsculas antes de iniciar a migração.
2. Crie a estrutura de pastas de destino no SharePoint primeiro
   Crie manualmente as pastas de nível superior na biblioteca de documentos do SharePoint que correspondam à estrutura do compartilhamento de arquivos de origem. Use a interface do usuário do SharePoint ou um script para criar pastas com nomes exatos. Isso dá à ferramenta de migração um destino para mapear e reduz a chance de criação de duplicatas.
3. Ative a mesclagem de pastas na ferramenta de migração
   Na Ferramenta de Migração do SharePoint, abra Configurações e selecione “Preservar estrutura de pastas” e “Mesclar pastas com o mesmo nome.” Para o ShareGate, selecione “Mesclar” nas opções de pasta de destino. Para o Metalogix, ative “Mesclar pasta de destino com origem.” Isso instrui a ferramenta a colocar arquivos em pastas existentes em vez de criar novas.
4. Use uma única passagem de migração para a cópia inicial
   Agende uma passagem de migração completa que copie todos os arquivos e pastas da origem para o destino. Evite executar várias passagens para o mesmo conjunto de dados. Se precisar copiar arquivos adicionais depois, use o recurso de migração incremental com a opção de mesclagem ainda ativada.
5. Teste a migração em um subconjunto pequeno primeiro
   Selecione uma pasta do compartilhamento de arquivos de origem que contenha subpastas. Execute a migração para um site de teste do SharePoint. Verifique a biblioteca de destino em busca de pastas duplicadas. Se aparecerem duplicatas, ajuste as configurações da ferramenta antes de executar a migração completa.

Se pastas duplicadas ainda aparecerem após a correção principal

Mesmo com configurações corretas, alguns cenários de migração produzem pastas duplicadas. Aqui estão os padrões comuns e como resolvê-los.

Pasta duplicada criada com sufixo de timestamp

A ferramenta de migração adiciona um sufixo de data ou número ao nome de uma pasta quando detecta um conflito de nome. Por exemplo, “Contratos” se torna “Contratos 2025-03-21.” Isso acontece quando a ferramenta está configurada para criar uma nova pasta para cada passagem de migração em vez de mesclar. Para corrigir, exclua a pasta duplicada e execute a migração novamente com a opção de mesclagem ativada. Se a duplicata contiver arquivos que não estavam na pasta original, mova esses arquivos para a pasta original antes de excluir a duplicata.

Pasta criada sob um caminho pai diferente

A ferramenta de migração coloca uma pasta na raiz da biblioteca em vez de dentro da pasta pai correta. Isso ocorre quando o mapeamento do caminho de origem está incorreto. Por exemplo, a pasta de origem “\servidor\compartilhamento\Financeiro\Relatorios” mapeia para a raiz da biblioteca de destino, criando uma pasta “Relatorios” lá em vez de dentro da pasta “Financeiro” existente. Para corrigir, exclua a pasta mal colocada e reconfigure o mapeamento de caminho de origem para destino. Na ferramenta de migração, especifique o caminho exato da pasta de destino, como “https://tenant.sharepoint.com/sites/site/Shared%20Documents/Financeiro.”

Nome da pasta com espaços à direita ou caracteres especiais

Um nome de pasta no compartilhamento de arquivos de origem pode ter um espaço à direita ou um caractere que o SharePoint não suporta, como um e comercial ou um til. A ferramenta de migração pode criar uma pasta no SharePoint com o caractere não suportado removido ou substituído, enquanto também cria uma segunda pasta com o nome original. Para corrigir, renomeie a pasta de origem para remover espaços à direita e substitua caracteres não suportados por hífens ou sublinhados antes de executar a migração. Os caracteres suportados pelo SharePoint incluem letras, números, espaços, hífens, sublinhados, pontos e parênteses.

Item	Ferramenta de Migração do SharePoint	ShareGate	Metalogix
Mesclar pastas com o mesmo nome	Configurações > Preservar estrutura de pastas + Mesclar pastas	Opções de destino > Mesclar	Mesclar pasta de destino com origem
Detecção de pastas sensível a maiúsculas/minúsculas	Trata como insensível	Trata como insensível	Trata como sensível (requer correção manual)
Suporte a mesclagem incremental	Sim, quando a mesclagem está ativada	Sim, quando a mesclagem está selecionada	Sim, quando a mesclagem está ativada
Tratamento de conflito de nome de pasta	Cria pasta com sufixo	Cria pasta com sufixo	Cria pasta com sufixo

Pastas duplicadas no SharePoint após uma migração de compartilhamento de arquivos são evitáveis. Examinando a origem em busca de conflitos de nomenclatura, ativando a mesclagem de pastas na ferramenta de migração e usando uma única passagem inicial, você pode manter sua biblioteca de destino limpa. Se aparecerem duplicatas, verifique o mapeamento do caminho da pasta e exclua as pastas extras após mover seu conteúdo. Para migrações contínuas, sempre ative a mesclagem incremental para evitar que novas passagens criem estruturas de pastas separadas.