Link de Pessoa Específica Quebra Após Renomear Usuário: Causa e Solução

Quando um usuário altera seu nome de exibição no Microsoft 365, qualquer link de Pessoa Específica criado em uma biblioteca de documentos do SharePoint é quebrado. O link não resolve mais para a pessoa pretendida e os usuários veem um erro ou um nome irresolvível em vez de um contato clicável. Isso acontece porque o SharePoint armazena o endereço de email ou o nome principal do usuário (UPN) nos metadados do link, mas o identificador subjacente do link não é atualizado quando o nome do usuário muda. Este artigo explica por que o link quebra e fornece as etapas exatas para corrigir os links quebrados e evitar que o problema ocorra novamente.

Por que Renomear um Usuário Quebra os Links de Pessoa Específica

Quando você cria um link de Pessoa Específica em uma biblioteca de documentos do SharePoint, o SharePoint armazena uma referência ao usuário. Essa referência não é o nome de exibição do usuário. Em vez disso, o SharePoint armazena o endereço de email ou UPN do usuário nos metadados subjacentes do link. O link exibe o nome de exibição atual do usuário no momento da criação, mas o valor real que faz o link funcionar é o email ou UPN.

Quando um administrador renomeia um usuário no Microsoft 365, o nome de exibição do usuário muda. No entanto, o endereço de email e o UPN geralmente permanecem os mesmos ou são atualizados separadamente. Se o email ou UPN mudar como parte da renomeação, a referência armazenada no link do SharePoint se torna obsoleta. O link ainda aponta para o email ou UPN antigo, que não resolve mais para um usuário válido. Como resultado, o link quebra e exibe o nome irresolvível ou um erro.

Outro cenário é quando o ID do objeto do usuário muda, como quando um usuário é excluído e recriado com o mesmo nome. O SharePoint armazena o ID do objeto para colunas Pessoa. Se o ID do objeto mudar, o link não consegue encontrar o usuário. Isso é menos comum, mas acontece em ambientes que limpam e recriam contas de usuário com frequência.

O Papel do Tipo de Coluna Pessoa

As colunas Pessoa do SharePoint armazenam um identificador de usuário. O identificador pode ser o endereço de email, UPN ou ID do objeto do Active Directory. A coluna exibe o nome de exibição, mas o valor subjacente é o identificador. Quando você renomeia um usuário, o nome de exibição é atualizado em todos os lugares do SharePoint, exceto nos metadados do link de Pessoa Específica. O link retém o identificador antigo. Se o identificador for o endereço de email e o endereço de email mudar, o link quebra. Se o identificador for o UPN e o UPN mudar, o link quebra. Se o identificador for o ID do objeto e o usuário for recriado, o link quebra.

Etapas para Corrigir Links de Pessoa Específica Quebrados

Para corrigir um link de Pessoa Específica quebrado, você deve atualizar o identificador de usuário subjacente armazenado na coluna Pessoa. O método depende se o endereço de email ou UPN do usuário mudou.

1. Identifique o link quebrado
   Abra a biblioteca de documentos do SharePoint que contém o link quebrado. Clique no link. Se o link mostrar um nome irresolvível ou um erro, o identificador do usuário está obsoleto. Anote o nome de exibição atual mostrado no link.
2. Encontre o novo email e UPN do usuário
   Vá para o centro de administração do Microsoft 365 em admin.microsoft.com. Selecione Usuários > Usuários ativos. Encontre o usuário renomeado. Copie o novo endereço de email e UPN do perfil do usuário.
3. Atualize o valor da coluna Pessoa no SharePoint
   Use o PowerShell do SharePoint para atualizar a coluna Pessoa. Abra o PowerShell e conecte-se ao SharePoint usando Connect-PnPOnline -Url "https://sualocacao.sharepoint.com/sites/seustie" -Interactive. Em seguida, execute: Set-PnPListItem -List "Documentos" -Identity 1 -Values @{"ColunaPessoa" = "usuario@novodominio.com"} Substitua 1 pelo ID do item, Documentos pelo nome da sua biblioteca e ColunaPessoa pelo nome real da coluna. Isso sobrescreve o identificador obsoleto com o novo email.
4. Verifique se o link funciona
   Atualize a página da biblioteca de documentos. Clique no link. Agora ele deve exibir o novo nome de exibição do usuário e resolver corretamente. Se o link ainda mostrar um erro, repita a etapa 3 usando o UPN em vez do email.
5. Atualize todos os links para o mesmo usuário
   Se o usuário aparecer em vários links no site, execute o comando PowerShell para cada item. Para encontrar todos os itens que referenciam o usuário antigo, use: Get-PnPListItem -List "Documentos" | Where-Object { $_.FieldValues.ColunaPessoa -match "dominioantigo.com" } Em seguida, atualize cada item.

Método Alternativo: Editar o Valor da Coluna no Navegador

Se você tiver apenas um ou dois links quebrados, pode atualizá-los diretamente no navegador. Abra a biblioteca de documentos. Selecione o item que contém o link quebrado. Clique nos três pontos (reticências) e selecione Detalhes. No painel de detalhes, encontre a coluna Pessoa. Limpe o valor existente e digite o novo nome do usuário. O SharePoint resolverá o novo nome e armazenará o identificador correto. Salve as alterações.

Se o Link Ainda Não Funcionar Após a Atualização

O usuário foi excluído e recriado

Se a conta do usuário foi excluída e recriada com o mesmo nome de exibição e email, o ID do objeto é diferente. O SharePoint armazena o ID do objeto na coluna Pessoa. O link não consegue resolver o ID do objeto antigo. Para corrigir isso, remova o valor antigo da coluna Pessoa e adicione o usuário novamente. Use o método do navegador descrito acima. O link armazenará o novo ID do objeto.

A coluna Pessoa é somente leitura

Algumas colunas Pessoa são configuradas como somente leitura nas configurações da biblioteca. Você não pode atualizá-las pelo navegador. Use o PowerShell com o parâmetro -SystemUpdate para contornar as restrições de somente leitura: Set-PnPListItem -List "Documentos" -Identity 1 -Values @{"ColunaPessoa" = "usuario@novodominio.com"} -SystemUpdate

O link está em um ambiente do SharePoint Server local

O SharePoint Server local armazena usuários pelo identificador de segurança (SID) do Active Directory. Se o usuário for renomeado, mas não recriado, o SID permanece o mesmo. O link deve continuar funcionando. Se o link quebrar, execute uma sincronização incremental do perfil do usuário na Administração Central do SharePoint. Isso atualiza o nome de exibição e resolve o link.

Comportamento do Link de Pessoa Específica: Original vs Após Renomeação

Item	Link Original	Após Renomeação
Nome de exibição mostrado	Nome de exibição antigo	Irresolvível ou em branco
Identificador subjacente	Email ou UPN antigo	Identificador obsoleto
Comportamento ao clicar	Abre cartão de contato	Erro ou nenhuma ação
Método de correção	Não aplicável	Atualizar valor da coluna com novo identificador

Após corrigir o link, o nome de exibição mostra o novo nome do usuário e o link abre o cartão de contato correto. O identificador subjacente agora corresponde à conta de usuário atual.

Para evitar esse problema, use uma coluna Pessoa com validação de coluna que armazene o endereço de email. Quando um usuário for renomeado, atualize o email no Microsoft 365 e o link continuará funcionando porque o endereço de email permanece o mesmo. Alternativamente, evite renomear usuários que são referenciados em links de Pessoa Específica. Se a renomeação for necessária, planeje atualizar todos os links imediatamente após a alteração.