PowerShell de Azure Active Directory para Graph

Artículo
06/13/2023

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 enumerados aquí son diferentes de los cmdlets de MSOL que forman parte del módulo msonline de PowerShell.

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

El módulo de vista previa de PowerShell para Graph de Azure AD se puede descargar desde el Galería de PowerShell en la página AzureADPreview.

El módulo de disponibilidad general de Azure AD PowerShell para Graph se puede descargar desde el Galería de PowerShell en la página de AzureAD.

Instalación del módulo Azure AD

El módulo Azure AD PowerShell para Graph es compatible con 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 o Windows Server 2008 R2.

Si el equipo tiene todos los requisitos previos para la instalación, para instalar la versión de disponibilidad general del módulo en el equipo, puede ejecutar

Install-Module AzureAD

Para instalar la versión preliminar pública, use

Install-module AzureADPreview

Tenga en cuenta que no puede instalar la versión preliminar y la de disponibilidad general en el mismo equipo simultáneamente.

Acerca de la Galería de PowerShell

El módulo Azure AD se distribuye con la Galería de PowerShell. Para instalar elementos desde la Galería se 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 programa de instalación basado en MSI (para PowerShell 3 y 4).

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

Buscar en los elementos de la Galería con Find-Module y Find-Script
Guardar los elementos en el sistema desde la Galería con Save-Module y Save-Script
Instalación de elementos desde la Galería con Install-Module e Install-Script
Cargar elementos en la Galería con Publish-Module y Publish-Script
Adición de su propio repositorio personalizado con Register-PSRepository

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 que ha instalado en el equipo, ejecute este comando:

PS C:\WINDOWS\system32> Get-Module AzureADPreview

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

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

PS C:\WINDOWS\system32> Install-Module AzureADPreview

Este comando comprueba en la Galería de PowerShell si existe una versión más reciente y la instala en el equipo si la versión en la Galería de PowerShell es más reciente que la instalada 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 las 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.

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.

¿Sugerencias?

Si tiene sugerencias sobre cómo mejorar Azure Active Directory PowerShell, no dude en informarnos.

Más acerca de Windows PowerShell

Windows PowerShell es un shell de línea de comandos y un lenguaje de scripting basados en tareas y diseñados para la administración del sistema. A diferencia de la mayoría de los shells, que aceptan y devuelven texto, Windows PowerShell se basa en .NET Framework, y acepta y devuelve objetos de .NET Framework.

Windows PowerShell presenta el concepto de cmdlet (pronunciado "command-let"), una sencilla herramienta de línea de comandos de función única integrada en el shell. Los cmdlets siguen esta convención de nomenclatura: un verbo y un sustantivo en inglés separados por un guion (-), como Get-Help, Get-Process y Start-Service. Windows PowerShell incluye más de cien cmdlets principales básicos.

Para más información sobre los cmdlets o su sintaxis, use el comando Get-Help <cmdlet name>, donde <cmdlet name> es el nombre del cmdlet que desea investigar. Para información más detallada, puede ejecutar cualquiera de los siguientes comandos:

Get-Help <cmdlet name> -Detailed
Get-Help <cmdlet name> -Examples
Get-Help <cmdlet name> -Full

Para más información acerca de Windows PowerShell, consulte Getting Started with Windows PowerShell (Introducción a Windows PowerShell).