Criar sites do SharePoint e adicionar usuários com o PowerShell

Artigo
04/16/2024

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

Quando você usa o PowerShell para o Microsoft 365 para criar sites do SharePoint e adicionar usuários, você pode executar tarefas rapidamente e repetidamente mais rápido do que pode no Centro de administração do Microsoft 365. Você também pode executar tarefas que não são possíveis de executar no Centro de administração do Microsoft 365.

Conectar-se ao SharePoint

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

Etapa 1: criar novas coleções de sites usando o PowerShell

Crie vários sites usando o PowerShell e um arquivo .csv que você cria usando o código de exemplo fornecido e o Bloco de Notas. Para este procedimento, você está substituindo as informações de espaço reservado mostradas em colchetes por suas próprias informações específicas do site e do locatário. Esse processo permite criar um único arquivo e executar um único comando do PowerShell que usa esse arquivo. Isso torna as ações repetíveis e portáteis e elimina muitos erros, se não todos, que podem vir da digitação de comandos longos no Shell de Gerenciamento do SharePoint. Há duas partes nesse procedimento. Primeiro você cria um arquivo .csv e, em seguida, faz referência a esse arquivo .csv usando o PowerShell, que usa seu conteúdo para criar os sites.

O cmdlet do PowerShell importa o arquivo .csv e o canaliza para um loop dentro dos colchetes encaracolados que lê a linha de abertura do arquivo como cabeçalhos de coluna. O cmdlet do PowerShell itera por meio dos registros restantes, cria uma nova coleção de sites para cada registro e atribui propriedades da coleção de sites de acordo com os cabeçalhos de coluna.

Criando um arquivo .csv

Observação

O parâmetro de cota de recursos funciona apenas em sites clássicos. Se você usar esse parâmetro em um site moderno, poderá receber uma mensagem de aviso de que ele foi preterido.

Abra o bloco de notas e cole o seguinte bloco de texto:

Owner,StorageQuota,Url,ResourceQuota,Template,TimeZoneID,Name
owner@tenant.onmicrosoft.com,100,https://tenant.sharepoint.com/sites/TeamSite01,25,EHS#1,10,Contoso Team Site
owner@tenant.onmicrosoft.com,100,https://tenant.sharepoint.com/sites/Blog01,25,BLOG#0,10,Contoso Blog
owner@tenant.onmicrosoft.com,150,https://tenant.sharepoint.com/sites/Project01,25,PROJECTSITE#0,10,Project Alpha
owner@tenant.onmicrosoft.com,150,https://tenant.sharepoint.com/sites/Community01,25,COMMUNITY#0,10,Community Site

Onde o locatário é o nome do locatário e o proprietário é o nome de usuário do usuário em seu locatário a quem você deseja conceder a função de administrador do site primário.

(Você pode pressionar Ctrl+H ao usar o Bloco de Notas para substituir em massa mais rapidamente.)

Salve o arquivo em sua área de trabalho como SiteCollections.csv.

Dica

Antes de usar este ou qualquer outro arquivo de script .csv ou Windows PowerShell, é uma boa prática garantir que não haja caracteres desnecessários ou não impressos. Abra o arquivo no Word, e na faixa de opções, clique no ícone do parágrafo para mostrar caracteres não imprimíveis. Não deve haver caracteres estranhos não imprimíveis. Por exemplo, não deve haver marcas do parágrafo no final do arquivo.

Execute o comando do Windows PowerShell:

No prompt Windows PowerShell, digite ou copie e cole o seguinte comando e pressione Enter:

Import-Csv C:\users\MyAlias\desktop\SiteCollections.csv | ForEach-Object {New-SPOSite -Owner $_.Owner -StorageQuota $_.StorageQuota -Url $_.Url -NoWait -ResourceQuota $_.ResourceQuota -Template $_.Template -TimeZoneID $_.TimeZoneID -Title $_.Name}

Onde MyAlias é igual a seu alias de usuário

Aguarde o prompt Windows PowerShell reaparecer. Pode demorar um minuto ou dois.
No prompt Windows PowerShell, digite ou copie e cole o seguinte cmdlet e pressione Enter:
```
Get-SPOSite -Detailed | Format-Table -AutoSize
```
Observe os novos conjuntos de sites na lista. Usando nosso arquivo CSV de exemplo, você verá as seguintes coleções de sites: TeamSite01, Blog01, Project01 e Community01.

