Relatório de Migração Mostra Caracteres Não Suportados: Causa e Solução

Ao migrar arquivos para o SharePoint ou OneDrive, o relatório de migração pode exibir itens que falharam devido a caracteres não suportados. Esse erro ocorre porque o SharePoint e o OneDrive não aceitam determinados caracteres em nomes de arquivos ou pastas. Os caracteres incluem ~, #, %, &, *, {, }, \, :, <, >, ?, /, | e ". Este artigo explica por que o erro acontece e fornece etapas claras para corrigir os nomes antes ou depois da migração.

Por que Caracteres Não Suportados Causam Falha na Migração

O SharePoint e o OneDrive usam as regras de nomenclatura do sistema de arquivos Windows, mas adicionam restrições extras. Os seguintes caracteres não são permitidos em nomes de arquivos ou pastas do SharePoint:

• ~ til
• # cerquilha
• % porcentagem
• & e comercial
• * asterisco
• { chave esquerda
• } chave direita
• \ barra invertida
• : dois pontos
• < sinal de menor
• > sinal de maior
• ? ponto de interrogação
• / barra
• | barra vertical
• " aspas duplas

Ao executar uma migração, a Ferramenta de Migração do SharePoint (SPMT) ou qualquer ferramenta de terceiros verifica cada nome de arquivo. Se encontrar algum desses caracteres, registra o arquivo como falha no relatório de migração. A causa raiz é estritamente uma restrição de nomenclatura no SharePoint. A biblioteca de destino não pode criar um arquivo com esses caracteres, então a migração pula ou falha o item.

O relatório de migração normalmente mostra o caminho completo e o caractere específico que causou a falha. Você deve renomear o arquivo ou pasta antes de poder migrá-lo com sucesso.

Etapas para Corrigir Caracteres Não Suportados Antes ou Depois da Migração

Você pode corrigir os nomes dos arquivos antes de iniciar a migração ou depois que o relatório mostrar falhas. Os métodos a seguir funcionam para arquivos locais, unidades de rede locais ou arquivos já preparados em um local temporário.

Método 1: Usar a Pré-Varredoura da Ferramenta de Migração do SharePoint

1. Baixar e abrir o SPMT
   Acesse o centro de administração do Microsoft 365 e baixe a Ferramenta de Migração do SharePoint. Instale e abra no computador que tem acesso aos arquivos de origem.
2. Escolher a origem
   Selecione o local de origem: uma pasta local, um compartilhamento de rede ou um farm do SharePoint on-premises. Insira o caminho da pasta que contém os arquivos que deseja migrar.
3. Executar apenas uma varredura
   Na interface do SPMT, escolha a opção de verificar os arquivos sem migrar. Isso gera um relatório que lista todos os arquivos com caracteres não suportados. O relatório mostra o caminho completo do arquivo e o caractere não permitido.
4. Revisar o relatório de varredura
   Abra o arquivo CSV criado pelo SPMT. Procure a coluna chamada "Problema" ou "MotivoFalha". Cada linha com um caractere não suportado mostrará o caractere específico, por exemplo, "O caractere '#' não é permitido."
5. Renomear os arquivos manualmente ou com um script
   Use o Método 2 ou 3 abaixo para renomear os arquivos listados no relatório de varredura. Após renomear, execute uma nova varredura para confirmar que não há mais problemas.

Método 2: Usar um Script PowerShell para Substituir Caracteres Não Suportados

1. Abrir 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. Definir o caminho da pasta
   Execute este comando para definir a pasta que contém seus arquivos. Substitua C:\ArquivosOrigem pelo seu caminho real.
   $caminho = "C:\ArquivosOrigem"
3. Executar o script de renomeação
   Copie e cole o script a seguir no PowerShell. Ele substitui todos os caracteres não suportados por um sublinhado _.
   Get-ChildItem -Path $caminho -Recurse | Where-Object { $_.Name -match '[~#%&*{}:<>?/|"\\]' } | Rename-Item -NewName { $_.Name -replace '[~#%&*{}:<>?/|"\\]', '_' } -ErrorAction SilentlyContinue
4. Verificar as alterações
   Execute Get-ChildItem -Path $caminho -Recurse | Where-Object { $_.Name -match '[~#%&*{}:<>?/|"\\]' } para confirmar que não restaram caracteres não suportados. A saída deve estar vazia.

Método 3: Renomear Arquivos Manualmente no Explorador de Arquivos

1. Abrir a pasta de origem no Explorador de Arquivos
   Navegue até a pasta que contém os arquivos com caracteres não suportados.
2. Classificar por nome ou data
   Use os cabeçalhos das colunas para classificar os arquivos. Isso ajuda a encontrar os arquivos que o relatório de migração identificou.
3. Clicar com o botão direito e renomear
   Clique com o botão direito no arquivo, selecione Renomear e remova ou substitua o caractere não suportado. Por exemplo, altere Projeto #1.pptx para Projeto 1.pptx.
4. Pressionar Enter para salvar
   Pressione Enter para confirmar o novo nome. Repita para cada arquivo que contenha caracteres não suportados.

Se o Relatório de Migração Ainda Mostrar Falhas Após a Renomeação

Arquivos ainda exibem o mesmo erro

Se você renomear um arquivo, mas o relatório de migração ainda mostrar a mesma falha, verifique se o caminho do arquivo é muito longo. O SharePoint tem um limite de 400 caracteres para o caminho. Mesmo com um nome válido, um caminho longo pode causar falha. Encurte a estrutura de pastas ou mova o arquivo para uma pasta de nível superior.

Caracteres ocultos em nomes de arquivos

Alguns arquivos podem conter caracteres invisíveis, como espaço não separável ou espaço de largura zero. Esses caracteres não aparecem no Explorador de Arquivos, mas ainda causam falhas na migração. Use um editor hexadecimal ou um comando PowerShell como Get-ChildItem | Format-Hex para verificar caracteres ocultos. Substitua-os por um espaço comum.

Arquivos com espaço no início ou no final

O SharePoint remove espaços no início e no final dos nomes de arquivos. Se um nome de arquivo tiver um espaço no início ou no final, a migração pode falhar. Renomeie o arquivo para remover o espaço. Use PowerShell: Get-ChildItem -Path $caminho | Rename-Item -NewName { $_.Name.Trim() }

Comparação de Caracteres Não Suportados: Antes e Depois da Correção

Item	Nome Original (Falha)	Nome Corrigido (Sucesso)
Arquivo com til	Rascunho~1.docx	Rascunho_1.docx
Arquivo com cerquilha	Projeto #1.pptx	Projeto 1.pptx
Arquivo com dois pontos	Notas: 2024.txt	Notas 2024.txt
Arquivo com ponto de interrogação	O que?.pdf	O que.pdf
Arquivo com asterisco	Final * Rascunho.xlsx	Final Rascunho.xlsx

Agora você pode identificar e corrigir caracteres não suportados em seus arquivos de origem da migração. Use a pré-varredura do SPMT para encontrar todos os caracteres problemáticos antes de iniciar a migração principal. Para correções em lote, execute o script PowerShell para substituir todos os caracteres não suportados por sublinhados em uma única passada. Após renomear, execute uma segunda varredura para confirmar zero falhas. Essa abordagem economiza tempo e evita tentativas repetidas de migração.