Azure Active Directory PowerShell per Graph

  • Articolo

È 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 MSOL che fanno parte del modulo MSOnline PowerShell.

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

Il modulo di anteprima di Azure AD PowerShell per Graph può essere scaricato dal PowerShell Gallery nella pagina AzureADPreview.

Il modulo di disponibilità generale di Azure AD PowerShell per Graph può essere scaricato dal PowerShell Gallery nella pagina AzureAD.

Installare il modulo di Azure AD

Il modulo Azure AD PowerShell per Graph è 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 o Windows Server 2008 R2.

Se il computer soddisfa tutti i prerequisiti per l'installazione, per installare la versione con disponibilità generale del modulo nel computer è possibile eseguire

Install-Module AzureAD

Per installare la versione di anteprima pubblica, usare

Install-module AzureADPreview

Non è possibile installare la versione di anteprima e la versione con disponibilità generale nello stesso computer contemporaneamente.

Il modulo di Azure AD viene distribuito usando PowerShell Gallery. L'installazione degli elementi di PowerShell Gallery 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

È possibile controllare la versione del modulo installata nel computer eseguendo questo comando:

PS C:\WINDOWS\system32> Get-Module AzureADPreview

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

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

PS C:\WINDOWS\system32> Install-Module AzureADPreview

Questo comando controlla se in PowerShell Gallery è disponibile una versione più recente e la installa nel computer se la versione in PowerShell Gallery è più recente di quella installata.

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. Verranno quindi chieste 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.

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.

Se si hanno suggerimenti,

Se si hanno suggerimenti su come migliorare Azure Active Directory PowerShell, non esitarsi a comunicare.

Altre informazioni su Windows PowerShell

Windows PowerShell è una shell della riga di comando basata su attività e un linguaggio di script progettato per l'amministrazione del sistema. Diversamente dalla maggior parte delle shell, che accettano e restituiscono testo, Windows PowerShell è basato su .NET Framework e accetta e restituisce oggetti di .NET Framework.

Windows PowerShell introduce il concetto di cmdlet (si pronuncia "command-let"), un semplice strumento da riga di comando con una singola funzione, incorporato nella shell. I cmdlet usano questa convenzione di denominazione: un verbo e un sostantivo separati da un trattino (-), come Get-Help, Get-Process e Start-Service. Windows PowerShell include oltre cento cmdlet di base.

Per altre informazioni su questi cmdlet e sulla loro sintassi, usare il comando Get-Help <cmdlet name>, dove <cmdlet name> è il nome del cmdlet che si vuole cercare. Per informazioni più dettagliate, è possibile eseguire uno dei comandi seguenti:

  • Get-Help <cmdlet name> -Detailed
  • Get-Help <cmdlet name> -Examples
  • Get-Help <cmdlet name> -Full

Per altre informazioni su Windows PowerShell, vedere Guida introduttiva a Windows PowerShell.