Installieren des Exchange Online PowerShell-Moduls (Schritt für Schritt)

Von Mirko Peters · 2026-11-12

Installieren Sie das Exchange Online PowerShell-Modul mit Install-Module ExchangeOnlineManagement: Voraussetzungen, Bereich, Versionsprüfung, Updates und Fehlerbehebung.

Automatisch mit KI aus dem Originalbeitrag übersetzt. Englisches Original lesen

Um das Exchange Online PowerShell-Modul zu installieren, öffnen Sie PowerShell als Administrator und führen Install-Module -Name ExchangeOnlineManagement aus. Damit wird das Modul für alle Benutzer auf dem Computer installiert. Können Sie den Befehl nicht als Administrator ausführen, ergänzen Sie -Scope CurrentUser. Dann wird das Modul nur für Ihr eigenes Konto installiert. Dieser Artikel richtet sich an Exchange- und Microsoft 365-Administratoren, die einen neuen Admin-PC, einen Jump-Server oder einen Build-Agenten einrichten. Er behandelt die Voraussetzungen, die Schritte zur Installation und Überprüfung, das Aktualisieren und Entfernen des Moduls sowie die Fehler, auf die Sie am häufigsten stoßen.

Das Wichtigste in Kürze

• Installieren Sie das Exchange Online PowerShell-Modul mit Install-Module -Name ExchangeOnlineManagement in einem als Administrator gestarteten PowerShell-Fenster für alle Benutzer.
• Verwenden Sie -Scope CurrentUser, wenn Sie keine Administratorrechte nutzen können. Aktualisieren Sie das Modul später mit demselben Bereich, mit dem Sie es installiert haben.
• Windows PowerShell 5.1 benötigt .NET Framework 4.7.2. Die Unterstützung für PowerShell 7 hängt von der Modulversion ab: Ab Version 3.10.0 benötigen Sie PowerShell 7.6.0 oder höher.
• Überprüfen Sie das Ergebnis mit Get-InstalledModule. Der Befehl zeigt die Version an und ob das Modul im Speicherort für alle Benutzer oder im Speicherort des aktuellen Benutzers liegt.
• Das Modul benötigt in WinRM keine Basisauthentifizierung mehr, weil seine Verbindungen REST verwenden.

Was das Modul ist und was Sie vorher benötigen

Das Modul heißt ExchangeOnlineManagement. In der Microsoft-Dokumentation wird es als Exchange Online PowerShell V3-Modul bezeichnet. Es verbindet Sie mit Exchange Online PowerShell, mit Security & Compliance PowerShell und mit PowerShell für das integrierte Sicherheits-Add-on für lokale Postfächer. Es verwendet moderne Authentifizierung und funktioniert daher mit oder ohne Multifaktor-Authentifizierung.

Eine Änderung betrifft ältere Skripts. Laut Microsoft ersetzen seit Oktober 2023 REST-API-Verbindungen die alten Remote-PowerShell-Verbindungen mit Basisauthentifizierung. Die Verbindungen des Moduls benötigen keine Basisauthentifizierung in WinRM, daher müssen Sie dort nichts aktivieren.

Prüfen Sie vor der Installation diese Voraussetzungen:

• PowerShell-Version und .NET. Windows PowerShell 5.1 benötigt .NET Framework 4.7.2. Windows 11, Windows Server 2022 und Windows Server 2025 werden mit 4.8.x ausgeliefert, dort ist die Voraussetzung also bereits erfüllt. PowerShell 7 funktioniert ebenfalls. Die minimal erforderliche Version hängt von der Modulversion ab, wie der nächste Abschnitt erklärt.
• Ausführungsrichtlinie. Laut Microsoft-Seite erhalten Sie ohne passende Ausführungsrichtlinie die Fehlermeldung „Files cannot be loaded because running scripts is disabled on this system“. Die dokumentierte Lösung ist Set-ExecutionPolicy RemoteSigned, als Administrator ausgeführt. Lesen Sie die Microsoft-Seite zu Ausführungsrichtlinien, bevor Sie etwas ändern, und fragen Sie bei verwalteten Geräten zuerst Ihr Sicherheitsteam.
• PowerShellGet und PackageManagement. REST-Verbindungen unter Windows setzen PowerShellGet voraus, und PowerShellGet hängt von PackageManagement ab. Ohne diese Module kann ein Fehler auftreten, der auf ein fehlendes Cmdlet Update-ModuleManifest hinweist. Microsoft weist außerdem darauf hin, dass Vorabversionen dieser beiden Module Verbindungsprobleme verursachen können. Mit folgendem Befehl listen Sie die installierten Versionen auf: Get-InstalledModule PackageManagement -AllVersions; Get-InstalledModule PowerShellGet -AllVersions.
• TLS 1.2. Unter Windows PowerShell 5.1 auf einem älteren Windows setzt die PowerShell Gallery TLS 1.2 oder höher voraus. Schlägt der Download auf einem alten Server mit einem Verbindungsfehler fehl, sollten Sie das als Erstes prüfen.

