Freigeben über


Informationen zum Exchange Online PowerShell-Moduls

Das Exchange Online PowerShell-Modul (seit 2022 auch als Exchange Online PowerShell V3-Modul oder EXO V3-Modul bezeichnet) verwendet moderne Authentifizierung und funktioniert mit oder ohne mehrstufige Authentifizierung (MFA), um eine Verbindung mit allen cloudbezogenen Exchange-PowerShell-Umgebungen herzustellen: Exchange Online PowerShell, Security & Compliance PowerShell und Exchange Online Protection PowerShell für den Cloudschutz von lokalen E-Mail-Umgebungen.

Verbindungsanweisungen zum Verwenden des 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.

REST-API-Verbindungen im EXO V3-Modul

Exchange Online PowerShell und Security & Compliance PowerShell verwendet REST-API-Verbindungen für alle Cmdlets seit 2023.

REST-API-Verbindungen erfordern die Module PowerShellGet und PackageManagement. Weitere Informationen finden Sie unter PowerShellGet für REST-basierte Verbindungen in Windows.

Cmdlets in REST-API-Verbindungen haben die folgenden Vorteile gegenüber ihren historischen Gegenstücken:

  • Sicherer: Integrierte Unterstützung für moderne Authentifizierung und keine Abhängigkeit von der PowerShell-Remotesitzung. PowerShell auf Ihrem Clientcomputer benötigt keine Standardauthentifizierung in WinRM.
  • Zuverlässiger: Vorübergehende Fehler verwenden integrierte Wiederholungen, sodass Fehler oder Verzögerungen minimiert werden. Zum Beispiel:
    • Fehler aufgrund von Netzwerkverzögerungen.
    • Verzögerungen aufgrund großer Abfragen, deren Abschluss sehr lange dauert.
  • Bessere Leistung: REST-API-Verbindungen vermeiden das Einrichten eines PowerShell-Runspaces.

In der folgenden Tabelle werden die Vorteile von REST-API-Cmdlets mit nicht verfügbaren PowerShell-Remote-Cmdlets und den exklusiven Get-EXO*-Cmdlets im EXO V3-Modul verglichen.

  PowerShell-Remote-Cmdlets Get-EXO*-Cmdlets REST-API-Cmdlets
Sicherheit Am wenigsten sicher Hohe Sicherheit Hohe Sicherheit
Leistung Geringe Leistung Hohe Leistung Mittlere Leistung
Zuverlässigkeit Am wenigsten zuverlässig Hohe Zuverlässigkeit Hohe Zuverlässigkeit
Funktionalität Alle Parameter und Ausgabeeigenschaften verfügbar Eingeschränkte Parameter und Ausgabeeigenschaften verfügbar Alle Parameter und Ausgabeeigenschaften verfügbar

REST-API-Cmdlets haben die gleichen Cmdlet-Namen und funktionieren genau wie ihre PowerShell-Remote-Entsprechungen, sodass Sie cmdlet-Namen oder -Parameter in Skripts nicht aktualisieren müssen.

Tipp

Das Cmdlet Invoke-Command funktioniert nicht in REST-API-Verbindungen. Alternativen finden Sie unter Problemumgehungen für Invoke-Command Szenarien in REST-API-Verbindungen.

Einige Cmdlets in Exchange Online PowerShell werden mit dem experimentellen UseCustomRouting-Switch aktualisiert. Dieser Schalter wird den Befehl direkt an den erforderlichen Postfachserver weiterleiten, und die Gesamtleistung kann verbessert werden. Verwenden Sie den UseCustomRouting-Schalter experimentell.

  • 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
  • Der UseCustomRouting-Schalter ist nur für die folgenden Exchange Online PowerShell-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 das Cmdlet Get-ConnectionInformation, um Informationen zu Verbindungen mit Exchange Online PowerShell und Security & Compliance-PowerShell abzurufen. Dieses Cmdlet ist erforderlich, da das Cmdlet Get-PSSession in Windows PowerShell keine Informationen für REST-API-Verbindungen zurückgibt.

    Szenarien, in denen Sie Get-ConnectionInformation verwenden können, werden in der folgenden Tabelle beschrieben:

    Szenario Erwartete Ausgabe
    Führen Sie nach den Befehlen Connect-ExchangeOnline oder Connect-IPPSSession aus. Gibt ein Verbindungsinformationsobjekt zurück.
    Führen Sie nach mehreren Befehlen Connect-ExchangeOnline oder Connect-IPPSSession aus. Gibt eine Auflistung von Verbindungsinformationsobjekten zurück.
  • Verwenden Sie den Schalter SkipLoadingFormatData im Cmdlet Connect-ExchangeOnline , um das Laden von Formatdaten zu vermeiden und Connect-ExchangeOnline-Befehle schneller auszuführen.

  • Cmdlets, die von der REST-API unterstützt werden, weisen ein Timeout von 15 Minuten auf, das sich auf Massenvorgänge auswirken kann. Für den folgenden Befehl Update-DistributionGroupMember zum Aktualisieren von 10.000 Mitgliedern einer Verteilergruppe kann beispielsweise ein Timeout auftreten:

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

    Verwenden Sie stattdessen den Befehl Update-DistributionGroupMember , um weniger Mitglieder zu aktualisieren, und fügen Sie dann die verbleibenden Mitglieder einzeln mithilfe eines Add-DistributionGroupMember-Befehls hinzu. Zum Beispiel:

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

Weitere Informationen zu den Neuerungen im EXO V3-Modul finden Sie weiter unten in diesem Artikel im Abschnitt Versionshinweise .

