Instalación de Microsoft Entra PowerShell

El módulo Microsoft Entra PowerShell permite a los profesionales de TI administrar de forma eficaz Microsoft Entra recursos, lo que garantiza una integración y funcionalidad sin problemas en varias plataformas. Este módulo mejora la capacidad de automatizar y simplificar las tareas administrativas.

En este artículo, aprenderá a instalar, comprobar, actualizar y solucionar problemas del módulo de PowerShell Microsoft Entra en los distintos sistemas operativos.

El Microsoft Entra módulo de PowerShell se divide en dos módulos, cada uno con submódulos que se pueden instalar por separado. Los dos módulos principales son:

  • Microsoft.Entra: la versión de disponibilidad general o v1.0 de Microsoft Entra PowerShell. Apunta a los recursos de Microsoft Graph v1.0 y del SDK de PowerShell de Microsoft Graph v1.0.
  • Microsoft.Entra.Beta - la Beta versión preliminar de Microsoft Entra PowerShell. Apunta a los recursos beta de Microsoft Graph y de SDK de PowerShell en Microsoft Graph Beta.

Se recomienda usar powerShell versión 7 o posterior con el módulo de PowerShell de Microsoft Entra en todas las plataformas, como Windows, Linux y macOS.

Instalación del módulo de PowerShell de Microsoft Entra en Windows

El método de instalación recomendado y la versión de PowerShell para el módulo:

Requisitos previos en Windows

  • Ejecute el siguiente comando desde PowerShell para determinar la versión de PowerShell:

    $PSVersionTable.PSVersion

  • Determine si tiene instalado el módulo:

    Get-Module -Name Microsoft.Entra -ListAvailable

  • Establezca la directiva de ejecución de PowerShell en remota firmada o menos restrictiva.

    • Compruebe la directiva de ejecución de PowerShell:

      Get-ExecutionPolicy -List

    • Establezca la directiva de ejecución de PowerShell a remota firmada:

      Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

    Para obtener más información sobre las directivas de ejecución, consulte about_Execution_Policies.

Installation

Al instalar el módulo, puede elegir instalar todo el módulo o un submódulo específico. En los ejemplos siguientes se muestra cómo instalar todo el módulo para v1.0 y Beta.

Use el cmdlet Install-Module para instalar el módulo.

Install-Module -Name Microsoft.Entra -Repository PSGallery -Scope CurrentUser -Force -AllowClobber

Opcionalmente, puede cambiar el ámbito de la instalación mediante el parámetro Scope . Esta operación requiere permisos de administrador.

Install-Module -Name Microsoft.Entra -Repository PSGallery -Scope AllUsers -Force -AllowClobber

Instalar submódulos específicos

La instalación de módulos específicos es ideal para escenarios de automatización como el uso de Azure Functions y Azure Automation.

Ejecute el siguiente comando para mostrar todos los módulos Microsoft.Entra GA/v1.0 de Galería de PowerShell:

Find-Module -Name "Microsoft.Entra*" -Repository PSGallery |
Where-Object { $_.Name -notmatch "beta" }

Este comando muestra todos los módulos de Microsoft Entra PowerShell GA/v1.0 en la galería de PowerShell.

Por ejemplo, para instalar el Users módulo, ejecute el siguiente comando:

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

Instalación de Microsoft Entra PowerShell en Linux

Requisitos previos en Linux

Instalación en Linux

Al instalar el módulo, puede elegir instalar todo el módulo o un submódulo específico. En el ejemplo siguiente se muestra cómo instalar todo el módulo.

Abra el Terminal u otra aplicación host de shell y ejecute pwsh para iniciar PowerShell.

Use el cmdlet Install-Module para instalar el módulo:

Install-Module -Name Microsoft.Entra -Repository PSGallery -Scope CurrentUser -Force -AllowClobber

Opcionalmente, puede cambiar el ámbito de la instalación mediante el parámetro Scope . Esta operación requiere permisos de administrador.

Install-Module -Name Microsoft.Entra -Repository PSGallery -Scope AllUsers -Force -AllowClobber

