Informazioni sul modulo PowerShell V2 di Exchange Online

Il modulo PowerShell V2 di Exchange Online, abbreviato come modulo EXO V2, usa l'autenticazione moderna e funziona con l'autenticazione a più fattori per la connessione a tutti gli ambienti di PowerShell correlati a Exchange in Microsoft 365: PowerShell di Exchange Online, PowerShell di sicurezza e conformità e PowerShell autonomi di Exchange Online Protection (EOP).

Per le istruzioni di connessione che usano il modulo EXO V2, vedere gli articoli seguenti:

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.

Segnalare bug e problemi relativi al modulo EXO V2

Quando si segnala un problema a exocmdletpreview[at]service[dot]microsoft[dot]com, assicurarsi di includere i file di log nel messaggio di posta elettronica. Per generare i file di log, sostituire <Path to store log file> con la cartella di output desiderata ed eseguire il comando seguente:

Connect-ExchangeOnline -EnableErrorReporting -LogDirectoryPath <Path to store log file> -LogLevel All

Nota

La versione più recente del modulo EXO V2 e l'uso frequente dei cmdlet Connect-ExchangeOnline e Disconnect-ExchangeOnline in una singola sessione o script di PowerShell potrebbero causare una perdita di memoria. Il modo migliore per evitare questo problema consiste nell'usare il parametro CommandName nel cmdlet Connect-ExchangeOnline per limitare i cmdlet utilizzati nella sessione.

Funzionamento del modulo EXO V2

Il modulo contiene un piccolo set di esclusivi cmdlet di PowerShell di Exchange Online ottimizzati per gli scenari di recupero dei dati in blocco, ossia che coinvolgono migliaia di oggetti. La prima volta che si apre il modulo, verranno visualizzati solo questi cmdlet esclusivi. Dopo aver eseguito la connessione all'organizzazione di Exchange Online, verranno visualizzati tutti i cmdlet di Remote PowerShell precedenti.

Il modulo usa l'autenticazione moderna per tutti i cmdlet. Non è possibile usare l'autenticazione di base nel modulo EXO V2, ma è comunque necessario abilitare l'opzione di autenticazione di base in WinRM come spiegato più avanti in questo articolo.

I cmdlet di Exchange Online nel modulo EXO V2 sono destinati a sostituire gli equivalenti più vecchi, meno efficienti, ma i cmdlet equivalenti sono ancora disponibili, dopo la connessione.

Nella tabella seguente sono elencati i cmdlet ottimizzati di PowerShell di Exchange Online, disponibili solo nel modulo EXO V2:

Modulo EXO V2. Cmdlet precedente correlato
Get-EXOMailbox Get-Mailbox
Get-EXORecipient Get-Recipient
Get-EXOCasMailbox Get-CASMailbox
Get-EXOMailboxPermission Get-MailboxPermission
Get-EXORecipientPermission Get-RecipientPermission
Get-EXOMailboxStatistics Get-MailboxStatistics
Get-EXOMailboxFolderStatistics Get-MailboxFolderStatistics
Get-EXOMailboxFolderPermission Get-MailboxFolderPermission
Get-EXOMobileDeviceStatistics Get-MobileDeviceStatistics

Nella tabella seguente sono elencati i cmdlet relativi alla connessione disponibili nel modulo EXO V2:

Modulo EXO V2. Cmdlet precedente correlato
Connect-ExchangeOnline Connect-EXOPSSession

oppure

Nuovo PSSession

Connect-IPPSSession Connect-IPPSSession
Disconnect-ExchangeOnline Rimuovi PSSession

Nella tabella seguente sono elencati i vari cmdlet di Exchange Online, che si possono trovare nel modulo EXO V2:

Modulo EXO V2. Commenti
Get-CustomNudge Disponibile nella versione 2.0.6-Preview5 o successiva
New-CustomNudge Disponibile nella versione 2.0.6-Preview5 o successiva
Remove-CustomNudge Disponibile nella versione 2.0.6-Preview5 o successiva
Set-CustomNudge Disponibile nella versione 2.0.6-Preview5 o successiva
Get-CustomNudgeAssignment Disponibile nella versione 2.0.6-Preview5 o successiva
New-CustomNudgeAssignment Disponibile nella versione 2.0.6-Preview5 o successiva
Remove-CustomNudgeAssignment Disponibile nella versione 2.0.6-Preview5 o successiva
Set-CustomNudgeAssignment Disponibile nella versione 2.0.6-Preview5 o successiva
Get-CustomNudgeSettings Disponibile nella versione 2.0.6-Preview5 o successiva
Set-CustomNudgeSettings Disponibile nella versione 2.0.6-Preview5 o successiva
Get-MyAnalyticsFeatureConfig Disponibile nella versione 2.0.4 o successiva.
Set-MyAnalyticsFeatureConfig Disponibile nella versione 2.0.4 o successiva.
Get-UserBriefingConfig Sostituito da Get-MyAnalyticsFeatureConfig.
Set-UserBriefingConfig Sostituito da Set-MyAnalyticsFeatureConfig.
Get-VivaInsightsSettings Disponibile nella versione 2.0.5 successiva.
Set-VivaInsightsSettings Disponibile nella versione 2.0.5 successiva.

