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 marcar 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 seu sistema operacional estiver usando o Windows PowerShell 5, 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, certifique-se sempre de que o módulo esteja 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.

Observação

Para executar comandos do PowerShell do SharePoint Online em um console do Windows PowerShell 7, você deve importar o módulo do SharePoint usando 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 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 função de administrador do SharePoint a um usuário, confira 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 do Shell de Gerenciamento do SharePoint Online e o SDK dos Componentes do Cliente do SharePoint, em que o módulo não será carregado se ambos estiverem instalados no mesmo computador. Se você encontrar esse problema, desinstale o SDK dos Componentes do Cliente do SharePoint.