Solución de errores comunes en Microsoft Entra PowerShell

En este artículo se explica cómo determinar, diagnosticar y corregir problemas que podría surgir al usar Microsoft Entra PowerShell.

Antes de solucionar los errores, asegúrese de que ejecuta la versión más reciente de Microsoft Entra PowerShell. Para comprobar la versión del módulo instalado, ejecute:

Get-InstalledModule -Name Microsoft.Entra

La versión del módulo Microsoft.Entra debe ser la más reciente en comparación con la última versión publicada en la Galería de PowerShell. Si el módulo instalado no está actualizado, actualícelo mediante la ejecución de:

Update-Module -Name Microsoft.Entra

Problemas de instalación

Durante la instalación, puede encontrar algunos errores que impiden que el módulo se instale correctamente. Estos son algunos problemas comunes y sus soluciones.

No se encuentra el parámetro AllowPrerelease

Es posible que reciba un error si usa una versión anterior de Install-Module: "Install-Module: no se encuentra un parámetro que coincida con el nombre AllowPrereleasedel parámetro ". Para corregir este error, ejecute los siguientes comandos para actualizar:

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

Se ha excedido el límite de capacidad de 4096 funciones para este ámbito

En PowerShell 5.1, es posible que vea el error: "No se puede crear la función {cmdlet-name} porque se ha superado la capacidad de función 4096". Para corregir este error, aumente el límite de funciones ejecutando el siguiente comando y vuelva a intentar importar el módulo.

$MaximumFunctionCount = 32768

Comandos ya disponibles en el módulo

Si hay un conflicto si ya está instalado Beta o v1.0, es posible que vea el error: "Los siguientes comandos ya están disponibles en este sistema: Enable-EntraAzureADAlias, Get-EntraUnsupportedCommand, Test-EntraScript." Para corregir este error, agregue el parámetro -AllowClobber y vuelva a ejecutar el comando.

Dependencias faltantes

Cuando Microsoft Entra las dependencias de PowerShell no están instaladas, es posible que vea el error: "El módulo module-name dependiente no está instalado en este equipo. Para usar el módulo Microsoft.Entraactual, asegúrese de que está instalado su módulo module-name dependiente." Para corregir este error, instale las dependencias mediante el siguiente script:

  • Instale las dependencias de SDK de PowerShell en Microsoft Graph 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 #>

Problemas de autenticación.

Si no se autentican o reciben tokens, se puede producir una respuesta "401 No autorizado". Este error puede producirse por varias razones. Para corregir este error, asegúrese de que usa las credenciales correctas y tiene permisos suficientes. Compruebe que los registros de aplicaciones (si procede) están configurados correctamente con los permisos de API necesarios en Microsoft Entra ID.

Cmdlet no reconocido

PowerShell no reconoce el cmdlet que intenta ejecutar. Para corregir este error, asegúrese de que el módulo de PowerShell Microsoft Entra está instalado correctamente. Para comprobar este estado, ejecute:

Get-Module -Name Microsoft.Entra -ListAvailable

Si el módulo no aparece en la lista, instálelo mediante:

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

Conflictos de versión

Es posible que encuentre errores que indican que hay varias versiones del módulo instaladas, como el mensaje "Ensamblado con el mismo nombre ya está cargado". Para corregir este error, desinstale todas las versiones en conflicto del módulo y, a continuación, instale la versión más reciente:

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

Errores de permisos

Es posible que reciba errores relacionados con permisos insuficientes al intentar ejecutar comandos o scripts. Para corregir este error, asegúrese de que tiene los permisos necesarios para realizar la operación. Es posible que tenga que ajustar los permisos en el Centro de administración Microsoft Entra.

Problemas de actualización de módulos

Es posible que se produzcan problemas al intentar actualizar el módulo de PowerShell de Microsoft Entra. Para corregir este error, use el fragmento de código para instalar la versión más reciente. Si hay errores, intente desinstalar y vuelva a instalar el módulo.

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

Problemas de rendimiento

Es posible que los scripts o comandos se ejecuten lentamente o no se completen según lo previsto. Para corregirlo, considere la posibilidad de refinar las consultas para capturar solo los datos necesarios, mediante filtros y seleccionando propiedades específicas. Aumente los tiempos de espera si es necesario.

Control de errores

Es posible que reciba errores del módulo de PowerShell de Microsoft Entra que son difíciles de entender o administrar. Para corregir este error, use $Error[0].Exception | Format-List -Force para obtener información detallada del error. La información puede ayudar a comprender aún más la respuesta de la API y solucionar problemas.

El servidor proxy bloquea la conexión

Si recibe errores de Install-Module indicando que no se puede acceder a Galería de PowerShell, es posible que se encuentre detrás de un proxy. Sistemas operativos diferentes tendrán requisitos diferentes para configurar un servidor proxy de todo el sistema. Póngase en contacto con el administrador del sistema para la configuración del proxy y para saber cómo configurarlos en su entorno.

Es posible que PowerShell no esté configurado para usar este proxy automáticamente. Con PowerShell 5.1 y versiones posteriores, use los siguientes comandos para configurar la sesión de PowerShell para que use un servidor proxy:

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

Si las credenciales del sistema operativo están configuradas correctamente, esta configuración enruta las solicitudes de PowerShell a través del proxy. Para que esta configuración persista entre sesiones, agregue los comandos al perfil de PowerShell.

Para instalar el paquete, el proxy debe permitir conexiones HTTPS a www.powershellgallery.com.

Otros problemas

Si experimenta un problema de producto con Microsoft Entra PowerShell no aparece en este artículo o necesita más ayuda, presente un problema en GitHub.

  • Last updated on