Installieren Microsoft Entra PowerShell

Mit dem Microsoft Entra PowerShell-Modul können IT-Experten Microsoft Entra Ressourcen effizient verwalten und so eine nahtlose Integration und Funktionalität auf verschiedenen Plattformen gewährleisten. Dieses Modul verbessert Ihre Fähigkeit, administrative Aufgaben zu automatisieren und zu optimieren.

In diesem Artikel erfahren Sie, wie Sie das Microsoft Entra PowerShell-Modul auf den verschiedenen Betriebssystemen installieren, überprüfen, aktualisieren und beheben.

Das Microsoft Entra PowerShell-Modul ist in zwei Module unterteilt, die jeweils über Untermodule verfügen, die separat installiert werden können. Die beiden Hauptmodule sind:

  • Microsoft.Entra - die allgemein verfügbare oder v1.0 Version von Microsoft Entra PowerShell. Sie verweist auf Microsoft Graph v1.0- und Microsoft Graph PowerShell SDK v1.0-Ressourcen.
  • Microsoft.Entra.Beta - die Beta oder Vorschauversion von Microsoft Entra PowerShell. Sie verweist auf Microsoft Graph Beta- und Microsoft Graph PowerShell SDK Betaressourcen.

PowerShell Version 7 oder höher wird für die Verwendung mit dem Microsoft Entra PowerShell-Modul auf allen Plattformen empfohlen, einschließlich Windows, Linux und macOS.

Installieren des Microsoft Entra PowerShell-Moduls auf Windows

Die empfohlene Installationsmethode und PowerShell-Version für das Modul:

  • Aus der PowerShell-Katalog installieren
  • Wird mit Windows PowerShell 5.1+ oder PowerShell 7+ verwendet.

Voraussetzungen für Windows

  • Führen Sie den folgenden Befehl aus PowerShell aus, um Ihre PowerShell-Version zu ermitteln:

    $PSVersionTable.PSVersion

  • Ermitteln Sie, ob das Modul installiert ist:

    Get-Module -Name Microsoft.Entra -ListAvailable

  • Festlegen der PowerShell-Ausführungsrichtlinie auf Remotesignatur oder weniger restriktiv

    • Überprüfen Sie die PowerShell-Ausführungsrichtlinie:

      Get-ExecutionPolicy -List

    • Legen Sie die PowerShell-Ausführungsrichtlinie auf „Remote signiert“ fest:

      Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

    Weitere Informationen zu Ausführungsrichtlinien finden Sie unter about_Execution_Policies.

Installation

Bei der Installation des Moduls können Sie das gesamte Modul oder ein bestimmtes Untermodul installieren. Die folgenden Beispiele zeigen, wie das gesamte Modul sowohl für v1.0 als auch für Beta installiert wird.

Verwenden Sie das Cmdlet Install-Module , um das Modul zu installieren.

Install-Module -Name Microsoft.Entra -Repository PSGallery -Scope CurrentUser -Force -AllowClobber

Optional können Sie den Bereich der Installation mithilfe des Scope-Parameters ändern. Für diesen Vorgang sind Administratorberechtigungen erforderlich.

Install-Module -Name Microsoft.Entra -Repository PSGallery -Scope AllUsers -Force -AllowClobber

Installieren bestimmter Untermodule

Die Installation bestimmter Module eignet sich ideal für Automatisierungsszenarien wie die Verwendung von Azure Functions und Azure Automation.

Führen Sie den folgenden Befehl aus, um alle Microsoft.Entra GA/v1.0-Module im PowerShell-Katalog auflisten:

Find-Module -Name "Microsoft.Entra*" -Repository PSGallery |
Where-Object { $_.Name -notmatch "beta" }

Dieser Befehl führt alle Microsoft Entra PowerShell-GA/v1.0Module in der PowerShell-Katalog auf.

Führen Sie z. B. den folgenden Befehl aus, um das Users Modul zu installieren:

Install-Module -Name Microsoft.Entra.Users -Repository PSGallery -Force -AllowClobber

Installieren von Microsoft Entra PowerShell unter Linux

Voraussetzungen für Linux

Installation unter Linux

Bei der Installation des Moduls können Sie das gesamte Modul oder ein bestimmtes Untermodul installieren. Das folgende Beispiel zeigt, wie das gesamte Modul installiert wird.

Öffnen Sie die Terminal- oder andere Shellhostanwendung, und führen Sie die Ausführung aus pwsh , um PowerShell zu starten.

Verwenden Sie das Cmdlet Install-Module , um das Modul zu installieren:

Install-Module -Name Microsoft.Entra -Repository PSGallery -Scope CurrentUser -Force -AllowClobber

Optional können Sie den Bereich der Installation mithilfe des Scope-Parameters ändern. Für diesen Vorgang sind Administratorberechtigungen erforderlich.

