Información general del módulo Microsoft.SharePoint.Powershell

Para obtener una lista de los cmdlets de SharePoint Server, vea Cmdlets de Microsoft.SharePoint.Powershell.

Acceso a PowerShell para SharePoint Server

Tras instalar SharePoint Server, los cmdlets de PowerShell correspondientes estarán disponibles en la Shell de administración de SharePoint 2016. Podrá administrar la mayoría de los aspectos de SharePoint Server en la Shell de administración de SharePoint. De este modo, podrá crear nuevas colecciones de sitios, aplicaciones web, cuentas de usuario, aplicaciones de servicio, proxies y mucho más. Los comandos que escriba en Shell de administración de SharePoint devuelven objetos de SharePoint basados en Microsoft .NET Framework. Puede aplicar estos objetos como entradas de comandos subsiguientes o para almacenar los objetos en variables locales y usarlos más tarde.

Con el Shell de administración de SharePoint, no es necesario registrar el complemento que contiene los cmdlets. El registro se controla mediante la Add-PSSnapin Microsoft.SharePoint.PowerShell línea del SharePoint.ps1 archivo. Este archivo se encuentra en la %CommonProgramFiles%\Microsoft Shared\Web Server Extensions\<version>\Config\PowerShell\Registration carpeta .

• <version> 15 es igual a SharePoint Server 2013
• y <version> 16 es igual a SharePoint Server 2016

Si decide usar la consola de PowerShell, deberá registrar el complemento de forma manual.

Tanto si usa el Shell de administración de SharePoint como la consola de PowerShell, también puede cargar complementos y módulos adicionales.

Nota:

El shell de administración de SharePoint y la consola de PowerShell usan de forma distinta la opción ReuseThread, que define el modo en que se usa el modelo de subprocesos. El uso del Shell de administración de SharePoint se define mediante esta línea, {Host.Runspace.ThreadOptions = "ReuseThread"}, que se encuentra en el SharePoint.ps1 archivo. Para obtener más información, vea PSThreadOptions.

Permisos

Antes de poder usar el Add-SPShellAdmin cmdlet para conceder permisos a los usuarios para ejecutar cmdlets de SharePoint Server, compruebe que cumple todos los requisitos mínimos siguientes:

• Debe pertenecer al rol fijo de servidor SecurityAdmin en la instancia de SQL Server.
• Debe pertenecer al grupo Administradores en el servidor donde vaya a usar el cmdlet de PowerShell.

Nota:

Si no dispone de estos permisos, póngase en contacto con el administrador del programa de instalación o con el administrador de SQL Server para solicitar los permisos.

Para más información sobre permisos de PowerShell, vea Add-SPShellAdmin.

Si no tiene pertenencia al rol de SharePoint_Shell_Access o WSS_Admin_WPG grupo local, use el Add-SPShellAdmin cmdlet para agregar el grupo de WSS_Admin_WPG en todos los servidores front-end web de la granja de servidores de SharePoint y el rol de SharePoint_Shell_Access . Si la base de datos de SQL Server no tiene un rol de SharePoint_Shell_Access, el rol se crea automáticamente al ejecutar el Add-SPShellAdmin cmdlet. Después de ejecutar el Add-SPShellAdmin cmdlet, los usuarios pueden ejecutar cmdlets de PowerShell de SharePoint en un entorno de granja de servidores de varios servidores.

Nota:

Cuando instale SharePoint Server, la cuenta de usuario desde la que se inicie la instalación dispondrá de los permisos necesarios para usar los cmdlets de PowerShell. Si no se ha agregado ningún usuario para ejecutar un cmdlet de PowerShell, puede usar el Add-SPShellAdmin cmdlet para agregarlos.

Para ver una lista de todos los cmdlets SPShellAdmin , desde un símbolo del sistema de PowerShell, escriba Get-Command -Noun SPShellAdmin.

Secuencias de comandos y directivas de ejecución

Aunque puede usar PowerShell de Microsoft para realizar una tarea administrativa, también puede usar una secuencia de comandos para automatizar una serie de tareas. Una secuencia de comandos es un archivo de texto que contiene uno o más comandos de PowerShell de Microsoft. Los scripts de Microsoft PowerShell tienen una extensión de nombre de .ps1 archivo.

Para ejecutar scripts, la directiva de ejecución mínima necesaria para SharePoint Server es RemoteSigned, aunque la directiva predeterminada para PowerShell es Restringida. Si la directiva se deja como Restringida, el Shell de administración de SharePoint cambia la directiva de PowerShell a RemoteSigned. Esto quiere decir que tendrá que seleccionar la opción Ejecutar como administrador para iniciar la Shell de administración de SharePoint con permisos elevados de administrador. Este cambio se aplica a todas las sesiones de PowerShell. Para obtener más información sobre los scripts y las directivas de ejecución, consulte about_scripts y Acerca de las directivas de ejecución.