Informationen zum Exchange Online PowerShell V2-Modul

Das Exchange Online PowerShell V2-Modul (abgekürzt als EXO V2-Modul) verwendet die moderne Authentifizierung und funktioniert mit der mehrstufigen Authentifizierung (Multi-Factor Authentication, MFA) zum Herstellen einer Verbindung mit allen Exchange-bezogenen PowerShell-Umgebungen in Microsoft 365: Exchange Online PowerShell, Security & Compliance PowerShell sowie PowerShell in eigenständigem Exchange Online Protection (EOP).

Verbindungsanweisungen unter Verwendung des EXO V2-Moduls finden Sie in den folgenden Artikeln:

In Rest dieses Artikels werden die Funktionsweise des Moduls, seine Installation und Wartung sowie die im Modul verfügbaren optimierten Exchange Online-Cmdlets beschrieben.

Melden von Fehlern und Problemen beim EXO V2-Modul

Wenn Sie ein Problem unter exocmdletpreview[at]service[dot]microsoft[dot]com melden, achten Sie darauf, die Protokolldateien in Ihre E-Mail-Nachricht einzuschließen. Um die Protokolldateien zu generieren, ersetzen Sie <Path to store log file> durch den gewünschten Ausgabeordner, und führen Sie den folgenden Befehl aus:

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

Hinweis

Die neueste Version des EXO V2-Moduls und die häufige Verwendung der cmdlets Connect-ExchangeOnline und Disconnect-ExchangeOnline in einer einzelnen PowerShell-Sitzung oder einem einzelnen Skript können zu einem Arbeitsspeicherverlust führen. Die beste Möglichkeit, dieses Problem zu vermeiden, besteht darin, den Parameter CommandName im Connect-ExchangeOnline-Cmdlet zu verwenden, um die in der Sitzung verwendeten Cmdlets einzuschränken.

Funktionsweise des EXO V2-Moduls

Das Modul enthält ein paar neue Exchange Online PowerShell-Cmdlets, die für den Massenabruf von Daten optimiert sind (stellen Sie sich vor: Tausende und Abertausende von Objekten). Wenn Sie das Modul zum ersten Mal öffnen, werden nur diese exklusiven Cmdlets angezeigt. Nach dem Herstellen einer Verbindung mit Ihrer Exchange Online-Organisation werden alle gewohnten Cmdlets aus Exchange Online PowerShell angezeigt.

Das Modul verwendet für alle Cmdlets moderne Authentifizierung. Die Standardauthentifizierung kann im EXO V2-Modul nicht verwendet werden, Sie müssen aber trotzdem die Einstellung für die Standardauthentifizierung in WinRM wie weiter unten in diesem Artikel erläutert aktivieren.

Die Exchange Online-Cmdlets im EXO V2-Modul sind dafür vorgesehen, ihre älteren, weniger leistungsfähigen Äquivalente zu ersetzen, die entsprechenden Cmdlets sind aber weiterhin verfügbar (nach dem Herstellen der Verbindung).

Die verbesserten Exchange Online PowerShell-Cmdlets, die nur im EXO V2-Modul verfügbar sind, werden in der folgenden Tabelle aufgeführt:

Cmdlet im EXO V2-Modul Älteres verwandtes Cmdlet
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

Die verbindungsbezogenen Cmdlets, die im EXO V2-Modul verfügbar sind, werden in der folgenden Tabelle aufgeführt:

Cmdlet im EXO V2-Modul Älteres verwandtes Cmdlet
Connect-ExchangeOnline Connect-EXOPSSession

oder

New-PSSession

Connect-IPPSSession Connect-IPPSSession
Disconnect-ExchangeOnline Remove-PSSession

Verschiedene Exchange Online PowerShell-Cmdlets, die sich im EXO V2-Modul befinden, werden in der folgenden Tabelle aufgeführt:

Cmdlet im EXO V2-Modul Kommentare
Get-MyAnalyticsFeatureConfig Verfügbar in Version 2.0.4 oder höher.
Set-MyAnalyticsFeatureConfig Verfügbar in Version 2.0.4 oder höher.
Get-UserBriefingConfig Ersetzt durch Get-MyAnalyticsFeatureConfig.
Set-UserBriefingConfig Ersetzt durch Set-MyAnalyticsFeatureConfig.
Get-VivaInsightsSettings Verfügbar in Version 2.0.5-Preview2 oder höher.
Set-VivaInsightsSettings Verfügbar in Version 2.0.5-Preview2 oder höher.

Updates für Version 2.0.6

