Introdução à Shell de Gestão do SharePoint Online

Enquanto administrador do SharePoint Online, pode utilizar a Shell de Gestão do SharePoint Online para executar comandos administrativos a partir da linha de comandos. Isto pode ajudá-lo a gerir utilizadores, sites e organizações de forma mais eficiente.

Neste artigo


O que é a Shell de Gestão do SharePoint Online?

A Shell de Gestão do SharePoint Online é um módulo do Windows PowerShell. Pode utilizá-la para gerir utilizadores, sites, coleções de sites e organizações do SharePoint Online a partir da linha de comandos, em vez de utilizar a interface de utilizador do Centro de Administração do SharePoint. O Windows PowerShell permite efetuar estas operações da linha de comandos utilizando um comando personalizado denominado cmdlet. Um cmdlet, que se pronuncia "command-let", é criado como um par verbo-nome, como Get-Command. As duas partes de um cmdlet são separadas por um hífen (-) sem espaços. A parte do verbo refere-se à ação que o cmdlet efetuará. A parte do nome refere-se ao objeto sobre o qual o cmdlet efetuará a ação. Os cmdlets são eficazes sobretudo para operações em lote — por exemplo, adicionando centenas de novos utilizadores do SharePoint Online.

 Nota    Pode utilizar o cmdlet Get-Command para listar todos os cmdlets e o cmdlet Get-Help para obter mais informações sobre qualquer cmdlet. Para mais informações, consulte Get-Command e Get-Help.

Como se utiliza o Windows PowerShell Command Builder?

A Ferramenta Windows PowerShell Command Builder ajuda-o a compreender e utilizar mais rapidamente os cmdlets do Windows PowerShell para SharePoint Online. Suponha que pretende criar um site. Ao utilizar a ferramenta Command Builder para criar um cmdlet, pode criar um site a partir da linha de comandos, em vez de passar por várias páginas na interface de utilizador. Para utilizar a ferramenta, basta escolher um verbo, como Add. A ferramenta filtra os cmdlets começados por esse verbo e mostra os nomes que pode utilizar com o verbo especificado, como Site.

Pode transferir a ferramenta Command Builder e instalá-la no seu ambiente de trabalho. Para mais informações, consulte Guia de Introdução do Windows PowerShell Command Builder.

Qual a diferença entre os cmdlets do SharePoint Online e os cmdlets do Office 365?

O conjunto de cmdlets da Shell de Gestão do SharePoint Online difere do conjunto de cmdlets do Office 365 para profissionais e pequenas empresas. Os cmdlets da Shell de Gestão do SharePoint Online gerem os utilizadores e sites do SharePoint Online, enquanto os cmdlets do Office 365 gerem as tarefas ao nível do Office 365, como domínio, licença, informações da organização e serviços. Ambos gerem utilizadores e grupos. No entanto, os utilizadores e grupos do Office 365 aplicam-se não só aos serviços do SharePoint Online, mas também aos serviços do Exchange Online e Lync Online.

Devo utilizar o Centro de Administração do SharePoint Online ou cmdlets?

Se não tiver utilizado anteriormente o Office 365 e o SharePoint Online para administrar o SharePoint Online, o Centro de Administração do SharePoint Online é um bom ponto de partida. Para obter mais informações sobre o Centro de Administração do SharePoint Online, consulte a Ajuda do Centro de Administração do SharePoint.

Depois de se familiarizar com as funcionalidades e tecnologias do SharePoint Online, utilize os cmdlets do Windows PowerShell. Sobretudo quando pretender gerir muitos utilizadores, sites ou coleções de sites do SharePoint Online, os cmdlets da Shell de Gestão do SharePoint Online são a melhor opção.

Início da Página Início da Página

Como posso obter permissões e configurar o ambiente?

Obter permissões

Para executar os cmdlets da Shell de Gestão do SharePoint Online, tem de ser administrador global do SharePoint Online.

 Nota    Para utilizar cmdlets, um administrador de sites do SharePoint Online tem de ser administrador global no Office 365.

Configurar o ambiente

Antes de poder executar cmdlets, tem de configurar o ambiente da Shell de Gestão do SharePoint Online e ligar ao serviço. Para mais informações, consulte Configurar o ambiente da Shell de Gestão do SharePoint Online.

