Instale o Azure Active Directory PowerShell para Graph
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.
Sobre a Galeria do PowerShell
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:
- Pesquisar itens na Galeria com Find-Module e Find-Script
- Salvar itens da Galeria em seu sistema com Save-Module e Save-Script
- Instalar itens da Galeria com Install-Module e Install-Script
- Carregar itens na Galeria com Publish-Module e Publish-Script
- Adicionar seu próprio repositório personalizado com Register-PSRepository
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
- Confira os Novos recursos e aprimoramentos.