Version 2.0.6-Preview6 des EXO V2-Moduls ist jetzt verfügbar. Diese Vorschauversion verbessert die historischen Funktionen des Moduls mit den folgenden Features:

  • Version 2.0.6 enthält Cmdlets, die von der REST-API unterstützt werden:

    • REST-API-Cmdlets basieren nicht auf der Remote-PowerShell-Sitzung, sodass PowerShell auf Ihrem Clientcomputer keine Standardauthentifizierung in WinRM benötigt.
    • REST-API-Cmdlets funktionieren genauso wie ihre entsprechenden Remote-PowerShell-Cmdlets, sodass Sie keines Ihrer Skripts aktualisieren müssen.
    • Praktisch alle verfügbaren PowerShell-Remote-Cmdlets werden jetzt von der REST-API unterstützt. Einige Cmdlets werden möglicherweise vorübergehend bei der Verwendung der REST-API als verfügbar angezeigt oder ausgeblendet, während wir Probleme finden und beheben.
  • Der neue UseRPSSession-Schalter in Connect-ExchangeOnline gewährt Zugriff auf alle vorhandenen Remote-PowerShell-Cmdlets wie zuvor:

    • Der UseRPSSession-Schalter erfordert Standardauthentifizierung in WinRM auf Ihrem Clientcomputer.
    • Wenn Sie beim Herstellen der Verbindung nicht den Schalter UseRPSSession verwenden, können Sie nur die REST-API-Cmdlets verwenden.
  • Einige REST-API-Cmdlets wurden mit dem experimentellen UseCustomRouting-Schalter aktualisiert. Dieser Schalter wird den Befehl direkt an den erforderlichen Postfachserver weiterleiten, und die Gesamtleistung kann verbessert werden.

    • Wenn Sie den UseCustomRouting-Schalter verwenden, müssen Sie für die Identität des Postfachs die folgenden Werte verwenden:

      • Benutzerprinzipalname (User Principal Name, UPN)
      • E-Mail-Adresse
      • Postfach-GUID
    • Die Schalter UseCustomRouting ist nur für die folgenden REST-API-Cmdlets verfügbar:

      • 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

      Verwenden Sie den Schalter UseCustomRouting experimentell, und melden Sie alle Fehler, auf die Sie stoßen.

Installieren und Verwalten des EXO V2-Moduls

Sie können das EXO V2-Modul aus dem PowerShell-Katalog unter https://www.powershellgallery.com/packages/ExchangeOnlineManagement/ herunterladen.

In den Vorgehensweisen in diesem Abschnitt wird erläutert, wie das EXO V2-Modul installiert, aktualisiert und deinstalliert wird.

Unterstützte Betriebssysteme für das EXO V2-Modul

Die neueste Version des EXO V2-Moduls wird offiziell in PowerShell 7 unter Windows, Linux und Apple macOS unterstützt.

Insbesondere wird die Version 2.0.4 oder höher des EXO V2-Moduls in PowerShell 7.0.3 oder höher unterstützt.

Weitere Informationen zu PowerShell 7 finden Sie unter Ankündigung von PowerShell 7.0.

Apple macOS

Das EXO V2-Modul wird in den folgenden Versionen von macOS unterstützt:

  • macOS 11 Big Sur oder höher
  • macOS 10.15 Catalina
  • macOS 10.14 Mojave

Anweisungen zur Installation von PowerShell 7 auf macOS finden Sie unter Installieren von PowerShell auf macOS.

Hinweis

Wie im Installationsartikel beschrieben, müssen Sie OpenSSL installieren, da dies für WSMan erforderlich ist.

Führen Sie nach der Installation von PowerShell 7 und OpenSSL die folgenden Schritte aus:

  1. PowerShell als Superuser ausführen: sudo pwsh

  2. Führen Sie in der PowerShell-Superusersitzung die folgenden Befehle aus:

    Install-Module -Name PSWSMan
    
    Install-WSMan
    

    Wenn Sie dazu aufgefordert werden, akzeptieren Sie PSGallery als Quelle für die Cmdlets.

Jetzt erfüllen Sie die üblichen PowerShell-Voraussetzungen und Sie können Das EXO V2-Modul installieren.

Linux

Das EXO-V2-Modul wird offiziell von den folgenden Linux-Verteilungen unterstützt:

  • Ubuntu 18.04 LTS
  • Ubuntu 20.04 LTS

Wenn Sie Probleme haben, das EXO V2-Modul auf anderen Linux-Verteilungen zu verwenden, senden Sie eine E-Mail an die folgende Adresse: exocmdletpreview[at]service[dot]microsoft[dot]com. Die E-Mail-Adresse ist absichtlich verschleiert, um Spam zu vermeiden.

