M365Con 2027 – conferência online gratuita · 11–22 Jan 2027 · 120 sessions→ m365con.net

Blog · Mirko Peters

Corrigir permissões do SharePoint em massa a partir de um relatório, e não item por item

Disclosure: Cognillo sponsors M365.FM. This page describes the company factually; paid partnerships and links are labelled as advertising.

By · · Updated

Corrija permissões do SharePoint em massa: exporte um relatório, marque cada linha como manter, remover ou redefinir, teste um script do PnP PowerShell primeiro em um site e depois verifique.

Automatically translated with AI from the original post. Read the English original

Para corrigir permissões do SharePoint em massa, você exporta um relatório de quem tem acesso, marca cada linha como manter, remover ou redefinir e, em seguida, executa um script que lê suas decisões. Este guia é para administradores do SharePoint que lidam com centenas de itens com permissões exclusivas e não querem clicar em cada um deles. Você verá como montar a lista de decisões, quais cmdlets do PnP PowerShell fazem o trabalho, o que o relatório da Microsoft deixa de fora e como testar, registrar e verificar uma execução. Um exemplo prático, com números fictícios, mostra o ciclo completo.

Pontos-chave

  • Para corrigir permissões do SharePoint em massa, comece por um relatório: cada alteração em um script deve remontar a uma linha que uma pessoa marcou como manter, remover ou redefinir.
  • O relatório de compartilhamento de sites da Microsoft lista todos os arquivos, usuários, permissões e links exclusivos, mas deixa de fora os links de Qualquer pessoa e as pessoas individuais dentro de grupos do SharePoint.
  • Três cmdlets do PnP PowerShell cobrem a maioria das correções em massa: Remove-PnPGroupMember, Set-PnPListItemPermission e Remove-PnPSiteCollectionAdmin.
  • Redefinir um item para herdar as permissões da sua lista remove as permissões exclusivas dele e costuma ser a correção mais limpa para o acúmulo indevido de permissões.
  • Teste o script em um site, mantenha um registro de cada alteração e execute um segundo relatório depois para comprovar que o problema desapareceu.

Por que corrigir item por item não funciona

A maioria dos problemas de permissões do SharePoint se acumula devagar. Alguém compartilha um único arquivo com um colega. Outra pessoa decide interromper a herança de permissões em uma pasta de um projeto que terminou há muito tempo. Depois de alguns anos, algumas bibliotecas de documentos têm centenas de itens com permissões exclusivas, e ninguém consegue dizer quais ainda importam.

Corrigir isso um por um tem três problemas. É lento. É fácil deixar itens de fora. E não deixa registro do que foi alterado, então você não consegue desfazer um erro nem responder a uma auditoria.

A correção em massa inverte a ordem. Primeiro você reúne os fatos em um relatório. Depois, uma pessoa decide. Só então um script age, e apenas sobre as linhas que têm uma decisão. Assim você mantém a velocidade da automação e o cuidado de uma revisão manual.

Como corrigir permissões do SharePoint em massa: cinco etapas

Siga estas etapas na ordem.

  1. Exporte os fatos. Crie um relatório para o site. O guia da Microsoft sobre o relatório de compartilhamento de arquivos e pastas informa que um administrador do site o executa em Configurações, Uso do site, na seção Compartilhado com usuários externos, com Executar relatório. Você escolhe onde salvar o CSV e recebe um e-mail quando ele terminar.
  2. Adicione uma coluna de decisão. Abra o CSV no Excel e adicione uma coluna com três valores permitidos: manter, remover, redefinir. Adicione uma segunda coluna para o motivo. Peça ao proprietário do site que revise as linhas que você não consegue avaliar sozinho.
  3. Escreva o script em torno das decisões. Leia o arquivo com Import-Csv, percorra as linhas e execute um cmdlet por tipo de decisão. Ignore toda linha sem decisão.
  4. Teste em um site e depois em uma biblioteca. Execute o script primeiro em um site de teste ou em uma única biblioteca. Compare o resultado com o que você esperava.
  5. Confira com um segundo relatório. Depois da execução real, gere o relatório novamente. As linhas que você removeu devem ter desaparecido, e as linhas que você manteve devem estar iguais.

Não pule a etapa 2. Um script é tão seguro quanto a lista que ele lê.

Como funciona a herança de permissões antes de você redefinir qualquer coisa

