Verbinden mit Microsoft 365 über PowerShellConnect to Microsoft 365 with PowerShell

Dieser Artikel gilt sowohl für Microsoft 365 Enterprise als auch für Office 365 Enterprise.This article applies to both Microsoft 365 Enterprise and Office 365 Enterprise.

Mit PowerShell für Microsoft 365 können Sie Ihre Microsoft 365-Einstellungen über die Befehlszeile verwalten.PowerShell for Microsoft 365 enables you to manage your Microsoft 365 settings from the command line. Um eine Verbindung mit PowerShell herzustellen, installieren Sie einfach die erforderliche Software, und stellen Sie eine Verbindung mit Ihrer Microsoft 365-Organisation her.To connect to PowerShell, just install the required software and then connect to your Microsoft 365 organization.

Es gibt zwei Versionen des PowerShell-Moduls, mit denen Sie die Verbindung zu Microsoft 365 herstellen und Benutzerkonten, Gruppen und Lizenzen verwalten können:There are two versions of the PowerShell module that you can use to connect to Microsoft 365 and administer user accounts, groups, and licenses:

  • Azure Active Directory-PowerShell für Graph, dessen Cmdlets AzureAD in ihrem Namen enthaltenAzure Active Directory PowerShell for Graph, whose cmdlets include AzureAD in their name
  • Microsoft Azure Active Directory-Modul für Windows PowerShell, dessen Cmdlets MSol in ihrem Namen enthaltenMicrosoft Azure Active Directory Module for Windows PowerShell, whose cmdlets include Msol in their name

Zurzeit ersetzt das Modul „Azure Active Directory-PowerShell für Graph“ die Funktionen des Moduls „Microsoft Azure Active Directory-Modul für Windows PowerShell“ für Benutzer-, Gruppen- und Lizenzverwaltung nicht vollständig.Currently, the Azure Active Directory PowerShell for Graph module doesn't completely replace the functionality of the Microsoft Azure Active Directory Module for Windows PowerShell module for user, group, and license administration. In einigen Fällen müssen Sie beide Versionen verwenden.In some cases, you need to use both versions. Sie können problemlos beide Versionen auf demselben Computer installieren.You can safely install both versions on the same computer.

Was sollten Sie wissen, bevor Sie beginnen?What do you need to know before you begin?

BetriebssystemOperating system

Sie müssen eine 64-Bit-Version von Windows verwenden.You must use a 64-bit version of Windows. Die Unterstützung für die 32-Bit-Version des Microsoft Azure Active Directory-Moduls für Windows PowerShell wurde 2014 eingestellt.Support for the 32-bit version of the Microsoft Azure Active Directory Module for Windows PowerShell ended in 2014.

Sie können folgende Versionen von Windows verwenden:You can use the following versions of Windows:

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

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

Hinweis

Für Windows 8.1, Windows 8, Windows 7 Service Pack 1 (SP1), Windows Server 2012 R2, Windows Server 2012 und Windows Server 2008 R2 SP1 laden Sie Windows Management Framework 5.1 herunter. und installieren Sie es.For Windows 8.1, Windows 8, Windows 7 Service Pack 1 (SP1), Windows Server 2012 R2, Windows Server 2012, and Windows Server 2008 R2 SP1, download and install the Windows Management Framework 5.1.

PowerShellPowerShell

  • Für das Azure Active Directory PowerShell für Graph-Modul müssen Sie PowerShell 5.1 oder höher verwenden.For the Azure Active Directory PowerShell for Graph module, you must use PowerShell version 5.1 or later.

  • Für das Microsoft Azure Active Directory-Modul für Windows PowerShell-Modul müssen Sie PowerShell 5.1 oder höher bis zu PowerShell 6 verwenden.For the Microsoft Azure Active Directory Module for Windows PowerShell module, you must use PowerShell version 5.1 or later, up to PowerShell version 6. PowerShell 7 kann nicht verwendet werden.You can't use PowerShell version 7.

Hinweis

Diese Verfahren sind für Benutzer vorgesehen, die Mitglieder einer Microsoft 365-Administratorrolle sind.These procedures are intended for users who are members of a Microsoft 365 admin role. Weitere Informationen finden Sie unter Informationen zu Administratorrollen.For more information, see About admin roles.