Anweisungen zur Installation von PowerShell 7 auf Linux finden Sie unter Installieren von PowerShell auf Linux.

Führen Sie nach der Installation von PowerShell 7 die folgenden Schritte aus:

  1. PowerShell als Superuser ausführen: sudo pwsh

  2. Führen Sie in der PowerShell-Superusersitzung die folgenden Befehle aus:

    Install-Module -Name PSWSMan
    
    Install-WSMan
    

    Wenn Sie dazu aufgefordert werden, akzeptieren Sie PSGallery als Quelle für die Cmdlets.

Jetzt erfüllen Sie die üblichen PowerShell-Voraussetzungen und Sie können Das EXO V2-Modul installieren.

Windows

Alle Versionen des EXO V2-Moduls werden in Windows PowerShell 5.1 unterstützt. PowerShell 7 unter Windows erfordert Version 2.0.4 oder höher des EXO V2-Moduls.

Das EXO V2-Modul wird in den folgenden Versionen von Windows unterstützt:

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

1 Diese Version von Windows hat das Ende des Supports erreicht und wird nur noch auf virtuellen Azure-Computern unterstützt.

2 Diese Version von Windows unterstützt die Version 2.0.4 oder höher des EXO V2-Moduls nicht. Es wird nur die Version 2.0.3 oder früher unterstützt.

3Zur Verwendung von Windows PowerShell 5.1 unter dieser Version von Windows sind Microsoft .NET Framework 4.5 oder höher und Windows Management Framework 5.1 erforderlich. Weitere Informationen finden Sie unter Windows Management Framework 5.1.

4 PowerShell 7 unter dieser Version von Windows erfordert die Windows 10 Universal C Runtime (CRT).

Voraussetzungen für das EXO V2-Modul

Hinweis

Die in diesem Abschnitt beschriebenen Einstellungen sind in allen Versionen von PowerShell auf allen Betriebssystemen erforderlich.

  • Legen Sie die PowerShell-Ausführungsrichtlinie auf RemoteSigned fest:

    PowerShell muss zum Ausführen von Skripts konfiguriert werden. Standardmäßig ist dies nicht der Fall. Beim Versuch, eine Verbindung herzustellen, wird der folgende Fehler angezeigt:

    Dateien können nicht geladen werden, weil das Ausführen von Skripts auf diesem System deaktiviert ist. Stellen Sie ein gültiges Zertifikat bereit, mit dem die Dateien signiert werden sollen.

    Um festzulegen, dass alle PowerShell-Skripts, die Sie aus dem Internet herunterladen, von einem vertrauenswürdigen Herausgeber signiert sein müssen, müssen Sie den folgenden Befehl in einem PowerShell-Fenster mit erhöhten Rechten ausführen (ein PowerShell-Fenster, das Sie durch Auswahl von Als Administrator ausführen geöffnet haben):

    Set-ExecutionPolicy RemoteSigned
    

    Mehr zu Ausführungsrichtlinien finden Sie unter Ausführungsrichtlinien.

  • Aktivierung der Standardauthentifizierung in WinRM:

    Hinweis

    Wie früher in diesem Artikel beschrieben erfordert v2.0.6 des EXO V2-Moduls keine Standardauthentifizierung in WinRM für REST-API-Cmdlets.

    WinRM muss die Standardauthentifizierung zulassen. Die Kombination aus Benutzername und Kennwort wird nicht gesendet, der Header der Standardauthentifizierung ist jedoch erforderlich, um das OAuth-Token der Sitzung zu senden, da die clientseitige WinRM-Implementierung keine Unterstützung für OAuth bietet.

    Um zu überprüfen, ob die Standardauthentifizierung für WinRM aktiviert ist, führen Sie den folgenden Befehl in der Eingabeaufforderung oder Windows PowerShell aus:

    Hinweis

    Sie müssen WinRM vorübergehend aktivieren, um die nachstehenden WinRM-Befehle ausführen zu können. Sie können WinRM durch Ausführen des Befehls winrm quickconfig aktivieren.

    winrm get winrm/config/client/auth
    

    Wenn der Wert Basic = true nicht angezeigt wird, müssen Sie einen der folgenden Befehle ausführen, um die Standardauthentifizierung für WinRM zu aktivieren:

    • In der Eingabeaufforderung:

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

      winrm set winrm/config/client/auth '@{Basic="true"}'
      
    • In Windows PowerShell zum Ändern der Registrierung:

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

    Wenn die Standardauthentifizierung für WinRM deaktiviert ist, wird beim Versuch, eine Verbindung herzustellen, einer der folgenden Fehler gemeldet:

    Die Anforderung kann vom WinRM-Client nicht verarbeitet werden. Die Standardauthentifizierung ist in der Clientkonfiguration zurzeit deaktiviert. Ändern Sie die Clientkonfiguration, und versuchen Sie es erneut.

    Erstellen der PowerShell-Sitzung ist mit OAuth fehlgeschlagen.

