Instalar o PowerShell do Azure Active Directory para Graph
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.
Sobre a Galeria do PowerShell
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:
- Pesquisar itens na Galeria com os cmdlets Find-Module e Find-Script
- Guardar itens no seu sistema a partir da Galeria com Guardar Módulo e Guardar Script
- Instalar itens a partir da Galeria com os cmdlets Install-Module e Install-Script
- Carregar itens para a Galeria com os cmdlets Publish-Module e Publish-Script
- Adicionar o seu repositório personalizado com o cmdlet Register-PSRepository
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.