Ein sehr altes System führt nicht weiter. Windows 7 SP1 und Windows Server 2008 R2 SP1 erhalten nur Modulversion 2.0.3. Microsoft erklärt, dass diese Version keine Verbindung herstellen kann, weil ihr die REST-Unterstützung fehlt.

Welche PowerShell-Version zu welcher Modulversion passt

Windows PowerShell 5.1 funktioniert mit allen Modulversionen, sofern die oben genannte .NET-Anforderung erfüllt ist. Für PowerShell 7 nennt Microsoft folgende Zuordnung:

• Modul 3.10.0 oder neuer benötigt PowerShell 7.6.0 oder neuer, die .NET 10 verwendet.
• Module 3.5.0 bis 3.9.2 benötigen PowerShell 7.4.0 oder neuer, die .NET 8 verwendet.
• Module 3.0.0 bis 3.4.0 benötigen PowerShell 7.2.0 oder neuer, die .NET 6 verwendet.
• Modul 2.0.4 und neuere Versionen der 2.x-Reihe benötigen PowerShell 7.0.3.

Wenn Sie das neueste Modul auf einem Rechner mit PowerShell 7.4 installiert haben, sollten Sie also mit Problemen rechnen. Aktualisieren Sie entweder PowerShell, oder installieren Sie eine ältere Modulversion mit -RequiredVersion. Zum Zeitpunkt der Erstellung dieses Artikels führt Microsoft 3.10.1 als aktuelle Version auf. Prüfen Sie die Modulseite, um die Nummer zu finden, die zum Zeitpunkt Ihres Lesens gilt.

Microsoft unterstützt das Modul außerdem unter Linux und macOS. Unter Linux benötigt die Verbindung über einen Proxy Modulversion 3.0.0 oder neuer. Auf beiden Systemen ist Connect-IPPSSession und damit Security & Compliance PowerShell in PowerShell 7 nicht verfügbar. Wenn Sie Exchange Online von einem Mac aus verwalten, ist das die einzige Einschränkung, die Sie bei der Planung Ihrer Werkzeuge kennen sollten.

Windows 10 verdient einen kurzen Hinweis. Die Consumer-Editionen haben das Ende des Supports im Oktober 2025 erreicht, und Microsoft gibt an, dass sie .NET 8.0 und .NET 10.0 nicht unterstützen. Für Modul 3.5.0 und neuer mit PowerShell 7.4 oder neuer funktionieren nur noch die Enterprise- und IoT-LTSC-Editionen, die weiterhin unterstützt werden.

Prüfen Sie Ihre PowerShell-Version, bevor Sie installieren

Eine Prüfung von zwei Minuten erspart später viel Raterei. Führen Sie in dem Fenster, in dem Sie arbeiten möchten, $PSVersionTable.PSVersion aus, um zu sehen, welche PowerShell-Version Sie verwenden. Vergleichen Sie das Ergebnis mit der oben stehenden Zuordnung. Unter Windows PowerShell 5.1 sollten Sie außerdem die PowerShellGet-Version kennen, führen Sie dafür Get-InstalledModule PowerShellGet -AllVersions aus. Zeigt der Befehl eine Vorabversion an, entfernen Sie sie oder aktualisieren Sie auf eine stabile Version, bevor Sie fortfahren. Die Modulseite von Microsoft nennt Vorabversionen von PowerShellGet und PackageManagement als Ursache für Verbindungsprobleme.