Melden von Fehlern und Problemen für Vorschauversionen des Exchange Online PowerShell-Moduls

Tipp

Verwenden Sie für allgemein verfügbare Versionen des Moduls nicht die folgende E-Mail-Adresse, um Probleme zu melden. Meldungen zu allgemein verfügbaren Versionen des Moduls werden nicht beantwortet. Erstellen Sie stattdessen ein Supportticket.

Verwenden Sie exocmdletpreview[at]service[dot]microsoft[dot]comnur für Vorschauversionen des Moduls, um probleme zu melden, die auftreten können. Stellen Sie sicher, dass Sie die Protokolldateien in Ihre E-Mail-Nachricht einschließen. Um die Protokolldateien zu generieren, ersetzen Sie <Path> durch einen Ausgabeordner, und führen Sie dann den folgenden Befehl aus:

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

Cmdlets im Exchange Online PowerShell-Modul

Das EXO-Modul enthält neun exklusive Get-EXO*-Cmdlets, die für die Geschwindigkeit in Massenabrufszenarien (Tausende von Objekten) in Exchange Online PowerShell optimiert sind. Die verbesserten Cmdlets im Modul sind in der folgenden Tabelle aufgeführt:

EXO-Modul-Cmdlet Ä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

Tipp

Wenn Sie mehrere Verbindungen mit Exchange Online PowerShell im selben Fenster öffnen, werden die Get-EXO*-Cmdlets immer der letzten (aktuellen) Exchange Online PowerShell-Verbindung zugeordnet. Führen Sie den folgenden Befehl aus, um die REST-API-Sitzung zu suchen, in der die Get-EXO*- Cmdlets ausgeführt werden: Get-ConnectionInformation | Where-Object {$_.ConnectionUsedForInbuiltCmdlets -eq $true}.

Die verbindungsbezogenen Cmdlets im Modul sind in der folgenden Tabelle aufgeführt:

EXO-Modul-Cmdlet Älteres verwandtes Cmdlet Kommentare
Connect-ExchangeOnline Connect-EXOPSSession in V1 des Moduls
oder
New-PSSession
Connect-IPPSSession Connect-IPPSSession in V1 des Moduls
Disconnect-ExchangeOnline Remove-PSSession
Get-ConnectionInformation Get-PSSession Verfügbar in Version 3.0.0 oder höher.

Tipp

Die häufige Verwendung der Cmdlets Connect-ExchangeOnline und Disconnect-ExchangeOnline in einer einzelnen PowerShell-Sitzung oder einem einzelnen Skript kann zu einem Speicherverlust 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.

Verschiedene Exchange Online Feature-Cmdlets, die sich im Modul befinden, sind in der folgenden Tabelle aufgeführt:

Cmdlet Kommentare
Get-DefaultTenantBriefingConfig Verfügbar in Version 3.2.0 oder höher.
Set-DefaultTenantBriefingConfig Verfügbar in Version 3.2.0 oder höher.
Get-DefaultTenantMyAnalyticsFeatureConfig Verfügbar in Version 3.2.0 oder höher.
Set-DefaultTenantMyAnalyticsFeatureConfig Verfügbar in Version 3.2.0 oder höher.
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 v2.0.5 oder höher.
Set-VivaInsightsSettings Verfügbar in v2.0.5 oder höher.
Get-VivaModuleFeature Verfügbar in Version 3.2.0 oder höher.
Get-VivaModuleFeatureEnablement Verfügbar in Version 3.2.0 oder höher.
Add-VivaModuleFeaturePolicy Verfügbar in Version 3.2.0 oder höher.
Get-VivaModuleFeaturePolicy Verfügbar in Version 3.2.0 oder höher.
Remove-VivaModuleFeaturePolicy Verfügbar in Version 3.2.0 oder höher.
Update-VivaModuleFeaturePolicy Verfügbar in Version 3.2.0 oder höher.
Add-VivaOrgInsightsDelegatedRole Verfügbar in v3.7.0-Preview1 oder höher.
Get-VivaOrgInsightsDelegatedRole Verfügbar in v3.7.0-Preview1 oder höher.
Remove-VivaOrgInsightsDelegatedRole Verfügbar in v3.7.0-Preview1 oder höher.

Installieren und Verwalten des Exchange Online PowerShell-Moduls

Sie laden das Modul aus dem PowerShell-Katalog unter https://www.powershellgallery.com/packages/ExchangeOnlineManagement/herunter.

In den Verfahren in diesem Abschnitt wird erläutert, wie Das Modul installiert, aktualisiert und deinstalliert wird.

Unterstützte Betriebssysteme für das Exchange Online PowerShell-Modul

Das Modul wird offiziell in PowerShell 7 unter Windows, Linux und Apple macOS unterstützt:

  • Modulversionen 3.5.0 (Mai 2024) oder höher erfordern PowerShell 7.4.0 (November 2023) oder höher aufgrund von .NET 8.0-Assemblyabhängigkeiten. In früheren Versionen von PowerShell 7 treten möglicherweise Kompatibilitätsprobleme auf (PowerShell 7.3.6 ist besser kompatibel als 7.3.7).
  • Die Modulversionen 3.0.0 (September 2022) bis 3.4.0 (Oktober 2023) erfordern PowerShell 7.2.0 (November 2021) oder höher aufgrund von .NET 6.0-Assemblyabhängigkeiten in REST-API-Cmdlets und -Verbindungen.
  • Die Unterstützung für das Modul in PowerShell 7 begann mit Version 2.0.4 (Februar 2021) in PowerShell 7.0.3 (Juli 2020).

