Restaurar Herança de Permissões sem Perder Proprietários: Guia do SharePoint

Quando um site, biblioteca ou lista do SharePoint quebra a herança de permissões e você a restaura posteriormente, a ação padrão remove todas as permissões exclusivas, incluindo as atribuídas aos proprietários do site. Isso pode deixar os proprietários sem acesso se eles foram adicionados apenas por meio de permissões exclusivas. Este artigo explica por que isso acontece e fornece as etapas exatas para restaurar a herança preservando o acesso dos proprietários. Você aprenderá a usar o PowerShell e a Central de Administração do SharePoint para manter os proprietários do site no lugar.

Por que Restaurar a Herança Remove os Proprietários

Quando um site do SharePoint herda permissões do pai, ele usa o conjunto de permissões do pai. Se você quebrar a herança, o site obtém seu próprio conjunto de permissões exclusivas. Restaurar a herança remove o conjunto de permissões exclusivas e força o site a usar novamente as permissões do pai. Quaisquer usuários ou grupos que foram adicionados apenas no nível do site por meio de permissões exclusivas são removidos. Isso inclui os proprietários do site se eles não estavam no conjunto de permissões do pai.

A causa raiz é que o SharePoint trata a operação de restauração como uma reinicialização completa. Ele não mescla permissões exclusivas no conjunto pai. Ele simplesmente exclui o conjunto exclusivo. Se você tiver proprietários de site que foram adicionados após a quebra da herança, eles perdem o acesso quando a herança é restaurada.

O Papel do Administrador Principal da Coleção de Sites

O administrador principal da coleção de sites sempre pode acessar o site, mesmo após a restauração da herança. Esse usuário é armazenado no nível da coleção de sites, não no conjunto de permissões. Se você é o administrador principal, não perderá o acesso. Mas quaisquer proprietários adicionais adicionados por meio de permissões exclusivas serão removidos.

O que Acontece com os Grupos do SharePoint

Grupos do SharePoint como Membros e Visitantes também são afetados. Se você adicionou grupos personalizados ou alterou a associação do grupo após quebrar a herança, essas alterações são perdidas. O site reverte para os grupos e associações padrão do pai.

Etapas para Restaurar a Herança Mantendo os Proprietários

Siga estas etapas em ordem. Você precisará de permissões de administrador do SharePoint e do SharePoint Online Management Shell instalado.

1. Verifique a herança de permissões atual
   Vá para a Central de Administração do SharePoint. Selecione Sites ativos. Encontre o site que deseja modificar. Clique no nome do site para abrir o painel de detalhes. Em Permissões, procure por Herança de permissões. Se disser Permissões exclusivas, a herança está quebrada. Anote os proprietários atuais na seção Proprietários do site.
2. Faça backup das permissões exclusivas atuais
   Abra o SharePoint Online Management Shell como administrador. Execute Connect-SPOService -Url https://[tenant]-admin.sharepoint.com. Substitua [tenant] pelo nome do seu locatário. Em seguida, execute Get-SPOSite -Identity https://[tenant].sharepoint.com/sites/[sitename] | Select -ExpandProperty Owner para ver o proprietário principal. Para uma lista completa de proprietários, use o cmdlet PnP PowerShell: Connect-PnPOnline -Url https://[tenant].sharepoint.com/sites/[sitename] -Interactive. Em seguida, execute Get-PnPWebPermission -Identity $web para listar todas as permissões exclusivas. Salve a saída em um arquivo de texto.
3. Desative temporariamente a configuração Negar adicionar e personalizar páginas
   Alguns sites bloqueiam alterações de permissão por meio da configuração DenyAddAndCustomizePages. Execute Set-SPOSite -Identity https://[tenant].sharepoint.com/sites/[sitename] -DenyAddAndCustomizePages 0 para permitir modificações de permissão. Você pode reativar isso após a restauração.
