Installare Microsoft Entra PowerShell

Il modulo di PowerShell Microsoft Entra consente ai professionisti IT di gestire in modo efficiente le risorse Microsoft Entra, garantendo un'integrazione e funzionalità senza problemi in varie piattaforme. Questo modulo migliora la possibilità di automatizzare e semplificare le attività amministrative.

Questo articolo illustra come installare, verificare, aggiornare e risolvere i problemi del modulo di PowerShell Microsoft Entra nei diversi sistemi operativi.

Il modulo di PowerShell Microsoft Entra è suddiviso in due moduli, ognuno con moduli secondari che possono essere installati separatamente. I due moduli principali sono:

  • Microsoft.Entra - la versione con disponibilità generale di Microsoft Entra PowerShell. Fa riferimento alle risorse di Microsoft Graph v1.0 e di SDK PowerShell di Microsoft Graph v1.0.
  • Microsoft. Entra.Beta: la Beta versione di anteprima o di Microsoft Entra PowerShell. Fa riferimento alle risorse Microsoft Graph Beta e SDK PowerShell di Microsoft Graph Beta.

PowerShell versione 7 o successiva è consigliato per l'uso con il modulo powerShell Microsoft Entra in tutte le piattaforme, tra cui Windows, Linux e macOS.

Installare il modulo powerShell Microsoft Entra in Windows

Metodo di installazione consigliato e versione di PowerShell per il modulo:

  • Eseguire l'installazione dal PowerShell Gallery
  • Usare con Windows PowerShell 5.1+ o PowerShell 7+.

Prerequisiti per Windows

  • Eseguire il comando seguente da PowerShell per determinare la versione di PowerShell:

    $PSVersionTable.PSVersion

  • Determinare se il modulo è installato:

    Get-Module -Name Microsoft.Entra -ListAvailable

  • Impostare i criteri di esecuzione di PowerShell su firma remota o meno restrittivi

    • Controllare i criteri di esecuzione di PowerShell:

      Get-ExecutionPolicy -List

    • Impostare il criterio di esecuzione di PowerShell in "Con firma remota":

      Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

    Per altre informazioni sui criteri di esecuzione, vedere about_Execution_Policies.

Installazione

Quando si installa il modulo, è possibile scegliere di installare l'intero modulo o un modulo secondario specifico. Gli esempi seguenti mostrano come installare l'intero modulo sia per v1.0 che per Beta.

Usare il cmdlet Install-Module per installare il modulo.

Install-Module -Name Microsoft.Entra -Repository PSGallery -Scope CurrentUser -Force -AllowClobber

Facoltativamente, è possibile modificare l'ambito dell'installazione usando il parametro Scope . Questa operazione richiede autorizzazioni di amministratore.

Install-Module -Name Microsoft.Entra -Repository PSGallery -Scope AllUsers -Force -AllowClobber

Installare moduli secondari specifici

L'installazione di moduli specifici è ideale per scenari di automazione come l'uso di Funzioni di Azure e Automazione di Azure.

Eseguire il comando seguente per elencare tutti i Microsoft.Entra moduli GA/v1.0 nel PowerShell Gallery:

Find-Module -Name "Microsoft.Entra*" -Repository PSGallery |
Where-Object { $_.Name -notmatch "beta" }

Questo comando elenca tutti i moduli Microsoft Entra PowerShell GA/v1.0 nella PowerShell Gallery.

Ad esempio, per installare il Users modulo, eseguire il comando seguente:

Install-Module -Name Microsoft.Entra.Users -Repository PSGallery -Force -AllowClobber

Installare Microsoft Entra PowerShell in Linux

Prerequisiti in Linux

Installazione in Linux

Quando si installa il modulo, è possibile scegliere di installare l'intero modulo o un modulo secondario specifico. Nell'esempio seguente viene illustrato come installare l'intero modulo.

Aprire il terminale o un'altra applicazione host della shell ed eseguire pwsh per avviare PowerShell.

Usare il cmdlet Install-Module per installare il modulo:

Install-Module -Name Microsoft.Entra -Repository PSGallery -Scope CurrentUser -Force -AllowClobber

Facoltativamente, è possibile modificare l'ambito dell'installazione usando il parametro Scope . Questa operazione richiede autorizzazioni di amministratore.

