Instalar o PowerShell do Azure Active Directory para Graph

  • Artigo

Importante

Azure AD o Powershell está previsto para ser preterido a 30 de março de 2024. Para obter mais detalhes sobre os planos de preterição, veja a atualização de preterição. Recomendamos que continue a migrar para o Microsoft Graph PowerShell, que é o módulo recomendado para interagir com Azure AD. Além disso, o Microsoft Graph PowerShell permite-lhe aceder a todas as APIs do Microsoft Graph e está disponível no PowerShell 7. Para obter respostas a consultas de migração frequentes, consulte as FAQ sobre Migração.

Pode utilizar a versão do módulo do PowerShell do Azure Active Directory para o Graph para Azure AD tarefas administrativas, como a gestão de utilizadores, a gestão de domínios e para configurar o início de sessão único. Os cmdlets listados aqui são diferentes dos cmdlets msOnline que fazem parte da versão 1.0 do PowerShell do Azure Active Directory.

O módulo Azure AD PowerShell para Graph tem duas versões: uma versão de Pré-visualização Pública e uma versão de Disponibilidade Geral (GA). Não é recomendado utilizar a versão de Pré-visualização Pública para cenários de produção.

Transfira os módulos do Galeria do PowerShell utilize o seguinte;

Azure Active Directory PowerShell for Graph release version history (Histórico de versões de versões do Azure Active Directory para Graph)

O histórico de lançamentos do módulo Azure AD e do módulo Azure AD Preview está aqui:azure active directory powershell for graph: version release history( Histórico de versões).

Instalar o Módulo Azure AD

Pré-requisitos

O módulo Azure AD é suportado nos seguintes sistemas operativos Windows com a versão predefinida do Microsoft .NET Framework e Windows PowerShell:

  • Windows 8.1
  • Windows 8
  • Windows 7
  • Windows Server 2012 R2,
  • Windows Server 2012
  • Windows Server 2008 R2.

Nota

O módulo Azure AD PowerShell não é compatível com o PowerShell 7. Só é suportado no PowerShell 5.1.

Para instalar a versão de Disponibilidade Geral do módulo, execute:

Install-Module AzureAD

Para instalar a versão de pré-visualização pública, execute:

Install-module AzureADPreview

Não é possível instalar a versão de pré-visualização e a versão ga no mesmo computador ao mesmo tempo.

O módulo Azure AD é distribuído com o Galeria do PowerShell. A instalação de itens a partir da galeria requer a versão mais recente do módulo PowerShellGet, que está disponível no Windows 10, no Windows Management Framework (WMF) 5.0 ou no instalador baseado em MSI (para o PowerShell 3 e 4).

Com o módulo PowerShellGet mais recente, pode:

Consultar a página Introdução para obter mais informações sobre como utilizar os comandos do PowerShellGet com a Galeria. Também pode executar Update-Help -Module PowerShellGet para instalar ajuda local para estes comandos.

Sistemas Operativos Suportados

O módulo PowerShellGet requer o PowerShell 3.0 ou mais recente.

Por conseguinte, o PowerShellGet requer um dos seguintes sistemas operativos:

  • Windows 10
  • Windows 8.1 Pro
  • Windows 8.1 Enterprise
  • Windows 7 SP1
  • Windows Server 2016 TP5
  • Windows Server 2012 R2
  • Windows Server 2008 R2 SP1

O PowerShellGet também requer .NET Framework 4.5 ou superior. Pode instalar o .NET Framework 4.5 ou posterior a partir daqui.

Atualizar o Módulo Azure AD

Para verificar a versão do módulo instalado no computador, execute este comando:

Get-Module AzureADPreview

ModuleType Version Name                ExportedCommands
---------- ------- ----                ----------------
Binary     2.0.0.7 azureadpreview     {Add-AzureADAdmini...

Para atualizar a versão do módulo Azure AD PowerShell no seu computador, execute novamente o cmdlet Install-Module:

Install-Module AzureADPreview

Este comando verifica a galeria do PowerShell para ver se está disponível uma versão mais recente. Se sim, o mais recente do que o instalado no seu computador.

Ligar ao Azure AD

Para poder executar qualquer um dos cmdlets referidos neste artigo, primeiro tem de ligar ao seu serviço online. Para tal, execute o cmdlet Connect-AzureAD na linha de comando do Windows PowerShell. Em seguida, ser-lhe-ão pedidas as suas credenciais. Se pretender, pode fornecer as suas credenciais antecipadamente, por exemplo:

$AzureAdCred = Get-Credential
Connect-AzureAD -Credential $AzureAdCred

O primeiro comando pede as credenciais e armazena-as como $AzureAdCred. O comando seguinte utiliza essas credenciais como $azureadcred para ligar ao serviço.

Nota

Os módulos Azure AD e Azure AD Preview incluem cmdlets com diferentes convenções de nomenclatura, ou seja, -AzureAD e -AzureADMS. Os -AzureAD cmdlets ligam-se ao ponto https://graph.windows.net final do Graph Azure AD enquanto os -AzureADMS cmdlets fazem chamadas para o ponto graph.microsoft.comfinal do Microsoft Graph. A autenticação é processada automaticamente quando altera as chamadas de um ponto final para outro e não lhe são pedidas as credenciais novamente.

Para ligar a um ambiente específico do Azure Active Directory, utilize o parâmetro AzureEnvironment, da seguinte forma:

Connect-AzureAD -AzureEnvironment "AzureGermanyCloud"

Este exemplo liga a sua sessão do PowerShell ao ambiente do AzureAD alemão. Veja Connect-AzureAD para obter mais informações.

Passos seguintes