Connettersi a Exchange Online tramite Windows PowerShell

Completato

PowerShell per Exchange Online è il modulo che è possibile usare per gestire gli oggetti correlati alla posta elettronica in Exchange Online, ad esempio cassette postali, contatti e distribuzione. Alcune delle informazioni che è possibile esaminare e gestire usando PowerShell per Exchange Online, ad esempio gli indirizzi e-mail, possono essere esaminate anche nelle proprietà degli oggetti utente con i cmdlet di AzureAD. Le proprietà relative alla posta elettronica, tuttavia, possono essere gestite solo usando PowerShell per Exchange Online.

Nota

Nel momento in cui viene scritto questo percorso di apprendimento, la versione corrente del modulo PowerShell per Exchange Online è la V2 (EXO v2). Quando si cercano istruzioni su come connettersi a Exchange Online, queste indicano che è necessario usare la comunicazione remota di PowerShell oppure che il cmdlet Connect-EXOPSSession non è aggiornato e non deve essere tenuto presente.

Il modulo EXO v2 include tutti i cmdlet originali per la gestione di Exchange Online e diversi cmdlet aggiuntivi che includono EXO nel nome del cmdlet. Questi cmdlet EXO, ad esempio Get-EXOMailbox, sono più efficienti dei cmdlet originali.

Installazione del modulo EXO v2

Il modulo EXO v2 è supportato in Windows PowerShell 5.1 e PowerShell 7. Poiché è supportato in PowerShell 7, è considerato multipiattaforma. È possibile usare il modulo EXO v2 in Windows, macOS e Linux.

Per installare il modulo EXO v2, eseguire il comando seguente:

Install-Module -Name ExchangeOnlineManagement

Preparazione alla connessione

Per usare il modulo EXO v2, è necessario consentire gli script. È possibile impostare i criteri di esecuzione su RemoteSigned o Unrestricted. Se non si consentono gli script, si noterà l'errore che indica che non è possibile caricare i file perché l'esecuzione di script è disabilitata nel sistema.

È anche necessario consentire l'autenticazione di base per il client WinRM. Questa è abilitata per impostazione predefinita in Windows 10, ma alcune organizzazioni hanno disabilitato l'autenticazione di base per WinRM per rafforzare la sicurezza. Se l'autenticazione di base non è abilitata, si noterà l'errore Il client WinRM non è in grado di elaborare la richiesta. L'autenticazione di base è attualmente disabilitata nella configurazione client.

Per esaminare la configurazione dell'autenticazione per il client Gestione remota Windows (WinRM), eseguire il comando seguente:

winrm get winrm/config/client/auth

Per abilitare l'autenticazione di base per il client WinRM, eseguire il comando seguente:

winrm set winrm/config/client/auth '@{Basic="true"}'

Nota

Se si esegue questo comando da un prompt dei comandi anziché da un prompt di PowerShell, non includere le virgolette singole intorno a @{Basic="true"}.

Anche se è necessario abilitare l'autenticazione di base nel client WinRM, il modulo EXO v2 esegue l'autenticazione in Exchange Online usando l'autenticazione moderna. In alcuni casi rari l'autenticazione moderna potrebbe non essere abilitata per Exchange Online e sarà necessario abilitarla.

Nota

Tutte le distribuzioni di Exchange Online devono usare l'autenticazione moderna. Questo perché presenta miglioramenti significativi per la sicurezza rispetto all'autenticazione di base.

Connessione a Exchange Online

È possibile connettersi a Exchange Online usando il cmdlet Connect-ExchangeOnline senza parametri aggiuntivi. Quando si stabilisce la connessione a Exchange Online, vengono richiesti un nome utente e una password per l'accesso. È necessario accedere con un account utente dotato di privilegi sufficienti per completare le azioni che si intende eseguire. È possibile che venga richiesta anche l'autenticazione a più fattori.

Nota

Per i tenant in Cina o in Germania, è necessario usare rispettivamente il parametro -ExchangeEnvironmentName e specificare rispettivamente O365China o O365Germany. Per i tenant governativi statunitensi sicuri, è necessario specificare O365USGovGCCHigh o O365USGovDOD.

Se si è dietro a un server proxy, potrebbe essere necessario specificare le opzioni proxy durante la procedura di connessione. A tale scopo, specificare un oggetto PSSessionOption tra le informazioni di configurazione del proxy. Nell'esempio seguente viene illustrato come creare un nuovo oggetto PSSessionOption e quindi usarlo durante la connessione a Exchange Online:

$ProxyOptions = New-PSSessionOption -ProxyAccessType IEConfig
Connect-ExchangeOnline -PsSessionOption $ProxyOptions