A página de suporte da Microsoft sobre como personalizar permissões de uma lista ou biblioteca do SharePoint explica que pastas, listas e documentos normalmente herdam permissões do site que os contém. Para dar a uma lista ou biblioteca permissões próprias, um proprietário escolhe Interromper herança de permissões, e os itens abaixo dela passam a herdar as novas configurações. Para voltar atrás, a guia Permissões oferece Excluir permissões exclusivas, que remove as permissões personalizadas que você definiu.

Três avisos da mesma página são importantes para trabalhos em massa:

  • O limite de 100.000 itens. Você não pode interromper nem restaurar a herança em uma lista, biblioteca ou pasta que tenha mais de 100.000 itens. Um único arquivo em uma biblioteca grande ainda pode ter a herança interrompida.
  • Remover um usuário alcança itens filhos. Remover um usuário ou grupo também o remove dos itens filhos, inclusive daqueles com herança interrompida, e não é possível restaurá-lo. Leia seu log antes de executar uma remoção.
  • O acesso limitado permanece. Uma pessoa com quem apenas um item foi compartilhado recebe acesso limitado ao site, e deixar de compartilhar o item não remove esse acesso.

A Microsoft recomenda grupos do SharePoint e considera as permissões em nível de item suportadas dentro de um uso razoável. Nossa regra prática é atribuir acesso por meio de um grupo, e não a usuários individuais, para que as permissões do site continuem legíveis e restem menos permissões exclusivas para corrigir.

Qual cmdlet resolve qual problema?

O PnP PowerShell tem cmdlets para a maioria das correções em massa. Estes três são os que mais aparecem.

Remover uma pessoa de um grupo do SharePoint. A referência de Remove-PnPGroupMember mostra a sintaxe: Remove-PnPGroupMember -LoginName user@company.com -Group 'Marketing Site Members'. Use-o para problemas de associação a grupos, como um colaborador que saiu e ainda está em um grupo de Membros.

Alterar ou redefinir permissões de um item. A referência de Set-PnPListItemPermission lista estas opções:

  • -AddRole e -RemoveRole adicionam ou removem um nível de permissão para um usuário ou grupo em um item. Use Get-PnPRoleDefinition para ver as funções disponíveis.
  • -ClearExisting remove todas as permissões existentes no item antes de a nova função ser adicionada.
  • -InheritPermissions redefine o item para que ele herde permissões da lista e remove suas permissões exclusivas.
  • -SystemUpdate altera permissões sem criar uma nova versão nem acionar o Power Automate.

Redefinir costuma ser a correção mais limpa. Se um item só tem permissões exclusivas porque alguém o compartilhou uma vez, uma redefinição o devolve às regras da biblioteca.

Remover um administrador de coleção de sites. A referência de Remove-PnPSiteCollectionAdmin mostra Remove-PnPSiteCollectionAdmin -Owners "user@contoso.onmicrosoft.com". Os administradores que você não indicar mantêm o acesso. Também é possível passar uma lista de usuários.

Para substituir um usuário por outro, execute duas etapas: adicione a nova pessoa onde a antiga tinha acesso e, depois, remova a antiga. Faça a adição primeiro, para que ninguém perca o acesso no meio do processo.

O que o relatório não mostra

Um relatório é um ponto de partida, não a verdade completa. A página de relatório de compartilhamento da Microsoft informa o que o CSV deixa de fora:

  • Usuários individuais dentro de grupos do SharePoint. O grupo aparece, mas não os seus membros.
  • Links enviados por e-mail que nunca foram clicados.
  • Links anônimos (de qualquer pessoa).

Isso tem consequências reais. Se o seu objetivo é descobrir onde uma pessoa tem acesso, o relatório mostrará o grupo, então você precisa ler os membros do grupo separadamente. Se o seu objetivo é remover o compartilhamento público, o relatório não listará os links "Qualquer pessoa" de forma alguma, então você precisa de outra fonte, como os relatórios de governança de acesso a dados no centro de administração do SharePoint. Segundo a Microsoft, esses relatórios exigem o SharePoint Advanced Management.

Para um único site do SharePoint no SharePoint Online, revise também as permissões do site e os níveis de permissão em uso em Configurações do site antes de alterar qualquer item. Depois, verifique as opções de relatórios do SharePoint para todo o locatário, e não apenas para um site. Um CSV por site não escala para centenas de sites.

Para sites conectados a grupos do Microsoft 365, a associação ao grupo é gerenciada pelo próprio grupo, e não nos grupos do site. Um script que edita os grupos do site não vai corrigir uma pessoa que faz parte do grupo do Microsoft 365.

Torne o script seguro para execução

