Problembehandlung für häufige Fehler in Microsoft Entra PowerShell

In diesem Artikel wird erläutert, wie Sie Probleme ermitteln, diagnostizieren und beheben, die bei der Verwendung von Microsoft Entra PowerShell auftreten können.

Stellen Sie vor der Problembehandlung sicher, dass Sie die neueste Version der Microsoft Entra PowerShell ausführen. Um die Version Ihres installierten Moduls zu überprüfen, führen Sie Folgendes aus:

Get-InstalledModule -Name Microsoft.Entra

Die Version des Microsoft.Entra-Moduls sollte der neuesten veröffentlichten Version in der PowerShell-Katalog entsprechen. Wenn Ihr installiertes Modul nicht auf dem neuesten Stand ist, aktualisieren Sie es, indem Sie Folgendes ausführen:

Update-Module -Name Microsoft.Entra

Installationsprobleme

Während der Installation können Einige Fehler auftreten, die verhindern, dass das Modul ordnungsgemäß installiert wird. Im Folgenden finden Sie einige häufige Probleme und deren Lösungen.

AllowPrerelease-Parameter kann nicht gefunden werden

Möglicherweise wird eine Fehlermeldung angezeigt, wenn Sie eine ältere Version von Install-Module verwenden: "Install-Module: Ein Parameter kann nicht gefunden werden, der dem Parameternamen AllowPrereleaseentspricht". Führen Sie zum Beheben dieses Fehlers die folgenden Befehle aus, um ein Upgrade auszuführen:

## Update Nuget Package and PowerShellGet Module 

Install-PackageProvider NuGet -Scope CurrentUser -Force 

Install-Module PowerShellGet -Scope CurrentUser -Force -AllowClobber 

## Remove old modules from existing session 

Remove-Module PowerShellGet,PackageManagement -Force -ErrorAction Ignore 

## Import updated module 

Import-Module PowerShellGet -MinimumVersion 2.0 -Force 

Import-PackageProvider PowerShellGet -MinimumVersion 2.0 -Force

Funktionskapazität 4096 wurde für diesen Bereich überschritten.

In PowerShell 5.1 wird möglicherweise der Fehler angezeigt: "Funktion {cmdlet-name} kann nicht erstellt werden, weil die Funktionskapazität 4096 überschritten wurde." Um diesen Fehler zu beheben, erhöhen Sie die Funktionsgrenze, indem Sie den folgenden Befehl ausführen, und versuchen Sie dann erneut, das Modul zu importieren.

$MaximumFunctionCount = 32768

Befehle, die bereits im Modul verfügbar sind

Wenn ein Konflikt auftritt, wenn entweder Beta oder v1.0 bereits installiert ist, wird möglicherweise der Fehler angezeigt: "Die folgenden Befehle sind auf diesem System bereits verfügbar: Enable-EntraAzureADAlias, Get-EntraUnsupportedCommand, Test-EntraScript." Beheben Sie diesen Fehler, indem Sie den Parameter -AllowClobber hinzufügen und den Befehl erneut ausführen.

Fehlende Abhängigkeiten

Wenn Microsoft Entra PowerShell-Abhängigkeiten nicht installiert sind, wird möglicherweise der Fehler angezeigt: "Abhängiges Modul module-name ist auf diesem Computer nicht installiert. Um das aktuelle Modul Microsoft.Entrazu verwenden, stellen Sie sicher, dass das abhängige Modul module-name installiert ist." Um diesen Fehler zu beheben, installieren Sie die Abhängigkeiten mithilfe des folgenden Skripts:

  • Installieren Sie die Abhängigkeiten für das Microsoft Graph PowerShell SDK v1.0.