Aggiornamenti per la versione 2.0.6

La versione 2.0.6-Preview6 del modulo EXO V2 è ora disponibile. Questa versione di anteprima migliora le funzionalità cronologiche del modulo con le funzionalità seguenti:

  • PowerShell di Exchange Online nella versione 2.0.6 include cmdlet supportati dall'API REST:

    • I cmdlet dell'API REST non si basano sulla sessione remota di PowerShell, quindi PowerShell nel computer client non richiede l'autenticazione di base in WinRM per la PowerShell di Exchange Online.
    • I cmdlet dell'API REST nella PowerShell di Exchange Online funzionano esattamente come i cmdlet equivalenti remoti di PowerShell, quindi non è necessario aggiornare gli script.
    • Praticamente tutti i cmdlet di PowerShell remoti disponibili nella PowerShell di Exchange Online sono ora supportati dall'API REST. Alcuni cmdlet potrebbero apparire temporaneamente o scomparire dalla disponibilità usando l'API REST quando vengono rilevati e risolti problemi.
  • L'opzione UseRPSSession in Connect-ExchangeOnline concede l'accesso a tutti i cmdlet di PowerShell remoti esistenti come prima:

    • L'opzione UseRPSSession richiede l'autenticazione di base in WinRM nel computer client.
    • Se non si usa l'opzione UseRPSSession quando ci si connette, è possibile usare solo i cmdlet dell'API REST.
  • Alcuni cmdlet dell'API REST della PowerShell di Exchange Online sono stati aggiornati con l'opzione sperimentale UseCustomRouting. Questa opzione instrada il comando direttamente al server delle cassette postali necessario e potrebbe migliorare le prestazioni generali.

    • 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 dell'API REST della PowerShell di 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 l'opzione UseCustomRouting in modo sperimentale e segnalare gli eventuali problemi riscontrati.

Nota

Sicurezza e conformità PowerShell nella versione 2.0.6 non include cmdlet supportati dall'API REST. Tutti i cmdlet in Sicurezza e conformità PowerShell si basano sulla sessione remota di PowerShell, quindi PowerShell nel computer client richiede l'autenticazione di base in WinRM per usare correttamente il cmdlet Connect-IPPSSession.

Installare e gestire il modulo EXO V2

È possibile scaricare il modulo EXO V2 da PowerShell Gallery all’indirizzohttps://www.powershellgallery.com/packages/ExchangeOnlineManagement/.

Le procedure descritte in questa sezione spiegano come installare, aggiornare e disinstallare il modulo EXO V2.

Sistemi operativi supportati per il modulo EXO V2

La versione più recente del modulo EXO V2 è ufficialmente supportata in PowerShell 7 in Windows, Linux e Apple macOS.

In particolare, la versione 2.0.4 o successiva del modulo EXO V2 è supportata in PowerShell 7.0.3 o versione successiva.

Per altre informazioni su PowerShell 7, vedere Annuncio di PowerShell 7,0.

Apple macOS

Il modulo EXO V2 è supportato nelle versioni seguenti di macOS:

  • MacOS 11 Big Sur o versioni successive
  • macOS 10.15 Catalina
  • macOS 10.14 Mojave

Per istruzioni sull'installazione di PowerShell 7 in macOS, vedere Installazione di PowerShell in macOS.

Nota

Come descritto nell'articolo sull’installazione, è necessario installare OpenSSL, obbligatorio per WSMan.

Dopo aver installato PowerShell 7 e OpenSSL, eseguire la procedura seguente:

  1. Eseguire PowerShell come utente avanzato: sudo pwsh

  2. Nella sessione dell'utente con privilegi avanzati di PowerShell, eseguire i seguenti comandi:

    Install-Module -Name PSWSMan
    
    Install-WSMan
    

    Se richiesto, accettare PSGallery come origine per i cmdlet.

