Os proprietários de coleções de sites do SharePoint mudam com frequência. Você precisa de uma maneira rápida de ver quem é dono de cada site no seu tenant. Verificações manuais no navegador demoram muito para muitos sites. O PowerShell oferece um único comando para listar todos os proprietários. Este artigo mostra os comandos exatos do PowerShell e um checklist para manter sua lista de proprietários precisa.
Principais Conclusões: Checklist PowerShell para Proprietários de Sites SharePoint
- Get-SPOSite -Limit All | Select Url, Owner: Lista cada URL do site e seu proprietário principal em uma única tabela.
- Get-SPOSite -Detailed | Select Url, Owner, SecondaryOwner: Adiciona proprietários secundários à saída.
- Get-SPOSiteGroup -Site $Url | Where Group -eq “Owners”: Mostra todos os membros do grupo Proprietários de um site específico.
Por que o PowerShell é a Melhor Ferramenta para Listar Proprietários de Sites SharePoint
O centro de administração do SharePoint mostra proprietários de sites um de cada vez. Para um tenant com 100 ou mais sites, isso leva horas. O PowerShell executa a mesma verificação em segundos. O módulo SharePoint Online Management Shell conecta-se ao seu tenant e lê as propriedades do site diretamente do serviço.
O cmdlet Get-SPOSite retorna um objeto de site que inclui a propriedade Owner. Essa propriedade contém o endereço de e-mail ou nome principal do usuário do administrador da coleção de sites principal. Para proprietários secundários, você precisa da propriedade SecondaryOwner. O grupo Proprietários dentro de cada site contém todos os usuários que têm controle total. O PowerShell pode ler essa associação de grupo também.
Você precisa ter o módulo SharePoint Online Management Shell instalado e a função de administrador do SharePoint no seu tenant. Sem esses pré-requisitos, os comandos falharão com erros de acesso negado.
Passos para Listar Proprietários de Sites SharePoint com PowerShell
Siga estes passos para conectar-se ao seu tenant e listar todos os proprietários de sites. Cada passo se baseia no anterior. Execute os comandos no SharePoint Online Management Shell ou no Windows PowerShell 5.1.
- Instalar o módulo SharePoint Online Management Shell
Abra o PowerShell como administrador. Execute Install-Module -Name Microsoft.Online.SharePoint.PowerShell -Scope CurrentUser. Pressione Y para confirmar a instalação do PSGallery. - Conectar-se ao seu tenant SharePoint
Execute Connect-SPOService -Url https://seutenant-admin.sharepoint.com. Substitua seutenant pelo nome real do seu tenant. Uma janela de login será aberta. Insira suas credenciais de administrador do SharePoint. - Listar todos os sites com seus proprietários principais
Execute Get-SPOSite -Limit All | Select Url, Owner. A saída mostra cada URL do site e o e-mail do proprietário principal. O parâmetro -Limit All garante que nenhum site seja ignorado. - Incluir proprietários secundários na saída
Execute Get-SPOSite -Detailed -Limit All | Select Url, Owner, SecondaryOwner. O parâmetro -Detailed adiciona a propriedade SecondaryOwner. Alguns sites podem mostrar o campo em branco se nenhum proprietário secundário estiver definido. - Exportar a lista de proprietários para um arquivo CSV
Execute Get-SPOSite -Detailed -Limit All | Select Url, Owner, SecondaryOwner | Export-Csv -Path C:\temp\siteowners.csv -NoTypeInformation. Abra o arquivo CSV no Excel para filtrar, classificar ou auditar os dados. - Verificar o grupo Proprietários de um site específico
Execute Get-SPOSiteGroup -Site https://seutenant.sharepoint.com/sites/nomedosite | Where-Object {$_.Group -eq “Owners”}. Isso mostra todos os usuários que têm controle total por meio do grupo Proprietários padrão.
Checklist Prático para Proprietários de Sites SharePoint
Use este checklist após executar os comandos PowerShell. Cada item ajuda você a verificar e limpar a propriedade dos sites. Verifique os itens mensalmente ou após grandes mudanças de pessoal.
Verificar se cada site tem pelo menos um proprietário ativo
Abra o arquivo CSV exportado. Procure por campos Owner em branco. Um site sem proprietário principal se torna ingerenciável. Atribua um novo proprietário usando Set-SPOSite -Identity $Url -Owner novoproprietario@seutenant.com.
Remover ex-funcionários das funções de proprietário
Compare as colunas Owner e SecondaryOwner com seu diretório de RH. Se uma pessoa não trabalha mais na empresa, execute Remove-SPOUser -Site $Url -LoginName usuario@seutenant.com. Isso a remove do grupo Proprietários e de todos os outros grupos do site.
Padronizar proprietários secundários em todos os sites de equipe
Muitos sites não têm proprietário secundário. Execute Set-SPOSite -Identity $Url -SecondaryOwner secundario@seutenant.com para cada site que não tiver um. Um proprietário secundário pode assumir se o proprietário principal sair.
Auditar usuários externos no grupo Proprietários
Usuários externos raramente devem ser proprietários de sites. Execute Get-SPOSiteGroup -Site $Url | Where-Object {$_.Group -eq “Owners”} | Select-Object -ExpandProperty Users. Procure por endereços de e-mail fora do seu domínio. Remova qualquer proprietário externo que não tenha necessidade de negócios.
Documentar as atribuições de proprietários em uma lista central
Mantenha o arquivo CSV exportado em uma biblioteca de documentos segura do SharePoint. Atualize o arquivo sempre que executar o script. Compartilhe o documento com sua equipe de TI para que todos saibam quem é o proprietário de cada site.
Erros Comuns ao Usar PowerShell para Proprietários de Sites
“Get-SPOSite mostra “Owner” como um GUID em vez de um nome”
Isso acontece quando o site foi criado a partir de um grupo do Microsoft 365. A propriedade Owner mostra o ID do grupo, não uma pessoa. Execute Get-SPOSiteGroup -Site $Url para ver os membros reais do grupo Proprietários. O grupo contém as contas de usuário reais.
“O comando PowerShell retorna acesso negado”
Você precisa da função de administrador do SharePoint no centro de administração do Microsoft 365. Sua conta também deve ser administradora da coleção de sites para os sites que deseja consultar. Execute Connect-SPOService novamente com uma conta de administrador global, se necessário.
“A lista do grupo Proprietários inclui contas de serviço ou contas de sistema”
O SharePoint Online adiciona automaticamente algumas contas de sistema ao grupo Proprietários. Essas contas começam com “spo” ou “app@sharepoint”. Você não pode removê-las. Ignore essas entradas ao auditar proprietários humanos.
Proprietários de Sites de Equipe vs Sites de Comunicação: Principais Diferenças
| Item | Site de Equipe (Grupo Microsoft 365) | Site de Comunicação |
|---|---|---|
| Proprietário principal | Proprietário do grupo Microsoft 365 | Administrador da coleção de sites |
| Proprietário secundário | Definido via Set-SPOSite -SecondaryOwner | Definido via Set-SPOSite -SecondaryOwner |
| Associação ao grupo Proprietários | Lista de proprietários do grupo + grupo Proprietários do site | Apenas grupo Proprietários do site |
| PowerShell para listar proprietários | Get-SPOSiteGroup mostra membros do grupo | Get-SPOSite mostra propriedade Owner |
Sites de equipe conectados a um grupo do Microsoft 365 têm duas camadas de propriedade. O proprietário do grupo controla a associação ao grupo. O grupo Proprietários do site controla as permissões do SharePoint. Sites de comunicação têm apenas o grupo Proprietários do site. Sempre verifique ambas as camadas para sites de equipe para obter uma lista completa de proprietários.
Agora você pode listar todos os proprietários de sites do SharePoint no seu tenant usando PowerShell. Execute os comandos Get-SPOSite mensalmente e compare a saída com seu checklist. Use a exportação CSV para manter uma trilha de auditoria permanente. Para sites com grupos do Microsoft 365, lembre-se de verificar também a lista de proprietários do grupo, além do grupo Proprietários do site.