Informazioni sul modulo PowerShell di Exchange Online

Il modulo PowerShell di Exchange Online, noto anche come modulo PowerShell V3 di Exchange Online o modulo EXO V3 dal 2022) usa l'autenticazione moderna e funziona con o senza autenticazione a più fattori (MFA) per connettersi a tutti gli ambienti PowerShell correlati al cloud di Exchange: Exchange Online PowerShell, sicurezza & conformità PowerShell e PowerShell per il componente aggiuntivo per la sicurezza predefinita per le cassette postali locali.

Per le istruzioni di connessione tramite il modulo, vedere i seguenti articoli:

• Connettersi a PowerShell per Exchange Online

  Consiglio

  Le istruzioni di connessione per PowerShell nel componente aggiuntivo per la sicurezza predefinita per le cassette postali locali sono le stesse delle istruzioni di connessione per PowerShell di Exchange Online.

• Connettersi a PowerShell per Sicurezza e conformità

• Autenticazione solo app per gli script automatici in PowerShell Exchange Online e Sicurezza & Conformità PowerShell

• Usare le identità gestite di Azure per connettersi a PowerShell per Exchange Online

• Usare C# per connettersi a PowerShell di Exchange Online

Il resto di questo articolo spiega come funziona il modulo, come installare e gestire il modulo e i cmdlet ottimizzati di Exchange Online disponibili nel modulo.

Connessioni API REST nel modulo EXO V3

Exchange Online PowerShell e Sicurezza & Conformità PowerShell usano connessioni API REST per tutti i cmdlet dal 2023.

Le connessioni API REST richiedono i moduli PowerShellGet e PackageManagement. Per altre informazioni, vedere PowerShellGet per connessioni basate su REST in Windows.

I cmdlet nelle connessioni API REST presentano i vantaggi seguenti rispetto alle controparti storiche:

• Più sicuro: supporto integrato per l'autenticazione moderna e nessuna dipendenza dalla sessione di PowerShell remota. PowerShell nel computer client non richiede l'autenticazione di base in WinRM.
• Più affidabile: gli errori temporanei usano tentativi predefiniti, quindi gli errori o i ritardi sono ridotti al minimo. Ad esempio:
  • Errori dovuti a ritardi di rete.
  • Ritardi dovuti a query di grandi dimensioni il cui completamento richiede molto tempo.
• Prestazioni migliori: le connessioni API REST evitano di configurare uno spazio di esecuzione di PowerShell.

La tabella seguente confronta i vantaggi dei cmdlet dell'API REST con i cmdlet di PowerShell remoti non disponibili e gli esclusivi cmdlet Get-EXO* nel modulo EXO V3.

I cmdlet dell'API REST hanno gli stessi nomi dei cmdlet e funzionano come gli equivalenti di PowerShell remoti, quindi non è necessario aggiornare i nomi dei cmdlet o i parametri negli script.

Alcuni cmdlet in PowerShell di Exchange Online vengono aggiornati con l'opzione sperimentale UseCustomRouting. Questa opzione instrada il comando direttamente al server delle cassette postali necessario e potrebbe migliorare le prestazioni generali. Utilizzare sperimentalmente l'opzione UseCustomRouting .

• Quando si usa l'opzione UseCustomRouting, è possibile usare solo i valori seguenti per l'identità della cassetta postale:

  • Nome dell'entità utente (UPN)
  • Indirizzo di posta elettronica
  • GUID cassetta postale

• L'opzione UseCustomRouting è disponibile solo nei seguenti cmdlet di PowerShell per Exchange Online:

  • Get-Clutter
  • Get-FocusedInbox
  • Get-InboxRule
  • Get-MailboxAutoReplyConfiguration
  • Get-MailboxCalendarFolder
  • Get-MailboxFolderPermission
  • Get-MailboxFolderStatistics
  • Get-MailboxMessageConfiguration
  • Get-MailboxPermission
  • Get-MailboxRegionalConfiguration
  • Get-MailboxStatistics
  • Get-MobileDeviceStatistics
  • Get-UserPhoto
  • Remove-CalendarEvents
  • Set-Clutter
  • Set-FocusedInbox
  • Set-MailboxRegionalConfiguration
  • Set-UserPhoto

• Usare il cmdlet Get-ConnectionInformation per ottenere informazioni sulle connessioni a PowerShell e Exchange Online PowerShell per la sicurezza & la conformità. Questo cmdlet è necessario perché il cmdlet Get-PSSession in Windows PowerShell non restituisce informazioni per le connessioni API REST.

  Nella tabella seguente sono descritti gli scenari in cui è possibile utilizzare Get-ConnectionInformation :

  Scenario	Output previsto
  Esecuzione dopo i comandi Connect-ExchangeOnline o Connect-IPPSSession .	Restituisce un oggetto informazioni di connessione.
  Esecuzione dopo più comandi Connect-ExchangeOnline o Connect-IPPSSession .	Restituisce una raccolta di oggetti informazioni di connessione.

• Utilizzare l'opzione SkipLoadingFormatData nel cmdlet Connect-ExchangeOnline per evitare il caricamento dei dati di formato ed eseguire i comandi Connect-ExchangeOnline più velocemente.

