Microsoft 365 mit PowerShell verbinden

• 07/17/2020
• 6 Minuten zu lesen
• • J
  • D
  • m
  • d

Dieser Artikel gilt sowohl für Microsoft 365 Enterprise als auch für Office 365 Enterprise.

PowerShell für Microsoft 365 ermöglicht es Ihnen, Ihre Microsoft 365-Einstellungen über die Befehlszeile zu verwalten. Um sich mit PowerShell zu verbinden, installieren Sie einfach die erforderliche Software und verbinden sich dann mit Ihrer Microsoft 365-Organisation.

Es gibt zwei Versionen des PowerShell-Moduls, die Sie verwenden können, um eine Verbindung zu Microsoft 365 herzustellen und Benutzerkonten, Gruppen und Lizenzen zu verwalten:

• Azure Active Directory PowerShell for Graph, dessen Cmdlets AzureAD im Namen enthalten
• Microsoft Azure Active Directory Module for Windows PowerShell, dessen Cmdlets Msol im Namen enthalten

Zurzeit ersetzt das Azure Active Directory PowerShell for Graph-Modul nicht vollständig die Funktionalität des Microsoft Azure Active Directory Module for Windows PowerShell-Moduls für die Benutzer-, Gruppen- und Lizenzverwaltung. In einigen Fällen müssen Sie beide Versionen verwenden. Sie können beide Versionen sicher auf demselben Computer installieren.

Was müssen Sie wissen, bevor Sie beginnen?

Betriebssystem

Sie müssen eine 64-Bit-Version von Windows verwenden. Die Unterstützung für die 32-Bit-Version des Microsoft Azure Active Directory-Moduls für Windows PowerShell wurde 2014 eingestellt.

Sie können die folgenden Versionen von Windows verwenden:

• Windows 10, Windows 8.1, Windows 8, oder Windows 7 Service Pack 1 (SP1)

• Windows Server 2019, Windows Server 2016, Windows Server 2012 R2, Windows Server 2012, oder Windows Server 2008 R2 SP1

PowerShell

• Für das Azure Active Directory PowerShell for Graph Modul müssen Sie PowerShell Version 5.1 oder höher verwenden.

• Für das Microsoft Azure Active Directory-Modul für Windows PowerShell-Modul müssen Sie PowerShell Version 5.1 oder höher verwenden, bis hin zu PowerShell Version 6. Sie können PowerShell Version 7 nicht verwenden.

Verbinden Sie sich mit dem Azure Active Directory PowerShell for Graph-Modul

Befehle im Azure Active Directory PowerShell for Graph-Modul haben AzureAD im Cmdlet-Namen. Sie können das Azure Active Directory PowerShell for Graph-Modul oder Azure PowerShell installieren.

Für Verfahren, die die neuen Cmdlets im Azure Active Directory PowerShell for Graph-Modul erfordern, führen Sie die folgenden Schritte aus, um das Modul zu installieren und eine Verbindung mit Ihrem Microsoft 365-Abonnement herzustellen.

Schritt 1: Installieren der erforderlichen Software

Diese Schritte sind nur einmal auf Ihrem Computer erforderlich. Sie müssen die Software jedoch wahrscheinlich regelmäßig aktualisieren.

1. Öffnen Sie ein erweitertes Fenster der Windows PowerShell-Eingabeaufforderung (führen Sie Windows PowerShell als Administrator aus).

2. Führen Sie diesen Befehl aus:

   Install-Module -Name AzureAD

   Wenn Sie aufgefordert werden, ein Modul aus einem nicht vertrauenswürdigen Repository zu installieren, geben Sie Y ein und drücken Sie die Eingabetaste.

Schritt 2: Stellen Sie eine Verbindung zu Azure AD für Ihr Microsoft 365-Abonnement her

Um eine Verbindung zu Azure Active Directory (Azure AD) für Ihr Microsoft 365-Abonnement mit einem Kontonamen und einem Kennwort oder mit Multifaktorauthentifizierung herzustellen, führen Sie einen dieser Befehle von einer Windows PowerShell-Eingabeaufforderung aus. (Die Berechtigung muss nicht erhöht sein.)

Geben Sie im Dialogfeld Anmelden bei Ihrem Konto Ihren Benutzernamen und Ihr Kennwort für das Microsoft 365-Arbeits- oder Schulkonto ein und wählen Sie dann OK.

Wenn Sie die Multi-Faktor-Authentifizierung verwenden, folgen Sie den Anweisungen, um zusätzliche Authentifizierungsinformationen, wie z. B. einen Verifizierungscode, anzugeben.

Nach der Verbindung können Sie die Cmdlets für das Azure Active Directory PowerShell for Graph-Modul verwenden.

Verbinden mit dem Microsoft Azure Active Directory-Modul für Windows PowerShell

PowerShell Version 7 und höher unterstützen das Microsoft Azure Active Directory-Modul für Windows PowerShell-Modul und Cmdlets mit Msol in ihrem Namen nicht. Für PowerShell Version 7 und höher müssen Sie das Azure Active Directory PowerShell for Graph-Modul oder Azure PowerShell verwenden.