Um script em massa pode causar muitos danos em pouco tempo. Inclua estas proteções antes da primeira execução real:

  1. Adicione uma opção de simulação. Seu próprio script pode receber um parâmetro -DryRun que exibe cada ação planejada e não altera nada. Revise essa saída com o proprietário do site.
  2. Registre em log antes de alterar. Para cada linha, grave primeiro o estado anterior no log: o caminho do item, o usuário e o nível de permissão, como Controle Total, Editar ou Leitura. Esse log é o seu caminho de volta.
  3. Trabalhe em lotes. Execute 50 itens, verifique-os e só então execute os próximos 500. Um primeiro lote pequeno identifica cedo uma premissa errada.
  4. Guarde o relatório original. Armazene o CSV com suas decisões e o log em uma pasta que somente os proprietários do site possam abrir. A Microsoft sugere o mesmo para o próprio relatório, porque ele lista quem tem acesso a quê.
  5. Altere a associação a grupos em uma execução separada. Corrija as permissões dos itens em uma execução e a associação aos grupos em outra, para que você possa verificar cada tipo de alteração isoladamente.

Exemplo: limpeza de uma biblioteca de documentos

Os números são fictícios.

Um site de projeto tem uma biblioteca de documentos. O relatório tem 620 linhas. Após a ordenação, um administrador e o proprietário do site as classificam:

  • 410 linhas: manter. São as permissões normais baseadas em grupos.
  • 150 linhas: redefinir. São arquivos individuais com permissões exclusivas de compartilhamentos antigos.
  • 40 linhas: remover. Elas dão a um ex-prestador de serviço acesso direto.
  • 20 linhas: indefinidas. Voltam para o proprietário com uma pergunta.

O administrador escreve um script com dois ramos. O ramo de redefinição executa Set-PnPListItemPermission com -InheritPermissions para cada arquivo. O ramo de remoção executa Remove-PnPGroupMember para o prestador de serviço nos grupos em que ele aparece. O script grava uma linha de log por ação: a data, o item, o estado anterior e o novo estado.

Primeiro, o administrador executa o script em uma cópia da biblioteca com 20 linhas. O resultado corresponde ao plano. A execução completa leva uma noite. Um segundo relatório mostra 410 mais 20 linhas, que é o que o administrador esperava. O log fica salvo junto ao relatório, para que qualquer pessoa possa ver o que aconteceu.

Erros comuns

  • Executar um script sem uma lista de decisões. Você não consegue explicar depois por que um item foi alterado.
  • Redefinir a herança em uma biblioteca onde permissões exclusivas são intencionais. Algumas pastas são restritas de propósito. Marque-as como manter.
  • Confiar no relatório como se fosse completo. Ele deixa de fora os links "Qualquer pessoa" e os membros de grupos do SharePoint.
  • Remover antes de adicionar. Ao substituir um usuário por outro, adicione primeiro.
  • Conceder acesso pessoa por pessoa. Atribua permissões por meio de um grupo, e não a um usuário por item, para que a próxima revisão seja mais curta.
  • Esquecer o grupo do Microsoft 365. Uma pessoa pode manter o acesso pela associação ao grupo mesmo depois que você limpar o site.
  • Sem log e sem um segundo relatório. Sem eles, você não consegue comprovar a correção nem desfazê-la.

Como o software pode ajudar

Comece com as ferramentas que você já tem. O relatório de compartilhamento do site e os relatórios do centro de administração fornecem os fatos. O PnP PowerShell faz as alterações, e uma planilha guarda as decisões e o log.

Algumas ferramentas de terceiros combinam relatórios e correções em uma única tela. Um exemplo é o SharePoint Essentials Toolkit, da Cognillo. De acordo com a página de produto do fornecedor, ele oferece relatórios de permissões para sites, pastas e itens, mostra tudo a que uma pessoa tem acesso, substitui um usuário por outro e corrige permissões e links de compartilhamento a partir dos relatórios. O fornecedor também afirma que relatórios e tarefas podem ser agendados e exportados. Essas são declarações do fornecedor e não foram testadas pelo M365.FM. A abordagem manual descrita acima funciona sem nenhuma dessas ferramentas.

Divulgação: a Cognillo patrocina o M365.FM.

Próximo passo

Escolha um site com um problema de permissão conhecido, execute o relatório de compartilhamento e adicione uma coluna de decisão ao CSV. Em seguida, use essa lista para corrigir as permissões do SharePoint em massa primeiro em uma biblioteca de teste e mantenha o registro das alterações.

Entities in this article

SharePoint permissions SharePoint reporting SharePoint Essentials Toolkit PnP PowerShell

Related articles

RSS