Instalación de submódulos específicos en Linux

La instalación de módulos específicos es ideal para escenarios de automatización como el uso de Azure Functions y Azure Automation.

Ejecute el siguiente comando para mostrar todos los módulos Microsoft.Entra GA/v1.0 de la Galería de PowerShell:

Find-Module -Name "Microsoft.Entra*" -Repository PSGallery |
Where-Object { $_.Name -notmatch "beta" }

Este comando muestra todos los módulos de Microsoft Entra PowerShell GA/v1.0 en la Galería de PowerShell.

Por ejemplo, para instalar el Users módulo, ejecute el siguiente comando:

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

Instalación de Microsoft Entra PowerShell en macOS

En este artículo se explica cómo instalar el módulo desde el Galería de PowerShell en macOS.

Requisitos previos en macOS

Instalación en macOS

Al instalar el módulo, puede elegir instalar todo el módulo o un submódulo específico. En el ejemplo siguiente se muestra cómo instalar todo el módulo.

Abra el Terminal u otra aplicación host de shell y ejecute pwsh para iniciar PowerShell.

Use el cmdlet Install-Module para instalar el módulo de PowerShell de Microsoft Entra:

Install-Module -Name Microsoft.Entra -Repository PSGallery -Scope CurrentUser -Force -AllowClobber

Opcionalmente, puede cambiar el ámbito de la instalación mediante el parámetro Scope . Esta operación requiere permisos de administrador.

Install-Module -Name Microsoft.Entra -Repository PSGallery -Scope AllUsers -Force -AllowClobber

Instalación de submódulos específicos en macOS

La instalación de módulos específicos es ideal para escenarios de automatización como el uso de Azure Functions y Azure Automation.

Ejecute el siguiente comando para mostrar todos los módulos Microsoft.Entra GA/v1.0 en la Galería de PowerShell:

Find-Module -Name "Microsoft.Entra*" -Repository PSGallery |
Where-Object { $_.Name -notmatch "beta" }

Este comando muestra todos los módulos de Microsoft Entra PowerShell GA/v1.0 en Galería de PowerShell.

Por ejemplo, para instalar el Users módulo, ejecute el siguiente comando:

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

Comprobación de la ubicación y la versión del módulo instalados

Una vez completada la instalación, puede comprobar los submódulos instalados, su versión y ubicación con el comando siguiente.

Get-InstalledModule -Name Microsoft.Entra* |
Where-Object { $_.Name -notmatch "Beta" } | Format-Table Name, Version, InstalledLocation -AutoSize

Este comando muestra el módulo instalado Microsoft Entra PowerShell, su versión e ubicación de instalación. La versión de salida debe coincidir con la versión más reciente del Galería de PowerShell. Ya está listo para usar el módulo.

Name                                Version InstalledLocation
----                                ------- -----------------
Microsoft.Entra                     1.0.1   <PowerShell-Path>\PowerShell\Modules\Microsoft.Entra\1.0.1
Microsoft.Entra.Applications        1.0.1   <PowerShell-Path>\PowerShell\Modules\Microsoft.Entra.Applications\1.0.1
Microsoft.Entra.Authentication      1.0.1   <PowerShell-Path>\PowerShell\Modules\Microsoft.Entra.Authentication\1.0.1
Microsoft.Entra.DirectoryManagement 1.0.1   <PowerShell-Path>\PowerShell\Modules\Microsoft.Entra.DirectoryManagement\1.0.1
Microsoft.Entra.Governance          1.0.1   <PowerShell-Path>\PowerShell\Modules\Microsoft.Entra.Governance\1.0.1
Microsoft.Entra.Groups              1.0.1   <PowerShell-Path>\PowerShell\Modules\Microsoft.Entra.Groups\1.0.1
Microsoft.Entra.Reports             1.0.1   <PowerShell-Path>\PowerShell\Modules\Microsoft.Entra.Reports\1.0.1
Microsoft.Entra.SignIns             1.0.1   <PowerShell-Path>\PowerShell\Modules\Microsoft.Entra.SignIns\1.0.1
Microsoft.Entra.Users               1.0.1   <PowerShell-Path>\PowerShell\Modules\Microsoft.Entra.Users\1.0.1