Install-Module -Name Microsoft.Entra -Repository PSGallery -Scope AllUsers -Force -AllowClobber

Installare moduli secondari specifici in Linux

L'installazione di moduli specifici è ideale per scenari di automazione come l'uso di Funzioni di Azure e Automazione di Azure.

Eseguire il comando seguente per elencare tutti i Microsoft.Entra moduli GA/v1.0 nel PowerShell Gallery:

Find-Module -Name "Microsoft.Entra*" -Repository PSGallery |
Where-Object { $_.Name -notmatch "beta" }

Questo comando elenca tutti i moduli Microsoft Entra PowerShell GA/v1.0 nella PowerShell Gallery.

Ad esempio, per installare il Users modulo, eseguire il comando seguente:

Install-Module -Name Microsoft.Entra.Users -Repository PSGallery -Force -AllowClobber

Installare Microsoft Entra PowerShell in macOS

Questo articolo illustra come installare il modulo dal PowerShell Gallery in macOS.

Prerequisiti in macOS

Installazione in macOS

Quando si installa il modulo, è possibile scegliere di installare l'intero modulo o un modulo secondario specifico. Nell'esempio seguente viene illustrato come installare l'intero modulo.

Aprire il terminale o un'altra applicazione host della shell ed eseguire pwsh per avviare PowerShell.

Usare il cmdlet Install-Module per installare il modulo di PowerShell Microsoft Entra:

Install-Module -Name Microsoft.Entra -Repository PSGallery -Scope CurrentUser -Force -AllowClobber

Facoltativamente, è possibile modificare l'ambito dell'installazione usando il parametro Scope . Questa operazione richiede autorizzazioni di amministratore.

Install-Module -Name Microsoft.Entra -Repository PSGallery -Scope AllUsers -Force -AllowClobber

Installare moduli secondari specifici in macOS

L'installazione di moduli specifici è ideale per scenari di automazione come l'uso di Funzioni di Azure e Automazione di Azure.

Eseguire il comando seguente per elencare tutti i Microsoft.Entra moduli GA/v1.0 nel PowerShell Gallery:

Find-Module -Name "Microsoft.Entra*" -Repository PSGallery |
Where-Object { $_.Name -notmatch "beta" }

Questo comando elenca tutti i moduli Microsoft Entra PowerShell GA/v1.0 presenti nella PowerShell Gallery.

Ad esempio, per installare il Users modulo, eseguire il comando seguente:

Install-Module -Name Microsoft.Entra.Users -Repository PSGallery -Force -AllowClobber

Verificare la versione e il percorso del modulo installati

Al termine dell'installazione, è possibile verificare i moduli secondari installati, la relativa versione e il percorso con il comando seguente.

Get-InstalledModule -Name Microsoft.Entra* |
Where-Object { $_.Name -notmatch "Beta" } | Format-Table Name, Version, InstalledLocation -AutoSize

Questo comando mostra il Microsoft Entra modulo di PowerShell installato, la relativa versione e il percorso di installazione. La versione di output deve corrispondere alla versione più recente del PowerShell Gallery. È ora possibile usare il modulo.

Name                                Version InstalledLocation
----                                ------- -----------------
Microsoft.Entra                     1.0.1   <PowerShell-Path>\PowerShell\Modules\Microsoft.Entra\1.0.1
Microsoft.Entra.Applications        1.0.1   <PowerShell-Path>\PowerShell\Modules\Microsoft.Entra.Applications\1.0.1
Microsoft.Entra.Authentication      1.0.1   <PowerShell-Path>\PowerShell\Modules\Microsoft.Entra.Authentication\1.0.1
Microsoft.Entra.DirectoryManagement 1.0.1   <PowerShell-Path>\PowerShell\Modules\Microsoft.Entra.DirectoryManagement\1.0.1
Microsoft.Entra.Governance          1.0.1   <PowerShell-Path>\PowerShell\Modules\Microsoft.Entra.Governance\1.0.1
Microsoft.Entra.Groups              1.0.1   <PowerShell-Path>\PowerShell\Modules\Microsoft.Entra.Groups\1.0.1
Microsoft.Entra.Reports             1.0.1   <PowerShell-Path>\PowerShell\Modules\Microsoft.Entra.Reports\1.0.1
Microsoft.Entra.SignIns             1.0.1   <PowerShell-Path>\PowerShell\Modules\Microsoft.Entra.SignIns\1.0.1
Microsoft.Entra.Users               1.0.1   <PowerShell-Path>\PowerShell\Modules\Microsoft.Entra.Users\1.0.1

