Installieren von Azure Active Directory PowerShell für Graph

  • Artikel

Wichtig

Die Einstellung von Azure AD PowerShell ist für den 30. März 2024 geplant. Weitere Informationen zu den Veraltetkeitsplänen finden Sie in der Veraltetkeitsaktualisierung. Wir empfehlen Ihnen, die Migration zu Microsoft Graph PowerShell fortzusetzen. Dies ist das empfohlene Modul für die Interaktion mit Azure AD. Darüber hinaus ermöglicht Microsoft Graph PowerShell den Zugriff auf alle Microsoft Graph-APIs und ist in PowerShell 7 verfügbar. Antworten auf häufige Migrationsabfragen finden Sie in den häufig gestellten Fragen zur Migration.

Sie können die Azure Active Directory PowerShell-Modulversion für Graph für Azure AD administrative Aufgaben wie Benutzerverwaltung, Domänenverwaltung und zum Konfigurieren des einmaligen Anmeldens verwenden. Die hier aufgeführten Cmdlets unterscheiden sich von den MSOnline-Cmdlets, die Teil von Azure Active Directory PowerShell Version 1.0 sind.

Das Azure AD PowerShell für Graph-Modul verfügt über zwei Versionen: eine Public Preview-Version und eine Allgemeinverfügbarkeitsversion (GA). Es wird nicht empfohlen, die öffentliche Vorschauversion für Produktionsszenarien zu verwenden.

Laden Sie die Module aus der PowerShell-Katalog verwenden Sie Folgendes:

Versionsverlauf der Azure Active Directory PowerShell für Graph

Der Releaseverlauf für das Azure AD-Modul und das Azure AD Preview-Modul finden Sie hier:azure active directory powershell for graph: Versionsfreigabeverlauf.

Installieren des Azure AD-Moduls

Voraussetzungen

Das Azure AD-Modul wird unter den folgenden Windows-Betriebssystemen mit der Standardversion von Microsoft .NET Framework und Windows PowerShell unterstützt:

  • Windows 8.1
  • Windows 8
  • Windows 7
  • Windows Server 2012 R2,
  • Windows Server 2012
  • Windows Server 2008 R2.

Hinweis

Das Azure AD PowerShell-Modul ist nicht mit PowerShell 7 kompatibel. Es wird nur in PowerShell 5.1 unterstützt.

Führen Sie folgendes aus, um die Allgemeine Verfügbarkeitsversion des Moduls zu installieren:

Install-Module AzureAD

Führen Sie Folgendes aus, um die Public Preview-Version zu installieren:

Install-module AzureADPreview

Sie können nicht die Vorschauversion und die GA-Version gleichzeitig auf demselben Computer installieren.

Das Azure AD-Modul wird mithilfe der PowerShell-Katalog verteilt. Zum Installieren von Elementen aus dem Katalog ist die neueste Version des PowerShellGet-Moduls erforderlich, das in Windows 10, in Windows Management Framework (WMF) 5.0 oder im MSI-basierten Installationsprogramm (für PowerShell 3 und 4) verfügbar ist.

Mit dem neuesten PowerShellGet-Modul haben Sie folgende Möglichkeiten:

Sehen Sie sich die Seite Erste Schritte an, um weitere Informationen zur Verwendung von PowerShellGet-Befehlen mit dem Katalog zu erhalten. Sie können auch Update-Help -Module PowerShellGet ausführen, um die lokale Hilfe für diese Befehle zu installieren.

Unterstützte Betriebssysteme

Für das PowerShellGet-Modul ist PowerShell 3.0 oder neuer erforderlich.

Aus diesem Grund erfordert PowerShellGet eines der folgenden Betriebssysteme:

  • Windows 10
  • Windows 8.1 Pro
  • Windows 8.1 Enterprise
  • Windows 7 SP1
  • Windows Server 2016 TP5
  • Windows Server 2012 R2
  • Windows Server 2008 R2 SP1

Für PowerShellGet ist außerdem .NET Framework 4.5 oder höher erforderlich. Von hier können Sie .NET Framework 4.5 oder höher installieren.

Aktualisieren des Azure AD-Moduls

Führen Sie den folgenden Befehl aus, um die Version des auf Ihrem Computer installierten Moduls zu überprüfen:

Get-Module AzureADPreview

ModuleType Version Name                ExportedCommands
---------- ------- ----                ----------------
Binary     2.0.0.7 azureadpreview     {Add-AzureADAdmini...

Führen Sie das Cmdlet Install-Module erneut aus, um die Version des Azure AD PowerShell-Moduls auf Ihrem Computer zu aktualisieren:

Install-Module AzureADPreview

Dieser Befehl überprüft den PowerShell-Katalog, um festzustellen, ob eine neuere Version verfügbar ist. Wenn ja, die neuere als die auf Ihrem Computer installierte.

Stellen Sie eine Verbindung mit Azure AD her.

Bevor Sie eines der in diesem Artikel beschriebenen Cmdlets ausführen können, müssen Sie zuerst eine Verbindung mit Ihrem Onlinedienst herstellen. Führen Sie hierzu das Cmdlet Connect-AzureAD in der Windows PowerShell-Eingabeaufforderung aus. Anschließend werden Sie zur Eingabe Ihrer Anmeldeinformationen aufgefordert. Wenn Sie möchten, können Sie Ihre Anmeldeinformationen vorab angeben. Beispiel:

$AzureAdCred = Get-Credential
Connect-AzureAD -Credential $AzureAdCred

Der erste Befehl fordert Sie zur Eingabe von Anmeldeinformationen auf und speichert sie als „$AzureAdCred“. Der nächste Befehl verwendet diese Anmeldeinformationen als „$azureadcred“, um eine Verbindung mit dem Dienst herzustellen.

Hinweis

Die Azure AD- und Azure AD-Vorschaumodule bestehen aus Cmdlets mit unterschiedlichen Namenskonventionen, z. B. -AzureAD und -AzureADMS. Die -AzureAD Cmdlets stellen eine Verbindung mit dem Azure AD Graph-Endpunkt https://graph.windows.net her, während die -AzureADMS Cmdlets den Microsoft Graph-Endpunkt graph.microsoft.comaufrufen. Die Authentifizierung erfolgt automatisch, wenn Sie die Aufrufe von einem Endpunkt in einen anderen ändern und nicht erneut zur Eingabe der Anmeldeinformationen aufgefordert werden.

Verwenden Sie zum Herstellen einer Verbindung mit einer bestimmten Umgebung von Azure Active Directory den AzureEnvironment-Parameter wie folgt:

Connect-AzureAD -AzureEnvironment "AzureGermanyCloud"

In diesem Beispiel wird eine Verbindung zwischen Ihrer PowerShell-Sitzung und der deutschen AzureAD-Umgebung hergestellt. Weitere Informationen finden Sie unter Connect-AzureAD.

Nächste Schritte