Ora è possibile eseguire i normali prerequisiti di PowerShell e installare il modulo EXO V2.

Linux

Il modulo EXO V2 è ufficialmente supportato nelle distribuzioni seguenti di Linux:

  • Ubuntu 18.04 LTS
  • Ubuntu 20.04 LTS

In caso di problemi con l'uso del modulo EXO V2 in altre distribuzioni di Linux, inviare un messaggio di posta elettronica all’indirizzo seguente: exocmdletpreview[at]service[dot]microsoft[dot]com. L'indirizzo di posta elettronica è offuscato di proposito per evitare posta indesiderata.

Per istruzioni sull'installazione di PowerShell 7 in Linux, vedere Installazione di PowerShell in Linux.

Dopo aver installato PowerShell 7, eseguire la procedura seguente:

  1. Eseguire PowerShell come utente avanzato: sudo pwsh

  2. Nella sessione dell'utente con privilegi avanzati di PowerShell, eseguire i seguenti comandi:

    Install-Module -Name PSWSMan
    
    Install-WSMan
    

    Se richiesto, accettare PSGallery come origine per i cmdlet.

Ora è possibile eseguire i normali prerequisiti di PowerShell e installare il modulo EXO V2.

Nota

Se ci si connette a Exchange Online PowerShell da una rete dietro un server proxy, la versione 2.0.5 o versioni precedenti del modulo non funzionano in Linux. È necessario usare la versione 2.0.6 o successiva in Linux per connettersi da una rete dietro un server proxy.

Windows

Tutte le versioni del modulo EXO V2 sono supportate in Windows PowerShell 5.1. PowerShell 7 in Windows richiede la versione 2.0.4 o successiva del modulo EXO V2.

Il modulo EXO V2 è supportato nelle versioni seguenti di Windows:

  • Windows 11
  • Windows 10
  • Windows 8.14
  • Windows Server 2019
  • Windows Server 2016
  • Windows Server 2012 o Windows Server 2012 R24
  • Windows 7 Service Pack 1 (SP1)1,2,3
  • Windows Server 2008 R2 SP11,2,3

1 Questa versione di Windows ha raggiunto la fine del supporto e ora è supportata solo nelle macchine virtuali di Azure.

2 Questa versione di Windows non supporta la versione 2.0.4 o successiva del modulo EXO V2. È supportata solo la versione 2.0.3 o precedente.

3 Windows PowerShell 5.1 in questa versione di Windows richiede Microsoft .NET Framework 4.5 o versione successiva e Windows Management Framework 5.1. Per ulteriori informazioni, vedere Windows Management Framework 5.1.

4 PowerShell 7 in questa versione di Windows richiede Windows 10 Universal C Runtime (CRT).

Prerequisiti per il modulo EXO V2

Nota

Le impostazioni descritte in questa sezione sono necessarie in tutte le versioni di PowerShell su tutti i sistemi operativi.

  • 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 verrà 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 che tutti gli script di PowerShell scaricati da internet siano firmati da un editore attendibile, eseguire il seguente comando in una finestra di PowerShell elevata (una finestra di PowerShell aperta selezionando Esegui come amministratore):

    Set-ExecutionPolicy RemoteSigned
    

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

  • Attivare l'autenticazione di base in WinRM:

    Nota

    Come descritto in precedenza in questo articolo, la versione 2.0.6 del modulo EXO V2 non richiede l'autenticazione di base in WinRM per i cmdlet dell'API REST.

    WinRM deve consentire l'autenticazione di base. La combinazione di nome utente e password non viene inviata, ma è necessaria l'intestazione di autenticazione di base per inviare il token OAuth della sessione, perché l'implementazione di WinRM lato client non supporta OAuth.

    Per verificare che l'autenticazione di base sia abilitata per WinRM, eseguire il comando seguente in un prompt dei comandi o Windows PowerShell:

    Nota

    I comandi seguenti richiedono l'abilitazione di WinRM. Per abilitare WinRM, eseguire il comando seguente: winrm quickconfig.

    winrm get winrm/config/client/auth
    

    Se il valore Basic = truenon viene visualizzato, è necessario eseguire uno dei comandi seguenti per abilitare l'autenticazione di base per WinRM:

    • In un prompt dei comandi:

      winrm set winrm/config/client/auth @{Basic="true"}
      
    • In Windows PowerShell:

      winrm set winrm/config/client/auth '@{Basic="true"}'
      
    • In Windows PowerShell per modificare il registro:

      Set-ItemProperty -Path 'HKLM:\SOFTWARE\Policies\Microsoft\Windows\WinRM\Client' -Name 'AllowBasic' -Type DWord -Value '1'
      

    Se l'autenticazione di base per WinRM è disabilitata, quando si tenta di connettersi si verifica uno degli errori seguenti:

    Client Gestione remota Windows: impossibile elaborare la richiesta. L'autenticazione di base è attualmente disabilitata nella configurazione del client. Modificare la configurazione del client e riprovare.

    La creazione della sessione di PowerShell non è riuscita con OAuth.

