Como Corrigir Permissões Exclusivas que Reaparecem Após Redefinir uma Biblioteca

Você redefine uma biblioteca do SharePoint para herdar permissões do site pai, mas a biblioteca exibe permissões exclusivas novamente em minutos ou horas. Esse problema ocorre quando itens na biblioteca, como pastas ou arquivos, têm suas próprias quebras de permissão que não são removidas durante a redefinição. Este artigo explica por que isso acontece e fornece uma correção completa para remover permanentemente as permissões exclusivas de todos os itens da biblioteca.

Por que as Permissões Exclusivas Reaparecem Após Redefinir uma Biblioteca

Quando você redefine uma biblioteca para herdar permissões do site pai, o SharePoint remove a quebra de permissão apenas da raiz da biblioteca. Quaisquer arquivos, pastas ou subpastas dentro da biblioteca que tinham suas próprias permissões exclusivas permanecem quebrados. O SharePoint então relata a biblioteca como tendo permissões exclusivas porque esses itens filhos ainda existem com herança quebrada.

Essa condição ocorre com mais frequência quando usuários ou processos automatizados definiram anteriormente permissões exclusivas em itens individuais. A operação de redefinição da biblioteca não se propaga para objetos filhos. Para resolver completamente, você deve remover as quebras de permissão de todos os itens dentro da biblioteca.

Como Funciona a Herança de Permissões no SharePoint

O SharePoint usa um modelo de permissão hierárquico. A raiz do conjunto de sites tem um conjunto de permissões. Por padrão, cada site, biblioteca, pasta e arquivo herda permissões do nível acima. Quando você quebra a herança em uma biblioteca, pode atribuir permissões exclusivas apenas a essa biblioteca. Se você quebrar a herança em um arquivo dentro da biblioteca, esse arquivo terá suas próprias permissões separadas da biblioteca. Redefinir a biblioteca para herdar do site não corrige automaticamente a herança quebrada naquele arquivo.

Etapas para Remover Permanentemente as Permissões Exclusivas de uma Biblioteca

Para corrigir o problema completamente, você deve remover as quebras de permissão de todos os itens dentro da biblioteca. Use um dos seguintes métodos.

Método 1: Usar PowerShell do SharePoint para Redefinir Todas as Permissões de Itens

1. Instalar e conectar o SharePoint Online Management Shell
   Abra o Windows PowerShell como administrador. Execute Install-Module -Name Microsoft.Online.SharePoint.PowerShell se o módulo não estiver instalado. Em seguida, execute Connect-SPOService -Url https://seutenant-admin.sharepoint.com e faça login com uma conta de administrador do SharePoint.
