Criar sites do SharePoint e adicionar utilizadores com o PowerShell

Esse artigo se aplica ao Microsoft 365 Enterprise e ao 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.

Conectar-se 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.

Criando um arquivo .csv

Observação

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.

  1. 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
    

    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.)

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

Dica

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 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:

  1. 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

  2. Aguarde até que o pedido de Windows PowerShell volte a aparecer. Pode demorar um minuto ou dois.

  3. Na linha de Windows PowerShell, escreva ou copie e cole o seguinte cmdlet e prima Enter:

    Get-SPOSite -Detailed | Format-Table -AutoSize
    
  4. Observe os novos conjuntos de sites na lista. Com o nosso ficheiro CSV de exemplo, veria as seguintes coleções de sites: TeamSite01, Blog01, Project01 e Community01.

É tudo. 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.

Etapa 2: Adicionar usuários ou 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.

Criando arquivos .csv e .ps1

  1. 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
    

    Em que o inquilino é igual ao seu nome de inquilino

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

  3. 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
    

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

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

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

  6. 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.

Execute o script UsersAndGroups.ps1

  1. Regresse à Shell de Gestão do SharePoint.

  2. Na linha de comandos Windows PowerShell, escreva ou copie e cole a seguinte linha e prima Enter:

    Set-ExecutionPolicy Bypass
    
  3. Na linha de confirmação, prima Y.

  4. 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

  5. Aguarde a solicitação de retorno do prompt antes de prosseguir. 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.

Confira também

Ligar ao PowerShell do SharePoint

Gerir grupos de sites do SharePoint com o PowerShell

Gerenciar o Microsoft 365 com o PowerShell

Introdução ao PowerShell para o Microsoft 365