Suggerimento

In caso di problemi è possibile richiedere supporto nei forum di Exchange. Visitare i forum ai seguenti indirizzi: Exchange Online o Exchange Online Protection.

Installare il modulo EXO V2

Per installare il modulo EXO V2 per la prima volta, completare i passaggi seguenti:

  1. Installare o aggiornare il modulo PowerShellGet come descritto in Installazione di PowerShellGet.

  2. Chiudere e riaprire la finestra di Windows PowerShell.

  3. Ora è possibile usare il cmdlet Installa modulo per installare il modulo EXO V2 dalla raccolta di PowerShell. In genere, è consigliabile usare la versione pubblica più recente del modulo, ma è anche possibile installare una versione di anteprima, se disponibile.

    • Per installare la versione pubblica più recente del modulo, eseguire uno dei seguenti comandi:

      • In una finestra di PowerShell con privilegi elevati (tutti gli utenti):

        Install-Module -Name ExchangeOnlineManagement
        
      • Solo per l'account utente corrente:

        Install-Module -Name ExchangeOnlineManagement -Scope CurrentUser
        
    • Per installare una versione di anteprima del modulo, sostituire <PreviewVersion> con il valore necessario ed eseguire uno dei comandi seguenti:

      • In una finestra di PowerShell con privilegi elevati (tutti gli utenti):

        Install-Module -Name ExchangeOnlineManagement -RequiredVersion <PreviewVersion> -AllowPrerelease
        
      • Solo per l'account utente corrente:

        Install-Module -Name ExchangeOnlineManagement -RequiredVersion <PreviewVersion> -AllowPrerelease -Scope CurrentUser
        

    Al termine, immettere Y per accettare il contratto di licenza.

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

Aggiornare il modulo EXO V2

Se il modulo è già installato nel computer, è possibile eseguire i comandi seguenti per verificare la versione attualmente installata e aggiornarla alla più recente dalla PowerShell Gallery:

  1. Per vedere la versione del modulo attualmente installato, eseguire i comandi seguenti:

    Import-Module ExchangeOnlineManagement; Get-Module ExchangeOnlineManagement
    
  2. È possibile usare il cmdlet Aggiorna-modulo dalla PowerShell Gallery per aggiornare il modulo EXO V2. In genere, è consigliabile usare la versione pubblica più recente del modulo, ma è anche possibile aggiornare a una versione di anteprima, se disponibile.

    • Per eseguire l'aggiornamento alla versione più recente del modulo pubblico, eseguire uno dei seguenti comandi in base all'installazione originale del modulo (in una finestra di PowerShell con privilegi elevati vs. Scope CurrentUser):

      • In una finestra di PowerShell con privilegi elevati (tutti gli utenti):

        Update-Module -Name ExchangeOnlineManagement
        
      • Solo per l'account utente corrente:

        Update-Module -Name ExchangeOnlineManagement -Scope CurrentUser
        
    • Per eseguire l'aggiornamento a una versione di anteprima del modulo, è possibile eseguire l'aggiornamento alla versione di anteprima più recente disponibile oppure usare il parametro RequiredVersion per eseguire l'aggiornamento a una versione di anteprima specifica. Per visualizzare le versioni di anteprima disponibili, eseguire il comando: Find-Module ExchangeOnlineManagement -AllVersions -AllowPrerelease.

      Eseguire uno dei seguenti comandi in base all'installazione originale del modulo (in una finestra di PowerShell con privilegi elevati rispetto a Scope CurrentUser):

      • In una finestra di PowerShell con privilegi elevati (tutti gli utenti):

        Update-Module -Name ExchangeOnlineManagement -AllowPrerelease [-RequiredVersion <PreviewVersion>]
        
      • Solo per l'account utente corrente:

        Update-Module -Name ExchangeOnlineManagement -AllowPrerelease -Scope CurrentUser [-RequiredVersion <PreviewVersion>]
        

    Al termine, immettere Y per accettare il contratto di licenza.

  3. Per verificare l'esito dell'aggiornamento, eseguire i comandi seguenti per verificare le informazioni sulla versione del modulo installato:

    Import-Module ExchangeOnlineManagement; Get-Module ExchangeOnlineManagement
    

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