Tipp

Sie haben Probleme? Bitten Sie in den Exchange-Foren um Hilfe. Sie finden die Foren unter folgenden Links: Exchange Online oder Exchange Online Protection.

Installieren des EXO V2-Moduls

Führen Sie die folgenden Schritte aus, um das EXO V2-Modul zum ersten Mal zu installieren:

  1. Installieren oder aktualisieren Sie das PowerShellGet-Modul wie unter Installieren von PowerShellGet beschrieben.

  2. Schließen Sie das Windows PowerShell-Fenster und öffnen Sie es erneut.

  3. Jetzt können Sie das Cmdlet Install-Module verwenden, um das EXO V2-Modul aus dem PowerShell-Katalog zu installieren. Normalerweise benötigen Sie die neueste öffentliche Version des Moduls, Sie können aber auch eine Vorschauversion installieren, sofern eine verfügbar ist.

    • Um die neueste öffentliche Version des Moduls zu installieren, führen Sie einen der folgenden Befehle aus:

      • In einem PowerShell-Fenster mit erhöhten Rechten (alle Benutzer):

        Install-Module -Name ExchangeOnlineManagement
        
      • Nur für das aktuelle Benutzerkonto:

        Install-Module -Name ExchangeOnlineManagement -Scope CurrentUser
        
    • Um eine Vorschauversion des Moduls zu installieren, ersetzen Sie <PreviewVersion> durch den erforderlichen Wert und führen Sie einen der folgenden Befehle aus:

      • In einem PowerShell-Fenster mit erhöhten Rechten (alle Benutzer):

        Install-Module -Name ExchangeOnlineManagement -RequiredVersion <PreviewVersion> -AllowPrerelease
        
      • Nur für das aktuelle Benutzerkonto:

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

    Wenn Sie fertig sind, geben Sie Y ein, um den Lizenzvertrag anzunehmen.

Ausführliche Informationen zu Syntax und Parametern finden Sie unter Install-Module.

Aktualisieren des EXO V2-Moduls

Wenn das Modul bereits auf Ihrem Computer installiert ist, können Sie die nachstehenden Befehle ausführen, um die aktuell installierte Version anzuzeigen und sie auf die neueste Version aus dem PowerShell-Katalog zu aktualisieren:

  1. Führen Sie zum Anzeigen der aktuell installierten Version des Moduls die folgenden Befehle aus:

    Import-Module ExchangeOnlineManagement; Get-Module ExchangeOnlineManagement
    
  2. Sie können das Cmdlet Update-Module verwenden, um das EXO V2-Modul über die PowerShell-Galerie zu aktualisieren. Normalerweise benötigen Sie die neueste öffentliche Version des Moduls, Sie können aber auch auf eine Vorschauversion aktualisieren, sofern eine verfügbar ist.

    • Um auf die neueste öffentliche Version des Moduls zu aktualisieren, führen Sie einen der folgenden Befehle aus, je nachdem, wie Sie das Modul ursprünglich installiert haben (in einem PowerShell-Fenster mit erhöhten Rechten vs. Scope CurrentUser):

      • In einem PowerShell-Fenster mit erhöhten Rechten (alle Benutzer):

        Update-Module -Name ExchangeOnlineManagement
        
      • Nur für das aktuelle Benutzerkonto:

        Update-Module -Name ExchangeOnlineManagement -Scope CurrentUser
        
    • Um ein Upgrade auf eine Vorschauversion des Moduls durchzuführen, können Sie ein Upgrade auf die neueste verfügbare Vorschauversion durchführen oder den RequiredVersion-Parameter verwenden, um ein Upgrade auf eine bestimmte Vorschauversion durchzuführen. Führen Sie den folgenden Befehl aus, um die verfügbaren Vorschauversionen anzuzeigen: Find-Module ExchangeOnlineManagement -AllVersions -AllowPrerelease.

      Führen Sie einen der folgenden Befehle aus, je nachdem, wie Sie das Modul ursprünglich installiert haben (in einem erweiterten PowerShell-Fenster im Vergleich zu Scope CurrentUser):

      • In einem PowerShell-Fenster mit erhöhten Rechten (alle Benutzer):

        Update-Module -Name ExchangeOnlineManagement -AllowPrerelease [-RequiredVersion <PreviewVersion>]
        
      • Nur für das aktuelle Benutzerkonto:

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

    Wenn Sie fertig sind, geben Sie Y ein, um den Lizenzvertrag anzunehmen.

  3. Um zu bestätigen, dass das Update erfolgreich war, führen Sie die folgenden Befehle aus, um die Versionsinformationen des installierten Moduls zu überprüfen:

    Import-Module ExchangeOnlineManagement; Get-Module ExchangeOnlineManagement
    

