Cómo usar Connect AzureAD en PowerShell

El módulo Azure AD PowerShell le permite administrar su Azure Active Directory con PowerShell. El primer paso para utilizar este módulo es utilizar el cmdlet Connect-AzureAD. Una vez conectado, puede obtener, actualizar, crear o eliminar objetos en su entorno de Azure AD.

Es bueno saber de antemano que está previsto que el módulo AzureAD quede obsoleto el 30 de marzo de 2024. Está siendo reemplazado por el nuevo módulo Microsoft Graph. Actualmente, los módulos MgGraph aún no están completamente documentados, por lo que el módulo Azure AD todavía se usa con frecuencia.

En este artículo, veremos cómo conectarse a AzureAD desde PowerShell.

Requisitos

Antes de ver cómo conectarse a Azure AD, primero debemos asegurarnos de tener instalado el módulo correcto en PowerShell. Para comprobar si el módulo ya está instalado, podemos usar el cmdlet Get-Module.

Esto devolverá todos los módulos que coincidan con el nombre dado. Si el módulo no está instalado, devolverá $null. Para instalarlo, podemos usar el cmdlet Install-Module:

if ($null -eq (Get-Module -ListAvailable -Name AzureAD)) {
    Write-Host "Installing Azure AD module" -ForegroundColor Cyan
    Install-Module AzureAD -Repository PSGallery -AllowClobber -Force
}

Conectar AzureAD

Conectarse a AzureAD es bastante sencillo. Solo necesitará ejecutar el comando Connect-AzureAD, que luego le pedirá que inicie sesión con su cuenta de Microsoft 365. Utilizará automáticamente el método interactivo, por lo que puede seleccionar su cuenta y usar MFA para iniciar sesión:

Connect-AzureAD

Para comprobar si está conectado correctamente, puede utilizar el cmdlet Get-AzureADTenantDetail. Esto mostrará los detalles del inquilino al que está conectado.

Conexión con un inquilino diferente

También podemos usar el módulo AzureAD para administrar otros inquilinos que administramos. Para hacer esto necesitaremos usar el parámetro -tenantid. Aquí puede ingresar el ID del inquilino o el nombre de dominio del inquilino:

Connect-AzureAD -Tenant lazydev.onmicrosoft.com

Uso de Connect-AzureAD en un RunBook

También puede usar el módulo AzureAD en un Runbook de Azure. Es bueno tener en cuenta que el módulo ya no se mantiene, por lo que las identidades administradas, por ejemplo, no funcionarán directamente. Para conectar azuread en un runbook, primero necesitaremos usar AzModule.

El módulo AzureAZ le permite administrar su entorno de Azure. Podemos usar este módulo para generar un token de acceso, que luego podemos usar para conectarnos a Azure AD.

Nota
Si no ha utilizado identidades administradas antes, asegúrese de leer este artículo sobre cómo configurarlas y usarlas.

Primero, conéctese a Azure con la identidad administrada en su RunBook:

# Connect to Azure
$az = Connect-AzAccount -Identity
$az = Set-AzContext -SubscriptionName $az.context.Subscription -DefaultProfile $az.context

Con la conexión iniciada, podemos generar los tokens necesarios y conectarnos a AzureAD:

# Generate the token
$graphToken = Get-AzAccessToken -ResourceUrl "https://graph.microsoft.com/"
$aadToken = Get-AzAccessToken -ResourceUrl "https://graph.windows.net"

Connect-AzureAD -AccountId $az.account.id -TenantId $az.tenant.id -AadAccessToken $aadToken.token -MsAccessToken $graphToken.token

Concluyendo

Tenga en cuenta que está previsto que el módulo PowerShell AzureAD quede obsoleto en marzo de 2024. Le recomiendo que primero intente crear su script con el nuevo módulo Microsoft Graph.