Rozwiązywanie typowych błędów w programie Microsoft Entra PowerShell

W tym artykule wyjaśniono, jak określić, zdiagnozować i rozwiązać problemy, które mogą wystąpić podczas korzystania z programu Microsoft Entra PowerShell.

Przed rozwiązaniem problemów z wszelkimi błędami upewnij się, że używasz najnowszej wersji programu Microsoft Entra PowerShell. Aby sprawdzić wersję zainstalowanego modułu, uruchom polecenie:

Get-InstalledModule -Name Microsoft.Entra

Wersja modułu Microsoft.Entra powinna odpowiadać najnowszemu wydaniu w Galeria programu PowerShell. Jeśli zainstalowany moduł nie jest aktualny, zaktualizuj go, uruchamiając polecenie:

Update-Module -Name Microsoft.Entra

Problemy z instalacją

Podczas instalacji mogą wystąpić błędy, które uniemożliwiają poprawne zainstalowanie modułu. Poniżej przedstawiono niektóre typowe problemy i ich rozwiązania.

Nie można odnaleźć parametru AllowPrerelease

Jeśli używasz starszej wersji modułu Install-Module, może wystąpić błąd: "Install-Module: Nie można odnaleźć parametru zgodnego z nazwą AllowPrereleaseparametru ". Aby rozwiązać ten błąd, uruchom następujące polecenia, aby uaktualnić:

## 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

Przekroczono limit 4096 funkcji w tym zakresie

W programie PowerShell 5.1 może zostać wyświetlony błąd: "Nie można utworzyć funkcji {nazwa-polecenia cmdlet}, ponieważ przekroczono pojemność funkcji 4096". Aby naprawić ten błąd, zwiększ limit funkcji, uruchamiając następujące polecenie, a następnie spróbuj ponownie zaimportować moduł.

$MaximumFunctionCount = 32768

Polecenia dostępne już w module

Jeśli wystąpi konflikt, gdy zainstalowano już Beta lub v1.0, może zostać wyświetlony błąd: "Następujące polecenia są już dostępne w tym systemie: Enable-EntraAzureADAlias, Get-EntraUnsupportedCommand, Test-EntraScript." Aby naprawić ten błąd, dodaj parametr -AllowClobber i ponownie uruchom polecenie.

Brak zależności

Jeśli zależności programu Microsoft Entra PowerShell nie są zainstalowane, może zostać wyświetlony następujący błąd: "Moduł zależny module-name nie jest zainstalowany na tym komputerze. Aby użyć bieżącego modułu Microsoft.Entra, upewnij się, że jego moduł zależny module-name jest zainstalowany." Aby naprawić ten błąd, zainstaluj zależności przy użyciu następującego skryptu:

  • Zainstaluj zależności pakietu 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 #>

Problemy z uwierzytelnianiem

Niepowodzenie uwierzytelniania lub odbierania tokenów może spowodować odpowiedź "401 Brak autoryzacji". Ten błąd może wystąpić z kilku powodów. Aby naprawić ten błąd, upewnij się, że używasz poprawnych poświadczeń i masz wystarczające uprawnienia. Sprawdź, czy rejestracje aplikacji (jeśli dotyczy) są poprawnie skonfigurowane z niezbędnymi uprawnieniami interfejsu API w Microsoft Entra ID.

Polecenie cmdlet nie zostało rozpoznane

Program PowerShell nie rozpoznaje polecenia cmdlet, które próbujesz uruchomić. Aby naprawić ten błąd, upewnij się, że moduł Microsoft Entra PowerShell jest poprawnie zainstalowany. Ten stan można sprawdzić, uruchamiając polecenie:

Get-Module -Name Microsoft.Entra -ListAvailable

Jeśli moduł nie znajduje się na liście, zainstaluj go przy użyciu:

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

Konflikty wersji

Mogą wystąpić błędy wskazujące, że zainstalowano wiele wersji modułu, na przykład komunikat "Zestaw o tej samej nazwie jest już załadowany". Aby rozwiązać ten błąd, odinstaluj wszystkie powodujące konflikty wersje modułu, a następnie zainstaluj najnowszą wersję:

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

Błędy uprawnień

Podczas próby wykonania poleceń lub skryptów mogą wystąpić błędy związane z niewystarczającymi uprawnieniami. Aby naprawić ten błąd, upewnij się, że masz uprawnienia niezbędne do wykonania operacji. Może być konieczne dostosowanie uprawnień w centrum administracyjne Microsoft Entra.

Problemy z aktualizacją modułu

Podczas próby zaktualizowania modułu programu Microsoft Entra PowerShell mogą wystąpić problemy. Aby naprawić ten błąd, użyj fragmentu kodu, aby zainstalować najnowszą wersję. Jeśli występują błędy, spróbuj odinstalować , a następnie ponownie zainstalować moduł.

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

Problemy z wydajnością

Skrypty lub polecenia mogą działać wolno lub nie są wykonywane zgodnie z oczekiwaniami. Aby rozwiązać ten problem, rozważ uściślinie zapytań w celu pobrania tylko niezbędnych danych, przy użyciu filtrów i wybraniu określonych właściwości. Zwiększ limity czasu, jeśli to konieczne.

Obsługa błędów

W module Microsoft Entra PowerShell mogą występować błędy, które są trudne do zrozumienia lub zarządzania. Aby naprawić ten błąd, użyj polecenia $Error[0].Exception | Format-List -Force , aby uzyskać szczegółowe informacje o błędzie. Informacje te mogą pomóc w dalszym zrozumieniu odpowiedzi interfejsu API i rozwiązywaniu problemów.

Serwer proxy blokuje połączenie

Jeśli z Install-Module otrzymasz komunikaty o błędzie informujące, że usługa Galeria programu PowerShell jest niedostępna, być może korzystasz z serwera proxy. Różne systemy operacyjne i środowisko sieciowe mają różne wymagania dotyczące konfigurowania serwera proxy dla całego systemu. Skontaktuj się z administratorem systemu w celu uzyskania informacji o ustawieniach serwera proxy oraz sposobie konfigurowania ich dla Twojego środowiska.

Sam program PowerShell może nie być skonfigurowany do automatycznego używania tego serwera proxy. Za pomocą programu PowerShell 5.1 lub nowszego skonfiguruj sesję programu PowerShell do użycia serwera proxy, wydając następujące polecenia:

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

Jeśli poświadczenia systemu operacyjnego są poprawnie skonfigurowane, ta konfiguracja kieruje żądania programu PowerShell za pośrednictwem serwera proxy. Aby to ustawienie utrzymywało się między sesjami, dodaj te polecenia do profilu programu PowerShell.

Aby zainstalować pakiet, serwer proxy musi zezwolić na połączenia HTTPS z www.powershellgallery.com.

Inne problemy

Jeśli wystąpi problem z produktem z programem Microsoft Entra PowerShell, który nie został wymieniony w tym artykule lub potrzebujesz dalszej pomocy, zgłoś problem w GitHub.

  • Last updated on