Conectar ao Microsoft 365 com PowerShell

• 07/17/2020
• 6 minutos para ler
• • J
  • D
  • m
  • d

Este artigo aplica-se tanto ao Microsoft 365 Enterprise como ao Office 365 Enterprise.

PowerShell para Microsoft 365 permite-lhe gerir as suas definições do Microsoft 365 a partir da linha de comandos. Para se ligar ao PowerShell, basta instalar o software necessário e depois ligar-se à sua organização Microsoft 365.

Existem duas versões do módulo PowerShell que pode utilizar para se ligar ao Microsoft 365 e administrar contas de utilizador, grupos e licenças:

• Azure Active Directory PowerShell for Graph, cujos cmdlets incluem o AzureAD em seu nome
• Microsoft Azure Active Directory Module for Windows PowerShell, cujos cmdlets incluem o Msol em seu nome

Atualmente, o módulo Azure Active Directory PowerShell for Graph não substitui completamente a funcionalidade do módulo Microsoft Azure Active Directory Module for Windows PowerShell para administração de usuários, grupos e licenças. Em alguns casos, você precisa usar as duas versões. Você pode instalar com segurança ambas as versões no mesmo computador.

O que você precisa saber antes de começar?

Operating system

Você deve usar uma versão de 64 bits do Windows. Suporte para a versão 32-bit do Microsoft Azure Active Directory Module for Windows PowerShell terminou em 2014.

Pode usar as seguintes versões do Windows:

• Windows 10, Windows 8.1, Windows 8, ou Windows 7 Service Pack 1 (SP1)

• Windows Server 2019, Windows Server 2016, Windows Server 2012 R2, Windows Server 2012, ou Windows Server 2008 R2 SP1

PowerShell

• Para o módulo Active Directory PowerShell para Graph, você deve usar o PowerShell versão 5.1 ou posterior.

• Para o módulo Microsoft Azure Active Directory Module para Windows PowerShell, você deve usar o PowerShell versão 5.1 ou posterior, até o PowerShell versão 6. Não pode utilizar o PowerShell versão 7.

Connect with the Azure Active Directory PowerShell for Graph module

Comandos no módulo Azure Active Directory PowerShell for Graph têm o nome AzureAD no seu cmdlet. Pode instalar o Azure Active Directory PowerShell para módulo Graph ou Azure PowerShell.

Para procedimentos que requerem os novos cmdlet no módulo Azure Active Directory PowerShell para módulo Graph, siga estes passos para instalar o módulo e ligar-se à sua subscrição Microsoft 365.

Passo 1: Instale o software necessário

Estes passos são necessários apenas uma vez no seu computador. Mas você provavelmente precisará atualizar o software periodicamente.

1. Abra uma janela elevada do Windows PowerShell Command Prompt (execute o Windows PowerShell como administrador).

2. Executar este comando:

   Install-Module -Name AzureAD

   Se você for solicitado a instalar um módulo a partir de um repositório não confiável, digite Y e pressione Enter.

Passo 2: Ligue-se ao Azure AD para a sua subscrição do Microsoft 365

Para se ligar ao Azure Active Directory (Azure AD) para a sua subscrição do Microsoft 365 com um nome de conta e palavra-passe ou com autenticação multi-factor, execute um destes comandos a partir de um prompt de comando do Windows PowerShell. (Não precisa de ser elevado.)

Na caixa de diálogo Entrar na sua conta, digite o nome de usuário e senha do seu trabalho Microsoft 365 ou conta de escola e, em seguida, selecione OK.

Se você estiver usando autenticação multi-factor, siga as instruções para fornecer informações adicionais de autenticação, como um código de verificação.

Depois de conectar, você pode usar os cmdlets para o módulo PowerShell do Azure Active Directory para Graph.

Conecte-se com o Módulo Microsoft Azure Active Directory para Windows PowerShell

PowerShell versão 7 e posteriores não suportam o Módulo Microsoft Azure Active Directory para Windows PowerShell e cmdlets com Msol no nome. Para PowerShell versão 7 e posterior, você deve usar o módulo Azure Active Directory PowerShell para Graph ou Azure PowerShell.