Ausführliche Informationen zu Syntax und Parametern finden Sie unter Update-Module.

Problembehandlung bei der Installation des EXO V2-Moduls

  • Sie erhalten einen der folgenden Fehler:

    Das angegebene Modul "ExchangeOnlineManagement" mit PowerShellGetFormatVersion "<version>" wird von der aktuellen PowerShellGet-Version nicht unterstützt. Rufen Sie die neueste Version des PowerShellGet-Moduls zum Installieren dieses Moduls, "ExchangeOnlineManagement", ab.

    WARNUNG: Download von URI ''https://go.microsoft.com/fwlink/?LinkID=627338&clcid=0x409'' nach '' nicht möglich.

    WARNUNG: Die Liste der verfügbaren Anbieter kann nicht heruntergeladen werden. Überprüfen Sie Ihre Internetverbindung.

    Aktualisieren Sie die Installation des PowerShellGet-Moduls auf die neueste Version, wie unter Installieren von PowerShellGet beschrieben. Schließen Sie unbedingt das PowerShell-Fenster, und öffnen Sie es erneut, bevor Sie noch einmal versuchen, das ExchangeOnlineManagement-Modul zu aktualisieren.

  • Ab April 2020 unterstützt der PowerShell-Katalog nur noch Verbindungen mit TLS 1.2 oder höher. Weitere Informationen finden Sie unter PowerShell-Katalog: TLS-Unterstützung.

    Um Ihre aktuellen Einstellungen im Microsoft .NET Framework zu überprüfen, führen Sie den folgenden Befehl in Windows PowerShell aus:

    [Net.ServicePointManager]::SecurityProtocol
    

    Wie im Artikel „PowerShell-Katalog: TLS-Unterstützung“ beschrieben, führen Sie zum Installieren der Module „PowerShellGet“ oder „ExchangeOnlineManagement“ den folgenden Befehl in Windows PowerShell aus, um das Sicherheitsprotokoll vorübergehend auf TLS 1.2 zu ändern, bevor Sie das Modul installieren:

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

    Um die starke Kryptografie im Microsoft .NET Framework ab Version 4.x dauerhaft zu aktivieren, führen Sie einen der folgenden Befehle aus, je nach Ihrer Windows-Architektur:

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

    Weitere Informationen finden Sie unter SchUseStrongCrypto.

  • Sie erhalten den folgenden Fehler:

    Für die angegebenen Suchkriterien und den Modulnamen „ExchangeOnlineManagement“ wurde keine Übereinstimmung gefunden. Versuchen Sie, Get-PSRepository auszuführen, um alle verfügbaren registrierten Modulrepositorys anzuzeigen.

    Das Standard-Repository für PowerShell-Module ist nicht auf PSGallery festgelegt. Führen Sie den folgenden Befehl aus, um diesen Fehler zu beheben:

    Register-PSRepository -Default
    

Deinstallieren des EXO V2-Moduls

Um das Modul zu deinstallieren, führen Sie einen der folgenden Befehle aus, je nachdem, wie Sie das Modul ursprünglich installiert haben (in einem PowerShell-Fenster mit erhöhten Rechten oder Scope CurrentUser):

  • In einem PowerShell-Fenster mit erhöhten Rechten (alle Benutzer):

    Uninstall-Module -Name ExchangeOnlineManagement
    
  • Nur für das aktuelle Benutzerkonto:

    Uninstall-Module -Name ExchangeOnlineManagement
    

Ausführliche Informationen zu Syntax und Parametern finden Sie unter Uninstall-Module.

Eigenschaften und Eigenschaftensätze im EXO V2-Modul

Herkömmliche Exchange Online-Cmdlets geben alle möglichen Objekteigenschaften in der Ausgabe zurück, darunter viele Eigenschaften, die häufig leer sind oder in vielen Szenarien nicht interessant sind. Dieses Verhalten führt zu einer verminderten Leistung (mehr Serverrechenaufwand und zusätzliche Netzwerklast). Nur selten (wenn überhaupt) benötigen Sie die gesamten Eigenschaften in der Cmdlet-Ausgabe.

