Instalación de PowerShell de Azure Active Directory para Graph

  • Artículo

Importante

Azure AD PowerShell está planeado para desuso el 30 de marzo de 2024. Para más información sobre los planes de desuso, consulte la actualización de desuso. Le recomendamos que siga migrando a PowerShell de Microsoft Graph, que es el módulo recomendado para interactuar con Azure AD. Además, PowerShell de Microsoft Graph le permite acceder a todas las API de Microsoft Graph y está disponible en PowerShell 7. Para obtener respuestas a las consultas frecuentes de migración, consulte las preguntas más frecuentes sobre la migración.

Puede usar la versión del módulo de PowerShell de Azure Active Directory para Graph para tareas administrativas de Azure AD, como la administración de usuarios, la administración de dominios y para configurar el inicio de sesión único. Los cmdlets que se enumeran aquí son diferentes de los cmdlets msonline que forman parte de la versión 1.0 de PowerShell de Azure Active Directory.

El módulo Azure AD PowerShell para Graph tiene dos versiones: una versión preliminar pública y una versión de disponibilidad general (GA). No se recomienda usar la versión preliminar pública para escenarios de producción.

Descargue los módulos del Galería de PowerShell use lo siguiente;

Historial de versiones de La versión de PowerShell para Graph de Azure Active Directory

El historial de versiones del módulo de Azure AD y el módulo de versión preliminar de Azure AD se encuentra aquí:azure active directory powershell para graph: historial de versiones.

Instalación del módulo Azure AD

Requisitos previos

El módulo de Azure AD se admite en los siguientes sistemas operativos Windows con la versión predeterminada de Microsoft .NET Framework y Windows PowerShell:

  • Windows 8.1
  • Windows 8
  • Windows 7
  • Windows Server 2012 R2,
  • Windows Server 2012
  • Windows Server 2008 R2.

Nota

El módulo de PowerShell de Azure AD no es compatible con PowerShell 7. Solo se admite en PowerShell 5.1.

Para instalar la versión de disponibilidad general del módulo, ejecute:

Install-Module AzureAD

Para instalar la versión preliminar pública, ejecute:

Install-module AzureADPreview

No se puede instalar la versión preliminar y la versión de disponibilidad general en el mismo equipo al mismo tiempo.

El módulo de Azure AD se distribuye mediante el Galería de PowerShell. La instalación de elementos desde la galería requiere la versión más reciente del módulo PowerShellGet, que está disponible en Windows 10, en Windows Management Framework (WMF) 5.0 o en el instalador basado en MSI (para PowerShell 3 y 4).

Con la última versión del módulo PowerShellGet, puede:

Consulte la página Introducción para obtener más información sobre el uso de comandos PowerShellGet con la Galería. También puede ejecutar Update-Help -Module PowerShellGet para instalar la Ayuda local para estos comandos.

Sistemas operativos compatibles

El módulo PowerShellGet requiere PowerShell 3.0 o posterior.

Por lo tanto, PowerShellGet requiere uno de los siguientes sistemas operativos:

  • Windows 10
  • Windows 8.1 Pro
  • Windows 8.1 Enterprise
  • Windows 7 SP1
  • Windows Server 2016 TP5
  • Windows Server 2012 R2
  • Windows Server 2008 R2 SP1

PowerShellGet también requiere .NET Framework 4.5 o una versión posterior. Puede instalar .NET Framework 4.5 o posterior desde aquí.

Actualización del módulo Azure AD

Para comprobar la versión del módulo instalado en el equipo, ejecute este comando:

Get-Module AzureADPreview

ModuleType Version Name                ExportedCommands
---------- ------- ----                ----------------
Binary     2.0.0.7 azureadpreview     {Add-AzureADAdmini...

Para actualizar la versión del módulo de PowerShell de Azure AD en el equipo, vuelva a ejecutar el cmdlet Install-Module :

Install-Module AzureADPreview

Este comando comprueba la galería de PowerShell para ver si hay disponible una versión más reciente. Si es así, el más reciente que el instalado en el equipo.

Conectarse a Azure

Para poder ejecutar cualquiera de los cmdlets descritos en este artículo, primero debe conectarse a su servicio en línea. Para ello, ejecute el cmdlet Connect-AzureAD en el símbolo del sistema de Windows PowerShell. A continuación, se le pedirán sus credenciales. Si lo desea, puede proporcionar sus credenciales con antelación, por ejemplo:

$AzureAdCred = Get-Credential
Connect-AzureAD -Credential $AzureAdCred

El primer comando solicita las credenciales y las almacena como $AzureAdCred. El siguiente comando usa esas credenciales como $azureadcred para conectarse al servicio.

Nota

Los módulos De Azure AD y Azure AD Preview constan de cmdlets con diferentes convenciones de nomenclatura, es decir, -AzureAD y -AzureADMS. Los -AzureAD cmdlets se conectan al punto de conexión https://graph.windows.net de Azure AD Graph mientras los -AzureADMS cmdlets realizan llamadas al punto de conexión graph.microsoft.comde Microsoft Graph . La autenticación se controla de forma silenciosa al cambiar las llamadas de un punto de conexión a otro y no se le pedirán las credenciales de nuevo.

Para conectarse a un entorno específico de Azure Active Directory, use el parámetro AzureEnvironment, como se indica a continuación:

Connect-AzureAD -AzureEnvironment "AzureGermanyCloud"

En este ejemplo se conecta a la sesión de PowerShell en el entorno AzureAD alemán. Consulte Connect-AzureAD para más información.

Pasos siguientes