Como Corrigir Links de Pessoas Específicas Quebrados Após Renomeação de Usuário

Quando um usuário da sua organização altera seu nome de exibição ou endereço de email, os links existentes de “Pessoas Específicas” no SharePoint podem parar de funcionar. Esses links são usados para conceder acesso a uma pessoa ou grupo específico em um site, lista ou biblioteca. A causa é que o SharePoint armazena a identidade do usuário como uma declaração que referencia a conta antiga, e o link não é atualizado automaticamente após a renomeação. Este artigo explica por que a quebra ocorre e fornece métodos passo a passo para corrigir os links quebrados usando ferramentas de administração do SharePoint e PowerShell.

Por que a Renomeação de Usuário Quebra os Links de Pessoas Específicas

O SharePoint usa um sistema de identidade baseado em declarações. Quando você concede acesso a um link de “Pessoas Específicas”, o SharePoint armazena o identificador único do usuário, que está vinculado à conta do Azure Active Directory. Quando o nome de exibição ou o nome principal do usuário (UPN) muda, a declaração armazenada na entrada de permissão do SharePoint ainda aponta para o valor antigo. Essa incompatibilidade faz com que o link quebre — o usuário vê um erro ou uma página em branco ao tentar acessar o recurso.

A renomeação pode ocorrer por meio do Azure AD, central de administração do Microsoft 365 ou sincronização de diretório local. O ponto principal é que o SharePoint não atualiza automaticamente as entradas de permissão após uma renomeação. O link permanece vinculado à declaração da conta antiga até que alguém o atualize manualmente.

O que Acontece com o Link

Quando você compartilha um arquivo ou pasta usando um link de “Pessoas Específicas”, o SharePoint cria uma entrada de permissão para esse usuário. Após uma renomeação, a nova identidade do usuário existe no Azure AD, mas a entrada de permissão ainda referencia a antiga. O usuário pode ainda ver o item se tiver outras permissões, mas o link específico falha. Em alguns casos, o link pode parecer funcionar por um curto período devido a credenciais em cache, mas eventualmente quebra.

Como Confirmar que o Link Está Quebrado

Para verificar se um link está quebrado, abra o item compartilhado e clique no botão “Compartilhado com”. Se o usuário renomeado não aparecer na lista, ou se o nome dele aparecer como “Usuário Não Encontrado”, o link está quebrado. Você também pode ver um erro “403 Proibido” quando o usuário renomeado tenta acessar o link.

Passos para Corrigir Links de Pessoas Específicas Quebrados

Existem dois métodos principais para corrigir links quebrados: usando a central de administração do SharePoint para sites individuais, ou usando PowerShell para reparos em lote. Ambos os métodos exigem que a nova identidade do usuário renomeado esteja totalmente sincronizada com o SharePoint.

Método 1: Corrigir Links Usando a Central de Administração do SharePoint

1. Abra a central de administração do SharePoint
   Acesse https://admin.microsoft.com e selecione SharePoint na navegação à esquerda. Alternativamente, vá diretamente para https://admin.microsoft.com/SharePoint.
2. Navegue até Sites ativos
   No menu à esquerda, clique em Sites ativos. Encontre o site que contém o link quebrado. Talvez seja necessário pesquisar pelo nome ou URL do site.
3. Abra as permissões do site
   Clique no nome do site para abrir o painel de detalhes. No painel, clique na guia Permissões. Isso mostra todos os usuários e grupos com acesso ao site.
4. Remova a entrada do usuário antigo
   Encontre a identidade antiga do usuário renomeado. Ela pode aparecer com o nome de exibição antigo ou como “Usuário Não Encontrado”. Marque a caixa de seleção ao lado da entrada e clique em Excluir permissões do usuário. Confirme a exclusão.
5. Adicione o usuário renomeado
   Clique em Adicionar pessoas. Digite o novo nome de exibição ou endereço de email do usuário renomeado. Selecione o nível de permissão apropriado (por exemplo, Leitura ou Contribuição). Clique em Adicionar.
6. Recrie o link de Pessoas Específicas
   Navegue até o item que tinha o link quebrado. Use o botão Compartilhar para criar um novo link de “Pessoas Específicas” para o usuário renomeado. Teste o link abrindo-o em uma janela privada do navegador.

Método 2: Corrigir Links Usando o SharePoint Online Management Shell

Se você tiver muitos links quebrados em vários sites, use PowerShell para corrigi-los em lote. Você precisa do SharePoint Online Management Shell e dos nomes principais de usuário (UPN) antigo e novo do usuário renomeado.