In den Get-EXO*-Cmdlets im Modul sind die Ausgabeeigenschaften kategorisiert. Statt allen Eigenschaften gleiche Bedeutung zuzuschreiben und sie in allen Szenarien zurückzugeben, wurden bestimmte verwandte Eigenschaften in Eigenschaftensätze kategorisiert. Einfach ausgedrückt: Diese Eigenschaftensätze sind Buckets mit zwei oder mehr verwandten Eigenschaften für das Cmdlet.

Die größten und am häufigsten verwendeten Get-EXO*-Cmdlets verwenden Eigenschaftengruppen:

In diesen Cmdlets werden Eigenschaftengruppen durch folgende Parameter gesteuert:

  • PropertySets: Dieser Parameter akzeptiert einen oder mehrere verfügbare, durch Kommas getrennte Eigenschaftensatznamen. Die verfügbaren Eigenschaftensätze werden in Eigenschaftensätze in Exchange Online PowerShell V2-Cmdlets beschrieben.
  • Properties: Dieser Parameter akzeptiert einen oder mehrere, durch Kommas getrennte Eigenschaftennamen.

Sie können die Parameter PropertySets und Properties zusammen im selben Befehl verwenden.

Außerdem haben wir einen Minimum-Eigenschaftensatz einbezogen, der einen absoluten Mindestsatz von erforderlichen Eigenschaften für die Cmdlet-Ausgabe enthält (z. B. Identitätseigenschaften). Die Eigenschaftensätze in den Minimum-Eigenschaftensätzen werden auch in Exchange Online PowerShell V2-Cmdlets beschrieben.

  • Wenn Sie die PropertySets- oder Properties-Parameter nicht verwenden, erhalten Sie automatisch die Eigenschaften im Minimum-Eigenschaftensatz.
  • Wenn Sie die PropertySets- oder Properties-Parameter verwenden, erhalten Sie die angegebenen Eigenschaften und die Eigenschaften im Minimum-Eigenschaftensatz.

In beiden Fällen wird die Ausgabe des Cmdlets viel weniger Eigenschaften enthalten, und die Rückgabe der Ergebnisse wird erheblich schneller erfolgen.

Beispielsweise werden im folgenden Beispiel, nachdem Sie eine Verbindung mit Exchange Online PowerShell hergestellt haben, nur die Eigenschaften im Minimum-Eigenschaftensatz für die ersten zehn Postfächer zurückgegeben.

Get-EXOMailbox -ResultSize 10

Im Gegensatz dazu würde die Ausgabe des gleichen Get-Mailbox-Cmdlets mindestens 230 Eigenschaften für jedes der ersten zehn Postfächer zurückgeben.

Hinweis

Auch wenn der Parameter PropertySets den Wert "All" akzeptiert, raten wir dringend davon ab, mit diesem Wert alle Eigenschaften zurückzugeben, da dadurch der Befehl verlangsamt und die Zuverlässigkeit verringert wird. Verwenden Sie immer die PropertySets- und Properties-Parameter, um die Mindestanzahl von Eigenschaften abzurufen, die in Ihrem Szenario benötigt werden.

Weitere Informationen zum Filtern im EXO V2-Modul finden Sie unter Filter im Exchange Online V2-Modul.

Freigabehinweise

Wenn nicht anders angegeben, enthält das aktuelle Release des EXO V2-Moduls alle Features der vorherigen Versionen.

Aktuelles Release: Version 2.0.5

  • Neue Cmdlets Get-OwnerlessGroupPolicy und Set-OwnerlessGroupPolicy, um Microsoft 365-Gruppen ohne Besitzer zu verwalten.

    Hinweis

    Obwohl die Cmdlets im Modul verfügbar sind, ist das Feature nur für Mitglieder einer privaten Vorschau verfügbar.

  • Neue Cmdlets Get-VivaInsightsSettings und Set-VivaInsightsSettings, um den Benutzerzugriff auf Headspace-Features in Viva Insights zu steuern.

Frühere Releases

Version 2.0.4

  • PowerShell 7 wird offiziell in Windows, Linux und Apple macOS unterstützt, wie im Abschnitt Voraussetzungen für das EXO V2-Modul in diesem Artikel beschrieben.

  • Das EXO V2-Modul in PowerShell 7 unterstützt browserbasiertes Single Sign-On (SSO) und andere Anmeldemethoden. Weitere Informationen finden Sie unter PowerShell 7-Anmeldeverhalten.

  • Die Cmdlets Get-UserAnalyticsConfig und Set-UserAnalyticsConfig wurden durch die Cmdlets Get-MyAnalyticsConfig und Set-MyAnalyticsConfig ersetzt. Zusätzlich können Sie den Zugriff auf Featureebene konfigurieren. Weitere Informationen finden Sie unter MyAnalytics konfigurieren.

  • Richtlinien- und Sicherheitsdurchsetzung in Echtzeit bei allen benutzerbasierten Authentifizierungen. Continuous Access Evaluation (CAE) wurde im EXO V2-Modul aktiviert. Weitere Informationen zu CAE finden Sie hier.

  • Die Eigenschaften LastUserActionTime und LastInteractionTime sind jetzt in der Ausgabe des Cmdlets Get-EXOMailboxStatistics verfügbar.

  • Der interaktive Anmeldeprozess verwendet jetzt eine sicherere Methode zum Abrufen von Zugriffstoken unter Verwendung sicherer Antwort-URLs.