Herstellen einer Verbindung mit dem Azure Active Directory PowerShell für Graph-ModulConnect with the Azure Active Directory PowerShell for Graph module

Befehle im Azure Active Directory PowerShell für Graph-Modul haben AzureAD in ihrem Cmdlet-Namen.Commands in the Azure Active Directory PowerShell for Graph module have AzureAD in their cmdlet name. Sie können das Azure Active Directory PowerShell für Graph-Modul oder Azure PowerShell installieren.You can install the Azure Active Directory PowerShell for Graph module or Azure PowerShell.

Führen Sie bei Verfahren, die die neuen Cmdlets im Azure Active Directory PowerShell für Graph-Modul erfordern, die nachstehenden Schritte zum Installieren des Moduls und Herstellen einer Verbindung mit Ihrem Microsoft 365-Abonnement aus.For procedures that require the new cmdlets in the Azure Active Directory PowerShell for Graph module, follow these steps to install the module and connect to your Microsoft 365 subscription.

Hinweis

Informationen zur Unterstützung für verschiedene Versionen von Windows finden Sie unter Azure Active Directory PowerShell für Graph-Modul.For information about support for different versions of Windows, see Azure Active Directory PowerShell for Graph module .

Schritt 1: Installieren der erforderlichen SoftwareStep 1: Install the required software

Diese Schritte sind nur einmal auf Ihrem Computer erforderlich.These steps are required only one time on your computer. Sie müssen die Software aber wahrscheinlich regelmäßig aktualisieren.But you'll likely need to update the software periodically.

  1. Öffnen Sie ein Windows PowerShell-Eingabeaufforderungsfenster mit erhöhten Rechten (d. h., führen Sie Windows PowerShell als Administrator aus).Open an elevated Windows PowerShell Command Prompt window (run Windows PowerShell as an administrator).

  2. Führen Sie den folgenden Befehl aus:Run this command:

    Install-Module -Name AzureAD
    

    Falls Sie gefragt werden, ob Sie ein Modul aus einem nicht vertrauenswürdigen Repository installieren möchten: Geben Sie Y ein, und drücken Sie die EINGABETASTE.If you're prompted to install a module from an untrusted repository, type Y and press Enter.

Schritt 2: Herstellen einer Verbindung mit Azure AD für Ihr Microsoft 365-AbonnementStep 2: Connect to Azure AD for your Microsoft 365 subscription