Risolvere i problemi di installazione del modulo EXO V2

  • Viene visualizzato uno dei seguenti errori:

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

    AVVISO: non è possibile eseguire il download dall'URI 'https://go.microsoft.com/fwlink/?LinkID=627338&clcid=0x409' in ".

    AVVISO: impossibile 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 provare ad aggiornare nuovamente il modulo ExchangeOnlineManagement.

  • A partire da aprile 2020, la raccolta PowerShell supporta solo le connessioni con TLS 1.2 o versione successiva. Per altre informazioni, vedere PowerShell Gallery, supporto TLS.

    Per controllare le impostazioni correnti in Microsoft .NET Framework, eseguire il comando seguente in Windows PowerShell:

    [Net.ServicePointManager]::SecurityProtocol
    

    Come descritto nell'articolo del supporto TLS della PowerShell gallery, per cambiare temporaneamente il protocollo di sicurezza TLS 1.2 per installare i moduli PowerShellGet o ExchangeOnlineManagement, eseguire il comando seguente in Windows PowerShell prima di installare il modulo:

    [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12 
    

    Per abilitare permanentemente la crittografia avanzata in Microsoft .NET Framework versione 4.x o successiva, eseguire uno dei comandi seguenti in base all'architettura di Windows:

    • x64:

      Set-ItemProperty -Path 'HKLM:\SOFTWARE\Wow6432Node\Microsoft\.NETFramework\v4.0.30319' -Name 'SchUseStrongCrypto' -Type DWord -Value '1'
      
    • x86

      Set-ItemProperty -Path 'HKLM:\SOFTWARE\Microsoft\.NETFramework\v4.0.30319' -Name 'SchUseStrongCrypto' -Type DWord -Value '1'
      

    Per altre informazioni, vedereSchUseStrongCrypto.

  • 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.

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

    Register-PSRepository -Default
    

Disinstallare il modulo EXO V2

Per disinstallare il modulo, eseguire uno dei seguenti comandi in base all'installazione originale del modulo (in una finestra di PowerShell con privilegi elevati rispetto a Scope CurrentUser):

  • In una finestra di PowerShell con privilegi elevati (tutti gli utenti):

    Uninstall-Module -Name ExchangeOnlineManagement
    
  • Solo per l'account utente corrente:

    Uninstall-Module -Name ExchangeOnlineManagement
    

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

Proprietà e set di proprietà nel modulo EXO V2

I cmdlet di Exchange Online tradizionali restituisce tutte le possibili proprietà degli oggetti negli output, incluse numerose proprietà che spesso sono vuote o che in molti scenari non sono 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 del modulo Get-EXO* offrono proprietà di output categorizzate. Anziché assegnare uguale importanza a tutte le proprietà e restituirle in tutti gli scenari, le proprietà correlate sono state categorizzate in set di proprietà. In parole povere, questi set di proprietà sono contenitori con due o più proprietà correlate nel cmdlet.

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

In questi cmdlet, i set di proprietà sono controllati dai parametri seguenti:

È possibile usare i parametri PropertySet e Properties nello stesso comando.

È inoltre disponibile il set di proprietà Minimum, che include un insieme di proprietà di base per l'output del cmdlet (per esempio, proprietà identità). Le proprietà disponibili nel set di proprietà Minimum sono descritte anche in set di proprietà nei cmdlet di PowerShell V2 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 conterrà meno proprietà e il tempo necessario per restituire i risultati sarà molto inferiore.

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

Get-EXOMailbox -ResultSize 10

L’output dello stesso comando Get-Mailbox restituirebbe invece almeno 230 proprietà per ciascuna delle prime dieci cassette postali.

Nota

Anche se il parametro PropertySets accetta il valore All, è sconsigliabile l’utilizzo di questo valore per recuperare tutte le proprietà perché rallenta il comando e riduce l'affidabilità. Usare sempre i parametri PropertySets e Properties per recuperare il numero minimo di proprietà richiesti per lo scenario specifico..

Per altre informazioni sui filtri nel modulo EXO V2, vedere Filtri nel modulo V2 di Exchange Online.

Note sulla versione

Se non diversamente specificato, la versione corrente del modulo EXO V2 contiene tutte le funzionalità delle versioni precedenti.

Versione corrente: versione 2.0.5

  • Nuovo cmdlet Get-OwnerlessGroupPolicy e cmdlet 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à headspace in Viva Insights.

Versioni precedenti

Versione 2.0.4

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

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

  • I cmdlet Get-UserAnalyticsConfig e Set-UserAnalyticsConfig sono stati sostituiti dai cmdlet Get-MyAnalyticsConfig e Set-MyAnalyticsConfig. Inoltre, è possibile configurare l'accesso a livello di funzionalità. Per altre informazioni, vedere Configura MYAnalytics.

  • Criteri in tempo reale e applicazione della sicurezza in tutte le autenticazioni basate sugli utenti. La Valutazione continua dell'accesso (CAE) è stata abilitata nel modulo EXO V2. Leggere altre informazioni sulla Valutazione continua dell’accesso (CAE) qui.

  • 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 certificato (CBA), che consente l'uso dell'autenticazione moderna per gli script eseguiti automaticamente o gli scenari di automazione in background. Le posizioni di archiviazione dei certificati disponibili sono:
  • 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 carico di memoria per le applicazioni di PowerShell ad alto utilizzo.
  • 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 invocazione è stata ridotta da 8 secondi a circa 1 secondo. I risultati effettivi dipendono dalla dimensione del risultato del cmdlet e dall'ambiente del tenant.

Versione 1.0.1

  • Versione di disponibilità generale del modulo EXO V2. È stabile e pronta per l'uso in ambiente di produzione.
  • Il cmdlet Get-EXOMobileDeviceStatistics ora supporta il parametro Identity.
  • È stata migliorata l'affidabilità della riconnessione automatica della sessione: in alcuni casi in cui uno script restava in esecuzione per circa 50 minuti e poi generava l'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.
  • È stato migliorato il supporto per i filtri, che ora supporta altri quattro operatori: EndsWith, Contains, Not e NotLike. Consultare Filters in the EXO V2 module per informazioni sugli attributi che non sono 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>
  • L'affidabilità di Get-EXOMailboxStatistics è stata migliorata, grazie alla risoluzione di alcuni problemi di routing delle richieste che causavano errori.
  • L'utilizzo della memoria alla creazione di una sessione è stato ottimizzato, riutilizzando qualsiasi modulo esistente con una nuova sessione anziché crearne uno nuovo ogni volta che si importa la 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.
  • Remote PowerShell conteneva vari tipi di dati complessi, che intenzionalmente non erano supportati nei cmdlet EXO per migliorare le prestazioni. Le differenze relative ai tipi di dati non complessi tra i cmdlet di Remote PowerShell e i cmdlet V2 sono state risolte, in modo da consentire una migrazione semplice degli script di gestione.

Versione 0.3582.0

  • Supporto per il prefisso durante la creazione di una sessione.
    • È possibile creare solo una sessione alla volta che contiene cmdlet con prefisso.
    • Si noti che i cmdlet di EXO V2 non verranno prefissati perché hanno già il prefisso EXO, quindi non usare EXO come prefisso.
  • Usare i cmdlet di EXO V2 anche se l'autenticazione di base di WinRM è disabilitata nel computer client. Si noti che cmdlet di Remote PowerShell richiedono l'autenticazione di base di WinRM e che non sono disponibili se è disabilitata.
  • Il parametro Identity per i cmdlet v2 ora supporta anche Name e Alias. Si noti che l'uso di Alias o Name rallenta le prestazioni dei cmdlet V2, quindi non è consigliato.
  • È 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 presenti alcuni attributi con tipi di dati diversi, che verranno gestiti nei prossimi mesi.
  • Correzione di bug: problema di frequenti riconnessioni della sessione quando veniva richiamato Connect-ExchangeOnline con Credentials 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:

    Impossibile richiamare la pipeline perché lo stato dello spazio di esecuzione non è Opened. Lo stato corrente dello spazio di esecuzione è 'Closed'.

Versione 0.3527.4

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

Versione 0.3527.3

  • È stato aggiunto il supporto per gestire Exchange per un tenant diverso usando il flusso di delega.
  • Funziona in tandem con altri moduli di PowerShell in una singola 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 di bug: i cmdlet di Remote PowerShell falliscono in modo intermittente per un problema di differenza di tempo tra la scadenza del token e il passaggio all'inattività di PSSession.
  • Aggiornamento principale della sicurezza.
  • Correzioni di bug e miglioramenti.