Depois de configurar o ambiente, tem de executar Connect-SPOService antes de poder gerir os utilizadores e coleções de sites. Se ainda não tiver executado Connect-SPOService, receberá uma mensagem de erro a indicar que não existe nenhuma ligação disponível. Suponha que pretende ligar ao Centro de Administração do SharePoint Online para Contoso.com e o seu nome de utilizador é admin@contoso.com. Para ligar, basta executar o seguinte comando:

Connect-SPOService -Url https://contoso-admin.sharepoint.com -credential admin@contoso.com.

Início da Página Início da Página

Referência do cmdlet da Shell de Gestão do SharePoint Online

Os artigos seguintes listam os cmdlets do SharePoint Online por funcionalidade.


Cmdlets de gestão de utilizadores

Cmdlet Descrição
Add-SPOUser Adiciona um utilizador existente do Office 365 ou um grupo de segurança do Office 365 a um grupo do SharePoint.
Get-SPOUser Devolve as contas de utilizador ou grupo de segurança do SharePoint Online correspondentes a um determinado critério de pesquisa.
Remove-SPOUser Remove um utilizador ou grupo de segurança de uma coleção de sites ou grupo.
Set-SPOUser Configura as propriedades de um utilizador existente.
Get-SPOExternalUser Remove utilizadores externos localizados na pasta do inquilino com base em critérios específicos.
Remove-SPOExternalUser Remove permanentemente uma coleção de utilizadores externos da pasta do inquilino.

Início da Página Início da Página

Cmdlets de gestão de grupos de utilizadores

Cmdlet Descrição
Get-SPOSiteGroup Obtém todos os grupos na coleção de sites especificada.
New-SPOSiteGroup Cria um novo grupo numa coleção de sites do SharePoint Online.
Remove-SPOSiteGroup Remove um grupo do SharePoint Online de uma coleção de sites.
Set-SPOSiteGroup Atualiza o proprietário e os níveis de permissão do SharePoint Online num grupo numa coleção de sites.

Início da Página Início da Página

Cmdlets de atualização

Cmdlet Descrição
Upgrade-SPOSite Inicia o processo de atualização numa coleção de sites.
Request-SPOUpgradeEvaluationSite Solicita a criação de uma cópia de uma coleção de sites existente para validar os efeitos da atualização sem afetar o site original.

Início da Página Início da Página

Cmdlets de gestão de coleções de sites

Cmdlet Descrição
Get-SPODeletedSite Devolve todas as coleções de sites da Reciclagem
Get-SPOSite Devolve uma ou mais coleções de sites.
New-SPOSite Cria uma nova coleção de sites do SharePoint Online para a empresa atual.
Remove-SPODeletedSite Remove uma coleção de sites do SharePoint Online eliminada da Reciclagem.
Remove-SPOSite Envia uma coleção de sites do SharePoint Online para a Reciclagem do SharePoint Online.
Repair-SPOSite Verifica e repara a coleção de sites e o respetivo conteúdo.
Restore-SPODeletedSite Restaura uma coleção de sites do SharePoint Online eliminada da Reciclagem.
Set-SPOSite Define ou atualiza um ou mais valores das propriedades de uma coleção de sites.
Test-SPOSite Testa uma coleção de sites do SharePoint Online.

Início da Página Início da Página

Cmdlets para ligar e desligar serviços

Cmdlet Descrição
Connect-SPOService Liga um administrador global do SharePoint Online a uma ligação do SharePoint Online, ou seja, liga o administrador ao Centro de Administração do SharePoint Online.

Este cmdlet tem de ser executado antes de quaisquer outros cmdlets do SharePoint Online poderem ser executados.
Disconnect-SPOService Desliga de um serviço do SharePoint Online.

Cmdlets de monitorização e gestão ao nível da organização

Cmdlet Descrição
Get-SPOAppErrors Devolve erros da aplicação.
Get-SPOAppInfo Devolve todas as aplicações instaladas.
Get-SPOTenant Devolve as propriedades da organização do SharePoint Online.
Get-SPOTenantLogEntry Devolve os registos das empresas do SharePoint Online.
Get-SPOTenantLogLastAvailableTimeInUtc Devolve a hora a que os registos das organizações do SharePoint Online foram recolhidos.
Get-SPOWebTemplate Apresenta todos os modelos de sites correspondentes à identidade fornecida.
Set-SPOTenant Define as propriedades da organização do SharePoint Online.

Início da Página Início da Página

 
 
Aplica-se a:
Centro de Administração do SharePoint, SharePoint Online Enterprise (E1 e E2), SharePoint Online Enterprise (E3 e E4), SharePoint Online Médias Empresas