Weitere Informationen zu PowerShell 7 finden Sie unter Was ist PowerShell?.

Tipp

Alle Versionen des Moduls werden in Windows PowerShell 5.1 unterstützt und kompatibel.

Wie bereits erwähnt, werden in Exchange Online PowerShell und Security & Compliance-PowerShell nur REST-API-Verbindungen unterstützt:

  • Version 2.0.4 des Moduls (Februar 2021) unterstützt die REST-API nur für die neun exklusiven Get-EXO*- Cmdlets.
  • Version 2.0.5 des Moduls (Mai 2021) unterstützt REST-API-Cmdlets teilweise nur in Exchange Online PowerShell.
  • Version 3.0.0 (September 2022) oder höher unterstützt REST-API-Cmdlets in Exchange Online PowerShell vollständig.
  • Version 3.2.0 (Juni 2023) oder höher unterstützt rest-API-Cmdlets in Security & Compliance PowerShell vollständig.

Apple macOS

Hinweis

Derzeit ist Connect-IPPSSession und damit Security & Compliance PowerShell in PowerShell 7 auf macOS-Clients nicht verfügbar.

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

  • macOS 13 Ventura oder höher:

    Modulversion PowerShell-Version
    3.5.0 oder höher 7.4.0 oder höher

    7.4.0 ist die mindestens unterstützte Version von PowerShell 7 in macOS 13 oder höher. Die Modulversionen 3.0.0 bis 3.4.0 werden ebenfalls unterstützt.

  • macOS 12 Monterey und mac OS 11 Big Sur:

    Modulversion PowerShell-Version
    3.5.0 oder höher 7.4.x
    3.0.0 bis 3.4.0 7.2.0 bis 7.3.7 (oder höher)
    2.0.4 und 2.0.5 7.0.3 bis 7.1.5 (oder höher)

    Modulversionen 3.0.0 oder höher werden auf allen Prozessoren unterstützt.

    Die Modulversionen 2.0.4 und 2.0.5 werden nativ auf Intel-Prozessoren ausgeführt. Apple M1- oder Apple M2-Prozessoren erfordern Apple Rosetta 2.

    7.4.x ist die neueste unterstützte Version von PowerShell 7 in macOS 11 und macOS 12.

  • macOS 10.15 Catalina:

    Modulversion PowerShell-Version
    3.0.0 bis 3.4.0 7.2.0 bis 7.2.22
    2.0.4 und 2.0.5 7.0.3 bis 7.1.5 (oder höher)

    7.2.22 ist die neueste unterstützte Version von PowerShell 7 in macOS 10.15.

  • macOS 10.14 Mojave

    Modulversion PowerShell-Version
    2.0.4 und 2.0.5 7.0.3 bis 7.1.5

    7.1.5 ist die neueste unterstützte Version von PowerShell 7 in macOS 10.14.

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

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 können Sie die regulären PowerShell-Voraussetzungen erfüllen und das Exchange Online PowerShell-Modul installieren.

Linux

Hinweis

Derzeit ist Connect-IPPSSession und damit Security & Compliance PowerShell in PowerShell 7 auf Linux-Clients nicht verfügbar.

Wenn Sie über ein Netzwerk hinter einem Proxyserver eine Verbindung mit Exchange Online PowerShell unter Linux herstellen, müssen Sie die Modulversion 3.0.0 oder höher verwenden.

Das Modul wird offiziell in den folgenden Linux-Distributionen unterstützt:

  • Ubuntu 24.04 LTS

    Modulversion PowerShell-Version
    3.5.0 oder höher 7.4.0 oder höher
    3.0.0 bis 3.4.0 7.2.0 bis 7.3.7 (oder höher)
  • Ubuntu 20.04 LTS

    Modulversion PowerShell-Version
    3.5.0 oder höher 7.4.x
    3.0.0 bis 3.4.0 7.2.0 bis 7.3.7 (oder höher)
    2.0.4 und 2.0.5 7.0.3 bis 7.1.5 (oder höher)

    Version 3.7.0 oder höher schlägt möglicherweise mit SSL-Protokollfehlern fehl.

  • Ubuntu 18.04 LTS

    Modulversion PowerShell-Version
    3.5.0 oder höher 7.4.x
    3.0.0 bis 3.4.0 7.2.0 bis 7.3.7 (oder höher)
    2.0.4 und 2.0.5 7.0.3 bis 7.1.5 (oder höher)

    Bei Modulversionen 3.7.0 oder höher kann es zu Zuverlässigkeitsproblemen in Ubuntu 18.04 LTS kommen.

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 können Sie die regulären PowerShell-Voraussetzungen erfüllen und das Exchange Online PowerShell-Modul installieren.

Windows

  • Windows PowerShell 5.1:

    • Alle Versionen des Moduls werden unterstützt.
    • Aktuelle Versionen von Windows enthalten die erforderlichen Versionen der .NET Framework, sodass Sie die .NET Framework nicht installieren müssen, um das Modul in Windows PowerShell 5.1 verwenden zu können.
  • PowerShell 7:

    • Modulversionen 3.5.0 (Mai 2024) oder höher erfordern PowerShell 7.4.0 (November 2023) oder höher aufgrund von .NET 8.0-Assemblyabhängigkeiten. In früheren Versionen von PowerShell 7 können Kompatibilitätsprobleme auftreten (PowerShell 7.3.6 ist mit dem Modul besser kompatibel als 7.3.7).
    • Die Modulversionen 3.0.0 (September 2022) bis 3.4.0 (Oktober 2023) erfordern PowerShell 7.2.0 (November 2021) oder höher aufgrund von .NET 6.0-Assemblyabhängigkeiten in REST-API-Cmdlets und -Verbindungen.
    • Die Unterstützung für das Modul in PowerShell 7 begann mit Version 2.0.4 (Februar 2021) in PowerShell 7.0.3 (Juli 2020).