Notieren Sie das Ergebnis neben dem Rechnernamen, wenn Sie mehr als eine Handvoll Server verwalten. Meldet ein Kollege drei Monate später einen fehlgeschlagenen Verbindungsaufbau, können Sie die Versionen in Sekunden vergleichen.

Schritt für Schritt: Installation des Exchange Online PowerShell-Moduls

Diese Schritte funktionieren in Windows PowerShell 5.1 und in PowerShell 7.

1. Öffnen Sie PowerShell. Wählen Sie Als Administrator ausführen, wenn Sie für alle Benutzer installieren möchten. Verzichten Sie darauf, wenn Sie nur für den aktuellen Benutzer installieren möchten.
2. Wenn dies das erste Modul ist, das Sie auf dem Rechner installieren, aktualisieren Sie zuerst PowerShellGet, und schließen und öffnen Sie anschließend PowerShell erneut. Microsoft empfiehlt diese Reihenfolge vor der ersten Installation.
3. Führen Sie Install-Module -Name ExchangeOnlineManagement aus, um für alle Benutzer zu installieren. Für Ihr eigenes Konto allein führen Sie Install-Module -Name ExchangeOnlineManagement -Scope CurrentUser aus.
4. Beantworten Sie alle Abfragen, die PowerShell während der Installation anzeigt. Ihre Organisation muss den Zugriff auf die PowerShell Gallery erlauben, damit der Download funktioniert.
5. Prüfen Sie die Installation mit Get-InstalledModule ExchangeOnlineManagement | Format-List Name,Version,InstalledLocation.
6. Achten Sie auf die Zeile InstalledLocation. Ein Pfad unter %ProgramFiles%\WindowsPowerShell\Modules\ bedeutet, dass das Modul für alle Benutzer installiert ist. Ein Pfad in Ihrem Ordner „Dokumente“ bedeutet, dass es nur für den aktuellen Benutzer installiert ist.
7. Testen Sie es in einem neuen Fenster mit Connect-ExchangeOnline -UserPrincipalName admin@contoso.com. Die Verbindungsdetails finden Sie im Artikel Connect to Exchange Online PowerShell.

Möchten Sie eine Vorabversion verwenden? Fügen Sie -AllowPrerelease hinzu. Um eine bestimmte Vorabversion zu wählen, kombinieren Sie den Parameter mit -RequiredVersion. Find-Module ExchangeOnlineManagement -AllVersions -AllowPrerelease listet die verfügbaren Versionen auf. Lassen Sie -AllowPrerelease weg, werden nur die öffentlichen Versionen angezeigt. Installieren Sie eine Vorabversion nicht auf einem produktiven Admin-Server, außer Sie haben einen guten Grund dafür. Testen Sie sie zuerst auf einem Ersatzrechner.

Modul aktualisieren und deinstallieren

Microsoft veröffentlicht regelmäßig neue Modulversionen, und die Versionshinweise auf der Modulseite zeigen, was sich geändert hat. Version 3.7.0 hat beispielsweise das standardmäßige Laden der Hilfe über die Befehlszeile eingestellt, und Version 3.9.2 hat den Parameter UseRpsSession als veraltet markiert. Die Aktualisierung erfolgt mit einem einzigen Befehl: Update-Module -Name ExchangeOnlineManagement. Bei einer Installation für den aktuellen Benutzer ergänzen Sie -Scope CurrentUser. Microsoft empfiehlt, denselben Gültigkeitsbereich zu verwenden, mit dem Sie installiert haben. Bei einer Abweichung kann das Modul an zwei Orten installiert sein, und es ist nicht klar, welches PowerShell verwendet.

Deshalb lohnt es sich, die Prüfung Get-InstalledModule aus Schritt 5 vor und nach einer Aktualisierung auszuführen. Wenn Sie zwei Versionen sehen, finden Sie heraus, welchem Gültigkeitsbereich jede davon angehört.

Um das Modul zu entfernen, führen Sie Uninstall-Module -Name ExchangeOnlineManagement aus. Wurde es für alle Benutzer installiert, tun Sie dies als Administrator. Schließen Sie danach alle geöffneten PowerShell-Fenster, denn ein bereits geladenes Modul bleibt im Speicher, bis seine Sitzung endet.

Häufige Installationsfehler beheben

Die Modulseite von Microsoft nennt einige konkrete Fehler und Lösungen.