• I cmdlet supportati dall'API REST hanno un timeout di 15 minuti, che può influire sulle operazioni in blocco. Ad esempio, il comando Update-DistributionGroupMember seguente per aggiornare 10.000 membri di un gruppo di distribuzione potrebbe scadere:

  $Members = @("member1","member2",...,"member10000")
  
  Update-DistributionGroupMember -Identity DG01 -Members $Members
  

  Usare invece il comando Update-DistributionGroupMember per aggiornare un minor numero di membri e quindi aggiungere i membri rimanenti singolarmente usando un comando Add-DistributionGroupMember . Ad esempio:

  Update-DistributionGroupMember -Identity DG01 -Members $Members[0..4999]
  
  $Remaining = $Members[-5000..-1]
  
  foreach ($Member in $Remaining)
  
  {
     Add-DistributionGroupMember -Identity DG01 -Member $Member
  }
  

Per ulteriori informazioni sulle novità del modulo EXO V3, vedere la sezione Note sulla versione più avanti in questo articolo.

Segnalare bug e problemi per le versioni di anteprima del modulo PowerShell di Exchange Online

Solo per le versioni di anteprima del modulo, usa exocmdletpreview[at]service[dot]microsoft[dot]com per segnalare eventuali problemi che potresti incontrare. Assicurarsi di includere i file di log nel messaggio di posta elettronica. Per generare i file di log, sostituire <Path> con una cartella di output e quindi eseguire il comando seguente:

Connect-ExchangeOnline -EnableErrorReporting -LogDirectoryPath <Path> -LogLevel All

Cmdlet nel modulo PowerShell di Exchange Online

Il modulo EXO contiene nove cmdlet Get-EXO * esclusivi, ottimizzati per la velocità negli scenari di recupero di dati in blocco (migliaia e migliaia di oggetti) in PowerShell di Exchange Online. I cmdlet migliorati nel modulo sono elencati nella tabella seguente:

I cmdlet relativi alla connessione nel modulo sono elencati nella tabella seguente:

Nella tabella seguente sono elencati i cmdlet per le funzionalità di Exchange Online vari presenti nel modulo:

Sistemi operativi supportati per il modulo PowerShell di Exchange Online

Il modulo è ufficialmente supportato in PowerShell 7 in Windows, Linux e Apple macOS:

• Le versioni del modulo 3.10.0 (giugno 2026) o successive richiedono PowerShell 7.6.0 (marzo 2026) o versioni successive a causa delle dipendenze degli assembly .NET 10.0.
• Le versioni del modulo da 3.5.0 (maggio 2024) a 3.9.2 (gennaio 2026) richiedono PowerShell 7.4.0 (novembre 2023) o versioni successive a causa delle dipendenze degli assembly .NET 8.0. Nelle versioni precedenti di PowerShell 7 potrebbero verificarsi problemi di compatibilità (PowerShell 7.3.6 è più compatibile con il modulo rispetto a 7.3.7).
• Le versioni del modulo da 3.0.0 (settembre 2022) a 3.4.0 (ottobre 2023) richiedono PowerShell 7.2.0 (novembre 2021) o versioni successive a causa delle dipendenze dell'assembly .NET 6.0 nei cmdlet e nelle connessioni dell'API REST.
• Il supporto per il modulo in PowerShell 7 è iniziato con la versione 2.0.4 (febbraio 2021) in PowerShell 7.0.3 (luglio 2020).

Per altre informazioni su PowerShell 7, vedere Che cos'è PowerShell?.

Supporto macOS per il modulo

Per istruzioni sull'installazione di PowerShell 7 in macOS, vedere Installazione di PowerShell in macOS. Dopo aver installato PowerShell 7, è possibile eseguire i normali prerequisiti di PowerShell e installare e aggiornare il modulo PowerShell di Exchange Online.

Il modulo è supportato nelle seguenti versioni di macOS:

macOS 14 Sonoma o versione successiva

7.4.0 (.NET 8.0) è la prima versione supportata di PowerShell 7 in macOS 14 Sonoma o versione successiva.

macOS 13 Ventura

La versione più recente supportata del modulo è la 3.9.2 perché la versione più recente supportata di PowerShell 7 è la 7.5.x (.NET 9.0).

macOS 12 Monterey e macOS 11 Big Sur

La versione più recente supportata del modulo è la 3.9.2 perché la versione più recente supportata di PowerShell 7 è la 7.4.x (.NET 8.0).

Le versioni dei moduli da 3.0.0 a 3.9.2 sono supportate su tutti i processori.

Le versioni dei moduli 2.0.4 e 2.0.5 vengono eseguite in modo nativo su processori Intel. I processori Apple M1 o Apple M2 richiedono Apple Rosetta 2.

macOS 10.15 Catalina

La versione più recente supportata del modulo è la 3.4.0 perché la versione più recente supportata di PowerShell 7 è la 7.2.22 (.NET 6.0).

macOS 10.14 Mojave

La versione più recente supportata del modulo è la 2.0.5 perché la versione più recente supportata di PowerShell 7 è la 7.1.5 (.NET 5.0).

Supporto di Linux per il modulo

Per istruzioni sull'installazione di PowerShell 7 in Linux, vedere Installazione di PowerShell in Linux. Dopo aver installato PowerShell 7, è possibile eseguire i normali prerequisiti di PowerShell e installare e aggiornare il modulo PowerShell di Exchange Online.