Version 2.0.3

  • Allgemeine Verfügbarkeit der zertifikatbasierten Authentifizierung (CBA), was die Verwendung moderner Authentifizierung bei Szenarien unbeaufsichtigter Skripterstellung oder Hintergrundautomatisierung ermöglicht. Die verfügbaren Zertifikatspeicherorte sind:
    • Remote im Parameter „Azure Key Value“ (das Zertifikat). Mit dieser Option wird die Sicherheit verbessert, da das Zertifikat nur zur Laufzeit abgerufen wird.
    • Lokal im CurrentUser- oder LocalMachine-Zertifikatspeicher (der CertificateThumbprint-Parameter).
    • Lokal in einer exportierten Zertifikatdatei (der CertificateFilePath- und der CertificatePassword-Parameter). Weitere Informationen finden Sie in den Beschreibungen der Parameter in Connect-ExchangeOnline und in Authentifizierung nur in der App für unbeaufsichtigte Skripts im Exo V2-Modul.
  • Verbinden Sie sich in einem einzigen PowerShell-Fenster gleichzeitig mit Exchange Online PowerShell und Security & Compliance PowerShell.
  • Der neue CommandName-Parameter ermöglicht es Ihnen, die in einer Sitzung importierten Exchange Online PowerShell-Cmdlets anzugeben und einzuschränken. Diese Option verringert den Speicherbedarf für PowerShell-Anwendungen mit hoher Auslastung.
  • Get-EXOMailboxFolderPermission unterstützt jetzt ExternalDirectoryObjectID im Parameter Identity.
  • Die optimierte Latenz des ersten V2-Cmdlet-Aufrufs. Laborergebnisse zeigen, dass die erste Aufrufwartezeit von 8 Sekunden auf ungefähr 1 Sekunde reduziert wurde. Die tatsächlichen Ergebnisse sind vom Ergebnis der Cmdlet-Größe und der Mandantenumgebung abhängig.

Version 1.0.1

  • GA-Version (allgemeine Verfügbarkeit) des EXO PowerShell V2-Moduls. Es ist stabil und für die Verwendung in Produktionsumgebungen einsatzbereit.
  • Das Cmdlet Get-EXOMobileDeviceStatistics unterstützt nun den Parameter Identity.
  • Erhöhte Zuverlässigkeit der automatischen Wiederbindung von Sitzungen in bestimmten Fällen, in denen ein Skript für ~50 Minuten ausgeführt wurde und aufgrund eines Fehlers in der Logik für die automatische Wiederverbindung eine Fehlermeldung vom Typ "Cmdlet nicht gefunden" angezeigt wurde.
  • Datentypfehler bei zwei häufig verwendeten "User" und "MailboxFolderUser"-Attributen zur einfachen Migration von Skripts behoben.
  • Verbesserte Unterstützung von Filtern, da jetzt vier weitere Operatoren unterstützt werden: EndsWith, Contains, Not und NotLike support. Überprüfen Sie Filter in den EXO V2-Modulen im Hinblick auf nicht unterstützte Attribute.

Version 0.4578.0

  • Unterstützung für die Konfiguration von Briefing-E-Mails für Ihre Organisation auf Benutzerebene mit Set-UserBriefingConfig- und Get-UserBriefingConfig-Cmdlets hinzugefügt.
  • Unterstützung für die Sitzungsbereinigung mithilfe des Disconnect-ExchangeOnline-Cmdlets. Bei diesem Cmdlet handelt es sich um das V2-Äquivalent von Get-PSSession | Remove-PSSession. Zusätzlich zum Löschen von Sitzungsobjekten und lokalen Dateien wird auch das Zugriffstoken aus dem Cache entfernt, das für die Authentifizierung bei V2-Cmdlets verwendet wird.
  • Sie können FolderId jetzt als Identitätsparameter in Get-EXOMailboxFolderPermission verwenden. Sie können den FolderId-Wert mithilfe von Get-MailboxFolder abrufen. Beispiel: Get-MailboxFolderPermission -Identity <UPN>:<Folder-Path> Get-MailboxFolderPermission -Identity <UPN>:\<Folder-Id>
  • Die Zuverlässigkeit von Get-EXOMailboxStatistics wurde verbessert, da bestimmte Anforderungsroutingfehler behoben wurden, die zu Fehlern geführt haben.
  • Optimierte Speichernutzung, wenn eine Sitzung durch erneutes Verwenden eines vorhandenen Moduls mit einer neuen Sitzung erstellt wird, statt jedes Mal, wenn eine Sitzung importiert wird, eine neue Sitzung zu erstellen.

