Installare Azure Active Directory PowerShell per Graph

  • Articolo

Importante

Azure AD PowerShell è pianificato per la deprecazione il 30 marzo 2024. Per altre informazioni sui piani di deprecazione, vedere l'aggiornamento deprecazione. È consigliabile continuare la migrazione a Microsoft Graph PowerShell, ovvero il modulo consigliato per interagire con Azure AD. Microsoft Graph PowerShell consente inoltre di accedere a tutte le API di Microsoft Graph ed è disponibile in PowerShell 7. Per le risposte alle frequenti query di migrazione, vedere le domande frequenti sulla migrazione.

È possibile usare la versione del modulo PowerShell di Azure Active Directory per Graph per le attività amministrative di Azure AD, ad esempio gestione utenti, gestione del dominio e per la configurazione dell'accesso Single Sign-On. I cmdlet elencati di seguito sono diversi dai cmdlet MSOnline che fanno parte di Azure Active Directory PowerShell versione 1.0.

Il modulo Di Azure AD PowerShell per Graph include due versioni: una versione di anteprima pubblica e una versione generale di disponibilità (GA). Non è consigliabile usare la versione di anteprima pubblica per scenari di produzione.

Scaricare i moduli dalla PowerShell Gallery usare quanto segue;

Cronologia delle versioni di PowerShell di Azure Active Directory per Graph

La cronologia delle versioni per il modulo Azure AD e il modulo di anteprima di Azure AD è disponibile qui:azure active directory powershell per graph: cronologia della versione.

Installare il modulo di Azure AD

Prerequisiti

Il modulo Azure AD è supportato nei sistemi operativi Windows seguenti con la versione predefinita di 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

Il modulo di Azure AD PowerShell non è compatibile con PowerShell 7. È supportato solo in PowerShell 5.1.

Per installare la versione di disponibilità generale del modulo, eseguire:

Install-Module AzureAD

Per installare la versione di anteprima pubblica, eseguire:

Install-module AzureADPreview

Non è possibile installare sia la versione di anteprima che la versione ga nello stesso computer contemporaneamente.

Il modulo Azure AD viene distribuito usando il PowerShell Gallery. L'installazione di elementi dalla raccolta richiede la versione più recente del modulo PowerShellGet, disponibile in Windows 10, in Windows Management Framework (WMF) 5.0 o nel programma di installazione basato su MSI (per PowerShell 3 e 4).

Con la versione più recente del modulo PowerShellGet, è possibile:

Per altre informazioni su come usare i comandi PowerShellGet con PowerShell Gallery, consultare la pagina Introduzione. È inoltre possibile eseguire Update-Help -Module PowerShellGet per installare la Guida locale per tali comandi.

Sistemi operativi supportati

Il modulo PowerShellGet richiede PowerShell 3.0 o versione successiva.

Di conseguenza, PowerShellGet richiede uno dei sistemi operativi seguenti:

  • 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

PowerShellGet richiede anche .NET Framework 4.5 o versione successiva. È possibile installare .NET Framework 4.5 o versione successiva da qui.

Aggiornamento del modulo di Azure AD

Per controllare la versione del modulo installato nel computer, eseguire questo comando:

Get-Module AzureADPreview

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

Per aggiornare la versione del modulo Di Azure AD PowerShell nel computer, eseguire nuovamente il cmdlet Install-Module :

Install-Module AzureADPreview

Questo comando controlla la raccolta di PowerShell per verificare se è disponibile una versione più recente. In caso affermativo, la versione più recente di quella installata nel computer.

Connessione ad Azure AD

Prima di poter eseguire i cmdlet descritti in questo articolo, è necessario connettersi al servizio online. A questo scopo, eseguire il cmdlet Connect-AzureAD nel prompt del comandi di Windows PowerShell. Verrà quindi richiesto di specificare le credenziali. Se si vuole, è possibile specificare le credenziali in anticipo, ad esempio:

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

Il primo comando chiede le credenziali e le archivia come $AzureAdCred. Il comando successivo usa queste credenziali come $azureadcred per la connessione al servizio.

Nota

I moduli di Anteprima di Azure AD e Azure AD sono costituiti da cmdlet con convenzioni di denominazione diverse, ad esempio -AzureAD e -AzureADMS. I -AzureAD cmdlet si connettono all'endpoint https://graph.windows.net di Azure AD Graph mentre i -AzureADMS cmdlet effettuano chiamate all'endpoint graph.microsoft.comDi Microsoft Graph. L'autenticazione viene gestita in modo automatico quando si modificano le chiamate da un endpoint a un altro e non viene richiesto di nuovo le credenziali.

Per connettersi a un ambiente specifico di Azure Active Directory, usare il parametro AzureEnvironment, in questo modo:

Connect-AzureAD -AzureEnvironment "AzureGermanyCloud"

Questo esempio connette la sessione di PowerShell all'ambiente AzureAD tedesco. Per altre informazioni, vedere Connect-AzureAD.

Passaggi successivi