1. Instale e conecte-se ao SharePoint Online Management Shell
   Abra o Windows PowerShell como administrador. Execute Install-Module -Name Microsoft.Online.SharePoint.PowerShell se ainda não estiver instalado. Em seguida, execute Connect-SPOService -Url https://-admin.sharepoint.com e faça login com uma conta de administrador global ou administrador do SharePoint.
2. Obtenha a coleção de sites onde o link quebrado existe
   Use Get-SPOSite para listar todas as coleções de sites. Anote a URL do site que contém o link quebrado.
3. Remova as permissões do usuário antigo
   Execute Remove-SPOUser -Site -LoginName . Substitua pela URL do site e pelo nome principal de usuário antigo (por exemplo, nomeantigo@contoso.com). Isso remove todas as entradas de permissão para a identidade antiga.
4. Adicione o usuário renomeado
   Execute Add-SPOUser -Site -LoginName -Group para adicionar o usuário ao grupo apropriado do SharePoint. Se o link foi concedido diretamente ao usuário (não por meio de um grupo), use Set-SPOUser -Site -LoginName -IsSiteCollectionAdmin $true ou atribua um nível de permissão usando Add-SPOUser com o parâmetro -PermissionLevel.
5. Repita para cada site
   Execute os mesmos comandos para cada coleção de sites que tinha um link quebrado. Você pode criar um script lendo um arquivo CSV com URLs de sites e nomes de usuário.

Se os Links de Pessoas Específicas Ainda Tiverem Problemas Após a Correção Principal

Link do SharePoint Ainda Mostra “Usuário Não Encontrado”

Se o link ainda mostrar o usuário antigo depois que você adicionou o usuário renomeado, o cache de permissões do SharePoint pode não ter sido atualizado. Aguarde 15 a 30 minutos e verifique novamente. Se o problema persistir, verifique se a renomeação foi sincronizada com o SharePoint consultando o perfil do usuário na central de administração do SharePoint em Perfis de usuário. Se o perfil ainda mostrar o nome antigo, force uma sincronização de perfil usando PowerShell com Set-SPOUser -Site -LoginName novamente.

Comando PowerShell Falha com “Usuário Não Encontrado”

Esse erro geralmente significa que o nome principal de usuário antigo está incorreto ou o usuário foi excluído em vez de renomeado. Verifique o UPN atual do usuário no Azure AD. Se o usuário foi excluído e recriado, você não pode corrigir o link — você deve criar um novo link para a nova conta de usuário. Se o usuário ainda existir, mas o UPN mudou, use o novo UPN tanto para o comando de remoção quanto para o de adição.

Links Quebrados em Várias Bibliotecas em um Único Site

Quando um usuário recebeu acesso a muitos itens por meio de links de “Pessoas Específicas”, as entradas de permissão são armazenadas no nível do item. Os métodos acima corrigem permissões no nível do site, mas os links no nível do item podem permanecer quebrados. Para corrigir links no nível do item, use o botão Compartilhar em cada item para remover o usuário antigo e adicionar o novo. Para correções em lote no nível do item, use o PnP PowerShell com Get-PnPListItem e Set-PnPListItemPermission para iterar pelos itens e atualizar as permissões.

Correção de Permissão no Nível do Site vs. Nível do Item: Comparação

Item	Correção no Nível do Site	Correção no Nível do Item
Escopo	Remove e re-adiciona o usuário no nível da coleção de sites	Atualiza permissões em arquivos ou pastas individuais
Ferramentas	Central de administração do SharePoint ou SharePoint Online Management Shell	Interface do SharePoint ou PnP PowerShell
Tempo necessário	Minutos por site	Minutos por item; horas para lote
Quando usar	Usuário tinha permissões no nível do site e o link foi concedido por meio de um grupo	Usuário tinha links diretos de “Pessoas Específicas” em muitos itens

A melhor abordagem é primeiro corrigir as permissões no nível do site e depois usar o PnP PowerShell para corrigir os links no nível do item. Isso garante que o usuário renomeado tenha acesso ao site e possa ver os itens, mesmo que os links antigos ainda estejam quebrados.

Após concluir a correção, você pode restaurar o acesso para usuários renomeados sem perder o trabalho que foi compartilhado com eles. Em seguida, revise o processo de renomeação de usuários da sua organização e considere automatizar as atualizações de permissão usando o Azure AD Connect e o provisionamento do SharePoint PnP. Uma dica avançada é executar um script agendado do PowerShell que verifique entradas de permissão com nomes principais de usuário antigos após cada renomeação, evitando quebras de link antes que os usuários as relatem.