Install-Module -Name Microsoft.Entra -Repository PSGallery -Scope AllUsers -Force -AllowClobber

Installieren bestimmter Untermodule unter Linux

Die Installation bestimmter Module eignet sich ideal für Automatisierungsszenarien wie die Verwendung von Azure Functions und Azure Automation.

Führen Sie den folgenden Befehl aus, um alle Microsoft.Entra GA/v1.0-Module im PowerShell-Katalog auflisten:

Find-Module -Name "Microsoft.Entra*" -Repository PSGallery |
Where-Object { $_.Name -notmatch "beta" }

Dieser Befehl zeigt alle Microsoft Entra PowerShell GA/v1.0-Module in der PowerShell-Katalog an.

Führen Sie beispielsweise den folgenden Befehl aus, um das Users Modul zu installieren:

Install-Module -Name Microsoft.Entra.Users -Repository PSGallery -Force -AllowClobber

Installieren von Microsoft Entra PowerShell unter macOS

In diesem Artikel wird erläutert, wie Sie das Modul aus dem PowerShell-Katalog unter macOS installieren.

Voraussetzungen unter macOS

Installation unter macOS

Bei der Installation des Moduls können Sie das gesamte Modul oder ein bestimmtes Untermodul installieren. Das folgende Beispiel zeigt, wie das gesamte Modul installiert wird.

Öffnen Sie die Terminal- oder andere Shellhostanwendung, und führen Sie die Ausführung aus pwsh , um PowerShell zu starten.

Verwenden Sie das Cmdlet Install-Module, um das Microsoft Entra PowerShell-Modul zu installieren:

Install-Module -Name Microsoft.Entra -Repository PSGallery -Scope CurrentUser -Force -AllowClobber

Optional können Sie den Bereich der Installation mithilfe des Scope-Parameters ändern. Für diesen Vorgang sind Administratorberechtigungen erforderlich.

Install-Module -Name Microsoft.Entra -Repository PSGallery -Scope AllUsers -Force -AllowClobber

Installieren bestimmter Untermodule unter macOS

Die Installation bestimmter Module eignet sich ideal für Automatisierungsszenarien wie die Verwendung von Azure Functions und Azure Automation.

Führen Sie den folgenden Befehl aus, um alle Microsoft.Entra GA/v1.0-Module im PowerShell-Katalog auflisten:

Find-Module -Name "Microsoft.Entra*" -Repository PSGallery |
Where-Object { $_.Name -notmatch "beta" }

Dieser Befehl führt alle Microsoft Entra PowerShell-GA/v1.0Module in der PowerShell-Katalog auf.

Führen Sie beispielsweise den folgenden Befehl aus, um das Users Modul zu installieren:

Install-Module -Name Microsoft.Entra.Users -Repository PSGallery -Force -AllowClobber

Überprüfen der installierten Modulversion und des Speicherorts

Nach Abschluss der Installation können Sie die installierten Untermodule, deren Version und Speicherort mit dem folgenden Befehl überprüfen.

Get-InstalledModule -Name Microsoft.Entra* |
Where-Object { $_.Name -notmatch "Beta" } | Format-Table Name, Version, InstalledLocation -AutoSize

Dieser Befehl zeigt das installierte Microsoft Entra PowerShell-Modul, dessen Version und Installationsspeicherort an. Die Ausgabeversion sollte mit der neuesten Version des PowerShell-Katalog übereinstimmen. Jetzt können Sie das Modul verwenden.

Name                                Version InstalledLocation
----                                ------- -----------------
Microsoft.Entra                     1.0.1   <PowerShell-Path>\PowerShell\Modules\Microsoft.Entra\1.0.1
Microsoft.Entra.Applications        1.0.1   <PowerShell-Path>\PowerShell\Modules\Microsoft.Entra.Applications\1.0.1
Microsoft.Entra.Authentication      1.0.1   <PowerShell-Path>\PowerShell\Modules\Microsoft.Entra.Authentication\1.0.1
Microsoft.Entra.DirectoryManagement 1.0.1   <PowerShell-Path>\PowerShell\Modules\Microsoft.Entra.DirectoryManagement\1.0.1
Microsoft.Entra.Governance          1.0.1   <PowerShell-Path>\PowerShell\Modules\Microsoft.Entra.Governance\1.0.1
Microsoft.Entra.Groups              1.0.1   <PowerShell-Path>\PowerShell\Modules\Microsoft.Entra.Groups\1.0.1
Microsoft.Entra.Reports             1.0.1   <PowerShell-Path>\PowerShell\Modules\Microsoft.Entra.Reports\1.0.1
Microsoft.Entra.SignIns             1.0.1   <PowerShell-Path>\PowerShell\Modules\Microsoft.Entra.SignIns\1.0.1
Microsoft.Entra.Users               1.0.1   <PowerShell-Path>\PowerShell\Modules\Microsoft.Entra.Users\1.0.1