Para comprobar si se instala un submódulo específico, Users ejecute:

Get-InstalledModule -Name Microsoft.Entra.Users

La versión de salida debe coincidir con la versión más reciente del Galería de PowerShell.

Version              Name                                Repository           Description
-------              ----                                ----------           -----------
1.0.1                Microsoft.Entra.Users               PSGallery            Microsoft Entra PowerShell

Solución de problemas de instalación

Error Causa Workaround
Install-Module: no se puede encontrar un parámetro que coincida con el nombre de parámetro AllowPrerelease. Está usando una versión anterior de Install-Module. Para actualizar, siga esta guía. El problema solo se aplica a Windows plataforma.
El módulo dependiente "module-name" no está instalado en este equipo. Para usar el módulo actual "Microsoft. Entra, asegúrese de que está instalado su módulo dependiente "module-name". Las dependencias de Microsoft Entra PowerShell no están instaladas Para instalarlo, use este script.
Los cmdlets ya existen en el sistema Agregar -AllowClobber parámetro: Install-Module -Name Microsoft.Entra -Repository PSGallery -Force -AllowClobber
Los siguientes comandos ya están disponibles en este sistema: 'Enable-EntraAzureADAlias,Get-EntraUnsupportedCommand,Test-EntraScript' Hay un conflicto cuando ya está instalado Beta o v1.0. Para resolver el problema, desinstale la versión del módulo infractor.

Para obtener soluciones a otras instalaciones comunes y otros problemas generales, consulte Solución de problemas de instalación de módulos.

Iniciar sesión

Para empezar a administrar los recursos de Microsoft Entra con el módulo de PowerShell de Microsoft Entra, inicie una sesión de PowerShell y ejecute Connect-Entra para iniciar sesión en Microsoft Entra ID:

Connect-Entra -Scopes 'User.Read.All'
Get-EntraUser -Filter "userPrincipalName eq 'SawyerM@contoso.com'"

Use las credenciales de Microsoft Entra para iniciar sesión en la ventana de inicio de sesión que se abre.

Debe repetir este paso para cada nueva sesión de PowerShell que inicie.

Para más información sobre otros escenarios de autenticación, consulte más escenarios de autenticación.

Actualización del módulo

Si el módulo está instalado, siga estos pasos para actualizarlo.

En primer lugar, compruebe la versión y la ubicación del módulo mediante las instrucciones de la sección comprobar la instalación de este artículo.

Actualización a la versión más reciente

Use Update-Module para actualizar a la versión más reciente del módulo de PowerShell de Microsoft Entra.

Update-Module -Name Microsoft.Entra -Force

Para actualizar un submódulo específico, como Users, ejecute:

Update-Module -Name Microsoft.Entra.Users -Force

La actualización del módulo de PowerShell Microsoft Entra mediante Update-Module no quita las versiones anteriores del módulo del sistema.

Desinstalación del módulo

Para quitar el módulo, ejecute el comando :

Uninstall-Module -Name Microsoft.Entra -AllVersions -Force

Para desinstalar un submódulo específico, como Users, ejecute:

Uninstall-Module -Name Microsoft.Entra.Users -AllVersions -Force

Para desinstalar todos los submódulos, ejecute:

$InstalledSubModules = Get-InstalledModule -Name Microsoft.Entra.* |
Where-Object { $_.Name -notmatch "Beta" }
foreach ($module in $InstalledSubModules) {
    Write-Host "Checking for submodule: $($module.Name)" -ForegroundColor Yellow -BackgroundColor DarkBlue
    Uninstall-Module -Name $module.Name -Force -ErrorAction Stop
    Write-Host "Successfully uninstalled submodule: $($module.Name)" -ForegroundColor Green
}

Pasos siguientes

  • Para obtener más información sobre cómo navegar por el módulo Microsoft Entra PowerShell, consulte el artículo Navegar por el módulo.
  • Last updated on