• „No match was found for the specified search criteria and module name 'ExchangeOnlineManagement'“. Führen Sie Register-PSRepository -Default aus. Damit wird die PowerShell Gallery wieder als Repository registriert. Versuchen Sie danach die Installation erneut.
• Fehler zu PowerShellGetFormatVersion oder dass Anbieter nicht heruntergeladen werden können. Aktualisieren Sie PowerShellGet und starten Sie PowerShell neu.
• Der Download schlägt auf einem älteren Rechner mit Windows PowerShell 5.1 fehl. Die PowerShell Gallery benötigt TLS 1.2 oder höher. Microsoft verlinkt für die Details einen Blogbeitrag zur TLS-Unterstützung der Gallery.
• „Files cannot be loaded because running scripts is disabled on this system“. Legen Sie die Ausführungsrichtlinie wie oben beschrieben als Administrator fest.
• „Cannot find a cmdlet Update-Manifest“ oder eine ähnliche Meldung zu Update-ModuleManifest beim Verbinden. PowerShellGet oder PackageManagement fehlt. Installieren Sie beides und starten Sie PowerShell neu.

Wenn die Installation funktioniert, die Verbindung aber später mit einem merkwürdigen Assembly-Fehler scheitert, liegt die Ursache meist an einem anderen Modul in derselben Sitzung. Öffnen Sie ein neues Fenster und verbinden Sie sich zuerst.

Häufige Fehler

• Gemischte Gültigkeitsbereiche. Wenn Sie einmal für alle Benutzer installieren und später mit -Scope CurrentUser aktualisieren, liegen auf dem Rechner zwei Versionen. Wählen Sie einen Gültigkeitsbereich und bleiben Sie dabei.
• Falsche PowerShell-Version für das Modul. Das neueste Modul scheitert auf einer älteren PowerShell-7-Version auf Weise, die wie Verbindungsfehler aussieht. Vergleichen Sie Ihre Versionen mit der Tabelle oben.
• Vorabversion auf einem produktiven Host installieren. Vorabversionen sind für Tests gedacht. Verwenden Sie für die tägliche Arbeit die öffentliche Version.
• PowerShellGet ignorieren. Ein fehlendes oder Vorabversions-PowerShellGet kann REST-Verbindungen unterbrechen, wie die Microsoft-Seite beschreibt. Prüfen Sie es zuerst, wenn eine frische Installation keine Verbindung herstellt.
• Veraltete Anleitungen befolgen. Anleitungen, die empfehlen, die Basisauthentifizierung in WinRM zu aktivieren, beschreiben die eingestellte Remote-PowerShell-Methode. Sie brauchen sie nicht.

Verwandte Themen zum Vertiefen

• Verbindung mit dem Modul herstellen: Ist das Modul installiert, lautet die nächste Frage, wie Sie sich anmelden, mit oder ohne MFA. Das erklären der Artikel zum Exchange Online PowerShell-Modul und sein Begleitartikel zur Verbindung.
• Authentifizierung mit App-Only: Geplante Skripte benötigen ein Zertifikat oder eine verwaltete Identität, kein eingegebenes Kennwort.
• Das Modul in PowerShell 7 unter Linux und macOS verwenden: Welche Versionen unterstützt werden, hängt vom Betriebssystem ab. Prüfen Sie deshalb zuerst die Kompatibilitätsliste.
• Festlegen, wer PowerShell verwenden darf: Ein Exchange-Administrator kann den Zugriff auf Exchange Online PowerShell pro Benutzer aktivieren oder deaktivieren.
• Module aktuell halten: Legen Sie eine regelmäßige Erinnerung fest, um nach neuen Modulversionen zu suchen. Microsoft erhöht die minimal erforderliche PowerShell-Version von Zeit zu Zeit.

Nächster Schritt

Zur Installation des Exchange Online PowerShell-Moduls führen Sie Install-Module -Name ExchangeOnlineManagement aus und prüfen die Installation mit Get-InstalledModule. Verwenden Sie bei allen späteren Updates denselben Gültigkeitsbereich (Scope). Anschließend verbinden Sie sich mit Connect-ExchangeOnline in einem neuen Fenster und führen Get-AcceptedDomain aus, um zu prüfen, ob die Einrichtung funktioniert.