¿Cómo ejecutar scripts de PowerShell para SharePoint Online?

Requisito: Ejecute el script de PowerShell en SharePoint Online.

¿Cómo ejecutar un script de PowerShell para SharePoint Online?

¡PowerShell es un potente lenguaje de secuencias de comandos que se puede utilizar para automatizar tareas de SharePoint Online! Esta publicación de blog le mostrará cómo ejecutar scripts de PowerShell para SharePoint Online y cómo puede usarlos para administrar su entorno de SharePoint Online.

A diferencia de los scripts de PowerShell locales de SharePoint que deben ejecutarse únicamente desde el servidor de la granja de SharePoint, los scripts de PowerShell de SharePoint Online se pueden ejecutar desde el lado del cliente (¡desde sus escritorios!) cuando se instalan los módulos necesarios. Este artículo está escrito para principiantes absolutos que necesitan ejecutar scripts de PowerShell para SharePoint Online.

Paso 1: Instale los módulos de PowerShell necesarios para SharePoint Online

¿Cómo ejecutar un script de PowerShell para SharePoint Online? Antes de ejecutar scripts de PowerShell para SharePoint Online, debemos instalar el módulo o componentes necesarios en nuestra máquina local. Entonces, ¿qué módulo instalar? Bueno, eso depende de qué cmdlets utilice su secuencia de comandos.

Si su secuencia de comandos de PowerShell usa cmdlets para la administración de SharePoint Online, debe instalar el “Módulo de PowerShell de SharePoint Online”: ¿Cómo instalar el módulo de PowerShell de SharePoint Online?
Si está utilizando el modelo de objetos del lado del cliente, debe instalar el SDK de componentes de cliente de SharePoint Online: ¿Cómo instalar el SDK de componentes de cliente de SharePoint Online?
¿Cómo ejecuto un script PnP PowerShell para SharePoint Online? Si su script de PowerShell usa cmdlets PnP PowerShell, debe tener instalado el módulo PnP PowerShell para SharePoint Online. ¿Cómo instalar el módulo PnP PowerShell para SharePoint Online?

Generalmente, es una buena idea tener estos tres en su máquina cliente para administrar SharePoint Online usando PowerShell.

Paso 2: use PowerShell ISE para ejecutar sus scripts de PowerShell para SharePoint Online

PowerShell ISE es una gran herramienta para crear, depurar y ejecutar scripts de PowerShell. Aunque puede usar la consola de Windows PowerShell o el Shell de administración de SharePoint Online, recomiendo usar PowerShell ISE. Le brinda un excelente resaltado de sintaxis, depuración con puntos de interrupción, funciones IntelliSense y mucho más. PowerShell ISE está preinstalado en los sistemas operativos Windows 7, Windows 2012 y posteriores en “C:\WINDOWS\system32\WindowsPowerShel \v1.0”. En versiones anteriores, como Windows Server 2008, debe agregarlo a través de las funciones de Windows si la aplicación PowerShell ISE aún no está instalada.

¿Cómo ejecutar scripts de PowerShell en SharePoint Online?

Establecer política de ejecución:

Por motivos de seguridad, la ejecución de scripts de PowerShell está deshabilitada de forma predeterminada en Windows 7 y Windows Server 2008 R2. Escribir comandos en el ISE y ejecutarlos funcionará. Aún así, una vez guardados como script, recibirá el siguiente error cuando intente ejecutarlo: ScriptName.ps1 no se puede cargar porque la ejecución de scripts está deshabilitada. en este sistema. Consulte "obtener ayuda sobre_firmar" para obtener más detalles

Por lo tanto, ejecute “Set-ExecutionPolicy RemoteSigned” una vez.

Muy bien, ¿cómo ejecutar scripts de PowerShell de SharePoint Online en PowerShell ISE?

Vaya a Inicio >> Escriba "PowerShell ISE".
Haga clic derecho y abra PowerShell ISE con "Ejecutar como administrador" si tiene UAC habilitado.
Ahora, puede comenzar a escribir su secuencia de comandos de PowerShell o copiar y pegar la secuencia de comandos y luego hacer clic en el botón "Ejecutar secuencia de comandos" de la barra de herramientas. (Tecla de método abreviado: F5)

Cualquier resultado de su secuencia de comandos aparecerá en la ventana de resultados debajo del editor de secuencias de comandos. También puede utilizar Visual Studio Code para ejecutar scripts de PowerShell.

¿Cómo ejecutar un archivo ps1 en el Shell de administración de SharePoint Online?