PowerShell Core unterstützt nicht das Microsoft Azure Active Directory-Modul für Windows PowerShell-Modul und Cmdlets mit Msol im Namen. Führen Sie diese Cmdlets von Windows PowerShell aus.

Schritt 1: Installieren Sie die erforderliche Software

Diese Schritte sind nur einmalig auf Ihrem Computer erforderlich. Sie müssen die Software jedoch wahrscheinlich regelmäßig aktualisieren.

1. Wenn Sie nicht mit Windows 10 arbeiten, installieren Sie die 64-Bit-Version des Microsoft Online Services Sign-in Assistant: Microsoft Online Services Sign-in Assistant for IT Professionals RTW.

2. Befolgen Sie diese Schritte, um das Microsoft Azure Active Directory-Modul für Windows PowerShell zu installieren:

   1. Öffnen Sie eine erweiterte Windows PowerShell-Eingabeaufforderung (führen Sie Windows PowerShell als Administrator aus).
   2. Führen Sie den Befehl Install-Module MSOnline aus.
   3. Wenn Sie aufgefordert werden, den NuGet-Anbieter zu installieren, geben Sie Y ein und drücken Sie die Eingabetaste.
   4. Wenn Sie aufgefordert werden, das Modul von PSGallery zu installieren, geben Sie Y ein und drücken Sie die Eingabetaste.

Schritt 2: Stellen Sie eine Verbindung zu Azure AD für Ihr Microsoft 365-Abonnement her

Um eine Verbindung zu Azure AD für Ihr Microsoft 365-Abonnement mit einem Kontonamen und einem Kennwort oder mit Multifaktorauthentifizierung herzustellen, führen Sie einen dieser Befehle von einer Windows PowerShell-Eingabeaufforderung aus. (Die Berechtigung muss nicht erhöht sein.)

Geben Sie im Dialogfeld Anmelden bei Ihrem Konto Ihren Benutzernamen und Ihr Kennwort für das Microsoft 365-Arbeits- oder Schulkonto ein und wählen Sie dann OK.

Wenn Sie die Multi-Faktor-Authentifizierung verwenden, folgen Sie den Anweisungen, um zusätzliche Authentifizierungsinformationen wie einen Verifizierungscode anzugeben.

Woher wissen Sie, dass es funktioniert hat?

Wenn Sie keine Fehlermeldung erhalten, haben Sie die Verbindung erfolgreich hergestellt. Führen Sie für einen schnellen Test ein Microsoft 365-Cmdlet aus, z. B. Get-MsolUser, und sehen Sie sich die Ergebnisse an.

Wenn Sie eine Fehlermeldung erhalten, überprüfen Sie die folgenden Probleme:

• Ein häufiges Problem ist ein falsches Kennwort. Führen Sie Schritt 2 erneut aus, und achten Sie genau auf den Benutzernamen und das Kennwort, die Sie eingeben.

• Das Microsoft Azure Active Directory-Modul für Windows PowerShell erfordert, dass Microsoft .NET Framework 3.5.x auf Ihrem Computer aktiviert ist. Es ist wahrscheinlich, dass auf Ihrem Computer eine neuere Version installiert ist (z. B. 4 oder 4.5.x). Die Abwärtskompatibilität mit älteren Versionen von .NET Framework kann jedoch aktiviert oder deaktiviert werden. Weitere Informationen finden Sie in den folgenden Artikeln:

  • Für Windows Server 2012 oder Windows Server 2012 R2, siehe Aktivieren von .NET Framework 3.5 mithilfe des Assistenten zum Hinzufügen von Rollen und Funktionen.

  • Für Windows 7 oder Windows Server 2008 R2, siehe Sie können das Azure Active Directory-Modul für Windows PowerShell nicht öffnen.

  • Für Windows 10, Windows 8.1 und Windows 8, siehe Installieren Sie das .NET Framework 3.5 unter Windows 10, Windows 8.1 und Windows 8.

• Ihre Version des Microsoft Azure Active Directory-Moduls für Windows PowerShell ist möglicherweise veraltet. Führen Sie zum Überprüfen den folgenden Befehl in PowerShell für Microsoft 365 oder das Microsoft Azure Active Directory-Modul für Windows PowerShell aus:

  (Get-Item C:\Windows\System32\WindowsPowerShell\v1.0\Modules\MSOnline\Microsoft.Online.Administration.Automation.PSModule.dll).VersionInfo.FileVersion

  Wenn die zurückgegebene Versionsnummer niedriger als 1.0.8070.2 ist, deinstallieren Sie das Microsoft Azure Active Directory-Modul für Windows PowerShell und installieren Sie es ab Schritt 1 oben.

• Wenn Sie eine Verbindungsfehlermeldung erhalten, siehe „Connect-MsolService: Exception of type was thrown“ Fehler.

• Wenn Sie eine „Get-Item: Pfad kann nicht gefunden werden“-Fehlermeldung erhalten, führen Sie diesen Befehl aus:

   (dir "C:\Program Files\WindowsPowerShell\Modules\MSOnline").Name

Siehe auch

• Microsoft 365 mit PowerShell verwalten
• Starten Sie mit PowerShell für Microsoft 365
• Verbinden Sie mit allen Microsoft 365-Diensten in einem einzigen Windows PowerShell-Fenster