Microsoft Graph con PowerShell, cómo instalar y conectarse

Microsoft Graph con PowerShell, tu nuevo mejor aliado. En el pasado hemos usado mucho la conexión a Exchange desde PowerShell, pero parece que Microsoft cada vez nos está llevando a trabajar más con Microsoft Graph para muchas de las tareas que antes hacíamos desde otros módulos.

Microsoft Graph es una poderosa API que te permite acceder y manipular datos de Microsoft 365, como usuarios, grupos, correos, calendarios, tareas, informes y más. Con PowerShell, puedes automatizar y simplificar tus procesos de administración y gestión de Microsoft 365, usando scripts y comandos.

En este artículo, te voy a enseñar cómo instalar y conectarse a Microsoft Graph con PowerShell, paso a paso. Así podrás empezar a aprovechar las ventajas de esta combinación para optimizar tu trabajo.

Requisitos previos

Antes de instalar y conectarse a Microsoft Graph con PowerShell, necesitas cumplir los siguientes requisitos previos:

• Tener una cuenta de Microsoft 365 con permisos de administrador.
• Tener instalado PowerShell en tu equipo. Puedes descargarlo desde aquí.
• Tener instalado el módulo de Azure Active Directory PowerShell. Puedes instalarlo desde PowerShell con el siguiente comando:

Install-Module -Name AzureAD

Instalar el módulo de Microsoft Graph PowerShell

El módulo de Microsoft Graph PowerShell es un conjunto de cmdlets que te permiten interactuar con la API de Microsoft Graph desde PowerShell. Para instalarlo, sigue estos pasos:

1. Abre PowerShell como administrador.
2. Ejecuta el siguiente comando para instalar el módulo de Microsoft Graph PowerShell:

Install-Module -Name Microsoft.Graph

3. Si te aparece un mensaje de advertencia sobre el repositorio PSGallery, elige la opción Yes o Yes to All para continuar con la instalación.
4. Espera a que se complete la instalación. Puedes verificar que el módulo se ha instalado correctamente con el siguiente comando:

Get-Module -Name Microsoft.Graph -ListAvailable

Conectarse a Microsoft Graph con PowerShell

Una vez instalado el módulo de Microsoft Graph PowerShell, el siguiente paso es conectarse a Microsoft Graph con PowerShell. Para ello, sigue estos pasos:

1. Abre PowerShell como administrador.
2. Ejecuta el siguiente comando para iniciar sesión en Microsoft Graph con tu cuenta de Microsoft 365:

Connect-MgGraph

3. Se abrirá una ventana del navegador donde deberás introducir tu nombre de usuario y contraseña de Microsoft 365, y aceptar los permisos solicitados por la aplicación Microsoft Graph PowerShell.
4. Una vez autenticado, volverás a PowerShell y verás un mensaje de confirmación de que te has conectado a Microsoft Graph con éxito.

Ejecutar comandos de Microsoft Graph con PowerShell

Ahora que ya estás conectado a Microsoft Graph con PowerShell, puedes empezar a ejecutar comandos de Microsoft Graph con PowerShell para acceder y manipular los datos de Microsoft 365. Por ejemplo, puedes usar los siguientes comandos para realizar algunas tareas comunes:

• Obtener una lista de los usuarios de tu organización:

Get-MgUser

• Crear un nuevo usuario en tu organización:

New-MgUser -DisplayName "Juan Pérez" -UserPrincipalName "juan.perez@contoso.com" -AccountEnabled $true -MailNickname "juan.perez" -PasswordProfile @{ ForceChangePasswordNextSignIn = $true; Password = "P@ssw0rd" }

• Enviar un correo electrónico a un usuario desde tu cuenta:

Send-MgMailMessage -UserId "me" -Subject "Hola" -Body @{ ContentType = "Text"; Content = "Este es un mensaje de prueba" } -ToRecipients @{ EmailAddress = @{ Address = "juan.perez@contoso.com" } }

• Obtener una lista de los eventos de tu calendario:

Get-MgUserCalendarEvent -UserId "me"

• Crear un nuevo evento en tu calendario:

New-MgUserCalendarEvent -UserId "me" -Subject "Reunión con Juan" -Start @{ DateTime = "2023-12-25T10:00:00"; TimeZone = "Europe/Madrid" } -End @{ DateTime = "2023-12-25T11:00:00"; TimeZone = "Europe/Madrid" } -Location @{ DisplayName = "Oficina" } -Attendees @{ EmailAddress = @{ Address = "juan.perez@contoso.com" }; Type = "Required" }

Puedes consultar la documentación oficial del módulo de Microsoft Graph PowerShell para ver todos los comandos disponibles y sus parámetros.

Conclusión

En este artículo, has aprendido cómo instalar y conectarse a Microsoft Graph con PowerShell, paso a paso. También has visto algunos ejemplos de cómo ejecutar comandos de Microsoft Graph con PowerShell para acceder y manipular los datos de Microsoft 365.

Con PowerShell y la API de Microsoft Graph, puedes automatizar y simplificar tus procesos de administración y gestión de Microsoft 365, usando scripts y comandos. Así podrás ahorrar tiempo, mejorar tu productividad y optimizar tu trabajo.