PowerShell Core não suporta o módulo Microsoft Azure Active Directory Module para Windows PowerShell e cmdlets com Msol em seu nome. Execute estes cmdlets do Windows PowerShell.

Passo 1: Instale o software necessário

Estes passos são necessários apenas uma vez no seu computador. Mas provavelmente terá de actualizar o software periodicamente.

1. Se não estiver a executar o Windows 10, instale a versão de 64 bits do Microsoft Online Services Sign-in Assistant: Microsoft Online Services Sign-in Assistant for IT Professionals RTW.

2. Seguir estes passos para instalar o Microsoft Azure Active Directory Module for Windows PowerShell:

   1. Abrir um prompt de comando elevado do Windows PowerShell (execute o Windows PowerShell como administrador).
   2. Executar o comando Install-Module MSOnline.
   3. Se lhe for pedido para instalar o provedor NuGet, digite Y e pressione Enter.
   4. Se lhe for pedido para instalar o módulo da PSGallery, digite Y e pressione Enter.

Passo 2: Ligue-se ao Azure AD para a sua subscrição Microsoft 365

Para se ligar ao Azure AD para a sua subscrição Microsoft 365 com um nome de conta e palavra-passe ou com autenticação multi-factor, execute um destes comandos a partir de um prompt de comando do Windows PowerShell. (Não precisa de ser elevado.)

Na caixa de diálogo Entrar na sua conta, digite o nome de usuário e a senha da sua conta de trabalho ou da conta da escola Microsoft 365 e selecione OK.

Se estiver a usar autenticação multi-factor, siga as instruções para fornecer informações adicionais de autenticação, como um código de verificação.

Como sabe que funcionou?

Se não receber uma mensagem de erro, ligou-se com sucesso. Para um teste rápido, execute um Microsoft 365 cmdlet, como o Get-MsolUser, e veja os resultados.

Se receber uma mensagem de erro, verifique os seguintes problemas:

• Um problema comum é uma senha incorreta. Execute o Passo 2 novamente, e preste muita atenção no nome de usuário e senha que você digitar.

• O Microsoft Azure Active Directory Module for Windows PowerShell requer que o Microsoft .NET Framework 3.5.x esteja habilitado no seu computador. É provável que o seu computador tenha uma versão mais recente instalada (por exemplo, 4 ou 4.5.x). Mas a compatibilidade retroativa com versões antigas do .NET Framework pode ser ativada ou desativada. Para mais informações, veja os seguintes artigos:

  • Para Windows Server 2012 ou Windows Server 2012 R2, veja Ativar o .NET Framework 3.5 usando o Assistente de Adicionar Funções e Recursos.

  • Para Windows 7 ou Windows Server 2008 R2, veja Você não pode abrir o Módulo Active Directory do Azure para Windows PowerShell.

  • Para Windows 10, Windows 8.1 e Windows 8, veja Instalar o .NET Framework 3.5 no Windows 10, Windows 8.1 e Windows 8.

• Sua versão do módulo Active Directory do Microsoft Azure para Windows PowerShell pode estar desatualizada. Para verificar, execute o seguinte comando no PowerShell para Microsoft 365 ou no Microsoft Azure Active Directory Module for Windows PowerShell:

  (Get-Item C:\Windows\System32\WindowsPowerShell\v1.0\Modules\MSOnline\Microsoft.Online.Administration.Automation.PSModule.dll).VersionInfo.FileVersion

  Se o número da versão retornada for inferior a 1.0.8070.2, desinstale o Microsoft Azure Active Directory Module for Windows PowerShell e instale a partir do Passo 1, acima.

• Se receber uma mensagem de erro de conexão, consulte “Connect-MsolService”: Exception of type was thrown” error.

• Se você receber uma mensagem de erro “Get-Item”: Não é possível encontrar o caminho”, execute este comando:

   (dir "C:\Program Files\WindowsPowerShell\Modules\MSOnline").Name

Ver também

• Gerenciar Microsoft 365 com PowerShell
• Comece com PowerShell para Microsoft 365
• Conectar-se a todos os serviços Microsoft 365 em uma única janela do Windows PowerShell