É isso. Você criou várias coleções de sites usando o arquivo .csv que criou e um único comando Windows PowerShell. Agora você está pronto para criar e alocar usuários nestes sites.

Etapa 2: Adicionar usuários ou grupos

Agora você vai criar usuários e adicioná-los a um grupo de coleção de sites. Você usará um arquivo .csv para carregar em massa novos grupos e usuários.

Os procedimentos a seguir continuam usando os sites de exemplo TeamSite01, Blog01, Project01 e Community01.

Criando arquivos .csv e .ps1

Abra o bloco de notas e cole o seguinte bloco de texto:

Site,Group,PermissionLevels
https://tenant.sharepoint.com/sites/Community01,Contoso Project Leads,Full Control
https://tenant.sharepoint.com/sites/Community01,Contoso Auditors,View Only
https://tenant.sharepoint.com/sites/Community01,Contoso Designers,Design
https://tenant.sharepoint.com/sites/TeamSite01,XT1000 Team Leads,Full Control
https://tenant.sharepoint.com/sites/TeamSite01,XT1000 Advisors,Edit
https://tenant.sharepoint.com/sites/Blog01,Contoso Blog Designers,Design
https://tenant.sharepoint.com/sites/Blog01,Contoso Blog Editors,Edit
https://tenant.sharepoint.com/sites/Project01,Project Alpha Approvers,Full Control

Onde o locatário é igual ao nome do locatário

Salve o arquivo em sua área de trabalho como GroupsAndPermissions.csv.

Abra uma nova instância do bloco de notas e cole o seguinte bloco de texto:

Group,LoginName,Site
Contoso Project Leads,username@tenant.onmicrosoft.com,https://tenant.sharepoint.com/sites/Community01
Contoso Auditors,username@tenant.onmicrosoft.com,https://tenant.sharepoint.com/sites/Community01
Contoso Designers,username@tenant.onmicrosoft.com,https://tenant.sharepoint.com/sites/Community01
XT1000 Team Leads,username@tenant.onmicrosoft.com,https://tenant.sharepoint.com/sites/TeamSite01
XT1000 Advisors,username@tenant.onmicrosoft.com,https://tenant.sharepoint.com/sites/TeamSite01
Contoso Blog Designers,username@tenant.onmicrosoft.com,https://tenant.sharepoint.com/sites/Blog01
Contoso Blog Editors,username@tenant.onmicrosoft.com,https://tenant.sharepoint.com/sites/Blog01
Project Alpha Approvers,username@tenant.onmicrosoft.com,https://tenant.sharepoint.com/sites/Project01

Quando o locatário é igual ao nome de locatário e o nome de usuário é igual ao nome de usuário de um usuário existente.

Salve o arquivo em sua área de trabalho como Users.csv.

Abra uma nova instância do bloco de notas e cole o seguinte bloco de texto:

Import-Csv C:\users\MyAlias\desktop\GroupsAndPermissions.csv | ForEach-Object {New-SPOSiteGroup -Group $_.Group -PermissionLevels $_.PermissionLevels -Site $_.Site}
Import-Csv C:\users\MyAlias\desktop\Users.csv | where {Add-SPOUser -Group $_.Group –LoginName $_.LoginName -Site $_.Site}

Em que MyAlias é igual ao nome de usuário do usuário que está conectado no momento.

Salve o arquivo em sua área de trabalho como UsersAndGroups.ps1, que é um script Windows PowerShell simples.

Agora você está pronto para executar o script UsersAndGroup.ps1 para adicionar usuários e grupos a vários conjuntos de sites.

Execute o script UsersAndGroups.ps1

Retorne ao Shell de Gerenciamento do SharePoint.
No prompt de comando Windows PowerShell, digite ou copie e cole a seguinte linha e pressione Enter:
```
Set-ExecutionPolicy Bypass
```
No prompt de confirmação, pressione Y.
No prompt de comando Windows PowerShell, digite ou copie e cole o seguinte e pressione Enter:
```
c:\users\MyAlias\desktop\UsersAndGroups.ps1
```
Onde MyAlias é igual ao seu nome de usuário
Aguarde a solicitação de retorno do prompt antes de prosseguir. Primeiro você verá os grupos aparecerem quando eles forem criados. Em seguida, você verá a lista de grupos repetida à medida que os usuários são adicionados.