Arquivos Migrados Perdem Metadados de Criado Por: Causa e Solução

Quando você migra arquivos para o SharePoint, a coluna Criado Por frequentemente exibe a conta de migração em vez do autor original. Isso acontece porque a ferramenta de migração não preserva a identidade do autor original por padrão. A coluna Modificado Por também pode mostrar a data da migração em vez da data de modificação original. Este artigo explica por que essa perda de metadados ocorre e fornece dois métodos confiáveis para preservar as informações de autor e data original durante a migração.

Por Que Arquivos Migrados Perdem o Metadado Original de Criado Por

Quando você migra arquivos de um compartilhamento de arquivos local, um serviço de nuvem de terceiros ou outro ambiente SharePoint, o sistema de destino atribui a conta de migração como o criador. A causa subjacente é que o SharePoint trata o processo de migração como um novo evento de criação de arquivo. O conteúdo e a estrutura do arquivo são copiados, mas os campos de metadados Criado Por, Data de Criação, Modificado Por e Data de Modificação são sobrescritos com o usuário atual e valores de timestamp. Isso acontece porque a API do SharePoint não permite definir esses campos de sistema diretamente por meio de operações de upload padrão. A maioria das ferramentas de migração, incluindo a Ferramenta de Migração do SharePoint (SPMT), exige configuração explícita para preservar esses metadados. Sem essa configuração, a identidade do autor original é perdida.

Como o SharePoint Armazena Criado Por e Modificado Por

O SharePoint armazena Criado Por e Modificado Por nos campos Author e Editor do item de lista. Esses campos são somente leitura para a maioria dos usuários e só podem ser modificados por meio do modelo de objeto ou por uma conta com permissões elevadas. Quando um arquivo é carregado ou migrado, o SharePoint define esses campos para a conta que está realizando a ação. A única maneira de reter os valores originais é usar um método que escreva diretamente nesses campos durante ou após a migração.

Passos para Preservar Criado Por e Modificado Por Durante a Migração

Você tem duas abordagens principais: configurar o mapeamento de usuários na ferramenta de migração antes da migração ou usar PowerShell para corrigir os metadados após a migração. O primeiro método é mais limpo e exige menos esforço. O segundo método é uma alternativa caso você já tenha concluído a migração sem preservar os metadados.

Método 1: Usar a Ferramenta de Migração do SharePoint com Mapeamento de Usuários

1. Baixar e instalar a Ferramenta de Migração do SharePoint
   Acesse a central de administração do Microsoft 365 e baixe o SPMT. Instale-o em uma máquina com acesso tanto aos arquivos de origem quanto ao site SharePoint de destino.
2. Criar um novo trabalho de migração
   Abra o SPMT e selecione Iniciar sua primeira migração. Escolha Compartilhamentos de arquivos ou o tipo de origem apropriado. Insira o caminho de origem e a URL do site SharePoint de destino.
3. Habilitar o mapeamento de usuários
   Nas configurações de migração, role até Mapeamento de usuários. Selecione Mapear usuários. Baixe o arquivo CSV de modelo de mapeamento de usuários. Abra o CSV no Excel. Na primeira coluna, insira o nome principal do usuário (UPN) de origem. Na segunda coluna, insira o UPN de destino. Por exemplo: olddomain\jsmith mapeia para jsmith@contoso.com. Salve o CSV e faça upload de volta no SPMT.
4. Configurar a preservação de data
   Na mesma área de configurações, expanda Configurações avançadas. Marque a caixa Preservar datas de criação e modificação de arquivos. Isso instrui o SPMT a escrever os timestamps originais nos campos Criado e Modificado.
5. Executar a migração
   Clique em Iniciar. Monitore o progresso. Após a conclusão, verifique se a coluna Criado Por exibe o autor original e a coluna Data de Criação exibe o timestamp original.

Método 2: Corrigir Metadados Após a Migração Usando PowerShell

Se você já migrou arquivos e os metadados estão incorretos, use o PnP PowerShell para atualizar os campos Author e Editor. Este método requer a função de Administrador do SharePoint ou permissões de proprietário do conjunto de sites.

1. Instalar o módulo PnP PowerShell
   Abra o Windows PowerShell como administrador. Execute Install-Module PnP.PowerShell -Scope CurrentUser. Pressione Y para confirmar a instalação.