Die Unterstützung spezifischer Modulversionen in Windows hängt von Windows PowerShell Und .NET Framework- und/oder .NET-Unterstützung ab, wie in der folgenden Liste beschrieben:

  • Windows 11:

    Modulversion PowerShell-Version .NET-Anforderung
    2.0.5 oder höher 5.1 .NET Framework 4.7.2 (4.8.x ist enthalten, sodass Sie die .NET Framework nicht installieren müssen)
    3.5.0 oder höher 7.4.0 oder höher .NET 8.0
    Enthalten in 24H2 oder höher.
    3.0.0 bis 3.4.0 7.2.0 bis 7.3.7 (oder höher) .NET 6.0 (7.2.x)
    .NET 7.0 (7.3.x)

    7.2.0 (.NET 6.0) ist die früheste unterstützte Version von PowerShell 7 in Windows 11.

  • Windows Server 2022:

    Modulversion PowerShell-Version .NET-Anforderung
    2.0.5 oder höher 5.1 .NET Framework 4.7.2 (4.8 ist enthalten, sodass Sie die .NET Framework nicht installieren müssen)
    3.5.0 oder höher 7.4.0 oder höher .NET 8.0
    3.0.0 bis 3.4.0 7.2.0 bis 7.3.7 (oder höher) .NET 6.0 (7.2.x)
    .NET 7.0 (7.3.x)

    7.2.0 (.NET 6.0) ist die früheste unterstützte Version von PowerShell 7 in Windows Server 2022.

  • Windows 10:

    Modulversion PowerShell-Version Unterstützte Windows-Version .NET-Anforderung
    2.0.5 oder höher 5.1 Anniversary Update (Version 1607; August 2016) oder höher .NET Framework 4.7.2
    April 2018 Update (Version 1803) oder höher enthält die .NET Framework 4.7.2, sodass Sie es nicht herunterladen müssen.
    3.5.0 oder höher 7.4.0 oder höher Update oktober 2018 (Version 1809) oder höher .NET 8.0
    3.0.0 bis 3.4.0 7.2.0 bis 7.3.7 (oder höher) Update oktober 2018 (Version 1809) oder höher .NET 6.0 (7.2.x)
    .NET 7.0 (7.3.x)
    2.0.4 und 2.0.5 7.0.3 bis 7.1.5 (oder höher) Anniversary Update (Version 1607; August 2016) oder höher .NET Core 3.1 (7.0.x)
    .NET 5.0 (7.1.x)
  • Windows Server 2016 und Windows Server 2019:

    Modulversion PowerShell-Version .NET-Anforderung
    2.0.5 oder höher 5.1 .NET Framework 4.7.2
    Im Windows Server 2019 enthalten.
    3.5.0 oder höher 7.4.0 oder höher .NET 8.0
    3.0.0 bis 3.4.0 7.2.0 bis 7.3.7 (oder höher) .NET 6.0 (7.2.x)
    .NET 7.0 (7.3.x)
    2.0.4 und 2.0.5 7.0.3 bis 7.1.5 (oder höher) .NET Core 3.1 (7.0.x)
    .NET 5.0 (7.1.x)
  • Windows 8.1, Windows Server 2012 und Windows Server 2012 R2:

    Modulversion PowerShell-Version .NET-Anforderung
    2.0.5 oder höher 5.1 .NET Framework 4.7.2
    3.0.0 bis 3.4.0 7.2.x .NET 6.0
    2.0.4 und 2.0.5 7.0.3 bis 7.1.5 (oder höher) .NET Core 3.1 (7.0.x)
    .NET 5.0 (7.1.x)

    7.2.22 (.NET 6.0) ist die neueste unterstützte Version von PowerShell 7 in Windows 8.1, Windows Server 2012 und Windows Server 2012 R2.

  • Windows 7.1 SP1 und Windows Server 2008 R2 SP1:

    Modulversion PowerShell-Version .NET-Anforderung
    2.0.3 5.1 .NET Framework 4.7.1

    Hinweis

    Obwohl Sie diese Version des Moduls installieren können, können Sie keine Verbindung mit Exchange Online PowerShell herstellen. In Modulversion 2.0.3 wird keine Unterstützung für REST-API-Verbindungen unterstützt.

Voraussetzungen für das Exchange Online PowerShell-Modul

Legen Sie die PowerShell-Ausführungsrichtlinie auf RemoteSigned fest.

Tipp

Die Einstellungen in diesem Abschnitt gelten für alle Versionen von PowerShell auf allen Betriebssystemen.

PowerShell muss zum Ausführen von Skripts konfiguriert werden. Standardmäßig ist dies nicht der Fall. Wenn Sie versuchen, eine Verbindung herzustellen, wird die folgende Fehlermeldung 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 die Signierung eines vertrauenswürdigen Herausgebers für alle aus dem Internet heruntergeladenen PowerShell-Skripts zu erfordern, führen Sie den folgenden Befehl in einem PowerShell-Fenster mit erhöhten Rechten aus (ein PowerShell-Fenster, das Sie öffnen, indem Sie Als Administrator ausführen auswählen):

Set-ExecutionPolicy RemoteSigned

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

Standardauthentifizierung in WinRM