4. Restaure a herança usando o navegador
   Vá para o site onde a herança está quebrada. Navegue até Configurações (ícone de engrenagem) > Permissões do site. Clique em Excluir permissões exclusivas. Confirme a ação. Isso restaura a herança. O site agora usa as permissões do pai. Todas as permissões exclusivas são removidas.
5. Adicione os proprietários de volta usando PowerShell
   Após restaurar a herança, apenas os proprietários do site pai têm acesso de proprietário. Para adicionar os proprietários originais de volta, use o PnP PowerShell. Execute Connect-PnPOnline -Url https://[tenant].sharepoint.com/sites/[sitename] -Interactive. Em seguida, execute Set-PnPWebPermission -User 'usuario@dominio.com' -AddRole 'Full Control' para cada proprietário que você precisa restaurar. Substitua usuario@dominio.com pelo e-mail real. A função Full Control fornece acesso de nível de proprietário. Repita para cada proprietário.
6. Reative a configuração Negar adicionar e personalizar páginas
   Execute Set-SPOSite -Identity https://[tenant].sharepoint.com/sites/[sitename] -DenyAddAndCustomizePages 1 para reativar a configuração. Isso evita alterações não intencionais de permissão.
7. Verifique as permissões
   Vá para o site. Clique em Configurações > Permissões do site. Confirme se a herança mostra Herdado. Verifique a seção Proprietários do site para garantir que os proprietários restaurados apareçam. Teste o acesso entrando como um dos proprietários restaurados.

Se o SharePoint Ainda Tiver Problemas Após a Correção Principal

Proprietários Restaurados Não Conseguem Acessar o Site Imediatamente

Se um proprietário restaurado ainda vir um erro de permissão negada, aguarde 15 minutos para que as alterações de permissão se propaguem pelo SharePoint. Se o problema persistir, verifique se o usuário foi adicionado à coleção de sites e não apenas ao site pai. Execute Get-PnPSiteCollectionAdmin no PnP PowerShell para ver os administradores da coleção de sites. Adicione o usuário como administrador da coleção de sites, se necessário: Set-PnPSiteCollectionAdmin -Owners 'usuario@dominio.com'.

Heranca Reverte para Exclusiva Após Adicionar Proprietários

Se, após adicionar proprietários, o site mostrar permissões exclusivas novamente, você provavelmente usou o botão Compartilhar ou as Configurações avançadas de permissões incorretamente. O botão Compartilhar pode quebrar a herança se o usuário não estiver no conjunto de permissões do pai. Sempre use o PowerShell para adicionar proprietários após restaurar a herança. O cmdlet Set-PnPWebPermission adiciona o usuário ao conjunto de permissões herdadas sem quebrar a herança.

Conexão PowerShell Falha

Se Connect-PnPOnline falhar, certifique-se de ter o módulo PnP PowerShell mais recente. Execute Install-Module PnP.PowerShell -Force em uma janela do PowerShell elevada. Se ainda receber erros, verifique se sua conta tem permissões de administrador do SharePoint ou administrador global. Você também pode usar Connect-PnPOnline -Url $url -UseWebLogin para autenticar através do navegador.

Item	Antes da Restauração	Após Restauração (Sem Este Guia)	Após Restauração (Com Este Guia)
Herança de permissões	Exclusiva	Herdada	Herdada
Proprietários do site de permissões exclusivas	Presentes	Removidos	Restaurados via PowerShell
Administrador principal da coleção de sites	Presente	Presente	Presente
Grupos personalizados do SharePoint	Presentes	Removidos	Removidos (devem ser recriados)
Acesso para proprietários restaurados	Acesso total	Sem acesso	Acesso total

Restaurar a herança de permissões não precisa remover seus proprietários de site. Seguindo as etapas deste guia, você pode usar o PowerShell para readicionar os proprietários após a restauração sem quebrar a herança novamente. Comece fazendo backup das permissões atuais. Em seguida, use o navegador para restaurar a herança e o PowerShell para adicionar os proprietários de volta. Sempre verifique o acesso após o processo. Para sites com muitas permissões personalizadas, considere documentar o conjunto de permissões exclusivas antes de fazer qualquer alteração.