Verbinden mit Office 365 PowerShellConnect to Office 365 PowerShell

Mit Office 365 PowerShell können Sie Ihre Office 365-Einstellungen über die Befehlszeile verwalten.Office 365 PowerShell lets you manage your Office 365 settings from the command line. Das Herstellen einer Verbindung mit Office 365 PowerShell ist ein einfacher Vorgang, bei dem Sie die erforderliche Software installieren und dann eine Verbindung mit Ihrer Office 365-Organisation herstellen.Connecting to Office 365 PowerShell is a simple process where you install the required software and then connect to your Office 365 organization.

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

  • Azure Active Directory PowerShell für Graph (Cmdlets enthalten AzureAD in ihrem Namen)Azure Active Directory PowerShell for Graph (cmdlets include AzureAD in their name)
  • Microsoft Azure Active Directory-Modul für Windows PowerShell (Cmdlets enthalten MSol in ihrem Namen)Microsoft Azure Active Directory Module for Windows PowerShell (cmdlets include MSol in their name)

Zum Zeitpunkt des Erscheinens dieses Artikels ersetzt das Azure Active Directory PowerShell für Graph-Modul nicht vollständig die Funktionen in den Cmdlets des Microsoft Azure Active Directory-Moduls für Windows PowerShell für Benutzer-, Gruppen- und Lizenzverwaltung.As of the date of this article, the Azure Active Directory PowerShell for Graph module does not completely replace the functionality in the cmdlets of Microsoft Azure Active Directory Module for Windows PowerShell module for user, group, and license administration. In vielen Fällen müssen Sie beide Versionen verwenden.In many 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.

Tipp

Neu bei PowerShell?New to PowerShell? Sehen Sie sich ein Video mit einer Übersicht über PowerShell an, das Ihnen von LinkedIn Learning bereitgestellt wird.See a video Overview of PowerShell, brought to you by LinkedIn Learning.

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

  • Geschätzte Zeit bis zum Abschließen des Vorgangs: 5 MinutenEstimated time to complete: 5 minutes

  • 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

      Sie müssen PowerShell 5.1 oder höher verwenden.You must use PowerShell version 5.1 or later. 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.

      Hinweis

      Verwenden Sie eine 64-Bit-Version von Windows.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 im Oktober 2014 eingestellt.Support for the 32-bit version the Microsoft Azure Active Directory Module for Windows PowerShell was discontinued in October of 2014.

  • Diese Verfahren sind für Benutzer vorgesehen, die Mitglieder einer Office 365-Administratorrolle sind.These procedures are intended for users who are members of an Office 365 admin role. Weitere Informationen finden Sie unter Informationen zu Administratorrollen von Office 365.For more information, see About Office 365 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.

Verwenden Sie für Verfahren, welche die neuen Cmdlets im Azure Active Directory PowerShell für Graph-Modul benötigen, die nachstehenden Schritte zum Installieren des Moduls und Herstellen einer Verbindung mit Ihrem Office 365-Abonnement.For procedures that require the new cmdlets in the Azure Active Directory PowerShell for Graph module, use these steps to install the module and connect to your Office 365 subscription.

Hinweis

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

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

Diese Schritte sind auf Ihrem Computer nur einmal erforderlich, nicht jedes Mal, wenn Sie eine Verbindung herstellen. Allerdings müssen Sie wahrscheinlich in regelmäßigen Abständen neuere Versionen der Software installieren.These steps are required once on your computer, not every time you connect. However, you'll likely need to install newer versions of the software periodically.

  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 im Befehlsfenster Administrator: Windows PowerShell den folgenden Befehl aus:In the Administrator: Windows PowerShell command window, 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 prompted about installing a module from an untrusted repository, type Y and press ENTER.

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

