Gerenciar grupos de sites do SharePoint com o PowerShell

Esse artigo se aplica ao Microsoft 365 Enterprise e ao Office 365 Enterprise.

Embora você possa usar o Centro de administração do Microsoft 365, você também pode usar o PowerShell para o Microsoft 365 para gerenciar seus grupos de sites do SharePoint.

Antes de começar

Os procedimentos neste artigo exigem que você se conecte ao SharePoint. Para obter instruções, consulte Conectar-se ao SharePoint PowerShell.

Exibir o SharePoint com o PowerShell para o Microsoft 365

O centro de administração do SharePoint tem alguns métodos fáceis de usar para gerenciar grupos de sites. Por exemplo, suponha que você queira examinar os grupos e os membros do grupo para o https://litwareinc.sharepoint.com/sites/finance site. Aqui está o que você tem que fazer para:

1. No centro de administração do SharePoint, selecione Sites ativos e selecione a URL do site.
2. Na página do site, selecione Configurações (localizadas no canto superior direito da página) e selecione Permissões do site.

E, em seguida, repita o processo para o próximo site que você deseja examinar.

Para obter uma lista dos grupos com o PowerShell para Microsoft 365, você pode usar os seguintes comandos:

$siteURL = "https://litwareinc.sharepoint.com/sites/finance"
$x = Get-SPOSiteGroup -Site $siteURL
foreach ($y in $x)
    {
        Write-Host $y.Title -ForegroundColor "Yellow"
        Get-SPOSiteGroup -Site $siteURL -Group $y.Title | Select-Object -ExpandProperty Users
        Write-Host
    }

Há duas maneiras de executar esse conjunto de comandos no prompt de comando do Shell de Gerenciamento do SharePoint:

• Copie os comandos no Bloco de Notas (ou em outro editor de texto), modifique o valor da variável $siteURL , selecione os comandos e cole-os no prompt de comando do Shell de Gerenciamento do SharePoint. Quando você fizer isso, o PowerShell para em um >> prompt. Pressione Enter para executar o foreach comando.
  
• Copie os comandos no Bloco de Notas (ou em outro editor de texto), modifique o valor da variável $siteURL e salve este arquivo de texto com um nome e a extensão .ps1 em uma pasta adequada. Em seguida, execute o script do prompt de comando do Shell de Gerenciamento do SharePoint especificando o caminho e o nome do arquivo. Aqui está um comando de exemplo:

C:\Scripts\SiteGroupsAndUsers.ps1

Em ambos os casos, você deve ver algo semelhante a este:

Esses são todos os grupos criados para o site https://litwareinc.sharepoint.com/sites/financee todos os usuários atribuídos a esses grupos. Os nomes de grupo estão em amarelo para ajudá-lo a separar nomes de grupo de seus membros.

Como outro exemplo, aqui está um conjunto de comandos que lista os grupos e todas as associações de grupo para todos os seus sites do SharePoint.

$x = Get-SPOSite
foreach ($y in $x)
    {
        Write-Host $y.Url -ForegroundColor "Yellow"
        $z = Get-SPOSiteGroup -Site $y.Url
        foreach ($a in $z)
            {
                 $b = Get-SPOSiteGroup -Site $y.Url -Group $a.Title
                 Write-Host $b.Title -ForegroundColor "Cyan"
                 $b | Select-Object -ExpandProperty Users
                 Write-Host
            }
    }

Confira também

Conectar-se ao SharePoint PowerShell

Create sites do SharePoint e adicione usuários ao PowerShell

Gerenciar usuários e grupos do SharePoint com o PowerShell

Gerenciar o Microsoft 365 com o PowerShell

Introdução ao PowerShell para o Microsoft 365