Um zu prüfen, ob ein bestimmtes Untermodul, zum Beispiel Users, installiert ist, führen Sie Folgendes aus:

Get-InstalledModule -Name Microsoft.Entra.Users

Die Ausgabeversion sollte mit der neuesten Version des PowerShell-Katalog übereinstimmen.

Version              Name                                Repository           Description
-------              ----                                ----------           -----------
1.0.1                Microsoft.Entra.Users               PSGallery            Microsoft Entra PowerShell

Behandlung von Installationsproblemen

Error Ursache Workaround
Install-Module: Ein Parameter kann nicht gefunden werden, der dem Parameternamen AllowPrerelease entspricht. Sie verwenden eine ältere Version von Install-Module. Folgen Sie diesem Leitfaden, um ein Upgrade durchzuführen. Das Problem gilt nur für Windows Plattform.
Abhängiges Modul "Modulname" ist auf diesem Computer nicht installiert. Um das aktuelle Modul 'Microsoft.Entra,' zu verwenden, stellen Sie sicher, dass das abhängige Modul 'module-name' installiert ist. Microsoft Entra PowerShell-Abhängigkeiten sind nicht installiert Verwenden Sie dieses Skript, um es zu installieren.
Cmdlets sind bereits auf dem System vorhanden Parameter hinzufügen -AllowClobber : Install-Module -Name Microsoft.Entra -Repository PSGallery -Force -AllowClobber
Die folgenden Befehle sind bereits auf diesem System verfügbar: "Enable-EntraAzureADAlias,Get-EntraUnsupportedCommand,Test-EntraScript" Es gibt einen Konflikt, wenn entweder Beta oder v1.0 bereits installiert ist Um das Problem zu beheben, deinstallieren Sie die problematische Modulversion.

Lösungen für andere allgemeine Installations- und andere allgemeine Probleme finden Sie unter "Problembehandlung bei Modulinstallationsproblemen".

Anmelden

Um mit der Verwaltung Ihrer Microsoft Entra-Ressourcen mit dem Microsoft Entra PowerShell-Modul zu beginnen, starten Sie eine PowerShell-Sitzung, und führen Sie Connect-Entra aus, um sich bei Microsoft Entra ID anzumelden:

Connect-Entra -Scopes 'User.Read.All'
Get-EntraUser -Filter "userPrincipalName eq 'SawyerM@contoso.com'"

Verwenden Sie Ihre Microsoft Entra Anmeldeinformationen, um sich beim daraufhin geöffneten Anmeldefenster anzumelden.

Sie müssen diesen Schritt für jede neue PowerShell-Sitzung wiederholen, die Sie starten.

Weitere Informationen zu anderen Authentifizierungsszenarien finden Sie in weiteren Authentifizierungsszenarien.

Aktualisieren des Moduls

Wenn das Modul installiert ist, führen Sie die folgenden Schritte aus, um es zu aktualisieren.

Überprüfen Sie zunächst die Modulversion und den Speicherort mithilfe der Anleitungen im Abschnitt "Installation überprüfen " in diesem Artikel.

Aktualisieren auf die neueste Version

Verwenden Sie "Update-Module", um auf die neueste Version des Microsoft Entra PowerShell-Moduls zu aktualisieren.

Update-Module -Name Microsoft.Entra -Force

Führen Sie folgenden Befehl aus, um ein bestimmtes Untermodul zu aktualisieren, wie z. B. Users:

Update-Module -Name Microsoft.Entra.Users -Force

Das Aktualisieren des Microsoft Entra PowerShell-Moduls mit Update-Module entfernt keine alten Versionen des Moduls von Ihrem System.

Deinstallieren des Moduls

Führen Sie den Befehl aus, um das Modul zu entfernen:

Uninstall-Module -Name Microsoft.Entra -AllVersions -Force

Führen Sie Folgendes aus, um ein bestimmtes Untermodul, wie Users, zu deinstallieren:

Uninstall-Module -Name Microsoft.Entra.Users -AllVersions -Force

Führen Sie Folgendes aus, um alle Untermodule zu deinstallieren:

$InstalledSubModules = Get-InstalledModule -Name Microsoft.Entra.* |
Where-Object { $_.Name -notmatch "Beta" }
foreach ($module in $InstalledSubModules) {
    Write-Host "Checking for submodule: $($module.Name)" -ForegroundColor Yellow -BackgroundColor DarkBlue
    Uninstall-Module -Name $module.Name -Force -ErrorAction Stop
    Write-Host "Successfully uninstalled submodule: $($module.Name)" -ForegroundColor Green
}

Nächste Schritte

  • Last updated on