Wenn Sie eine Verbindung mit Azure AD für Ihr Office 365-Abonnement mit einem Kontonamen und Kennwort oder mit mehrstufiger Authentifizierung (Multi-Factor Authentication, MFA) herstellen möchten, führen Sie einen dieser Befehle an einer Windows PowerShell-Eingabeaufforderung aus (sie muss nicht über erhöhte Rechte verfügen).To connect to Azure AD for your Office 365 subscription with an account name and password or with multi-factor authentication (MFA), run one of these commands from a Windows PowerShell command prompt (it does not 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 DialogfeldAnmelden bei Ihrem Konto den Benutzernamen und das Kennwort für Ihr Office 365-Geschäfts-, Schul- oder Unikonto ein, und klicken Sie dann auf OK.In the Sign into your account dialog box, type your Office 365 work or school account user name and password, and then click OK.

Wenn Sie MFA verwenden, befolgen Sie die Anweisungen in den zusätzlichen Dialogfeldern, um weitere Authentifizierungsinformationen, z. B. einen Überprüfungscode, bereitzustellen.If you are using MFA, follow the instructions in the additional dialog boxes to provide more authentication information, such as a verification code.

Nach dem Herstellen der Verbindung können Sie die neuen Cmdlets für das Azure Active Directory PowerShell für Graph-Modul verwenden.After connecting, you can use the new 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

Die Befehle im Microsoft Azure Active Directory-Modul für Windows PowerShell enthalten Msol in ihrem Cmdlet-Namen.Commands in the Microsoft Azure Active Directory Module for Windows PowerShell have Msol in their cmdlet name.

Hinweis

PowerShell Core unterstützt nicht das Microsoft Azure Active Directory-Modul für Windows PowerShell und Cmdlets mit Msol im Namen.PowerShell Core does not support the Microsoft Azure Active Directory Module for Windows PowerShell module and cmdlets with Msol in their name. Um diese Cmdlets weiterhin verwenden zu können, müssen Sie sie über Windows PowerShell ausführen.To continue using these cmdlets, you must run them from Windows PowerShell.

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

Diese Schritte sind auf Ihrem Computer nur einmal erforderlich, nicht jedes Mal, wenn Sie eine Verbindung herstellen. Allerdings müssen Sie wahrscheinlich in regelmäßigen Abständen neuere Versionen der Software installieren.These steps are required once on your computer, not every time you connect. However, you'll likely need to install newer versions of the software periodically.

  1. Installieren Sie die 64-Bit-Version des Microsoft Online Services-Anmeldeassistenten: Microsoft Online Services-Anmeldeassistent für IT-Experten RTW.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:Install the Microsoft Azure Active Directory Module for Windows PowerShell with these steps:

  • Ö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).
  • Führen Sie den BefehlInstall-Module MSOnline aus.Run the Install-Module MSOnline command.
  • Wenn Sie zum Installieren des NuGet-Anbieters aufgefordert werden, geben Sie Y ein, und drücken Sie die EINGABETASTE.If prompted to install the NuGet provider, type Y and press ENTER.
  • Wenn Sie aufgefordert werden, das Modul von PSGallery zu installieren, geben Sie Y ein, und drücken Sie die EINGABETASTE.If prompted to install the module from PSGallery, type Y and press ENTER.

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

Wenn Sie eine Verbindung mit Azure AD für Ihr Office 365-Abonnement mit einem Kontonamen und Kennwort oder mit mehrstufiger Authentifizierung (Multi-Factor Authentication, MFA) herstellen möchten, führen Sie einen dieser Befehle an einer Windows PowerShell-Eingabeaufforderung aus (sie muss nicht über erhöhte Rechte verfügen).To connect to Azure AD for your Office 365 subscription with an account name and password or with multi-factor authentication (MFA), run one of these commands from a Windows PowerShell command prompt (it does not 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 DialogfeldAnmelden bei Ihrem Konto den Benutzernamen und das Kennwort für Ihr Office 365-Geschäfts-, Schul- oder Unikonto ein, und klicken Sie dann auf OK.In the Sign into your account dialog box, type your Office 365 work or school account user name and password, and then click OK.

Wenn Sie MFA verwenden, befolgen Sie die Anweisungen in den zusätzlichen Dialogfeldern, um weitere Authentifizierungsinformationen, z. B. einen Überprüfungscode, bereitzustellen.If you are using MFA, follow the instructions in the additional dialog boxes to provide more authentication information, such as a verification code.

Woher wissen Sie, dass dieses Verfahren erfolgreich war?How do you know this worked?

Wenn Sie keine Fehlermeldungen erhalten, wurde die Verbindung erfolgreich hergestellt.If you don't receive any errors, you connected successfully. Ein schneller Test ist die Ausführung eines Office 365-Cmdlets, z. B. Get-MsolUser, und die Betrachtung der Ergebnisse.A quick test is to run an Office 365 cmdlet—for example, Get-MsolUser —and see the results.

Wenn Sie Fehlermeldungen erhalten, überprüfen Sie die folgenden Anforderungen:If you receive errors, check the following requirements:

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

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

  • 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 Office 365 PowerShell oder im Microsoft Azure Active Directory-Modul für Windows PowerShell aus:To check, run the following command in Office 365 PowerShell 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 der Wert 1.0.8070.2 ist, deinstallieren Sie das Microsoft Azure Active Directory-Modul für Windows PowerShell, und installieren Sie die neueste Version über den Link in Schritt 1.If the version number returned is lower than the value 1.0.8070.2, uninstall the Microsoft Azure Active Directory Module for Windows PowerShell and install the latest version from the link in Step 1.

  • Wenn Sie einen Verbindungsfehler erhalten, finden Sie in diesem Thema weitere Informationen: Fehler "Connect-MsolService: Ausnahme vom Typ ausgelöst".If you receive a connection error, see this topic: "Connect-MsolService: Exception of type was thrown" error.

Siehe auchSee also