Version 0.4368.1

  • Unterstützung für Security & Compliance PowerShell-Cmdlets mit dem Connect-IPPSSession Cmdlet hinzugefügt.
  • Das Ankündigungsbanner kann mit dem Schalter ShowBanner (-ShowBanner:$false) ausgeblendet werden.
  • Beenden Sie die Ausführung des Cmdlets für Client-Ausnahmen.
  • Remote PowerShell enthielt mehrere komplexe Datentypen, die in EXO-Cmdlets absichtlich nicht unterstützt wurden, um die Leistung zu verbessern. Unterschiede bei nicht komplexen Datentypen zwischen Remote-PowerShell-Cmdlets und V2-Cmdlets wurden behoben, um eine nahtlose Migration von Verwaltungsskripts zu ermöglichen.

Version 0.3582.0

  • Unterstützung von Präfixen während der Erstellung einer Sitzung.
    • Sie können jeweils nur eine Sitzung erstellen, die Präfix-Cmdlets enthält.
    • Beachten Sie, dass den EXO V2-Cmdlets kein Präfix vorangestellt wird, da sie bereits das Präfix "EXO" aufweisen; verwenden Sie EXO also nicht als Präfix.
  • Verwenden Sie EXO V2-Cmdlets, auch wenn die WinRM-Standardauthentifizierung auf dem Clientcomputer deaktiviert ist. Beachten Sie, dass Remote-PowerShell-Cmdlets die WinRM-Standardauthentifizierung erfordern, und dass sie nicht verfügbar sind, wenn sie deaktiviert ist.
  • Der Identity-Parameter für V2-Cmdlets unterstützt nun auch Name und Alias. Beachten Sie, dass die Verwendung von Alias oder Name die Leistung von V2-Cmdlets verringert. Deshalb empfiehlt es sich nicht, sie zu verwenden.
  • Ein Problem wurde behoben, bei dem sich der Datentyp der vom V2-Cmdlet zurückgegebenen Attribute von jenem von Remote-PowerShell-Cmdlets unterschied. Es gibt noch einige Attribute, die unterschiedliche Datentypen aufweisen, und wir planen, das in den kommenden Monaten anzugehen.
  • Bug behoben: Ein häufiges Problem bei Wiederverbindungen von Sitzungen, wenn Connect-ExchangeOnline mit Credentials oder UserPrincipalName aufgerufen wurde.

Version 0.3555.1

  • Ein Fehler wurde behoben, bei dem mittels Pipeline übertragene Cmdlets aufgrund eines Authentifizierungsproblems mit folgendem Fehler fehlschlugen:

    Die Pipeline kann nicht aufgerufen werden, da sich der Runspace nicht im geöffneten Zustand befindet. Der aktuelle Status des Runspace ist "geschlossen".

Version 0.3527.4

  • Aktualisierte Get-Help-Inhalte.
  • Es wurde ein Problem in Get-Help behoben, bei dem der Parameter Online mit Fehlercode 400 auf eine nicht vorhandene Seite umleitete.

Version 0.3527.3

  • Unterstützung für die Verwaltung von Exchange für einen anderen Mandanten mittels Delegierungsfluss hinzugefügt.
  • Funktioniert zusammen mit anderen PowerShell-Modulen in einem einzigen PS-Fenster.
  • Unterstützung für Positionsparameter wurde hinzugefügt.
  • Das Feld "Datum/Uhrzeit" unterstützt jetzt das Clientgebietsschema.
  • Bug behoben: PSCredential leer, wenn während Connect-ExchangeOnline übergeben.
  • Bug behoben: Client-Modulfehler, wenn Filter $null enthielt.
  • Sitzungen, die im EXO V2-Modul erstellt wurden, weisen nun Namen auf (Benennungsmuster: ExchangeOnlineInternalSession_%SomeNumber%).
  • Bug behoben: Remote-PowerShell-Cmdlets schlugen fehl aufgrund des Zeitunterschieds zwischen Ablauf des Tokens und PSSession-Leerlauf.
  • Größeres Sicherheitsupdate.
  • Bugfixes und Verbesserungen.