Ab Oktober 2023 ersetzten REST-API-Verbindungen Standardauthentifizierungsverbindungen (Remote-PowerShell) in Exchange Online PowerShell und Security & Compliance PowerShell. REST-API-Verbindungen erfordern keine Standardauthentifizierung in WinRM.

Version 3.2.0 (Juni 2023) und höhere Version des Moduls unterstützen REST-API-Cmdlets in Exchange Online PowerShell und Security & Compliance PowerShell vollständig.

PowerShellGet in Windows erforderlich

REST-API-Verbindungen in Windows erfordern das PowerShellGet-Modul. Nach Abhängigkeit erfordert das PowerShellGet-Modul das PackageManagement-Modul. Diese Module sind mehr für PowerShell 5.1 als für PowerShell 7 zu berücksichtigen, aber alle Versionen von PowerShell profitieren von der Installation der neuesten Versionen der Module. Installations- und Updateanweisungen finden Sie unter Installieren von PowerShellGet unter Windows.

Tipp

Vorschauversionen des PackageManagement- oder PowerShellGet-Moduls können Verbindungsprobleme verursachen. Wenn Verbindungsprobleme auftreten, vergewissern Sie sich, dass keine Vorschauversionen der Module installiert sind, indem Sie den folgenden Befehl ausführen: Get-InstalledModule PackageManagement -AllVersions; Get-InstalledModule PowerShellGet -AllVersions.

Wenn PowerShellGet nicht installiert ist, wenn Sie versuchen, eine Verbindung herzustellen, erhalten Sie die folgende Fehlermeldung:

Cmdlet Update-Manifest nicht gefunden

Installieren des Exchange Online PowerShell-Moduls

Führen Sie die folgenden Schritte aus, um das 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 fenster Windows PowerShell, und öffnen Sie es erneut.

  3. Jetzt können Sie das Cmdlet Install-Module verwenden, um das Modul aus dem PowerShell-Katalog zu installieren. In der Regel möchten Sie die neueste öffentliche Version des Moduls, aber Sie können auch eine Vorschauversion installieren, die neuer als die aktuelle Version ist.

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

      • 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
        
    • Führen Sie den folgenden Befehl aus, um die verfügbaren Vorschauversionen des Moduls anzuzeigen:

      Find-Module ExchangeOnlineManagement -AllVersions -AllowPrerelease
      
    • Führen Sie einen der folgenden Befehle aus, um die neueste verfügbare Vorschauversion des Moduls zu installieren:

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

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

        Install-Module -Name ExchangeOnlineManagement -Scope CurrentUser -AllowPrerelease
        
    • Um eine bestimmte 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 Exchange Online PowerShell-Moduls

Wenn das Modul bereits auf Ihrem Computer installiert ist, können Sie die Verfahren in diesem Abschnitt verwenden, um das Modul zu aktualisieren.

  1. Führen Sie den folgenden Befehl aus, um die Version des moduls anzuzeigen, das derzeit installiert ist und wo es installiert ist:

    Get-InstalledModule ExchangeOnlineManagement | Format-List Name,Version,InstalledLocation
    

    Wenn das Modul unter C:\Programme\WindowsPowerShell\Modules installiert ist, wird es für alle Benutzer installiert. Wenn das Modul im Ordner Dokumente installiert ist, wird es nur für das aktuelle Benutzerkonto installiert.

  2. Sie können das Cmdlet Update-Module verwenden, um das Modul aus dem PowerShell-Katalog zu aktualisieren. In der Regel möchten Sie die neueste öffentliche Version des Moduls, aber Sie können auch ein Upgrade auf eine Vorschauversion durchführen, falls diese verfügbar ist.

    • Um ein Upgrade auf die neueste öffentliche Version des Moduls durchzuführen, führen Sie einen der folgenden Befehle aus, je nachdem, wie Sie das Modul ursprünglich installiert haben (alle Benutzer und nur für das aktuelle Benutzerkonto):

      • 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 des Moduls anzuzeigen:

        Find-Module ExchangeOnlineManagement -AllVersions -AllowPrerelease
        
      • Führen Sie einen der folgenden Befehle aus, um ein Upgrade auf die neueste verfügbare Vorschauversion des Moduls durchzuführen:

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

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

          Update-Module -Name ExchangeOnlineManagement -Scope CurrentUser -AllowPrerelease
          
      • Um auf eine bestimmte Vorschauversion des Moduls zu aktualisieren, 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):

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

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

    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 Exchange Online PowerShell-Moduls

  • Sie erhalten einen der folgenden Fehler:

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

    WARNUNG: Vom URI kann nicht heruntergeladen werden.https://go.microsoft.com/fwlink/?LinkID=627338& clcid=0x409" bis "".

    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 versuchen, das ExchangeOnlineManagement-Modul erneut zu aktualisieren.

  • 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 Standardrepository für PowerShell-Module ist nicht auf PSGallery festgelegt. Führen Sie den folgenden Befehl aus, um diesen Fehler zu beheben:

    Register-PSRepository -Default
    
  • 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.

Deinstallieren des Exchange Online PowerShell-Moduls

Führen Sie den folgenden Befehl aus, um die Version des moduls anzuzeigen, das derzeit installiert ist und wo es installiert ist:

Get-InstalledModule ExchangeOnlineManagement | Format-List Name,Version,InstalledLocation

Wenn das Modul unter C:\Programme\WindowsPowerShell\Modules installiert ist, wurde es für alle Benutzer installiert. Wenn das Modul im Ordner Dokumente installiert ist, wurde es nur für das aktuelle Benutzerkonto installiert.

