Ao migrar arquivos para o OneDrive for Business, alguns podem falhar no upload com erro relacionado a metadados não suportados. Isso ocorre quando os arquivos contêm conjuntos de propriedades personalizadas, atributos estendidos ou fluxos de dados alternativos do NTFS que o OneDrive não reconhece. Este artigo explica quais metadados o OneDrive bloqueia, por que causam falhas na migração e como removê-los ou contorná-los para que sua migração seja concluída com sucesso.
Principais conclusões: corrigindo falhas de migração do OneDrive causadas por metadados não suportados
- Windows File Explorer > Propriedades do arquivo > Detalhes > Remover Propriedades: Use esta ferramenta nativa para remover metadados personalizados (tags, comentários, autores) de arquivos ou pastas individuais.
- Cmdlet Remove-Item do PowerShell em fluxos de dados alternativos: Execute
Remove-Item -Path \"arquivo:Zone.Identifier\"para excluir entradas ADS que o OneDrive bloqueia. - Central de administração do OneDrive > Sincronizar > Tipos de arquivo permitidos: Configure configurações de locatário para bloquear extensões de arquivo específicas ou formatos com muitos metadados antes do início da migração.
Por que o OneDrive bloqueia arquivos com metadados não suportados
O OneDrive for Business armazena arquivos no SharePoint Online, que impõe limites rigorosos de metadados. Arquivos que contêm propriedades de documento personalizadas, atributos estendidos ou fluxos de dados alternativos do NTFS geralmente disparam falhas de upload. A causa raiz é que o SharePoint Online não consegue indexar ou armazenar metadados que estão fora dos conjuntos de propriedades padrão do Office Open XML ou do sistema de arquivos básico. Os culpados comuns incluem arquivos migrados de farms do SharePoint locais, sistemas legados de gerenciamento de documentos ou aplicativos que incorporam esquemas de propriedades personalizadas em documentos do Office. O OneDrive retorna códigos de erro como 0x80070057, 0x80004005 ou uma mensagem genérica “O arquivo contém metadados não suportados” quando encontra esses arquivos.
Quais tipos de metadados não são suportados
O OneDrive bloqueia três categorias de metadados:
- Propriedades de documento personalizadas: Propriedades adicionadas via Arquivo > Informações > Propriedades > Propriedades Avançadas em aplicativos do Office. Exemplos incluem campos personalizados como “Código do Projeto” ou “ID do Departamento” que não fazem parte do conjunto de propriedades internas.
- Fluxos de dados alternativos do NTFS: Fluxos ocultos anexados a arquivos, geralmente criados por downloads da web (Zone.Identifier), ferramentas antivírus ou software de backup. O OneDrive não consegue processar esses fluxos.
- Atributos estendidos de arquivo: Atributos definidos por sistemas de gerenciamento de arquivos de terceiros, incluindo tags personalizadas, classificações ou comentários armazenados fora do conjunto de atributos NTFS padrão.
Etapas para identificar e remover metadados não suportados antes da migração
Siga estas etapas para verificar e limpar arquivos antes de migrá-los para o OneDrive. Execute estas etapas em uma cópia dos dados de origem para evitar perda de dados.
- Abra as propriedades do arquivo no Windows Explorer
Clique com o botão direito em um arquivo que falhou na migração e selecione Propriedades. Vá para a guia Detalhes. Revise a lista de propriedades. Qualquer propriedade com valor em “Personalizado” ou “Outro” pode não ser suportada. Clique em Remover Propriedades para remover metadados personalizados. - Use o PowerShell para listar fluxos de dados alternativos
Abra o PowerShell como Administrador. ExecuteGet-Item -Path "C:\caminho\para\arquivo.docx" -Stream *para listar todas as entradas ADS. Se a saída incluir fluxos como:Zone.Identifierou:Oplock, eles não são suportados. Remova-os comRemove-Item -Path "C:\caminho\para\arquivo.docx:Zone.Identifier". - Remova propriedades personalizadas de vários arquivos
Use a bibliotecaDocumentFormat.OpenXmlno PowerShell para remover propriedades personalizadas de arquivos do Office. Exemplo de script:$doc = Open-XmlPackage -Path "arquivo.docx"; $doc.DeletePart("CustomFilePropertiesPart"); $doc.Save(). Isso remove todos os conjuntos de propriedades personalizadas. - Execute a ferramenta de pré-verificação de migração do OneDrive
Baixe a Ferramenta de Migração do SharePoint no centro de administração do Microsoft 365. Execute a verificação prévia na pasta de origem. A ferramenta lista arquivos com metadados não suportados e fornece um relatório. Revise o relatório e limpe os arquivos sinalizados usando as etapas acima. - Repita a migração
Após a limpeza, faça o upload dos arquivos novamente usando a Ferramenta de Migração do SharePoint ou o cliente de sincronização do OneDrive. Monitore o painel de migração em busca de erros. Se o mesmo arquivo falhar, inspecione-o novamente com o comando de listagem de fluxos do PowerShell.
Se a migração do OneDrive ainda falhar após a limpeza dos metadados
O cliente de sincronização do OneDrive mostra “Processando alterações” indefinidamente
Isso pode acontecer quando um arquivo possui um ADS oculto que o cmdlet Remove-Item não excluiu. Execute Get-Item -Path "arquivo.docx" -Stream * novamente. Se ainda houver fluxos, exclua cada um individualmente. Em seguida, reinicie o cliente de sincronização do OneDrive clicando com o botão direito no ícone do OneDrive na bandeja do sistema e selecionando Pausar sincronização e depois Retomar sincronização.
A Ferramenta de Migração do SharePoint relata “Limite de metadados excedido”
O SharePoint Online tem um limite de 30.000 caracteres para metadados combinados por arquivo. Arquivos com muitas propriedades personalizadas ou valores de texto longos podem exceder esse limite. Abra o arquivo no aplicativo Office nativo. Vá para Arquivo > Informações > Propriedades > Propriedades Avançadas. Exclua quaisquer propriedades personalizadas com valores de texto grandes. Salve e faça o upload novamente.
Arquivos migram, mas metadados estão ausentes
O OneDrive não preserva propriedades personalizadas que não são suportadas. Após a migração, verifique se as propriedades internas como Título, Autor e Última modificação estão intactas. Se as propriedades personalizadas forem críticas, considere armazená-las em colunas do SharePoint em vez de metadados de arquivo. Crie uma biblioteca de documentos do SharePoint com colunas personalizadas e mapeie os valores durante a migração usando o recurso de mapeamento de colunas da Ferramenta de Migração do SharePoint.
Metadados internos vs propriedades personalizadas: o que o OneDrive preserva
| Item | Metadados internos (preservados) | Propriedades personalizadas (não preservadas) |
|---|---|---|
| Descrição | Propriedades padrão do Office: Título, Autor, Assunto, Palavras-chave, Comentários, Último salvamento por | Campos definidos pelo usuário adicionados via Propriedades Avançadas em aplicativos do Office |
| Método de armazenamento | Armazenado no pacote Office Open XML (docProps/core.xml) | Armazenado em uma parte XML personalizada separada (docProps/custom.xml) |
| Comportamento do OneDrive | Indexado e pesquisável no SharePoint Online | Bloqueado durante o upload; arquivo falha com erro |
| Manipulação pela ferramenta de migração | Preservado automaticamente | Deve ser removido ou mapeado para colunas do SharePoint antes da migração |
O OneDrive for Business preserva todas as propriedades de documento internas definidas pelo padrão Office Open XML. Propriedades personalizadas que não fazem parte desse padrão são rejeitadas. Se você precisar de metadados personalizados, crie colunas do SharePoint na biblioteca de documentos de destino e mapeie os valores durante a migração. Essa abordagem evita falhas de upload e mantém seus metadados acessíveis.