Como Corrigir Arquivos Migrados que Perdem o Metadado Criado Por

Ao migrar arquivos para o SharePoint, o campo Criado Por frequentemente exibe a conta de migração em vez do autor original. Isso acontece porque o SharePoint registra a conta que fez o upload como criador. Este artigo explica por que o metadado é perdido e fornece dois métodos para restaurar os valores originais de Criado Por.

Por que Arquivos Migrados Perdem o Metadado Original de Criado Por

O SharePoint armazena o valor de Criado Por no campo Autor de um item de lista ou arquivo de biblioteca. Quando você faz upload de um arquivo pela interface web, pela Ferramenta de Migração do SharePoint ou por uma ferramenta de terceiros, o SharePoint define o Autor como a conta que realizou o upload. A ferramenta de migração não transfere a informação do autor original a menos que você a configure especificamente.

A causa raiz é que o SharePoint trata cada upload de arquivo como um novo evento de criação. Os metadados do sistema de arquivos da origem (como propriedades de arquivo do Windows) não são mapeados para o campo Autor do SharePoint por padrão. A ferramenta de migração lê o arquivo, mas não escreve o autor original na coluna Autor a menos que você habilite uma configuração especial.

Além disso, se você mover arquivos entre bibliotecas do SharePoint usando os comandos Mover Para ou Copiar Para, o campo Criado Por é redefinido para a conta que realizou a movimentação. Isso é proposital para manter uma trilha de auditoria de quem colocou o arquivo no novo local.

Método 1: Configurar a Ferramenta de Migração do SharePoint para Preservar Criado Por

A Ferramenta de Migração do SharePoint (SPMT) pode preservar o valor original de Criado Por se você habilitar a opção correta antes de executar a migração. Este método funciona para migrações do OneDrive e do SharePoint.

1. Abra a Ferramenta de Migração do SharePoint
   Baixe e instale o SPMT do centro de administração do Microsoft 365, se ainda não o fez. Inicie a ferramenta e faça login com uma conta de administrador do SharePoint.
2. Crie uma nova tarefa de migração
   Clique em Iniciar e selecione Compartilhamentos de arquivos ou SharePoint Server como tipo de origem. Insira o caminho de origem e a URL do site de destino do SharePoint.
3. Abra as configurações avançadas
   Na página Escolher configurações, clique em Configurações avançadas para expandir as opções.
4. Habilite Preservar identidade do usuário
   Em Mapeamento de usuário, alterne a opção Preservar identidade do usuário para Ativado. Essa configuração instrui o SPMT a mapear o proprietário original do arquivo para o campo Autor do SharePoint.
5. Execute a migração
   Clique em Iniciar para começar a migração. Após a conclusão, verifique se a coluna Criado Por na biblioteca de destino exibe os nomes dos autores originais.

Se você já migrou arquivos sem essa configuração, não é possível reexecutar a migração para corrigir os metadados. Você deve usar o método PowerShell abaixo.

Método 2: Usar PowerShell para Atualizar o Campo Criado Por

Se a migração estiver concluída e o campo Criado Por estiver incorreto, você pode corrigi-lo com um script PowerShell. Este método requer o módulo SharePoint PnP PowerShell.

1. Instale o módulo PnP PowerShell
   Abra o PowerShell como administrador e execute: Install-Module -Name PnP.PowerShell -Force. Feche e reabra o PowerShell após a instalação.
2. Conecte-se ao seu site do SharePoint
   Execute: Connect-PnPOnline -Url "https://sualocacao.sharepoint.com/sites/seosite" -Interactive. Faça login com uma conta de administrador do SharePoint.
3. Obtenha o item de arquivo atual e o usuário
   Execute os seguintes comandos para armazenar o arquivo e o usuário de destino em variáveis:

   $file = Get-PnPListItem -List "Documentos" -Id 1
   $user = Get-PnPUser -LoginName "usuario@dominio.com"

   Substitua Documentos pelo nome da sua biblioteca, Id 1 pelo ID do item de lista e o nome de login pelo autor original.

4. Defina o campo Autor
   Execute: Set-PnPListItem -List "Documentos" -Identity $file -Values @{"Author" = $user}. Este comando atualiza o campo Criado Por para esse único arquivo.
5. Repita para arquivos adicionais
   Crie um loop para processar vários arquivos. Exemplo:

   $items = Get-PnPListItem -List "Documentos" -PageSize 500
   foreach ($item in $items) {
       $user = Get-PnPUser -LoginName "autororiginal@dominio.com"
       Set-PnPListItem -List "Documentos" -Identity $item -Values @{"Author" = $user}
   }

   Este script atualiza todos os itens da biblioteca para o mesmo autor. Ajuste o nome de login por arquivo, se necessário.

Observe que o campo Autor é somente leitura na interface web do SharePoint. Você não pode editá-lo manualmente nas configurações da lista ou no painel de propriedades do item.

Problemas Comuns ao Restaurar Metadados de Criado Por

Ferramenta de Migração do SharePoint Mostra Preservar Identidade do Usuário como Desabilitado

A opção Preservar identidade do usuário está disponível apenas ao migrar do SharePoint Server ou de compartilhamentos de arquivos. Não está disponível para outros tipos de origem, como Google Drive ou Box. Se a opção estiver desabilitada, você deve usar o método PowerShell para atualizar os metadados após a migração.

PowerShell Retorna um Erro de que o Campo Autor é Inválido

O campo Autor espera um objeto de usuário, não uma string. Sempre use Get-PnPUser para recuperar o objeto de usuário e passe-o para o parâmetro -Values. Se o usuário não existir no site do SharePoint, você deve adicioná-lo primeiro usando Add-PnPUser.

Criado Por é Redefinido Após Mover ou Copiar um Arquivo

Ao mover ou copiar um arquivo dentro do SharePoint, o campo Criado Por muda para a conta que realizou a movimentação. Para preservar o autor original, use o comando Mover para com a opção Manter histórico de versões do arquivo habilitada. Essa opção transfere o campo Autor do local de origem.

Comparação de Métodos de Migração do SharePoint: Preservação de Criado Por

Item	SPMT com Preservar Identidade do Usuário	PowerShell Set-PnPListItem
Descrição	Configuração da ferramenta de migração que mapeia o proprietário original do arquivo para o campo Autor	Script que atualiza o campo Autor para itens existentes
Quando usar	Antes do início da migração	Após a conclusão da migração
Requer permissões de administrador	Sim, administrador do SharePoint	Sim, proprietário ou administrador do site
Suporta operações em lote	Sim, para toda a migração	Sim, com um script de loop
Funciona para todos os tipos de arquivo	Sim	Sim

Agora você pode restaurar os metadados de Criado Por para arquivos migrados habilitando a configuração Preservar identidade do usuário no SPMT antes da migração ou executando um script PowerShell após a migração. Para migrações futuras, sempre habilite a opção Preservar identidade do usuário para evitar o problema completamente. Como dica avançada, use o recurso de ID de Documento do SharePoint para atribuir um ID permanente a cada arquivo, o que ajuda a vincular arquivos aos seus autores originais mesmo após movimentações ou cópias.