Führen Sie zum Deinstallieren des Moduls den folgenden Befehl in einer der folgenden Umgebungen aus, je nachdem, wie Sie das Modul ursprünglich installiert haben (alle Benutzer und nur für das aktuelle Benutzerkonto):

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

  • In einem normalen PowerShell-Fenster (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 Exchange Online PowerShell-Modul

Herkömmliche Exchange Online Cmdlets geben alle möglichen Objekteigenschaften zurück, einschließlich vieler leerer oder uninteressanter Eigenschaften. 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.

Die Get-EXO*- Cmdlets im Modul enthalten kategorisierte Ausgabeeigenschaften. Anstatt allen Eigenschaften die gleiche Wichtigkeit zuzuweisen und sie in allen Szenarien zurückzugeben, haben wir bestimmte verwandte Eigenschaften in Eigenschaftensätze kategorisiert. Diese Eigenschaftensätze sind Buckets mit mindestens zwei verwandten Eigenschaften für das Cmdlet.

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

In diesen Cmdlets steuern die folgenden Parameter Eigenschaftensätze:

  • PropertySets: Dieser Parameter akzeptiert einen oder mehrere verfügbare, durch Kommas getrennte Eigenschaftensatznamen. Die verfügbaren Eigenschaftensätze werden unter Eigenschaftensätze in Exchange Online PowerShell-Modul-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.

Wir haben auch einen Minimum-Eigenschaftssatz eingeschlossen, der einen minimalen Satz erforderlicher Eigenschaften für die Cmdlet-Ausgabe enthält (z. B. Identitätseigenschaften). Die Eigenschaften in den Minimum-Eigenschaftssätzen werden auch unter Eigenschaftensätze in Exchange Online PowerShell-Modul-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 Richtungen enthält die Cmdlet-Ausgabe weit weniger Eigenschaften, und die Ergebnisse werden viel schneller zurückgegeben.

Nachdem Sie beispielsweise eine Verbindung mit Exchange Online PowerShell hergestellt haben, gibt das folgende Beispiel nur die Eigenschaften im Minimum-Eigenschaftssatz für die ersten 10 Postfächer zurück.

Get-EXOMailbox -ResultSize 10

Im Gegensatz dazu würde die Ausgabe desselben Get-Mailbox-Befehls mindestens 230 Eigenschaften für jedes der ersten 10 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 Modul finden Sie unter Filter im Exchange Online PowerShell-Modul.

Versionshinweise

Sofern nicht anders angegeben, enthält die aktuelle Version des Exchange Online PowerShell-Moduls alle Features früherer Versionen.

Aktuelles Release

Version 3.9.0

  • Neuer EnableSearchOnlySession-Switch für Connect-IPPSSession, der bestimmte eDiscovery-Cmdlets und zugehörige Cmdlets aktiviert, die eine Verbindung mit anderen Microsoft 365-Diensten herstellen.

Frühere Releases

Version 3.8.0

  • Neuer AccessToken-Parameter für Connect-IPPSSession.

  • Get-VivaModuleFeature gibt jetzt Informationen zu ParentFeature, ChildFeature und PolicyModes zurück. Diese Werte stellen die über- und untergeordneten Features eines Viva-App-Features sowie die verfügbaren Aktivierungsmodi für zukünftige Richtlinien dar.

  • Neue Parameter IsUser OptInByDefault für die Cmdlets Add-VivaModuleFeaturePolicy und Update-VivaModuleFeaturePolicy und den entsprechenden Eigenschaftswert in allen *-VivaModuleFeaturePolicy-Cmdlets . Der Wert gibt an, ob Benutzer von der Richtlinie abgemeldet oder deaktiviert werden, solange der Benutzer keine Einstellung festgelegt hat.

    Sie können diesen Parameter verwenden, um das Feature in Ihrem organization aktiviert zu lassen, während sie die betroffenen Benutzer standardmäßig deaktivieren und das Feature für diese Benutzer effektiv weich deaktivieren.

  • Das Cmdlet Get-VivaFeatureCategory , alle kategoriebezogenen Parameter und Rückgabewerte (CategoryId, IsCategoryEnabled) wurden als veraltet gekennzeichnet.

Version 3.7.2

  • Der DisableWAM-Schalter ist im Cmdlet Connect-ExchangeOnline verfügbar, um web Account Manager (WAM) zu deaktivieren, wenn Wam-bezogene Verbindungsfehler auftreten.

Version 3.7.1

  • Der Ausgabe von Get-EXOMailbox wurde eine neue Eigenschaft mit dem Namen ExoExchangeSecurityDescriptor hinzugefügt, die der ExchangeSecurityDescriptor -Eigenschaft in der Ausgabe von Get-Mailbox ähnelt.
  • Neue Cmdlets zur Unterstützung des features "Viva Org Insights Delegation" wurden hinzugefügt:
    • Add-VivaOrgInsightsDelegatedRole
    • Get-VivaOrgInsightsDelegatedRole
    • Remove-VivaOrgInsightsDelegatedRole

Version 3.7.0

  • Integrierter Web Account Manager (WAM) in Authentifizierungsflüssen, um die Sicherheit zu erhöhen.
  • Die Befehlszeilenhilfe für Exchange Online PowerShell-Cmdlets wird standardmäßig nicht mehr geladen. Verwenden Sie den Schalter LoadCmdletHelp im Befehl Connect-ExchangeOnline, damit Hilfe für Exchange Online PowerShell-Cmdlets für das Cmdlet Get-Help verfügbar ist.
  • Es wurden Verbindungsprobleme mit der reinen App-Authentifizierung in Security & Compliance PowerShell behoben.

Version 3.6.0

  • Get-VivaModuleFeature gibt jetzt Informationen zu den Arten von Identitäten zurück, für die das Feature die Erstellung von Richtlinien unterstützt (z. B. Benutzer, Gruppen oder die gesamte organization).
  • Cmdlets für Viva Featurezugriffsverwaltung bewältigen jetzt Herausforderungen bei der fortlaufenden Zugriffsauswertung (Continuous Access Evaluation, CAE).
  • Korrektur für Kompatibilitätsproblem mit dem Microsoft.Graph-Modul hinzugefügt.

Version 3.5.1

  • Fehlerbehebungen in Get-EXOMailboxPermission und Get-EXOMailbox.
  • Das Modul wird für die Ausführung unter .NET 8 aktualisiert, wobei die vorherige Version basierend auf .NET 6 ersetzt wird.
  • Verbesserungen in Add-VivaModuleFeaturePolicy.

Version 3.5.0

  • Neues Cmdlet Get-VivaFeatureCategory .
  • Unterstützung für Richtlinienvorgänge auf Kategorieebene in Viva Featurezugriffsverwaltung (VFAM) hinzugefügt.
  • Neue IsFeatureEnabledByDefault-Eigenschaft in der Ausgabe von Get-VivaModuleFeaturePolicy. Der Wert dieser Eigenschaft zeigt den Standardaktivierungsstatus für Benutzer an, wenn keine organization- oder Benutzer-/Gruppenrichtlinien erstellt wurden.

Version 3.4.0

  • Fehlerbehebungen in Connect-ExchangeOnline, Get-EXORecipientPermission und Get-EXOMailboxFolderPermission.
  • Der Parameter SigningCertificate in Connect-ExchangeOnline unterstützt jetzt den eingeschränkten Sprachmodus (CLM).

Version 3.3.0

  • SkipLoadingCmdletHelp-Parameter in Connect-ExchangeOnline , um das Überspringen des Ladens von Cmdlet-Hilfedateien zu unterstützen.
  • Die globale Variable EXO_LastExecutionStatus ist verfügbar, um die status des zuletzt ausgeführten Cmdlets zu überprüfen.
  • Fehlerbehebungen in Connect-ExchangeOnline und Connect-IPPSSession.
  • IsUserControlEnabled-Parameter für Add-VivaModuleFeaturePolicy und Update-VivaModuleFeaturePolicy zur Unterstützung der Aktivierung von Benutzersteuerelementen per Richtlinie für Features, die in Viva Featurezugriffsverwaltung integriert sind.

Version 3.2.0

  • Neue Cmdlets:
    • Get-DefaultTenantBriefingConfig und Set-DefaultTenantBriefingConfig.
    • Get-DefaultTenantMyAnalyticsFeatureConfig und Set-DefaultTenantMyAnalyticsFeatureConfig.
    • Get-VivaModuleFeature, Get-VivaModuleFeatureEnablement, Add-VivaModuleFeaturePolicy, Get-VivaModuleFeaturePolicy, Remove-VivaModuleFeaturePolicy und Update-VivaModuleFeaturePolicy.
  • REST-API-Verbindungsunterstützung für Security & Compliance PowerShell.
  • ConnectionId-Parameter für Get-ConnectionInformation und Disconnect-ExchangeOnline:
    • Ruft Verbindungsinformationen für bestimmte REST-API-Verbindungen ab.
    • Selektive Trennung für REST-API-Verbindungen.
  • Mit dem Parameter "SigningCertificate" auf Connect-ExchangeOnline können Sie die Formatdateien (* signieren. Format.ps1xml) oder Skriptmoduldateien (.psm1) im temporären Modul, das Connect-ExchangeOnline mit einem Clientzertifikat erstellt, das in allen PowerShell-Ausführungsrichtlinien verwendet werden kann.
  • Fehlerbehebungen in Connect-ExchangeOnline.

Version 3.1.0

  • AccessToken-Parameter in Connect-ExchangeOnline verfügbar.
  • Fehlerbehebungen in Connect-ExchangeOnline und Get-ConnectionInformation.
  • Fehlerbehebung in Connect-IPPSSession für das Herstellen einer Verbindung mit Security & Compliance PowerShell mithilfe von CertificateThumbprint.

Version 3.0.0 (Vorschauversionen, bekannt als v2.0.6-PreviewX)

  • Features, die bereits in den REST-API-Verbindungen im Abschnitt EXO V3-Modul beschrieben sind:
    • Zertifikatbasierte Authentifizierung für Security & Compliance PowerShell (Version 2.0.6-Preview5 oder höher).
    • Das Cmdlet Get-ConnectionInformation für REST-basierte Verbindungen (Version 2.0.6-Preview7 oder höher).
    • Der SkipLoadingFormatData-Schalter im Cmdlet Connect-ExchangeOnline für REST-basierte Verbindungen (Version 2.0.6-Preview8 oder höher).
  • Der Parameter DelegatedOrganization funktioniert im Cmdlet Connect-IPPSSession , solange Sie auch den Parameter AzureADAuthorizationEndpointUri im Befehl verwenden.
  • Bestimmte Cmdlets, die in bestimmten Szenarien zur Bestätigung aufgefordert wurden, tun dies nicht mehr. Standardmäßig wird das Cmdlet bis zum Abschluss ausgeführt.
  • Das Format des Fehlers, der bei der fehlgeschlagenen Cmdletausführung zurückgegeben wird, wurde geringfügig geändert. Die Ausnahme enthält jetzt mehr Daten (z. B. den Ausnahmetyp), und der FullyQualifiedErrorId enthält FailureCategorynicht . Das Format des Fehlers kann noch geändert werden.

Version 2.0.5

  • Neue Cmdlets Get-OwnerlessGroupPolicy und Set-OwnerlessGroupPolicy zum Verwalten von besitzerlosen Microsoft 365-Gruppen.

    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 zum Steuern des Benutzerzugriffs auf Headspace-Features in Viva Insights.

Version 2.0.4

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

  • Das Modul in PowerShell 7 unterstützt browserbasiertes einmaliges Anmelden (Single Sign-On, SSO) und andere Anmeldemethoden. Weitere Informationen finden Sie unter Exklusive Verbindungsmethoden für PowerShell 7.

  • Die Cmdlets Get-UserAnalyticsConfig und Set-UserAnalyticsConfig wurden durch Get-MyAnalyticsConfig und Set-MyAnalyticsConfig ersetzt. Darüber hinaus können Sie den Zugriff auf Featureebene konfigurieren. Weitere Informationen finden Sie unter Konfigurieren von MyAnalytics.

  • Richtlinien- und Sicherheitsdurchsetzung in Echtzeit bei allen benutzerbasierten Authentifizierungen. Die fortlaufende Zugriffsevaluierung (Continuous Access Evaluation, CAE) ist im 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), die die Verwendung von moderner Authentifizierung bei unbeaufsichtigten Skripting- oder Hintergrundautomatisierungsszenarios ermöglicht. Die verfügbaren Zertifikatspeicherorte sind:
  • 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. Die Labergebnisse zeigen, dass sich die Latenz des ersten Anrufs von 8 Sekunden auf ungefähr 1 Sekunde verringert hat. Die tatsächlichen Ergebnisse hängen von der Größe des Cmdlet-Ergebnisses und der organization Umgebung ab.