2. Conectar ao seu site do SharePoint
   Execute Connect-PnPOnline -Url https://contoso.sharepoint.com/sites/seosite -Interactive. Faça login com uma conta que tenha permissões de administrador do conjunto de sites.
3. Obter o usuário de destino
   Execute $user = Get-PnPUser -Identity "autororiginal@contoso.com". Isso recupera o objeto de usuário para a pessoa que deve ser o autor original.
4. Atualizar o campo Author em um arquivo específico
   Execute Set-PnPListItem -List "Documentos" -Identity 1 -Values @{"Author" = $user.Id; "Editor" = $user.Id} -UpdateType UpdateOverwriteVersion. Substitua 1 pelo ID do item de lista do arquivo. O parâmetro UpdateOverwriteVersion escreve diretamente na versão atual sem criar uma nova entrada de versão, o que preserva o autor original no histórico de versões.
5. Atualizar vários arquivos usando um CSV
   Crie um arquivo CSV com as colunas ItemID, AuthorEmail e EditorEmail. Execute um loop: Import-Csv "C:\metadados.csv" | ForEach-Object { $author = Get-PnPUser -Identity $_.AuthorEmail; $editor = Get-PnPUser -Identity $_.EditorEmail; Set-PnPListItem -List "Documentos" -Identity $_.ItemID -Values @{"Author" = $author.Id; "Editor" = $editor.Id} -UpdateType UpdateOverwriteVersion }.

Problemas Comuns Quando os Metadados Não São Preservados

A Ferramenta de Migração Mostra Mapeamento de Usuários, Mas Criado Por Ainda Exibe a Conta de Migração

Isso geralmente significa que o arquivo CSV de mapeamento de usuários não foi carregado corretamente ou os nomes de usuário de origem não correspondem. Verifique se o UPN de origem no CSV corresponde exatamente ao que aparece no sistema de arquivos de origem. Para compartilhamentos de arquivos, a identidade de origem é tipicamente o nome de login do Windows do usuário no formato DOMINIO\nomeusuario. Se o CSV estiver correto, execute novamente o trabalho de migração com a opção Sobrescrever habilitada.

O Script PowerShell Retorna Erro de Permissão Negada

A conta que executa os comandos PowerShell deve ter permissões de administrador do conjunto de sites. Se você estiver usando uma conta de administrador de locatário, ainda precisará conceder acesso explícito de administrador do conjunto de sites. Vá para a central de administração do SharePoint > Sites ativos > selecione o site > Membros > Administradores do site > Adicione sua conta. Aguarde 10 minutos para as permissões serem propagadas e execute o script novamente.

O Histórico de Versões Mostra a Conta de Migração como Criador Mesmo Após a Atualização

O parâmetro UpdateOverwriteVersion atualiza os metadados da versão atual, mas não altera retroativamente as versões anteriores. Se você precisar corrigir todas as versões, deve excluir ou sobrescrever todo o histórico de versões. Isso não é recomendado por questões de conformidade. Em vez disso, aceite que apenas a versão atual exibe o autor correto. Edições futuras preservarão os metadados corrigidos.

Comparação dos Métodos de Preservação de Metadados

Item	SPMT com Mapeamento de Usuários	PowerShell Após a Migração
Quando usar	Antes do início da migração	Após a conclusão da migração
Esforço	Baixo — configure uma vez na ferramenta	Médio — requer script por arquivo
Preserva Criado Por	Sim, quando o mapeamento de usuários está correto	Sim, apenas para a versão atual
Preserva Data de Criação	Sim, quando a preservação de data está habilitada	Não — campos de data são somente leitura após a criação
Permissões necessárias	Membro do site com direitos de contribuição	Administrador do conjunto de sites
Suporta operações em lote	Sim, por padrão	Sim, com importação de CSV

Arquivos migrados perdem os metadados originais de Criado Por porque o SharePoint trata cada upload como um novo evento de criação. Para evitar isso, use o SPMT com mapeamento de usuários e preservação de data habilitados antes de executar a migração. Se a migração já estiver concluída, use o PnP PowerShell com o parâmetro UpdateOverwriteVersion para corrigir os campos Author e Editor na versão atual. Para migrações futuras, sempre teste um lote pequeno primeiro e verifique os metadados na biblioteca de destino antes de escalar. Considere usar a Ferramenta de Avaliação de Migração do SharePoint para identificar todos os arquivos que precisam de correção de metadados.