Criar sites do SharePoint e adicionar utilizadores com o PowerShell

Artigo
04/16/2024

Este artigo aplica-se tanto a Microsoft 365 Enterprise como a Office 365 Enterprise.

Quando utiliza o PowerShell para o Microsoft 365 para criar sites do SharePoint e adicionar utilizadores, pode executar tarefas rápida e repetidamente mais rapidamente do que no centro de administração do Microsoft 365. Também pode efetuar tarefas que não são possíveis de executar no centro de administração do Microsoft 365.

Ligar ao SharePoint

Os procedimentos neste artigo requerem que se ligue ao SharePoint. Para obter instruções, consulte Ligar ao PowerShell do SharePoint.

Passo 1: criar novas coleções de sites com o PowerShell

Crie vários sites com o PowerShell e um ficheiro .csv que criar com o código de exemplo fornecido e o Bloco de Notas. Para este procedimento, está a substituir as informações do marcador de posição apresentadas entre parênteses retos pelas suas próprias informações específicas do site e do inquilino. Este processo permite-lhe criar um único ficheiro e executar um único comando do PowerShell que utiliza esse ficheiro. Isto torna as ações repetíveis e portáteis e elimina muitos, se não todos, erros que podem vir da escrita de comandos longos na Shell de Gestão do SharePoint. Existem duas partes neste procedimento. Primeiro, cria um ficheiro .csv e, em seguida, faz referência a esse ficheiro .csv com o PowerShell, que utiliza o respetivo conteúdo para criar os sites.

O cmdlet do PowerShell importa o ficheiro de .csv e encaminha-o para um ciclo dentro dos parênteses curvas que lê a linha de abertura do ficheiro como cabeçalhos de coluna. Em seguida, o cmdlet do PowerShell itera através dos restantes registos, cria uma nova coleção de sites para cada registo e atribui propriedades da coleção de sites de acordo com os cabeçalhos de coluna.

Criar um ficheiro de .csv

Nota

O parâmetro de quota de recursos só funciona em sites clássicos. Se utilizar este parâmetro num site moderno, poderá receber uma mensagem de aviso a indicar que foi preterido.

Abra o Bloco de Notas e cole o seguinte bloco de texto no mesmo:

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

Em que inquilino é o nome do seu inquilino e proprietário é o nome de utilizador do utilizador no seu inquilino a quem pretende conceder a função de administrador do site primário.

(Pode premir Ctrl+H quando utilizar o Bloco de Notas para substituir em massa mais rapidamente.)

Guarde o ficheiro no seu ambiente de trabalho como SiteCollections.csv.

Sugestão

Antes de utilizar este ou qualquer outro ficheiro de script .csv ou Windows PowerShell, é uma boa prática certificar-se de que não existem carateres estranhos ou não imprimíveis. Abra o ficheiro no Word e, no friso, clique no ícone de parágrafo para mostrar carateres não imprimíveis. Não devem existir carateres estranhos que não sejam imprimíveis. Por exemplo, não deve haver marcas de parágrafo para além da última no final do ficheiro.

Executar o comando Windows PowerShell

Na linha de Windows PowerShell, escreva ou copie e cole o seguinte comando e prima 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}

Em que MyAlias é igual ao seu alias de utilizador

Aguarde até que o pedido de Windows PowerShell volte a aparecer. Pode demorar um ou dois minutos.
Na linha de Windows PowerShell, escreva ou copie e cole o seguinte cmdlet e prima Enter:
```
Get-SPOSite -Detailed | Format-Table -AutoSize
```
Repare nas novas coleções de sites na lista. Com o nosso ficheiro CSV de exemplo, veria as seguintes coleções de sites: TeamSite01, Blog01, Project01 e Community01.

Já está. Criou várias coleções de sites com o ficheiro de .csv que criou e um único comando Windows PowerShell. Agora, está pronto para criar e atribuir utilizadores a estes sites.

Passo 2: Adicionar utilizadores e grupos

Agora, vai criar utilizadores e adicioná-los a um grupo de coleções de sites. Irá utilizar um ficheiro .csv para carregar novos grupos e utilizadores em massa.

Os seguintes procedimentos continuam a utilizar os sites de exemplo TeamSite01, Blog01, Project01 e Community01.

Criar ficheiros .csv e .ps1

Abra o Bloco de Notas e cole o seguinte bloco de texto no mesmo:

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

Em que o inquilino é igual ao seu nome de inquilino

Guarde o ficheiro no ambiente de trabalho como GroupsAndPermissions.csv.

Abra uma nova instância do Bloco de Notas e cole o seguinte bloco de texto no mesmo:

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

Em que o inquilino é igual ao seu nome de inquilino e o nome de utilizador é igual ao nome de utilizador de um utilizador existente.

Guarde o ficheiro no ambiente de trabalho como Users.csv.

Abra uma nova instância do Bloco de Notas e cole o seguinte bloco de texto no mesmo:

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 utilizador do utilizador com sessão iniciada atualmente.

Guarde o ficheiro no ambiente de trabalho como UsersAndGroups.ps1, que é um script de Windows PowerShell simples.

Agora, está pronto para executar o script UsersAndGroup.ps1 para adicionar utilizadores e grupos a várias coleções de sites.

Executar UsersAndGroups.ps1 script

Regresse à Shell de Gestão do SharePoint.
Na linha de comandos Windows PowerShell, escreva ou copie e cole a seguinte linha e prima Enter:
```
Set-ExecutionPolicy Bypass
```
Na linha de confirmação, prima Y.
Na linha de comandos Windows PowerShell, escreva ou copie e cole o seguinte e prima Enter:
```
c:\users\MyAlias\desktop\UsersAndGroups.ps1
```
Em que MyAlias é igual ao seu nome de utilizador
Aguarde até que o pedido volte antes de avançar. Primeiro, verá que os grupos são apresentados à medida que são criados. Em seguida, verá a lista de grupos repetida à medida que os utilizadores são adicionados.