Version 1.0.1

  • GA-Version (allgemeine Verfügbarkeit) des EXO PowerShell V2-Moduls. Es ist stabil und bereit für den Einsatz in Produktionsumgebungen.
  • Das Cmdlet Get-EXOMobileDeviceStatistics unterstützt nun den Parameter Identity.
  • Verbesserte Zuverlässigkeit für die automatische Wiederherstellung von Sitzungen in bestimmten Szenarien, in denen ein Skript ~50 Minuten lang ausgeführt wurde und aufgrund eines Fehlers in der Logik für die automatische Wiederherstellung der Verbindung den Fehler "Cmdlet nicht gefunden" ausgelöst hat.
  • 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 im Exchange Online PowerShell-Modul auf Attribute, die in Filtern nicht unterstützt werden.

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. Zum Beispiel: Get-MailboxFolderPermission -Identity <UPN>:<Folder-Path>Get-MailboxFolderPermission -Identity <UPN>:\<Folder-Id>
  • Verbesserte Zuverlässigkeit von Get-EXOMailboxStatistics , da bestimmte Anforderungsroutingfehler, die zu Fehlern geführt haben, behoben werden.
  • Optimierte Speicherauslastung für neue Sitzungen, die aus der Wiederverwendung vorhandener Module erstellt wurden, anstatt 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 verschiedene komplexe Datentypen, die in EXO-Cmdlets absichtlich nicht unterstützt wurden, um die Leistung zu verbessern. Unterschiede bei nicht komplexen Datentypen zwischen PowerShell-Remote-Cmdlets und V2-Cmdlets werden aufgelöst, um eine nahtlose Migration von Verwaltungsskripts zu ermöglichen.

