Inicie no 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 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 você já instalou o Shell de Gerenciamento SharePoint Online executando o seguinte comando no modo administrativo no PowerShell:

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

Observação

  • Você sempre deve verificar se tem várias versões do shell de gerenciamento instaladas.

  • Se você encontrar várias versões instaladas, desinstale o número de versão mais baixo para garantir que você tenha todos os comandos mais recentes.

    Exemplo: Uninstall-Module -Name Microsoft.Online.SharePoint.PowerShell -RequiredVersion 16.0.21211.12000

Se o sistema operacional estiver usando o PowerShell 5 ou mais novo, você também poderá instalar o Shell de Gerenciamento 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 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, você sempre deve certificar-se de que o módulo está atualizado. Você pode atualizar o Shell de Gerenciamento 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 SharePoint Shell de Gerenciamento 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 SharePoint de administrador, consulte Atribuir funções de administrador ou Atribuir funções de administrador Microsoft 365 contas de usuário com o PowerShell.

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

  1. Execute o seguinte comando no prompt de comando SharePoint Shell de Gerenciamento 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

  • Se você encontrar problemas ao tentar se conectar usando o MFA, consulte Não é possível forçar a Autenticação Moderna ao usar o cmdletConnect-SPOService no shell de gerenciamento SharePoint Online.

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

  • Se você precisar especificar a região do seu ambiente SharePoint Online, use o parâmetro -Region, para obter mais informações, consulte a documentação Conexão-SPOService.