Felsöka vanliga fel i Microsoft Entra PowerShell

Den här artikeln beskriver hur du fastställer, diagnostiserar och åtgärdar problem som kan uppstå när du använder Microsoft Entra PowerShell.

Innan du felsöker några fel kontrollerar du att du kör den senaste versionen av Microsoft Entra PowerShell. Om du vill kontrollera versionen av den installerade modulen kör du:

Get-InstalledModule -Name Microsoft.Entra

Versionen av Microsoft. Entra-modulen bör vara den senaste jämfört med den senaste versionen i PowerShell Gallery. Om den installerade modulen inte är uppdaterad uppdaterar du den genom att köra:

Update-Module -Name Microsoft.Entra

Problem med installation

Under installationen kan du stöta på några fel som förhindrar att modulen installeras korrekt. Här följer några vanliga problem och deras lösningar.

Det går inte att hitta parametern AllowPrerelease

Du kan få ett felmeddelande om du använder en äldre version av Install-Module: "Install-Module: Det går inte att hitta någon parameter som motsvarar parameternamnet AllowPrerelease." Lös problemet genom att köra följande kommandon för att uppgradera:

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

Funktionskapaciteten 4096 har överskridits för det här omfånget

I PowerShell 5.1 kan du se felet: "Det går inte att skapa funktionen {cmdlet-name} eftersom funktionskapaciteten 4096 har överskridits." Åtgärda det här felet genom att öka funktionsgränsen genom att köra följande kommando och sedan försöka importera modulen igen.

$MaximumFunctionCount = 32768

Kommandon som redan är tillgängliga i modulen

Om det uppstår en konflikt när någon av Beta eller v1.0 redan är installerad kan du se felet: "Följande kommandon är redan tillgängliga i det här systemet: Enable-EntraAzureADAlias, Get-EntraUnsupportedCommand, Test-EntraScript." Åtgärda det här felet genom att lägga till parametern -AllowClobber och köra kommandot igen.

Beroenden saknas

När Microsoft Entra PowerShell-beroenden inte är installerade kan du se felet: "Beroende modul module-name är inte installerad på den här datorn. Om du vill använda den aktuella modulen Microsoft.Entrakontrollerar du att den beroende modulen module-name är installerad." Åtgärda det här felet genom att installera beroendena med hjälp av följande skript:

  • Installera beroenden för Microsoft Graph PowerShell-programvaruutvecklingspaketet 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 #>

Autentiseringsproblem

Om det inte går att autentisera eller ta emot token kan det resultera i ett "401 Obehörigt" svar. Detta fel kan uppstå av flera anledningar. Åtgärda det här felet genom att kontrollera att du använder rätt autentiseringsuppgifter och har tillräcklig behörighet. Kontrollera att appregistreringarna (om tillämpligt) är korrekt konfigurerade med nödvändiga API-behörigheter i Microsoft Entra ID.

Cmdlet känns inte igen

PowerShell känner inte igen den cmdlet som du försöker köra. Åtgärda det här felet genom att kontrollera att Microsoft Entra PowerShell-modulen är korrekt installerad. Du kan kontrollera den här statusen genom att köra:

Get-Module -Name Microsoft.Entra -ListAvailable

Om modulen inte visas installerar du den med hjälp av:

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

Versionskonflikter

Du kan stöta på fel som anger att flera versioner av modulen är installerade, till exempel meddelandet "Sammansättning med samma namn har redan lästs in". Åtgärda det här felet genom att avinstallera alla motstridiga versioner av modulen och sedan installera den senaste versionen:

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

Behörighetsfel

Du kan få fel som rör otillräcklig behörighet när du försöker köra kommandon eller skript. Åtgärda det här felet genom att kontrollera att du har de behörigheter som krävs för att utföra åtgärden. Du kan behöva justera behörigheter i Microsoft Entra administrationscenter.

Problem med moduluppdatering

Du kan stöta på problem när du försöker uppdatera Microsoft Entra PowerShell-modulen. Åtgärda det här felet genom att använda kodfragmentet för att installera den senaste versionen. Om det finns fel kan du prova att avinstallera och sedan installera om modulen.

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

Prestandaproblem

Dina skript eller kommandon kanske körs långsamt eller inte slutförs som förväntat. Du kan åtgärda det genom att förfina dina frågor så att de endast hämtar nödvändiga data med hjälp av filter och välja specifika egenskaper. Öka tidsgränserna om det behövs.

Hantering av fel

Du kan få fel från Microsoft Entra PowerShell-modulen som är svår att förstå eller hantera. Du kan åtgärda det här felet genom att använda $Error[0].Exception | Format-List -Force för att hämta detaljerad felinformation. Informationen kan hjälpa dig att förstå API-svaret och felsöka ytterligare.

Proxy blockerar anslutning

Om du får fel från Install-Module om att PowerShell Gallery inte går att nå, kanske du befinner dig bakom en proxyserver. Olika operativsystem och nätverksmiljöer har olika krav för att konfigurera en systemomfattande proxy. Kontakta systemadministratören för dina proxyinställningar och hur du konfigurerar dem för din miljö.

PowerShell själv kanske inte konfigureras för att använda den här proxyn automatiskt. Med PowerShell 5.1 och senare konfigurerar du PowerShell-sessionen så att den använder en proxy med hjälp av följande kommandon:

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

Om dina autentiseringsuppgifter för operativsystemet är korrekt konfigurerade dirigerar den här konfigurationen PowerShell-begäranden via proxyn. För att den här inställningen ska finnas kvar mellan sessionerna lägger du till kommandona i en PowerShell-profil.

För att installera paketet måste proxyn tillåta till HTTPS-anslutningar www.powershellgallery.com.

Övriga frågor

Om du stöter på ett produktproblem med Microsoft Entra PowerShell som inte finns med i den här artikeln eller behöver ytterligare hjälp kan du skicka in ett problem på GitHub.

  • Uppdaterades senast