Résoudre les erreurs courantes dans Microsoft Entra PowerShell

Cet article explique comment déterminer, diagnostiquer et résoudre les problèmes que vous pouvez rencontrer lors de l’utilisation de Microsoft Entra PowerShell.

Avant de résoudre les erreurs, vérifiez que vous exécutez la version la plus récente de la Microsoft Entra PowerShell. Pour vérifier la version de votre module installé, exécutez :

Get-InstalledModule -Name Microsoft.Entra

La version du module Microsoft.Entra doit être la plus récente par rapport à la dernière version publiée dans la PowerShell Gallery. Si votre module installé n’est pas à jour, mettez-le à jour en exécutant :

Update-Module -Name Microsoft.Entra

Problèmes d’installation

Pendant l’installation, vous pouvez rencontrer des erreurs qui empêchent l’installation correcte du module. Voici quelques problèmes courants et leurs solutions.

Le paramètre AllowPrerelease est introuvable

Vous risquez d’obtenir une erreur si vous utilisez une version antérieure d’Install-Module : « Install-Module : Un paramètre est introuvable qui correspond au nom AllowPrereleasedu paramètre . » Pour corriger cette erreur, exécutez les commandes suivantes pour effectuer la mise à niveau :

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

La capacité de fonction 4096 a été dépassée pour cette étendue

Dans PowerShell 5.1, vous pouvez voir l’erreur suivante : « La fonction {cmdlet-name} ne peut pas être créée, car la capacité de fonction 4096 a été dépassée. » Pour corriger cette erreur, augmentez la limite de fonction en exécutant la commande suivante, puis réessayez d’importer le module.

$MaximumFunctionCount = 32768

Commandes déjà disponibles dans le module

S’il existe un conflit lorsque l’une ou l’autre Beta est déjà installée, l’erreur peut s’afficher : « Test-EntraScript» Corrigez cette erreur en ajoutant le -AllowClobber paramètre et en réexécutant la commande.

Dépendances manquantes

Lorsque Microsoft Entra dépendances PowerShell ne sont pas installées, vous pouvez voir l'erreur suivante : « Le module module-name dépendant n'est pas installé sur cet ordinateur. Pour utiliser le module Microsoft.Entraactuel, vérifiez que son module module-name dépendant est installé.« Pour corriger cette erreur, installez les dépendances à l’aide du script suivant :

  • Installez les dépendances de Microsoft Graph - SDK PowerShell 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 #>

Problèmes d’authentification

L’échec de l’authentification ou de réception des jetons peut entraîner une réponse « 401 Non autorisé ». Cette erreur peut se produire pour plusieurs raisons : Pour corriger cette erreur, vérifiez que vous utilisez les informations d’identification correctes et disposez d’autorisations suffisantes. Vérifiez que les inscriptions de votre application (le cas échéant) sont correctement configurées avec les autorisations d’API nécessaires dans Microsoft Entra ID.

Cmdlet non reconnue

PowerShell ne reconnaît pas l’applet de commande que vous essayez d’exécuter. Pour corriger cette erreur, vérifiez que le module PowerShell Microsoft Entra est installé correctement. Vous pouvez vérifier cet état en exécutant :

Get-Module -Name Microsoft.Entra -ListAvailable

Si le module n’est pas répertorié, installez-le à l’aide de :

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

Conflits de version

Vous pouvez rencontrer des erreurs indiquant que plusieurs versions du module sont installées, par exemple le message « Assembly portant le même nom est déjà chargé ». Pour corriger cette erreur, désinstallez toutes les versions en conflit du module, puis installez la dernière version :

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

Erreurs d’autorisation

Vous pouvez recevoir des erreurs liées à des autorisations insuffisantes lors de la tentative d’exécution de commandes ou de scripts. Pour corriger cette erreur, vérifiez que vous disposez des autorisations nécessaires pour effectuer l’opération. Vous devrez peut-être ajuster les autorisations dans le centre d’administration Microsoft Entra.

Problèmes de mise à jour de module

Vous pouvez rencontrer des problèmes lors de la mise à jour du module PowerShell Microsoft Entra. Pour corriger cette erreur, utilisez l’extrait de code pour installer la dernière version. En cas d’erreur, essayez de désinstaller , puis réinstallez le module.

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

Problèmes de performance

Vos scripts ou commandes peuvent s’exécuter lentement ou ne pas se terminer comme prévu. Pour résoudre ce problème, envisagez d’affiner vos requêtes pour extraire uniquement les données nécessaires, en utilisant des filtres et en sélectionnant des propriétés spécifiques. Augmentez les délais d’expiration si nécessaire.

Gestion des erreurs

Vous pouvez recevoir des erreurs du module PowerShell Microsoft Entra difficiles à comprendre ou à gérer. Pour corriger cette erreur, utilisez-la $Error[0].Exception | Format-List -Force pour obtenir des informations détaillées sur l’erreur. Les informations peuvent vous aider à comprendre la réponse de l’API et à résoudre les problèmes.

Le proxy bloque la connexion

Si vous obtenez des erreurs de Install-Module indiquant que la PowerShell Gallery est inaccessible, il se peut que vous soyez derrière un proxy. Les différents systèmes d’exploitation et environnements réseau ont des exigences propres pour configurer un proxy à l’échelle du système. Contactez votre administrateur système pour vos paramètres de proxy et pour savoir comment les configurer pour votre environnement.

PowerShell lui-même peut ne pas être configuré pour utiliser ce proxy automatiquement. Avec PowerShell 5.1 et ultérieur, configurez la session PowerShell pour utiliser un proxy avec les commandes suivantes :

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

Si vos informations d’identification du système d’exploitation sont configurées correctement, cette configuration route les demandes PowerShell via le proxy. Pour conserver cette configuration entre les sessions, ajoutez les commandes à votre profil PowerShell.

Pour installer le package, votre proxy doit autoriser les connexions HTTPS sur www.powershellgallery.com.

Autres problèmes

Si vous rencontrez un problème de produit avec Microsoft Entra PowerShell non répertorié dans cet article ou si vous avez besoin d’aide supplémentaire, déposez un problème sur GitHub.

  • Dernière mise à jour :