Introdução ao Shell de Gerenciamento do SharePoint Online

Para começar a usar o PowerShell para gerenciar o SharePoint Online, você precisa instalar o Shell de Gerenciamento do SharePoint Online e conectar-se 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, você pode verificar se já instalou o Shell de Gerenciamento do SharePoint Online executando o seguinte comando no modo administrativo no PowerShell:

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

Se o sistema operacional estiver usando o PowerShell 5 ou mais recente, você também poderá instalar o Shell de Gerenciamento do SharePoint Online executando o seguinte comando no modo administrativo:

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

Se você não tiver privilégios administrativos no sistema, poderá instalar o Shell de Gerenciamento do SharePoint Online somente para o usuário atual executando o seguinte comando:

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

Para garantir que você tenha todos os cmdlets disponíveis, sempre verifique se o módulo está atualizado. Você pode atualizar o Shell de Gerenciamento do SharePoint Online executando 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.

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

  1. Execute o seguinte comando no prompt de comando do 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 um usuário a função de administrador do SharePoint, consulte Atribuir funções de administrador ou Atribuir funções de administrador a contas de usuário do Microsoft 365 com o PowerShell.

Observação

Se você encontrar problemas ao tentar se conectar ou receber um erro como "Mensagem de erro: não foi possível se conectar ao SharePoint Online", talvez seja necessário usar 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 no prompt de comando do 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

Há um problema conhecido entre o módulo shell de gerenciamento do SharePoint Online e o SDK de Componentes do Cliente do SharePoint em que o módulo não será carregado se ambos forem instalados no mesmo computador. Se você encontrar esse problema, desinstale o SDK de Componentes do Cliente do SharePoint.