Führen Sie über eine Windows PowerShell-Eingabeaufforderung einen der nachstehenden Befehle aus, um eine Verbindung mit Azure Active Directory (Azure AD) für Ihr Microsoft 365-Abonnement mit einem Kontonamen und Kennwort oder mit mehrstufiger Authentifizierung herzustellen.To connect to Azure Active Directory (Azure AD) for your Microsoft 365 subscription with an account name and password or with multi-factor authentication, run one of these commands from a Windows PowerShell command prompt. (Für die Eingabeaufforderung sind keine erhöhten Rechte erforderlich.)(It doesn't have to be elevated.)

Office 365-CloudOffice 365 cloud BefehlCommand
Office 365 weltweit (+GCC)Office 365 Worldwide (+GCC) Connect-AzureAD
Office 365, betrieben von 21VianetOffice 365 operated by 21 Vianet Connect-AzureAD -AzureEnvironmentName AzureChinaCloud
Office 365 DeutschlandOffice 365 Germany Connect-AzureAD -AzureEnvironmentName AzureGermanyCloud
Office 365 U.S. Government DoD und Office 365 U.S. Government GCC HighOffice 365 U.S. Government DoD and Office 365 U.S. Government GCC High Connect-AzureAD -AzureEnvironmentName AzureUSGovernment

Geben Sie im Dialogfeld Bei Ihrem Konto anmelden den Benutzernamen und das Kennwort für Ihr Microsoft 365-Geschäfts-, Schul- oder Unikonto ein, und wählen Sie dann OK aus.In the Sign into your account dialog box, type your Microsoft 365 work or school account user name and password, and then select OK.

Wenn Sie die mehrstufige Authentifizierung verwenden, folgen Sie den Anweisungen, um zusätzliche Authentifizierungsinformationen, z. B. einen Überprüfungscode, anzugeben.If you're using multi-factor authentication, follow the instructions to provide additional authentication information, such as a verification code.

Nach dem Herstellen der Verbindung können Sie die Cmdlets für das Azure Active Directory PowerShell für Graph-Modul verwenden.After you connect, you can use the cmdlets for the Azure Active Directory PowerShell for Graph module.

Herstellen einer Verbindung mit dem Microsoft Azure Active Directory-Modul für Windows PowerShellConnect with the Microsoft Azure Active Directory Module for Windows PowerShell

Hinweis

Die Cmdlets im Microsoft Azure Active Directory-Modul für Windows PowerShell weisen Msol in ihrem Namen auf.Cmdlets in the Microsoft Azure Active Directory Module for Windows PowerShell have Msol in their name.

Das Microsoft Azure Active Directory-Modul für Windows PowerShell-Modul und Cmdlets mit Msol im Namen werden von PowerShell 7 und höher nicht unterstützt.PowerShell version 7 and later don't support the Microsoft Azure Active Directory Module for Windows PowerShell module and cmdlets with Msol in their name. Für PowerShell 7 oder höher müssen Sie das Azure Active Directory PowerShell für Graph-Modul oder Azure PowerShell verwenden.For PowerShell version 7 and later, you must use the Azure Active Directory PowerShell for Graph module or Azure PowerShell.

Das Microsoft Azure Active Directory-Modul für Windows PowerShell-Modul und Cmdlets mit Msol im Namen werden von PowerShell Core nicht unterstützt.PowerShell Core doesn't support the Microsoft Azure Active Directory Module for Windows PowerShell module and cmdlets with Msol in their name. Führen Sie diese Cmdlets über Windows PowerShell aus.Run these cmdlets from Windows PowerShell.

Schritt 1: Installieren der erforderlichen SoftwareStep 1: Install the required software

Diese Schritte sind nur einmal auf Ihrem Computer erforderlich.These steps are required only one time on your computer. Sie müssen die Software aber wahrscheinlich regelmäßig aktualisieren.But you'll likely need to update the software periodically.

  1. Wenn Sie nicht Windows 10 ausführen, installieren Sie die 64-Bit-Version des Microsoft Online Services-Anmeldeassistenten: Microsoft Online Services-Anmeldeassistent für IT-Experten RTW.If you're not running Windows 10, install the 64-bit version of the Microsoft Online Services Sign-in Assistant: Microsoft Online Services Sign-in Assistant for IT Professionals RTW.

  2. Installieren Sie das Microsoft Azure Active Directory-Modul für Windows PowerShell mit den folgenden Schritten:Follow these steps to install the Microsoft Azure Active Directory Module for Windows PowerShell:

    1. Öffnen Sie eine Windows PowerShell-Eingabeaufforderung mit erhöhten Rechten (d. h., führen Sie Windows PowerShell als Administrator aus).Open an elevated Windows PowerShell command prompt (run Windows PowerShell as an administrator).
    2. Führen Sie den Befehl Install-Module MSOnline aus.Run the Install-Module MSOnline command.
    3. Wenn Sie zum Installieren des NuGet-Anbieters aufgefordert werden, geben Sie Y ein, und drücken Sie die EINGABETASTE.If you're prompted to install the NuGet provider, type Y and press Enter.
    4. Wenn Sie aufgefordert werden, das Modul von PSGallery zu installieren, geben Sie Y ein, und drücken Sie die EINGABETASTE.If you're prompted to install the module from PSGallery, type Y and press Enter.

Schritt 2: Herstellen einer Verbindung mit Azure AD für Ihr Microsoft 365-AbonnementStep 2: Connect to Azure AD for your Microsoft 365 subscription

Führen Sie über eine Windows PowerShell-Eingabeaufforderung einen der nachstehenden Befehle aus, um eine Verbindung mit Azure AD für Ihr Microsoft 365-Abonnement mit einem Kontonamen und Kennwort oder mit mehrstufiger Authentifizierung herzustellen.To connect to Azure AD for your Microsoft 365 subscription with an account name and password or with multi-factor authentication, run one of these commands from a Windows PowerShell command prompt. (Für die Eingabeaufforderung sind keine erhöhten Rechte erforderlich.)(It doesn't have to be elevated.)

Office 365-CloudOffice 365 cloud BefehlCommand
Office 365 weltweit (+GCC)Office 365 Worldwide (+GCC) Connect-MsolService
Office 365, betrieben von 21VianetOffice 365 operated by 21 Vianet Connect-MsolService -AzureEnvironment AzureChinaCloud
Office 365 DeutschlandOffice 365 Germany Connect-MsolService -AzureEnvironment AzureGermanyCloud
Office 365 U.S. Government DoD und Office 365 U.S. Government GCC HighOffice 365 U.S. Government DoD and Office 365 U.S. Government GCC High Connect-MsolService -AzureEnvironment USGovernment

Geben Sie im Dialogfeld Bei Ihrem Konto anmelden den Benutzernamen und das Kennwort für Ihr Microsoft 365-Geschäfts-, Schul- oder Unikonto ein, und wählen Sie dann OK aus.In the Sign into your account dialog box, type your Microsoft 365 work or school account user name and password, and then select OK.

Wenn Sie die mehrstufige Authentifizierung verwenden, folgen Sie den Anweisungen, um zusätzliche Authentifizierungsinformationen, z. B. einen Überprüfungscode, anzugeben.If you're using multi-factor authentication, follow the instructions to provide additional authentication information, such as a verification code.

Woher wissen Sie, dass der Vorgang erfolgreich war?How do you know it worked?

Wenn Sie keine Fehlermeldung erhalten, wurde die Verbindung hergestellt.If you don't get an error message, you connected successfully. Führen Sie für einen schnellen Test ein Microsoft 365-Cmdlet aus, z. B. Get-MsolUser , und sehen Sie sich die Ergebnisse an.For quick test, run a Microsoft 365 cmdlet, such as Get-MsolUser , and see the results.

Wenn eine Fehlermeldung angezeigt wird, überprüfen Sie die folgenden Punkte:If you get an error message, check the following issues:

  • Ein häufig auftretendes Problem ist ein falsches Kennwort.A common problem is an incorrect password. Führen Sie Schritt 2 erneut aus, und achten Sie dabei auf die korrekte Eingabe des Benutzernamens und des Kennworts.Run Step 2 again, and pay close attention to the user name and password that you enter.

  • Das Microsoft Azure Active Directory-Modul für Windows PowerShell setzt voraus, 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. Version 4 oder 4.5.* x*).The Microsoft Azure Active Directory Module for Windows PowerShell requires that Microsoft .NET Framework 3.5. x is enabled on your computer**. It's likely that your computer has a newer version installed (for example, 4 or 4.5.* x*). Die Abwärtskompatibilität mit älteren Versionen von .NET Framework kann jedoch aktiviert oder deaktiviert werden.But backward compatibility with older versions of the .NET Framework can be enabled or disabled. Weitere Informationen finden Sie in den folgenden Artikeln:For more information, see the following articles:

  • Möglicherweise ist Ihre Version des Microsoft Azure Active Directory-Moduls für Windows PowerShell veraltet.Your version of the Microsoft Azure Active Directory Module for Windows PowerShell might be out of date. Um dies zu überprüfen, führen Sie den folgenden Befehl in PowerShell für Microsoft 365 oder im Microsoft Azure Active Directory-Modul für Windows PowerShell aus:To check, run the following command in PowerShell for Microsoft 365 or the Microsoft Azure Active Directory Module for Windows PowerShell:

    (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 führen Sie die Installation über den vorstehenden Schritt 1 durch.If the version number returned is lower than 1.0.8070.2 , uninstall the Microsoft Azure Active Directory Module for Windows PowerShell and install from Step 1, above.

  • Wenn Sie einen Verbindungsfehler erhalten , finden Sie auf dieser Seite weitere Informationen: Fehler "Connect-MsolService: Ausnahme vom Typ ausgelöst".If you get a connection error message , see "Connect-MsolService: Exception of type was thrown" error.

  • Wenn Sie einen "Get-Item: Pfad nicht gefunden"-Fehler erhalten , führen Sie folgenden Befehl aus:If you get a "Get-Item: Cannot find path" error message , run this command:

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

Weitere InformationenSee also