Per verificare se, ad esempio, è installato un modulo secondario specifico, Users eseguire:

Get-InstalledModule -Name Microsoft.Entra.Users

La versione di output deve corrispondere alla versione più recente del PowerShell Gallery.

Version              Name                                Repository           Description
-------              ----                                ----------           -----------
1.0.1                Microsoft.Entra.Users               PSGallery            Microsoft Entra PowerShell

Risolvere i problemi di installazione

Error Cause Soluzione
Install-Module: non è possibile trovare un parametro corrispondente al nome del parametro AllowPrerelease. Si usa una versione precedente di Install-Module. Per eseguire l'aggiornamento, seguire questa guida. Il problema si applica solo alla piattaforma Windows.
Il modulo dipendente 'module-name' non è installato nel computer. Per utilizzare il modulo corrente 'Microsoft.Entra', assicurarsi che sia installato il relativo modulo dipendente 'module-name'. Le dipendenze di PowerShell per Microsoft Entra non sono installate Per eseguire l'installazione, usare questo script
I cmdlet esistono già nel sistema Aggiungi -AllowClobber parametro: Install-Module -Name Microsoft.Entra -Repository PSGallery -Force -AllowClobber
I comandi seguenti sono già disponibili in questo sistema: 'Enable-EntraAzureADAlias,Get-EntraUnsupportedCommand,Test-EntraScript' Si verifica un conflitto quando Beta o v1.0 è già installato Per risolvere il problema, disinstallare la versione del modulo che causa l'errore.

Per soluzioni ad altre installazioni comuni e altri problemi generali, vedere Risolvere i problemi di installazione dei moduli.

Accedere

Per iniziare a gestire le risorse Microsoft Entra con il modulo di PowerShell Microsoft Entra, avviare una sessione di PowerShell ed eseguire Connect-Entra per accedere a Microsoft Entra ID:

Connect-Entra -Scopes 'User.Read.All'
Get-EntraUser -Filter "userPrincipalName eq 'SawyerM@contoso.com'"

Usare le credenziali di Microsoft Entra per accedere alla finestra di accesso visualizzata.

È necessario ripetere questo passaggio per ogni nuova sessione di PowerShell avviata.

Per altre informazioni su altri scenari di autenticazione, vedere altri scenari di autenticazione.

Aggiornare il modulo

Se il modulo è installato, seguire questa procedura per aggiornarlo.

Prima di tutto, verificare la versione e il percorso del modulo usando le indicazioni riportate nella sezione verificare l'installazione di questo articolo.

Aggiornare alla versione più recente

Usare Update-Module per eseguire l'aggiornamento alla versione più recente del modulo di PowerShell Microsoft Entra.

Update-Module -Name Microsoft.Entra -Force

Per aggiornare un modulo secondario specifico, ad esempio Users, eseguire:

Update-Module -Name Microsoft.Entra.Users -Force

L'aggiornamento del modulo Microsoft Entra PowerShell tramite Update-Module non rimuove le versioni precedenti del modulo dal sistema.

Disinstallare il modulo

Per rimuovere il modulo, eseguire il comando :

Uninstall-Module -Name Microsoft.Entra -AllVersions -Force

Per disinstallare un modulo secondario specifico, ad esempio Users, eseguire:

Uninstall-Module -Name Microsoft.Entra.Users -AllVersions -Force

Per disinstallare tutti i moduli secondari, eseguire:

$InstalledSubModules = Get-InstalledModule -Name Microsoft.Entra.* |
Where-Object { $_.Name -notmatch "Beta" }
foreach ($module in $InstalledSubModules) {
    Write-Host "Checking for submodule: $($module.Name)" -ForegroundColor Yellow -BackgroundColor DarkBlue
    Uninstall-Module -Name $module.Name -Force -ErrorAction Stop
    Write-Host "Successfully uninstalled submodule: $($module.Name)" -ForegroundColor Green
}

Passaggi successivi

  • Per altre informazioni sull'esplorazione del modulo Microsoft Entra PowerShell, vedere l'articolo Esplorare il modulo.
  • Last updated on