SharePoint Online Management Shell es un módulo de Windows PowerShell que le permite ejecutar comandos para administrar su entorno de SharePoint Online en Office 365. Para ejecutar cualquier archivo de script de PowerShell (.ps1) con SharePoint Online Management Shell, haga lo siguiente:

Inicie el Shell de administración de SharePoint Online >> Navegue hasta la carpeta donde están guardados sus scripts.
Simplemente escriba el nombre del archivo de secuencia de comandos (use la tecla "tab" para completar con tabulación el nombre del archivo o ingrese manualmente ".\.ps1") y presione Enter. P.ej. Tenemos un script de PowerShell "Get-SPODeletedSites.ps1" guardado en la carpeta "C:\Scripts" que enumera todos los sitios eliminados en el inquilino.

Es posible que deba ingresar su nombre de usuario y contraseña e iniciar sesión una vez (¡debe tener permisos de administrador de SharePoint Online para conectarse al Shell de administración de SPO, por cierto!). También puede ejecutar un script de PowerShell simplemente haciendo clic derecho en el archivo .ps1 y eligiendo "Ejecutar con PowerShell" en el Explorador de archivos de Windows.

¿Cómo ejecuto un script de ps1 desde la línea de comando?

Para ejecutar un script de PowerShell desde la línea de comandos, use: PowerShell

¿Cómo me conecto a SharePoint Online desde PowerShell? Debe establecer la conexión a SharePoint Online desde PowerShell utilizando el comando de PowerShell "Connect-SPOService" y luego ejecutar cualquier comando de PowerShell de SharePoint Online disponible. P.ej.,


#Connect to SharePoint Online Admin center
Connect-SPOService -URL "https://YourDomain-admin.sharepoint.com" -Credential (Get-Credential)

#Get All Site collections
Get-SPOSite

#Get all SharePoint Online users from site
Get-SPOUser -site "https://salaudeen.sharepoint.com/sites/retail"

Recibirá un mensaje para ingresar su nombre de usuario y contraseña. La conexión a SharePoint Online desde PowerShell se explica en otra publicación: Conectarse a SharePoint Online PowerShell

Terminando

En conclusión, ejecutar scripts de PowerShell para SharePoint Online puede ser una forma poderosa de administrar y automatizar tareas en su entorno de SharePoint. Con la capacidad de crear, recuperar, actualizar y eliminar listas, bibliotecas, sitios y otros objetos de SharePoint, puede optimizar su flujo de trabajo, automatizar tareas repetitivas y hacer que su entorno de SharePoint sea más eficiente. Recuerde que antes de ejecutar cualquier script, es importante probarlo en un entorno que no sea de producción y tener instalados los permisos adecuados y el módulo de SharePoint Online.

Preguntas frecuentes:

¿Cómo me conecto a SharePoint Online con cuentas habilitadas para MFA desde PowerShell?

Para conectarse con SharePoint Online con una cuenta habilitada para la autenticación multifactor, simplemente deje el parámetro Credencial del cmdlet "Connect-SPOService". Por ejemplo, Connect-SPOService -Url https://YourTenant-admin.sharepoint.com. Si está utilizando el módulo PnP PowerShell SharePoint, use el interruptor "Interactivo", "Connect-PnPOnline -URL $SiteURL -Interactive"
Más información: Conéctese a SharePoint Online PowerShell con MFA

¿Cómo uso SharePoint Online PnP PowerShell?

Suponiendo que tiene instalado el módulo PnP PowerShell para SharePoint Online, use el siguiente comando "Connect-PnPOnline" para conectarse con el sitio de SharePoint Online. Una vez conectado, puede realizar operaciones en la lista de SharePoint, elementos de la lista, subsitios, etc.
Más información: ¿Cómo conectarse a SharePoint Online usando PnP PowerShell?

¿Cómo programo una secuencia de comandos de PowerShell de SharePoint Online para que se ejecute todos los días?

Puede automatizar sus scripts de PowerShell con el programador de tareas de Windows. Simplemente abra el Programador de tareas desde Inicio >> Herramientas administrativas, cree una tarea básica y siga el asistente. ¡También puede programar un script de PowerShell con Azure Automation!
Más información: ¿Cómo crear una tarea programada para SharePoint Online PowerShell?

¿Cómo habilito la infraestructura de publicación del servidor SharePoint mediante PowerShell?

Puede activar cualquier característica de SharePoint en la colección de sitios de SharePoint o en el nivel de sitio mediante PowerShell. Features.Add método en CSOM o Enable-PnPFeature para habilitar una característica de SharePoint.
Más información: Habilite la característica SharePoint Online en PowerShell