Version 0.3582.0

  • Unterstützung für Präfixe während der Sitzungserstellung:
    • Sie können jeweils nur eine Sitzung erstellen, die Cmdlets mit Präfix enthält.
    • EXO V2-Cmdlets haben kein Präfix, da sie bereits über das Präfix EXO verfügen. Verwenden Sie EXO daher nicht als Präfix.
  • Verwenden Sie EXO V2-Cmdlets, auch wenn die WinRM-Standardauthentifizierung auf dem Clientcomputer deaktiviert ist. Remote-PowerShell-Verbindungen erfordern WinRM Basic-Authentifizierung, und PowerShell-Remote-Cmdlets sind nicht verfügbar, wenn die Standardauthentifizierung in WinRM deaktiviert ist.
  • Der Identitätsparameter für V2-Cmdlets unterstützt jetzt Name und Alias. Die Verwendung von Alias oder Name verlangsamt die Leistung von V2-Cmdlets, daher wird davon abgeraten, 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. Wir verfügen immer noch über wenige Attribute mit unterschiedlichen Datentypen, und wir planen, diese in den kommenden Monaten zu verarbeiten.
  • Fehler behoben: Häufiges Verbindungsproblem bei sitzungen, wenn Connect-ExchangeOnline mit Anmeldeinformationen 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 Zustand Geöffnet 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 Online-Parameter zu einer nicht vorhandenen Seite mit dem Fehlercode 400 umgeleitet wurde.

Version 0.3527.3

  • Unterstützung für die Verwaltung von Exchange für eine andere organization mithilfe des Delegierungsflusses hinzugefügt.
  • Funktioniert zusammen mit anderen PowerShell-Modulen in einem einzelnen PowerShell-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%).
  • Fehlerbehebung: Remote-PowerShell-Cmdlets treten aufgrund des Zeitunterschieds zwischen Tokenablauf und Sitzungsablauf im Leerlauf zeitweilig fehl.
  • Größeres Sicherheitsupdate.
  • Bugfixes und Verbesserungen.