Instale o Azure Active Directory PowerShell para Graph

  • Artigo

Importante

Azure AD Powershell está previsto para ser preterido em 30 de março de 2024. Para obter mais detalhes sobre os planos de substituição, consulte a atualização de substituição. Incentivamos você a continuar migrando para o Microsoft Graph PowerShell, que é o módulo recomendado para interagir com Azure AD. Além disso, o Microsoft Graph PowerShell permite que você acesse todas as APIs do Microsoft Graph e está disponível no PowerShell 7. Para obter respostas para consultas de migração frequentes, consulte as Perguntas frequentes sobre migração.

Você pode usar a versão do módulo do PowerShell do Azure Active Directory para o Graph para Azure AD tarefas administrativas, como gerenciamento de usuários, gerenciamento de domínio e configuração de logon único. Os cmdlets listados aqui são diferentes dos cmdlets do MSOnline que fazem parte do Azure Active Directory PowerShell versão 1.0.

O módulo Azure AD PowerShell para Graph tem duas versões: uma versão de visualização pública e uma versão ga (disponibilidade geral). Não é recomendável usar a versão de Visualização Pública para os cenários de produção.

Baixe os módulos do Galeria do PowerShell use o seguinte;

Histórico de versão do PowerShell 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 para grafo: histórico de versão de versão.

Instale o Módulo do Azure AD

Pré-requisitos

O módulo Azure AD tem suporte nos seguintes sistemas operacionais Windows com a versão padrão 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.

Observação

O módulo Azure AD PowerShell não é compatível com o PowerShell 7. Ele só tem suporte no PowerShell 5.1.

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

Install-Module AzureAD

Para instalar a versão prévia pública, execute:

Install-module AzureADPreview

Não é possível instalar a versão prévia e a versão ga no mesmo computador ao mesmo tempo.

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

Com o módulo PowerShellGet mais recente, você pode:

Confira a página Introdução para obter mais informações sobre como usar os comandos PowerShellGet com a Galeria. Também é possível executar Update-Help -Module PowerShellGet para instalar a ajuda local para esses comandos.

Sistemas operacionais com suporte

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

Portanto, PowerShellGet exige um dos seguintes sistemas operacionais:

  • 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 o .NET Framework 4.5 ou posterior. Você pode instalar o .NET Framework 4.5 ou acima acessando aqui.

Atualizando o Módulo do Azure AD

Para marcar 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 computador, execute novamente o cmdlet Install-Module:

Install-Module AzureADPreview

Esse comando verifica a galeria do PowerShell para ver se uma versão mais recente está disponível. Em caso afirmativo, o mais recente do que o instalado no computador.

Conecte-se ao AD do Azure

Antes de executar qualquer um dos cmdlets analisados neste artigo, primeiro você deve conectar seu serviço online. Para tanto, execute o cmdlet Connect-AzureAD no prompt de comando do Windows PowerShell. Em seguida, você será solicitado a fornecer suas credenciais. Se você quiser, poderá fornecer suas credenciais antecipadamente, por exemplo:

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

O primeiro comando solicita as credenciais e armazena-as como $AzureAdCred. O comando seguinte usa essas credenciais como $azureadcred para conectar o serviço.

Observação

Os módulos Azure AD e Azure AD Preview são compostos por cmdlets com diferentes convenções de nomenclatura, ou seja, -AzureAD e -AzureADMS. Os -AzureAD cmdlets se conectam ao ponto de extremidade https://graph.windows.net do Azure AD Graph enquanto os -AzureADMS cmdlets fazem chamadas para o ponto graph.microsoft.comde extremidade do Microsoft Graph. A autenticação é tratada silenciosamente quando você altera as chamadas de um ponto de extremidade para outro e você não é solicitado a fornecer as credenciais novamente.

Para conectar um ambiente específico do Azure Active Directory, use o parâmetro AzureEnvironment da seguinte maneira:

Connect-AzureAD -AzureEnvironment "AzureGermanyCloud"

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

Próximas etapas