Compartir a través de


Cmdlets de SharePoint Server

Para obtener una lista de los cmdlets de SharePoint Server, consulte cmdlets de SharePoint Server

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 del módulo de Microsoft.SharePoint.PowerShell.dll para los cmdlets de SharePoint Server es automático, como resultado de la Microsoft Add-PSSnapin. Línea de SharePoint.PowerShell en el archivo SharePoint.ps1 que se encuentra en %CommonProgramFiles%\Microsoft Shared\Web Server Extensions<version>\Config\PowerShell\Registration, donde la versión "15" es igual a SharePoint Server 2013 y la versión "16" es igual a SharePoint Server 2016. Si decide usar la consola de PowerShell, deberá registrar el complemento de forma manual.

Tanto si usa la Shell de administración de SharePoint como la consola de PowerShell, podrá cargar otros complementos.

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 con esta línea ({Host.Runspace.ThreadOptions = "ReuseThread"}) del archivo SharePoint.ps1. Para obtener más información, vea PSThreadOptions.

Permisos

Si quiere usar el cmdlet Add-SPShellAdmin para conceder permisos a los usuarios para que usen cmdlets de SharePoint Server, asegúrese de que cumple los requisitos mínimos siguientes:

  • Debe ser miembro del 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 es miembro del rol SharePoint_Shell_Access o del grupo local WSS_Admin_WPG, use el cmdlet Add-SPShellAdmin para agregar el grupo WSS_Admin_WPG a todos los servidores web front-end de la granja de servidores de SharePoint y al rol SharePoint_Shell_Access. Si la base de datos de SQL Server no tiene el rol SharePoint_Shell_Access, dicho rol se creará automáticamente cuando inicie el cmdlet Add-SPShellAdmin. Tras iniciar el cmdlet Add-SPShellAdmin, los usuarios podrá usar los cmdlets de PowerShell de SharePoint en entornos de granjas 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. En caso de que no se haya agregado algún usuario para usar un cmdlet de PowerShell, use el cmdlet Add-SPShellAdmin para agregar usuarios.

Para ver una lista de todos los cmdlets SPShellAdmin, en un símbolo del sistema de PowerShell_2nd_NoVer, 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 nombres de archivo de las secuencias de comandos de PowerShell de Microsoft tienen la extensión .ps1.

Para iniciar scripts, la directiva de ejecución mínima necesaria para SharePoint Server es RemoteSigned, aunque la directiva predeterminada para PowerShell es Restricted. Si la directiva se deja como Restricted, el shell de administración de SharePoint cambiará 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 aplicará en todas las sesiones de PowerShell. Para obtener más información, vea Enumeración de ExecutionPolicy

Para obtener más información sobre scripts y directivas de ejecución, vea about_scripts yabout_Execution_Policies respectivamente.