Inicie no Shell de Gerenciamento do SharePoint Online

  • Artigo

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 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, 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 Online do SharePoint:

    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 Microsoft 365 contas de usuário 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 Online do SharePoint:

    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 online do SharePoint e o SDK de Componentes do Cliente do SharePoint em que o módulo falhará ao carregar se ambos estiverem instalados no mesmo computador. Se você encontrar esse problema, desinstale o SDK de Componentes do Cliente do SharePoint.