Veelvoorkomende fouten in Microsoft Entra PowerShell oplossen

In dit artikel wordt uitgelegd hoe u problemen kunt vaststellen, diagnosticeren en oplossen die kunnen optreden bij het gebruik van Microsoft Entra PowerShell.

Voordat u eventuele fouten gaat oplossen, moet u ervoor zorgen dat u de meest recente versie van de Microsoft Entra PowerShell uitvoert. Voer de volgende opdracht uit om de versie van de geïnstalleerde module te controleren:

Get-InstalledModule -Name Microsoft.Entra

De versie van de Microsoft.Entra-module moet overeenkomen met de meest recente release in de PowerShell Gallery. Als uw geïnstalleerde module niet up-to-date is, werkt u deze bij door het volgende uit te voeren:

Update-Module -Name Microsoft.Entra

Installatieproblemen

Tijdens de installatie kunt u enkele fouten tegenkomen waardoor de module niet correct kan worden geïnstalleerd. Hier volgen enkele veelvoorkomende problemen en hun oplossingen.

De parameter AllowPrerelease kan niet worden gevonden

Mogelijk krijgt u een foutmelding als u een oudere versie van Install-Module gebruikt: 'Install-Module: A parameter can't found that matches parameter name AllowPrerelease.' Voer de volgende opdrachten uit om een upgrade uit te voeren om deze fout op te lossen:

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

De functiecapaciteit van 4096 is overschreden voor deze scope

In PowerShell 5.1 ziet u mogelijk de fout: 'Functie {cmdlet-name} kan niet worden gemaakt omdat de functiecapaciteit 4096 is overschreden.' Als u deze fout wilt oplossen, verhoogt u de functielimiet door de volgende opdracht uit te voeren en probeert u de module opnieuw te importeren.

$MaximumFunctionCount = 32768

Opdrachten die al beschikbaar zijn in de module

Als er een conflict is wanneer een van Beta beide of v1.0 al is geïnstalleerd, ziet u mogelijk de volgende foutmelding: "De volgende opdrachten zijn al beschikbaar op dit systeem: Enable-EntraAzureADAlias, Get-EntraUnsupportedCommand, Test-EntraScript." Los deze fout op door de -AllowClobber parameter toe te voegen en de opdracht opnieuw uit te voeren.

Ontbrekende afhankelijkheden

Wanneer Microsoft Entra PowerShell-afhankelijkheden niet zijn geïnstalleerd, ziet u mogelijk de volgende fout: 'Afhankelijke module module-name is niet geïnstalleerd op deze computer. Als u de huidige module Microsoft.Entrawilt gebruiken, moet u ervoor zorgen dat de afhankelijke module module-name is geïnstalleerd." Als u deze fout wilt oplossen, installeert u de afhankelijkheden met behulp van het volgende script:

  • Installeer Microsoft Graph PowerShell SDK v1.0 afhankelijkheden.
$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 #>

Verificatieproblemen

Als u tokens niet kunt verifiëren of ontvangen, kan dit resulteren in een '401 Niet-geautoriseerd' antwoord. Deze fout kan om verschillende redenen optreden. U kunt deze fout oplossen door ervoor te zorgen dat u de juiste referenties gebruikt en over voldoende machtigingen beschikt. Controleer of uw app-registraties (indien van toepassing) correct zijn geconfigureerd met de benodigde API-machtigingen in Microsoft Entra ID.

Cmdlet niet herkend

PowerShell herkent de cmdlet die u probeert uit te voeren niet. U kunt deze fout oplossen door ervoor te zorgen dat de Microsoft Entra PowerShell-module correct is geïnstalleerd. U kunt deze status controleren door het volgende uit te voeren:

Get-Module -Name Microsoft.Entra -ListAvailable

Als de module niet wordt vermeld, installeert u deze met behulp van:

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

Versieconflicten

Er kunnen fouten optreden die aangeven dat er meerdere versies van de module zijn geïnstalleerd, zoals het bericht 'Assembly met dezelfde naam is al geladen.' Als u deze fout wilt oplossen, verwijdert u alle conflicterende versies van de module en installeert u vervolgens de nieuwste versie:

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

Machtigingsfouten

Mogelijk ontvangt u fouten met betrekking tot onvoldoende machtigingen bij het uitvoeren van opdrachten of scripts. U kunt deze fout oplossen door ervoor te zorgen dat u over de benodigde machtigingen beschikt om de bewerking uit te voeren. Mogelijk moet u machtigingen aanpassen in de Microsoft Entra-beheercentrum.

Problemen met module-updates

U kunt problemen ondervinden bij het bijwerken van de Microsoft Entra PowerShell-module. Als u deze fout wilt oplossen, gebruikt u het codefragment om de nieuwste versie te installeren. Als er fouten zijn, verwijdert u de module en installeert u deze opnieuw.

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

Prestatieproblemen

Uw scripts of opdrachten worden mogelijk langzaam uitgevoerd of worden niet voltooid zoals verwacht. U kunt dit oplossen door uw query's te verfijnen om alleen benodigde gegevens op te halen, filters te gebruiken en specifieke eigenschappen te selecteren. Verhoog indien nodig de time-outs.

Afhandeling van fouten

Mogelijk ontvangt u fouten van de Microsoft Entra PowerShell-module die moeilijk te begrijpen of te beheren zijn. Gebruik $Error[0].Exception | Format-List -Force om gedetailleerde foutinformatie te krijgen en deze fout op te lossen. De informatie kan helpen bij het begrijpen van het API-antwoord en het oplossen van problemen.

Proxy blokkeert verbinding

Als u van Install-Module fouten krijgt dat de PowerShell Gallery niet bereikbaar is, zit u mogelijk achter een proxy. Verschillende besturingssystemen en netwerkomgevingen hebben verschillende vereisten om een systeembrede proxy te configureren. Neem contact op met uw systeembeheerder voor uw proxy-instellingen en hoe u deze configureert voor uw omgeving.

PowerShell zelf is mogelijk niet geconfigureerd om deze proxy automatisch te gebruiken. Configureer met PowerShell 5.1 en hoger de PowerShell-sessie om een proxy te gebruiken met behulp van de volgende opdrachten:

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

Als de referenties van uw besturingssysteem correct zijn geconfigureerd, routeert deze configuratie PowerShell-aanvragen via de proxy. Als u deze instelling tussen verschillende sessies wilt behouden, voegt u de opdracht toe aan een PowerShell-profiel.

Als u het pakket wilt installeren, moet uw proxy HTTPS-verbindingen met www.powershellgallery.com toestaan.

Overige problemen

Als u een productprobleem ondervindt met Microsoft Entra PowerShell dat niet in dit artikel wordt vermeld of als u meer hulp nodig hebt, kunt u een probleem indienen bij GitHub.

  • Laatst bijgewerkt om