Il modulo è ufficialmente supportato nelle seguenti distribuzioni di Linux:

Ubuntu 24.04 LTS

7.2.0 (.NET 6.0) è la prima versione supportata di PowerShell 7 in Ubuntu 24.04 LTS.

Ubuntu 22.04 LTS

7.2.0 (.NET 6.0) è la prima versione supportata di PowerShell 7 in Ubuntu 22.04 LTS.

Ubuntu 20.04 LTS

La versione più recente supportata del modulo è la 3.9.2 perché la versione più recente supportata di PowerShell 7 è la 7.4.x (.NET 8.0).

Le versioni del modulo da 3.7.0 a 3.9.2 potrebbero avere esito negativo con errori di protocollo SSL.

Ubuntu 18.04 LTS

La versione più recente supportata del modulo è la 3.9.2 perché la versione più recente supportata di PowerShell 7 è la 7.4.x (.NET 8.0).

Le versioni del modulo da 3.7.0 a 3.9.2 potrebbero avere problemi di affidabilità in Ubuntu 18.04 LTS.

Supporto Windows per il modulo

Il supporto della versione specifica del modulo in Windows dipende dal supporto di Windows PowerShell e dal supporto .NET Framework e/o .NET come descritto nelle sottosezioni seguenti:

Windows 11

In Windows PowerShell 5.1 il modulo richiede .NET Framework 4.7.2 (4.8.x è incluso in Windows 11, quindi non è necessario installare .NET Framework).

7.2.0 (.NET 6.0) è la prima versione supportata di PowerShell 7 in Windows 11.

Windows Server 2022 e Windows Server 2025

In Windows PowerShell 5.1 il modulo richiede .NET Framework 4.7.2 (4.8.x è incluso, quindi non è necessario installare .NET Framework).

7.2.0 (.NET 6.0) è la prima versione supportata di PowerShell 7 in Windows Server 2022 e Windows Server 2025.

Windows 10

In Windows PowerShell 5.1 il modulo richiede .NET Framework 4.7.2. L'aggiornamento di Windows 10 (aprile 2018), versione 1803 o successiva include .NET Framework 4.7.2, quindi non è necessario scaricarlo.

In Windows 10, .NET 8.0 e .NET 10.0 (e quindi PowerShell 7.4 o versioni successive e versioni dei moduli 3.5.0 o successive) sono supportati solo nelle edizioni Enterprise e IoT LTSC ancora supportate (versioni 1607, 1809 e 21H2).

Le edizioni consumer di Windows 10 hanno raggiunto la fine del supporto a ottobre 2025 e non supportano .NET 8.0 o .NET 10.0.

Windows Server 2016 e Windows Server 2019

In Windows PowerShell 5.1 il modulo richiede .NET Framework 4.7.2 (incluso in Windows Server 2019).

Windows 8.1, Windows Server 2012 e Windows Server 2012 R2

In Windows PowerShell 5.1 il modulo richiede .NET Framework 4.7.2.

7.2.22 (.NET 6.0) è la versione supportata più recente di PowerShell 7 in Windows 8.1, Windows Server 2012 e Windows Server 2012 R2.

Windows 7.1 SP1 e Windows Server 2008 R2 SP1

In Windows PowerShell 5.1 il modulo richiede .NET Framework 4.7.1.

Prerequisiti per il modulo PowerShell di Exchange Online

Impostare i criteri di esecuzione di PowerShell su RemoteSigned

PowerShell deve essere configurato per poter eseguire gli script e, per impostazione predefinita, non lo è. Durante il tentativo di connessione viene visualizzato l'errore seguente:

Impossibile caricare i file perché l'esecuzione di script è disabilitata nel sistema. Specificare un certificato valido per la firma dei file.

Per richiedere la firma di un autore attendibile per tutti gli script di PowerShell scaricati da Internet, esegui il comando seguente in una sessione di PowerShell con privilegi elevati (una finestra di PowerShell che si apre selezionando Esegui come amministratore):

Set-ExecutionPolicy RemoteSigned

Per altre informazioni sui criteri di esecuzione, vedere Informazioni sui criteri di esecuzione.

Autenticazione di base in WinRM

A partire da ottobre 2023, le connessioni API REST hanno sostituito le connessioni di autenticazione di base (PowerShell remoto) in PowerShell e Exchange Online PowerShell per lasicurezza & la conformità. Le connessioni API REST non richiedono l'autenticazione di base in WinRM.

La versione 3.2.0 (giugno 2023) e le versioni successive del modulo supportano pienamente i cmdlet dell'API REST in PowerShell e Exchange Online PowerShell per la sicurezza & la conformità.

PowerShellGet richiesto in Windows

Le connessioni API REST in Windows richiedono il modulo PowerShellGet. Per dipendenza, il modulo PowerShellGet richiede il modulo PackageManagement. La considerazione per questi moduli è più per PowerShell 5.1 che per PowerShell 7, ma tutte le versioni di PowerShell traggono vantaggio dall'installazione delle versioni più recenti dei moduli. Per istruzioni sull'installazione e l'aggiornamento, vedere Installazione di PowerShellGet in Windows.

Se PowerShellGet non è installato quando si prova a connettersi, viene visualizzato l'errore seguente:

Impossibile trovare un cmdlet Update-Manifest

Installare e aggiornare il modulo PowerShell di Exchange Online

Il modulo è disponibile in PowerShell Gallery all'indirizzo https://www.powershellgallery.com/packages/ExchangeOnlineManagement/.

Usare il cmdlet Install-Module per installare il modulo per la prima volta e il cmdlet Update-Module per aggiornare un'installazione esistente da PowerShell Gallery. Entrambi i cmdlet usano gli stessi parametri, quindi la stessa sintassi si applica sia durante l'installazione che durante l'aggiornamento.

Per verificare se il modulo è già installato e come è stato installato, eseguire Get-InstalledModule ExchangeOnlineManagement | Format-List Name,Version,InstalledLocation:

• Se il modulo è installato in %ProgramFiles%\WindowsPowerShell\Modules\, è installato per tutti gli utenti.
• Se il modulo è installato nella cartella Documenti, è installato solo per l'account utente corrente.

Prima di installare il modulo per la prima volta, installare o aggiornare il modulo PowerShellGet come descritto in Installazione di PowerShellGet, quindi chiudere e riaprire la finestra di PowerShell.

Per installare o aggiornare il modulo, utilizzare la sintassi seguente:

<Install-Module | Update-Module> -Name ExchangeOnlineManagement [-Scope CurrentUser] [-RequiredVersion <Version>] [-AllowPrerelease]

• In genere, si vuole la versione pubblica più recente del modulo, ma è anche possibile installare o aggiornare a una versione di anteprima.

• Requisiti per la sessione di PowerShell per installare o aggiornare il modulo:

  • Per tutti gli utenti: Eseguire il comando in una sessione di PowerShell con privilegi elevati.
  • Per l'utente corrente: Non è necessaria una sessione di PowerShell con privilegi elevati.

  Quando si aggiorna il modulo, usare lo stesso ambito usato per installarlo originariamente.

• Il parametro RequiredVersion consente di specificare la versione del modulo da installare o aggiornare. È possibile usare questo parametro con o senza l'opzione AllowPrerelease .

• L'opzione AllowPrerelease consente di installare o aggiornare una versione Preview del modulo. Per specificare la versione di anteprima, usare anche il parametro RequiredVersion .

  Per visualizzare tutte le versioni disponibili del modulo, incluse le versioni di anteprima, eseguire Find-Module ExchangeOnlineManagement -AllVersions -AllowPrerelease. Per visualizzare solo le versioni pubbliche, omettere l'opzione AllowPrerelease .

In questo esempio viene installata la versione pubblica più recente del modulo per tutti gli utenti.

Install-Module -Name ExchangeOnlineManagement

In questo esempio il modulo viene aggiornato alla versione pubblica più recente per l'account utente corrente.

Update-Module -Name ExchangeOnlineManagement -Scope CurrentUser

In questo esempio viene installata l'ultima versione di anteprima disponibile del modulo per tutti gli utenti.

Install-Module -Name ExchangeOnlineManagement -AllowPrerelease

Per informazioni dettagliate sulla sintassi e sui parametri, vedere gli articoli seguenti:

• Trova-modulo
• Modulo di installazione
• Modulo di aggiornamento
• Get-InstalledModule

Disinstallare il modulo PowerShell di Exchange Online

Per disinstallare il modulo, eseguire il comando seguente. Se originariamente il modulo era stato installato per tutti gli utenti, eseguire il comando in una sessione di PowerShell con privilegi elevati.

Uninstall-Module -Name ExchangeOnlineManagement

