Partilhar via


Introdução ao Shell de Gerenciamento do SharePoint Online

Para começar a utilizar o PowerShell para gerir o SharePoint Online, tem de instalar o Shell de Gerenciamento do SharePoint Online e ligar ao SharePoint Online.

Instale o Shell de Gerenciamento do SharePoint Online, baixe e execute o Shell de Gerenciamento do SharePoint Online ou instale o módulo da Galeria do PowerShell. Uma vez instalado, o módulo estará disponível para uso, e você não precisará instalá-lo novamente até precisar de recursos introduzidos em uma versão posterior. Por exemplo, talvez seja necessário instalar uma nova versão para negociação do TLS 1.2 depois de outubro de 2018.

Primeiro, pode marcar se já tiver instalado o Shell de Gerenciamento do SharePoint Online ao executar o seguinte comando no modo administrativo no PowerShell:

Get-Module -Name Microsoft.Online.SharePoint.PowerShell -ListAvailable | Select Name,Version

Se o seu sistema operativo estiver a utilizar o Windows PowerShell 5, também pode instalar o Shell de Gerenciamento do SharePoint Online ao executar o seguinte comando no modo administrativo:

Install-Module -Name Microsoft.Online.SharePoint.PowerShell

Se não tiver privilégios administrativos no sistema, pode instalar o Shell de Gerenciamento do SharePoint Online apenas para o utilizador atual ao executar o seguinte comando:

Install-Module -Name Microsoft.Online.SharePoint.PowerShell -Scope CurrentUser

Para garantir que tem todos os cmdlets disponíveis, deve certificar-se sempre de que o módulo está atualizado. Pode atualizar o Shell de Gerenciamento do SharePoint Online ao executar o seguinte comando no modo administrativo:

Update-Module -Name Microsoft.Online.SharePoint.PowerShell

Para abrir o prompt de comando do Shell de Gerenciamento do SharePoint Online, pela Tela inicial, digite sharepoint e, em seguida, clique em Shell de Gerenciamento do SharePoint Online.

Observação

Para executar comandos do PowerShell do SharePoint Online numa consola do Windows PowerShell 7, tem de importar o módulo do SharePoint com o parâmetro -UseWindowsPowerShell.

Import-Module Microsoft.Online.SharePoint.PowerShell -UseWindowsPowerShell

Para se conectar com um nome de usuário e senha

  1. Execute o seguinte comando na linha de comandos Shell de Gerenciamento do SharePoint Online:

    Connect-SPOService -Url https://contoso-admin.sharepoint.com -Credential admin@contoso.com
    
  2. Quando as credenciais forem solicitadas pela caixa de diálogo do Windows PowerShell, digite a senha da conta de administrador do SharePoint.

Para atribuir a função de administrador do SharePoint a um utilizador, consulte Atribuir funções de administrador ou Atribuir funções de administrador a contas de utilizador do Microsoft 365 com o PowerShell.

Observação

Se encontrar problemas ao tentar ligar ou receber um erro como "Mensagem de erro: Não foi possível ligar ao SharePoint Online", poderá ter de utilizar a Autenticação Moderna. Veja o seguinte exemplo:

Connect-SPOService -Credential $creds -Url https://tenant-admin.sharepoint.com -ModernAuth $true -AuthenticationUrl https://login.microsoftonline.com/organizations

Para conectar-se com a autenticação multifator (MFA)

  1. Execute o seguinte comando na linha de comandos Shell de Gerenciamento do SharePoint Online:

    Connect-SPOService -Url https://contoso-admin.sharepoint.com
    
  2. Quando aparecer a caixa de diálogo Shell de Gerenciamento do Microsoft SharePoint Online, digite o nome da conta e a senha de uma conta de administrador do SharePoint e, em seguida, clique em Entrar.

  3. Siga as instruções na caixa de diálogo Shell de Gerenciamento do Microsoft SharePoint Online para fornecer as informações de autenticação adicionais, como um código de verificação e, em seguida, clique em Entrar.

Agora você está pronto para usar os comandos do SharePoint Online.

Observação

Existe um problema conhecido entre o módulo Shell de Gerenciamento do SharePoint Online e o SDK de Componentes de Cliente do SharePoint em que o módulo não será carregado se ambos estiverem instalados no mesmo computador. Se encontrar este problema, desinstale o SDK de Componentes de Cliente do SharePoint.