2. Obter a URL do site e da biblioteca
   Identifique a URL do site (por exemplo, https://seutenant.sharepoint.com/sites/vendas) e o nome da biblioteca (por exemplo, Documentos Compartilhados).
3. Executar o script PowerShell para redefinir todas as permissões de itens
   Cole e execute o script a seguir, substituindo a URL do site e o nome da biblioteca pelos seus próprios valores:
   $siteUrl = "https://seutenant.sharepoint.com/sites/vendas"
$libraryName = "Documentos Compartilhados"
$web = Get-SPOSite $siteUrl | Get-SPOWeb
$list = $web.Lists[$libraryName]
foreach ($item in $list.Items) {
if ($item.HasUniqueRoleAssignments) {
$item.ResetRoleInheritance()
$item.Update()
}
}
Write-Host "Concluído"
4. Verificar o status de herança da biblioteca
   Vá para a biblioteca no SharePoint. Clique no ícone de engrenagem e selecione Configurações da biblioteca. Em Permissões e Gerenciamento, clique em Permissões para esta biblioteca de documentos. A página deve mostrar que esta biblioteca herda permissões do site pai.

Método 2: Usar SharePoint Designer para Redefinir Permissões em Massa

1. Abrir o site no SharePoint Designer 2013
   Inicie o SharePoint Designer 2013 e abra o site que contém a biblioteca.
2. Navegar até a biblioteca
   No painel de navegação esquerdo, clique em Listas e Bibliotecas. Selecione a biblioteca que tem o problema de permissão.
3. Editar as permissões do item da lista
   Clique em Configurações da Lista. Em Permissões e Gerenciamento, clique em Permissões para esta biblioteca de documentos. Se a biblioteca mostrar permissões exclusivas, clique em Herdar Permissões. Isso redefine a raiz da biblioteca. Em seguida, clique em Todos os Itens para exibir todos os itens. Selecione todos os itens, clique com o botão direito e escolha Redefinir Herança de Função. Isso remove permissões exclusivas de todos os itens selecionados.
4. Salvar e verificar
   Salve as alterações. Atualize a página de permissões da biblioteca para confirmar que a herança mostra Herdado do pai.

Método 3: Redefinição Manual para Bibliotecas Pequenas

1. Abrir a biblioteca e alternar para a exibição clássica
   Na biblioteca, clique no ícone de engrenagem e selecione Configurações da biblioteca. Em Permissões e Gerenciamento, clique em Permissões para esta biblioteca de documentos. Se a biblioteca mostrar permissões exclusivas, clique em Herdar Permissões.
2. Verificar cada pasta e arquivo
   Navegue por todas as pastas e subpastas da biblioteca. Para cada item, clique nas reticências (três pontos) e selecione Gerenciar acesso. Se o item mostrar um link que diz Parar de herdar permissões, ele está herdando atualmente. Se mostrar um link que diz Herdar permissões, clique nele para redefinir o item para herdar da biblioteca.
3. Repetir para todos os itens
   Redefina manualmente cada item que tenha herança quebrada. Este método só é prático para bibliotecas com menos de 20 itens.

Se as Permissões Exclusivas Ainda Reaparecerem Após a Correção Principal

Biblioteca do SharePoint Mostra Permissões Exclusivas Após Script PowerShell

Se o script PowerShell for executado sem erros, mas a biblioteca ainda mostrar permissões exclusivas, um ou mais itens podem ter sido perdidos. O script acima processa apenas itens na raiz da biblioteca, não itens dentro de subpastas. Para corrigir isso, modifique o script para iterar por todas as pastas recursivamente:

1. Usar um script PowerShell recursivo
   Execute o script a seguir que processa todos os itens em todas as subpastas:
   function Reset-AllItems($folder) {
foreach ($item in $folder.Items) {
if ($item.HasUniqueRoleAssignments) {
$item.ResetRoleInheritance()
$item.Update()
}
}
foreach ($subFolder in $folder.SubFolders) {
Reset-AllItems($subFolder)
}
}
$rootFolder = $list.RootFolder
Reset-AllItems($rootFolder)

Permissões Exclusivas Retornam Após um Usuário Mover um Arquivo com Permissões Quebradas

Quando um usuário move um arquivo de outra biblioteca ou site para a biblioteca redefinida, esse arquivo pode carregar suas próprias permissões exclusivas. A biblioteca então exibe permissões exclusivas novamente. Para evitar isso, treine os usuários para copiar arquivos em vez de movê-los. Alternativamente, execute o script PowerShell recursivo semanalmente para limpar quaisquer novos itens quebrados.

Redefinição de Permissões Não Funciona para Bibliotecas Grandes

O SharePoint Online tem um limite de recursos que restringe quantos itens você pode atualizar em uma única execução de script. Para bibliotecas com mais de 5.000 itens, execute o script em lotes de 1.000 itens. Adicione uma pausa entre os lotes usando Start-Sleep -Seconds 5.

Redefinição Manual vs Redefinição por PowerShell: Principais Diferenças

Item	Redefinição Manual (Interface do SharePoint)	Redefinição por PowerShell
Escopo	Apenas raiz da biblioteca	Todos os itens, incluindo subpastas
Tempo necessário	Minutos para bibliotecas pequenas	Minutos para bibliotecas grandes
Tratamento de erros	Verificação manual de cada item	Pula automaticamente itens sem permissões quebradas
Requer direitos de administrador do SharePoint	Não	Sim
Pode lidar com 5.000+ itens	Não	Sim, com lotes

Após concluir a redefinição, verifique a herança da biblioteca acessando Configurações da biblioteca > Permissões para esta biblioteca de documentos. A página deve mostrar Esta biblioteca de documentos herda permissões do site pai. Se precisar evitar quebras futuras, considere criar uma política de permissão do conjunto de sites que restrinja os usuários de quebrar a herança de permissões em itens abaixo do nível da biblioteca.