Per verificare come è stato installato il modulo (tutti gli utenti rispetto all'account utente corrente), usare il Get-InstalledModule comando all'inizio della sezione Installare e aggiornare il modulo PowerShell di Exchange Online.

Per informazioni dettagliate sulla sintassi e sul parametro, vedere Disinstalla-modulo .

Risolvere i problemi di installazione del modulo PowerShell di Exchange Online

Questa sezione descrive gli errori che potrebbero verificarsi durante l'installazione del modulo e come risolverli.

• Viene visualizzato uno dei seguenti errori:

  Il modulo "ExchangeOnlineManagement" specificato con PowerShellGetFormatVersion "<version>" non è supportato dalla versione corrente di PowerShellGet. Recuperare l'ultima versione del modulo PowerShellGet per installare questo modulo 'ExchangeOnlineManagement'.

  ATTENZIONE: Impossibile scaricare da URI 'https://go.microsoft.com/fwlink/?LinkID=627338& clcid=0x409' a ''.

  AVVISO: non è possibile scaricare l'elenco dei provider disponibili. Controllare la connessione Internet.

  Aggiornare l'installazione del modulo PowerShellGet alla versione più recente, come descritto in Installazione di PowerShellGet. Assicurarsi di chiudere e riaprire la finestra di PowerShell prima di tentare di aggiornare di nuovo il modulo ExchangeOnlineManagement.

• Viene visualizzato il seguente errore:

  Non è stata trovata alcuna corrispondenza per i criteri di ricerca e il nome del modulo specificati 'ExchangeOnlineManagement'. Provare a eseguire Get-PSRepository per visualizzare tutti i repository di moduli registrati disponibili.

  Il repository predefinito per i moduli di PowerShell non è impostato su PSGallery. Per correggere l'errore, eseguire il comando seguente:

  Register-PSRepository -Default
  

• In Windows PowerShell 5.1, si ricevono errori quando si tenta di installare il modulo perché la PowerShell Gallery richiede TLS 1.2 o connessioni successive (PowerShell 7 utilizza già TLS 1.2 o versione successiva). Questo problema interessa in genere solo le versioni precedenti di Windows in cui .NET Framework non usa TLS 1.2 per impostazione predefinita. Per altre informazioni e i passaggi per risolverlo, vedere Supporto TLS in PowerShell Gallery.

Proprietà e set di proprietà nel modulo PowerShell di Exchange Online

I cmdlet di Exchange Online tradizionali restituiscono tutte le possibili proprietà dell'oggetto, incluse molte proprietà vuote o non interessanti. Questo comportamento causa prestazioni degradate (ulteriore calcolo del server e carico di rete aggiunto). La restituzione di tutte le proprietà nell'output dei cmdlet è raramente necessaria.

I cmdlet Get-EXO* nel modulo contengono proprietà di output categorizzate. Invece di assegnare a tutte le proprietà la stessa importanza e restituirle in tutti gli scenari, abbiamo classificato proprietà correlate specifiche in insiemi di proprietà. Questi set di proprietà sono bucket di due o più proprietà correlate nel cmdlet.

I cmdlet Get-EXO* più grandi e più usati usano set di proprietà:

• Get-EXOCasMailbox
• Get-EXOMailbox
• Get-EXOMailboxStatistics
• Get-EXORecipient

In questi cmdlet, i parametri seguenti controllano i set di proprietà:

• PropertySets: questo parametro accetta uno o più nomi di set di proprietà disponibili separati da virgole. I set di proprietà disponibili sono descritti in Set di proprietà nei cmdlet del modulo PowerShell di Exchange Online.
• Properties: questo parametro accetta uno o più nomi di proprietà separati da virgole.

È possibile usare i parametriPropertySet e Properties nello stesso comando.

È stato incluso anche un set di proprietà Minimum che include un set minimo di proprietà necessarie per l'output del cmdlet, ad esempio le proprietà di identità. Le proprietà nei set di proprietà minimi sono descritte anche in Set di proprietà nei cmdlet del modulo PowerShell di Exchange Online.

• Se non si usano i parametri PropertySets o Properties, si ottengono automaticamente le proprietà nel set di proprietà Minimum.
• Se si usano i parametri PropertySets o Properties, si ottengono le proprietà specificate e le proprietà nel set Minimum.

In entrambi i casi, l'output del cmdlet contiene molte meno proprietà e i risultati vengono restituiti molto più velocemente.

Ad esempio, dopo essersi connessi a PowerShell per Exchange Online, nell'esempio seguente vengono restituite solo le proprietà nella proprietà Minimum impostata per le prime 10 cassette postali.

Get-EXOMailbox -ResultSize 10

Al contrario, l'output dello stesso comando Get-Mailbox restituirebbe almeno 230 proprietà per ognuna delle prime 10 cassette postali.

Per ulteriori informazioni sui filtri nel modulo, vedere Filtri nel modulo PowerShell di Exchange Online.

Note sulla versione

Se non diversamente specificato, la versione corrente del modulo PowerShell di Exchange Online contiene tutte le funzionalità delle versioni precedenti.

Versione corrente

Versione 3.10.1

• Sono stati risolti bug di autenticazione basata su certificato (CBA) e altri problemi di prestazioni minori.

Versioni precedenti

Versione 3.10.0

• A partire da questa versione del modulo, la versione minima richiesta di PowerShell 7 è la 7.6. Windows PowerShell 5.1 non è interessato.
• È stato risolto un problema per cui l'autenticazione basata su certificato (CBA) non riusciva in Connect-IPPSSession quando si usava l'opzione EnableSearchOnlySession .

Versione 3.9.2

• Nuovi cmdlet Add-WorkforceInsightsDelegationAccess, Get-WorkforceInsightsDelegationAccess e Remove-WorkforceInsightsDelegationAccess per la delega di Workforce Insights.
• Nuovo parametro EXOModuleBasePath in Connect-ExchangeOnline e Connect-IPPSSession per archiviare i file temporanei del modulo EXO in un percorso personalizzato.
• Parametro UseRpsSession deprecato da Connect-ExchangeOnline e Connect-IPPSSession.

Versione 3.9.0

• Nuova opzione EnableSearchOnlySession in Connect-IPPSSession, che abilita determinati cmdlet di eDiscovery e i relativi cmdlet che si connettono ad altri servizi di Microsoft 365.

Versione 3.8.0

• Nuovo parametro AccessToken in Connect-IPPSSession.

• Get-VivaModuleFeature ora restituisce informazioni su ParentFeature, ChildFeature e PolicyModes. Questi valori rappresentano le funzionalità padre e figlio di una funzionalità dell'app Viva insieme alle modalità di abilitazione disponibili per i criteri futuri.

• Nuovi parametri IsUserOptedInByDefault nei cmdlet Add-VivaModuleFeaturePolicy e Update-VivaModuleFeaturePolicy e il valore della proprietà corrispondente in tutti i cmdlet *-VivaModuleFeaturePolicy . Il valore indica se gli utenti sono inclusi o meno dal criterio, a condizione che l'utente non imposti una preferenza.

  È possibile usare questo parametro per mantenere la funzionalità abilitata nell'organizzazione e disattivare gli utenti interessati per impostazione predefinita, disabilitando di fatto la funzionalità per tali utenti.

• Sono stati deprecati il cmdlet Get-VivaFeatureCategory , tutti i parametri correlati alla categoria e i valori restituiti (CategoryId, IsCategoryEnabled).

Versione 3.7.2

• L'opzione DisableWAM è disponibile nel cmdlet Connect-ExchangeOnline per disabilitare Gestione account Web (WAM) se si verificano errori di connessione correlati a WAM.

Versione 3.7.1

• Aggiunta una nuova proprietà denominata ExoExchangeSecurityDescriptor all'output di Get-EXOMailbox che è simile alla ExchangeSecurityDescriptor proprietà nell'output di Get-Mailbox.
• Aggiunta di nuovi cmdlet per supportare la funzionalità di delega Viva Org Insights:
  • Add-VivaOrgInsightsDelegatedRole
  • Get-VivaOrgInsightsDelegatedRole
  • Remove-VivaOrgInsightsDelegatedRole

Versione 3.7.0

• Gestione account Web integrata nei flussi di autenticazione per migliorare la sicurezza.
• Guida della riga di comando per i cmdlet di PowerShell per Exchange Online non vengono più caricati per impostazione predefinita. Utilizzare l'opzione LoadCmdletHelp nel comando Connect-ExchangeOnline in modo che la Guida per i cmdlet di PowerShell di Exchange Online sia disponibile per il cmdlet Get-Help.
• Risolti problemi di connessione con l'autenticazione solo app in PowerShell per la sicurezza & la conformità.

Versione 3.6.0

• Get-VivaModuleFeature restituisce ora informazioni sui tipi di identità per cui la funzionalità supporta la creazione di criteri (ad esempio, utenti, gruppi o l'intera organizzazione).
• I cmdlet per la gestione dell'accesso alle funzionalità di Viva ora gestiscono i problemi di richiesta di valutazione dell'accesso continuo (CAE).
• Aggiunta di una correzione per un problema di compatibilità con il modulo Microsoft.Graph.

Versione 3.5.1

• Correzioni di bug in Get-EXOMailboxPermission e Get-EXOMailbox.
• Il modulo viene aggiornato per l'esecuzione su .NET 8, sostituendo la versione precedente basata su .NET 6.
• Miglioramenti in Add-VivaModuleFeaturePolicy.

Versione 3.5.0

• Nuovo cmdlet Get-VivaFeatureCategory .
• Aggiunta del supporto per le operazioni dei criteri a livello di categoria in Viva Feature Access Management (VFAM).
• Nuova proprietà IsFeatureEnabledByDefault nell'output di Get-VivaModuleFeaturePolicy. Il valore di questa proprietà mostra lo stato di abilitazione predefinito per gli utenti quando non sono stati creati criteri organizzazione o utente/gruppo.

Versione 3.4.0

• Correzioni di bug in Connect-ExchangeOnline, Get-EXORecipientPermission e Get-EXOMailboxFolderPermission.
• Il parametro SigningCertificate in Connect-ExchangeOnline supporta ora la modalità CLM (Constrained Language Mode).

Versione 3.3.0

• Parametro SkipLoadingCmdletHelp in Connect-ExchangeOnline per supportare il caricamento saltato dei file della Guida del cmdlet.
• La variabile EXO_LastExecutionStatus globale è disponibile per controllare lo stato dell'ultimo cmdlet eseguito.
• Correzioni di bug in Connect-ExchangeOnline e Connect-IPPSSession.
• Parametro IsUserControlEnabled in Add-VivaModuleFeaturePolicy e Update-VivaModuleFeaturePolicy per supportare l'abilitazione dei controlli utente tramite criteri per le funzionalità di cui è stato eseguito l'onboarding nella gestione dell'accesso alle funzionalità Viva.

Versione 3.2.0

• Nuovi cmdlet:
  • Get-DefaultTenantBriefingConfig e Set-DefaultTenantBriefingConfig.
  • Get-DefaultTenantMyAnalyticsFeatureConfig e Set-DefaultTenantMyAnalyticsFeatureConfig.
  • Get-VivaModuleFeature, Get-VivaModuleFeatureEnablement, Add-VivaModuleFeaturePolicy, Get-VivaModuleFeaturePolicy, Remove-VivaModuleFeaturePolicy e Update-VivaModuleFeaturePolicy.
• Supporto della connessione API REST per PowerShell per la sicurezza & la conformità.
• Parametro ConnectionId in Get-ConnectionInformation e Disconnect-ExchangeOnline:
  • Ottenere informazioni di connessione per connessioni API REST specifiche.
  • Disconnessione selettiva per connessioni API REST.
• SigningCertificate in Connect-ExchangeOnline consente di firmare i file di formato (*. Format.ps1xml) o file del modulo di script (.psm1) nel modulo temporaneo creato da Connect-ExchangeOnline con un certificato client da usare in tutti i criteri di esecuzione di PowerShell.
• Correzioni di bug in Connect-ExchangeOnline.

Versione 3.1.0

• Parametro AccessToken disponibile in Connect-ExchangeOnline.
• Correzioni di bug in Connect-ExchangeOnline e Get-ConnectionInformation.
• Correzione di bug in Connect-IPPSSession per la connessione a PowerShell di sicurezza & conformità tramite CertificateThumbprint.

Versione 3.0.0 (versioni di anteprima note come v2.0.6-PreviewX)

• Funzionalità già descritte nelle connessioni API REST nella sezione del modulo EXO V3 :
  • Autenticazione basata su certificati per PowerShell per la sicurezza & la conformità (versione 2.0.6-Preview5 o successiva).
  • Cmdlet Get-ConnectionInformation per le connessioni basate su REST (versione 2.0.6-Preview7 o successiva).
  • L'opzione SkipLoadingFormatData nel cmdlet Connect-ExchangeOnline per le connessioni basate su REST (versione 2.0.6-Preview8 o successiva).
• Il parametro DelegatedOrganization funziona nel cmdlet Connect-IPPSSession , purché si usi anche il parametro AzureADAuthorizationEndpointUri nel comando.
• Alcuni cmdlet che richiedevano conferma in scenari specifici non lo fanno più. Per impostazione predefinita, il cmdlet viene eseguito fino al completamento.
• Il formato dell'errore restituito dall'esecuzione non riuscita del cmdlet è stato leggermente modificato. L'eccezione ora contiene più dati (ad esempio, il tipo di eccezione) e FullyQualifiedErrorId non contiene .FailureCategory Il formato dell'errore è soggetto a ulteriori modifiche.

Versione 2.0.5

• Nuovi cmdlet Get-OwnerlessGroupPolicy e Set-OwnerlessGroupPolicy per gestire i Gruppi di Microsoft 365 senza proprietario.

  Nota

  Anche se i cmdlet sono disponibili nel modulo, la funzionalità è disponibile solo per i membri di un'anteprima privata.

• Nuovi cmdlet Get-VivaInsightsSettings e Set-VivaInsightsSettings per controllare l'accesso degli utenti alle funzionalità di Headspace in Viva Insights.

Versione 2.0.4

• PowerShell 7 è ufficialmente supportato in Windows, Linux e Apple macOS, come descritto nella sezione Prerequisiti per il modulo PowerShell di Exchange Online in questo articolo.

• Il modulo in PowerShell 7 supporta Single Sign-On (SSO) basato su browser e altri metodi di accesso. Per altre informazioni, vedere Metodi di connessione esclusivi di PowerShell 7.

• I cmdlet Get-UserAnalyticsConfig e Set-UserAnalyticsConfig sono stati sostituiti dai cmdlet Get-MyAnalyticsConfig e Set-MyAnalyticsConfig . È anche possibile configurare l'accesso a livello di funzionalità. Per altre informazioni, vedere Configurare MyAnalytics.

• Applicazione di criteri e sicurezza in tempo reale in tutte le autenticazioni basate sull'utente. La valutazione dell'accesso continuo (CAE) è abilitata nel modulo. Per ulteriori informazioni, consulta Spostamento verso l'applicazione dei criteri e della sicurezza in tempo reale.

• Le proprietà LastUserActionTime e LastInteractionTime sono ora disponibili nell'output del cmdlet Get-EXOMailboxStatistics.

• Il processo di accesso interattivo ora si avvale di un metodo più sicuro per recuperare i token di accesso attraverso URL di risposta sicura.

Versione 2.0.3

• Disponibilità generale dell'autenticazione basata su certificati (CBA), che consente l'uso dell'autenticazione moderna in scenari di scripting automatico o automazione in background. Le posizioni di archiviazione dei ceritificati disponibili sono:
  • Remota, nel parametro del valore della chiave di Azure (il Certificato). Questa opzione aumenta la sicurezza recuperando il certificato solo in fase di esecuzione.
  • Locale, nell'archivio dei certificati CurrentUser o LocalMachine (il parametro CertificateThumbprint).
  • Locale, in un file di certificato esportato (i parametri CertificateFilePath e CertificatePassword). Per altre informazioni, vedere le descrizioni dei parametri in Connect-ExchangeOnline e l'autenticazione solo app per gli script automatici nel modulo PowerShell di Exchange Online.
• Connettersi a PowerShell per Exchange Online e PowerShell per Sicurezza e conformità simultaneamente in una sola finestra di PowerShell.
• Il nuovo parametro CommandName consente di specificare e limitare i cmdlet di PowerShell in Exchange Online che sono importati in una sessione. Questa opzione riduce il footprint di memoria per le applicazioni PowerShell a utilizzo elevato.
• Get-EXOMailboxFolderPermission ora supporta ExternalDirectoryObjectID nel parametro Identity.
• La latenza dell'invocazione del cmdlet V2 è stata ottimizzata. I risultati di laboratorio mostrano che la latenza della prima chiamata è diminuita da 8 secondi a circa 1 secondo. I risultati effettivi dipendono dalle dimensioni del risultato del cmdlet e dall'ambiente dell'organizzazione.

Versione 1.0.1

• Versione di disponibilità generale del modulo EXO V2. È stabile e pronto per l'uso in ambienti di produzione.
• Il cmdlet Get-EXOMobileDeviceStatistics ora supporta il parametro Identity.
• È stata migliorata l'affidabilità per la riconnessione automatica delle sessioni in alcuni scenari in cui uno script era in esecuzione per ~50 minuti e generava un errore "Cmdlet non trovato" a causa di un bug nella logica di riconnessione automatica.
• Sono stati risolti i problemi relativi al tipo di dati per due attributi "User" e "MailboxFolderUser" usati di frequente, per una migrazione più semplice degli script.
• Supporto migliorato per i filtri in quanto ora supporta altri quattro operatori: EndsWith, Contains, Not e NotLike. Controllare i filtri nel modulo PowerShell di Exchange Online per gli attributi non supportati nei filtri.

Versione 0.4578.0

• È stato aggiunto il supporto per configurare un messaggio di briefing a livello di utente per l'organizzazione con i cmdlet Set-UserBriefingConfig e Get-UserBriefingConfig.
• È stato aggiunto il supporto della pulizia della sessione con il cmdlet Disconnect-ExchangeOnline. Questo cmdlet è l'equivalente in V2 di Get-PSSession | Remove-PSSession. Oltre a ripulire l'oggetto sessione e i file locali, rimuove il token di accesso dalla cache, che viene usato per l'autenticazione nei cmdlet V2.
• Ora è possibile usare FolderId come parametro di identità in Get-EXOMailboxFolderPermission. Il valore FolderId si può ottenere usando Get-MailboxFolder. Ad esempio: Get-MailboxFolderPermission -Identity <UPN>:<Folder-Path>Get-MailboxFolderPermission -Identity <UPN>:\<Folder-Id>
• È stata migliorata l'affidabilità di Get-EXOMailboxStatistics in quanto vengono risolti alcuni errori di instradamento delle richieste che hanno causato errori.
• È stato ottimizzato l'utilizzo della memoria per le nuove sessioni create riutilizzando moduli esistenti anziché creare una nuova sessione ogni volta che si importa una sessione.

Versione 0.4368.1

• È stato aggiunto il supporto per i cmdlet di PowerShell per Sicurezza e conformità con il cmdlet Connect-IPPSSession.
• La possibilità di nascondere il banner degli annunci è disponibile usando il parametro ShowBanner (-ShowBanner:$false).
• Capacità di terminare l'esecuzione del cmdlet in caso di eccezione del client.
• PowerShell remoto conteneva vari tipi di dati complessi che non erano intenzionalmente supportati nei cmdlet EXO per migliorare le prestazioni. Le differenze nei tipi di dati non complessi tra i cmdlet di PowerShell remoti e i cmdlet V2 vengono risolte per consentire la migrazione senza problemi degli script di gestione.

Versione 0.3582.0

• Supporto per il prefisso durante la creazione della sessione:
  • È possibile creare una sola sessione alla volta contenente cmdlet prefissati.
  • I cmdlet EXO V2 non hanno il prefisso perché hanno già il prefisso EXO, quindi non usarli EXO come prefisso.
• Usare i cmdlet di EXO V2 anche se l'autenticazione di base di WinRM è disabilitata nel computer client. Le connessioni di PowerShell remote richiedono l'autenticazione di base di WinRM e i cmdlet di PowerShell remoto non sono disponibili se l'autenticazione di base è disabilitata in WinRM.
• Il parametro Identity per i cmdlet V2 ora supporta Name e Alias. L'uso di Alias o Name rallenta le prestazioni dei cmdlet V2, quindi non è consigliabile usarli.
• È stato risolto il problema per cui il tipo di dati degli attributi restituiti dai cmdlet V2 era diverso rispetto ai cmdlet di Remote PowerShell. Sono ancora disponibili pochi attributi con tipi di dati diversi e si prevede di gestirli nei prossimi mesi.
• Bug risolto: Problema di riconnessione delle sessioni frequenti quando Connect-ExchangeOnline veniva richiamato con credenziali o UserPrincipalName

Versione 0.3555.1

• È stato corretto un bug per cui i cmdlet inviati tramite pipe non riuscivano con l'errore seguente a causa di un problema di autenticazione:

  Non è possibile richiamare la pipeline perché lo spazio di esecuzione non è nello stato aperto. Lo stato corrente dello spazio di esecuzione è 'Closed'.

Versione 0.3527.4

• Contenuto di Get-Help aggiornato.
• È stato risolto un problema in Get-Help per cui il parametro Online reindirizzava a una pagina inesistente con codice di errore 400.

Versione 0.3527.3

• È stato aggiunto il supporto per la gestione di Exchange per un'organizzazione diversa tramite il flusso di delega.
• Funziona in combinazione con altri moduli di PowerShell in un'unica finestra di PowerShell.
• È stato aggiunto il supporto per i parametri posizionali.
• Il campo di data e ora supporta le impostazioni locali del client.
• Correzione di bug: PSCredential vuoto se passato durante Connect-ExchangeOnline.
• Correzione di bug: errore del modulo client quando il filtro conteneva $null.
• Le sessioni create internamente al modulo EXO V2 hanno ora nomi (modello di denominazione: ExchangeOnlineInternalSession_% numero%).
• Correzione bug: i cmdlet di PowerShell remoto non riescono in modo intermittente a causa del tempo in cui la differenza tra la scadenza del token e la sessione diventa inattiva.
• Aggiornamento principale della sicurezza.
• Correzioni di bug e miglioramenti.