$RequiredModules = (@'
Microsoft.Graph.DirectoryObjects
Microsoft.Graph.Users
Microsoft.Graph.Users.Actions
Microsoft.Graph.Users.Functions
Microsoft.Graph.Groups
Microsoft.Graph.Identity.DirectoryManagement
Microsoft.Graph.Identity.Governance
Microsoft.Graph.Identity.SignIns
Microsoft.Graph.Applications
'@).Split("`n")

# Check if the pre-requisite modules are installed and install them if needed
foreach ($module in $RequiredModules) {
    Write-Host -ForegroundColor Yellow -BackgroundColor DarkBlue "Checking for $module"
    if (!(Get-Module -Name $module -ListAvailable)) {
        Install-Module -Name $module -Scope CurrentUser
    }
}

<# Attribution: https://github.com/SamErde and https://github.com/alexandair #>

Authentifizierungsprobleme

Fehler beim Authentifizieren oder Empfangen von Token können zu einer Antwort "401 Nicht autorisiert" führen. Dieser Fehler kann mehrere Ursachen haben. Um diesen Fehler zu beheben, stellen Sie sicher, dass Sie die richtigen Anmeldeinformationen verwenden und über ausreichende Berechtigungen verfügen. Überprüfen Sie, ob Ihre App-Registrierungen (falls zutreffend) ordnungsgemäß mit den erforderlichen API-Berechtigungen in Microsoft Entra ID konfiguriert sind.

Cmdlet wurde nicht erkannt

PowerShell erkennt das Cmdlet, das Sie ausführen möchten, nicht. Um diesen Fehler zu beheben, stellen Sie sicher, dass das Microsoft Entra PowerShell-Modul ordnungsgemäß installiert ist. Sie können diesen Status überprüfen, indem Sie Folgendes ausführen:

Get-Module -Name Microsoft.Entra -ListAvailable

Wenn das Modul nicht aufgeführt ist, installieren Sie es mit:

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

Versionskonflikte

Möglicherweise treten Fehler auf, die angeben, dass mehrere Versionen des Moduls installiert sind, z. B. die Meldung "Assembly mit demselben Namen ist bereits geladen". Um diesen Fehler zu beheben, deinstallieren Sie alle widersprüchlichen Versionen des Moduls, und installieren Sie dann die neueste Version:

Install-Module <Module-Name> -Required Version x.x

Berechtigungsfehler

Möglicherweise erhalten Sie Fehler im Zusammenhang mit unzureichenden Berechtigungen, wenn Sie versuchen, Befehle oder Skripts auszuführen. Um diesen Fehler zu beheben, stellen Sie sicher, dass Sie über die erforderlichen Berechtigungen zum Ausführen des Vorgangs verfügen. Möglicherweise müssen Sie die Berechtigungen im Microsoft Entra Admin Center anpassen.

Probleme beim Aktualisieren von Modulen

Beim Versuch, das Microsoft Entra PowerShell-Modul zu aktualisieren, treten möglicherweise Probleme auf. Verwenden Sie zum Beheben dieses Fehlers den Codeausschnitt, um die neueste Version zu installieren. Wenn Fehler auftreten, versuchen Sie, das Modul zu deinstallieren und dann erneut zu installieren.

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

Leistungsprobleme

Ihre Skripts oder Befehle werden möglicherweise langsam oder nicht wie erwartet ausgeführt. Um dies zu beheben, sollten Sie Ihre Abfragen so verfeinern, dass nur erforderliche Daten abgerufen werden, indem Sie Filter verwenden und bestimmte Eigenschaften auswählen. Erhöhen Sie bei Bedarf Timeouts.

Behandlung von Fehlern

Möglicherweise erhalten Sie Fehler aus dem Microsoft Entra PowerShell-Modul, das schwer zu verstehen oder zu verwalten ist. Verwenden Sie $Error[0].Exception | Format-List -Force, um detaillierte Fehlerinformationen zu erhalten und diesen Fehler zu beheben. Die Informationen können ihnen dabei helfen, die API-Antwort und die Problembehandlung weiter zu verstehen.

Der Proxy blockiert die Verbindung.

Wenn Sie von Install-Module die Fehlermeldung erhalten, dass die PowerShell-Katalog nicht erreichbar ist, befinden Sie sich möglicherweise hinter einem Proxy. Verschiedene Betriebssysteme und Netzwerkumgebungen haben unterschiedliche Anforderungen an die Konfiguration eines systemweiten Proxys. Wenden Sie sich an Ihren Systemadministrator, um Ihre Proxyeinstellungen zu erhalten und zu erfahren, wie Sie sie für Ihre Umgebung konfigurieren können.

PowerShell selbst ist möglicherweise nicht für die automatische Verwendung dieses Proxys konfiguriert. Konfigurieren Sie mit PowerShell 5.1 und höher die PowerShell-Sitzung für die Verwendung eines Proxys mithilfe der folgenden Befehle:

$webClient = New-Object -TypeName System.Net.WebClient
$webClient.Proxy.Credentials = [System.Net.CredentialCache]::DefaultNetworkCredentials

Wenn Ihre Betriebssystemanmeldeinformationen ordnungsgemäß konfiguriert sind, leitet diese Konfiguration PowerShell-Anforderungen über den Proxy weiter. Damit diese Einstellung zwischen Sitzungen beibehalten werden kann, fügen Sie dem PowerShell-Profil die Befehle hinzu.

Ihr Proxy muss HTTPS-Verbindungen mit www.powershellgallery.com zulassen, damit das Paket installiert werden kann.

Andere Probleme

Wenn ein Produktproblem mit Microsoft Entra PowerShell in diesem Artikel nicht aufgeführt ist oder weitere Unterstützung erforderlich ist, melden Sie ein Problem auf GitHub.

  • Zuletzt aktualisiert um