Si trabajas con Microsoft 365 y buscas una forma eficiente de gestionar entornos como SharePoint Online, Microsoft Teams o Microsoft Planner, los módulos PowerShell PnP pueden convertirse en tu mejor aliado. Con más de 700 cmdlets disponibles, estos módulos permiten automatizar tareas administrativas, simplificar procesos y mejorar la gestión de recursos dentro de la nube de Microsoft.
En los siguientes apartados, exploraremos en profundidad qué son los módulos PowerShell PnP, cómo instalarlos, su compatibilidad con distintos sistemas operativos y cómo utilizarlos para sacarles el máximo partido.
¿Qué son los módulos PowerShell PnP?
Los módulos PowerShell PnP son una extensión de PowerShell que proporciona cmdlets avanzados para gestionar varios servicios dentro del ecosistema de Microsoft 365. Estos módulos permiten interactuar con herramientas como SharePoint Online, Microsoft Teams, Microsoft Planner, Power Platform y otras soluciones empresariales.
Lo que distingue a PowerShell PnP de los cmdlets tradicionales de SharePoint es su enfoque en la simplicidad y eficiencia. En lugar de depender exclusivamente de CSOM o REST API, PnP PowerShell combina ambas tecnologías para facilitar la administración de recursos.
Instalación de PnP PowerShell
Para utilizar PnP PowerShell, es necesario contar con PowerShell en su versión 7.4.4 o posterior. Este módulo es compatible con Windows, Linux y macOS, lo que permite su uso en diferentes entornos.
Instalar la versión estable
Para instalar la versión estable de PnP PowerShell en el sistema, basta con ejecutar el siguiente comando en la terminal de PowerShell:
Install-Module PnP.PowerShell -Scope CurrentUser
Instalar la versión nocturna (Nightly Build)
Si se requiere la última versión de desarrollo con características en fase de prueba, se puede instalar la versión nocturna con el siguiente comando:
Install-Module PnP.PowerShell -Scope CurrentUser -AllowPrerelease -SkipPublisherCheck
Actualizar PnP PowerShell
Para actualizar a la versión más reciente, se recomienda ejecutar:
Update-Module PnP.PowerShell -Scope CurrentUser
Eliminar PnP PowerShell
Si es necesario desinstalar el módulo, se puede hacer con:
Uninstall-Module PnP.PowerShell -AllVersions
Conectarse a SharePoint Online con PnP PowerShell
Una vez instalado el módulo, el siguiente paso es conectarse a un entorno de SharePoint Online. Para ello, se utiliza el siguiente comando:
Connect-PnPOnline -Url https://tenant-admin.sharepoint.com -Interactive
Este cmdlet establece una conexión al centro de administración de SharePoint Online de la organización. Se recomienda utilizar el parámetro -Interactive para autenticarse de forma segura.
Cmdlets principales de PnP PowerShell
El módulo PnP PowerShell incluye numerosos cmdlets que permiten administrar distintos aspectos de Microsoft 365. Algunos de los más utilizados son los siguientes:
Gestión de scripts de sitio en SharePoint
- Obtener scripts de sitio disponibles:
Get-PnPSiteScript - Registrar un nuevo script de sitio:
Add-PnPSiteScript -Title "Nuevo Script" -Content $jsonScript - Eliminar un script de sitio:
Remove-PnPSiteScript -Identity "ID del Script"
Manejo de diseños de sitio
- Listar diseños de sitio disponibles:
Get-PnPSiteDesign - Asignar un diseño de sitio a una colección:
Apply-PnPSiteDesign -Identity "ID del Diseño" -WebUrl "URL del Sitio"
Compatibilidad y soporte de PnP PowerShell
Es importante señalar que PnP PowerShell es un módulo open-source mantenido por la comunidad, lo que significa que no cuenta con un SLA oficial por parte de Microsoft. Sin embargo, la comunidad de desarrolladores es muy activa y brinda soporte a través de foros y repositorios como GitHub.
Si encuentras un error o un problema en el módulo, puedes reportarlo en el siguiente enlace:
https://github.com/pnp/powershell/issues
Antes de reportar un problema, también es recomendable revisar la sección de debates en el repositorio de GitHub, ya que es posible que alguien más ya haya planteado una solución.
Utilizar PowerShell PnP es una de las mejores formas de optimizar la administración de entornos Microsoft 365. Gracias a su compatibilidad con distintos sistemas operativos y su amplio repertorio de cmdlets, facilita la automatización de tareas en SharePoint Online, Microsoft Teams y otros servicios en la nube.
Conociendo sus principales comandos y formas de instalación, cualquier administrador de sistemas puede sacarle el máximo partido. Comparte la información y así más personas sabrán cómo funciona esta extensiones.