Administración de Productos de SharePoint 2010 mediante Windows PowerShell

 

Se aplica a: SharePoint Foundation 2010

Última modificación del tema: 2017-01-18

En este artículo se describe cómo usar Windows PowerShell con Productos de Microsoft SharePoint 2010 y se proporciona información general sobre los conceptos y cmdlets de Windows PowerShell básicos necesarios para aprovechar al máximo esta eficaz funcionalidad.

En este artículo:

  • Introducción

  • Acceso a Windows PowerShell para Productos de SharePoint 2010 mediante la Consola de administración de SharePoint 2010

  • Permisos

  • Scripts y directivas de ejecución

  • Aprendizaje de Windows PowerShell

Introducción

Windows PowerShell es una herramienta de scripting de línea de comandos que proporciona a un administrador acceso completo a las interfaces de programación de aplicaciones (API) aplicables y le permite desbloquear la funcionalidad de interactuar directamente con Productos de SharePoint 2010 para manipular aplicaciones web, colecciones de sitios, sitios, listas y mucho más. Además, el administrador tiene la capacidad de generar scripts de cmdlets (se pronuncia "command-lets"), lo cual contribuye a mejorar la experiencia en comparación con versiones del producto anteriores.

Windows PowerShell 2,0 es un requisito previo para instalar Productos de SharePoint 2010. Se instalará, si es necesario, al ejecutar la Herramienta de preparación de Productos de Microsoft SharePoint. De forma predeterminada, Windows PowerShell se encuentra en la siguiente ruta de acceso: <%SystemRoot%>\System32\WindowsPowerShell\v1.0\PowerShell.exe.

Nota

Windows PowerShell 2,0 es compatible con versiones anteriores de Windows PowerShell 1.0 y se instala en la carpeta v1.0.

Para obtener una lista de las nuevas características de la versión 2.0 de Windows PowerShell, vea el tema acerca de Windows PowerShell 2.0 (https://go.microsoft.com/fwlink/?linkid=113247&clcid=0xC0A).

Para una herramienta interactiva y guía que lo ayude a aprender la sintaxis de Windows PowerShell, consulte Herramienta Generador de comandos de Windows PowerShell y Guía de introducción.

Se recomienda usar Windows PowerShell para realizar tareas administrativas de línea de comandos. La herramienta de línea de comandos Stsadm ya no se usa, pero se ha incluido para ofrecer compatibilidad con las versiones anteriores del producto.

Acceso a Windows PowerShell para Productos de SharePoint 2010

Una vez instalado Productos de SharePoint 2010, los cmdlets de Windows PowerShell aplicables se encontrarán disponibles mediante la Consola de administración de SharePoint 2010 o la consola de Windows PowerShell. Con la consola de administración, podrá administrar cada uno de los aspectos de Productos de SharePoint 2010. Podrá crear nuevas colecciones de sitios, aplicaciones web, cuentas de usuario, aplicaciones de servicio, servidores proxy, etc. Mediante los comandos de la consola de administración, se generan objetos de SharePoint basados en la plataforma de Microsoft .NET. Estos objetos pueden aplicarse como entrada de comandos subsiguientes o almacenarse en variables locales para usarlos más adelante.

Con la consola de administración, no es necesario registrar el complemento que contiene los cmdlets. El registro del módulo Microsoft.SharePoint.PowerShell.dll para los cmdlets de SharePoint 2010 es automático, como resultado de la línea Add-PSSnapin Microsoft.SharePoint.PowerShell del archivo SharePoint.ps1 ubicado en %CommonProgramFiles%\Microsoft Shared\Web Server Extensions\14\Config\PowerShell\Registration. Si decide usar la consola de Windows PowerShell, deberá registrar el complemento de forma manual.

Independientemente de si usa la consola de administración o la consola de Windows PowerShell, también podrá cargar complementos adicionales. Para obtener más información, vea el tema sobre la personalización de perfiles (https://go.microsoft.com/fwlink/?linkid=183166&clcid=0xC0A).

Para tener acceso a la Consola de administración de SharePoint 2010

  1. En el menú Inicio, haga clic en Todos los programas.

  2. Haga clic en Productos de Microsoft SharePoint 2010.

  3. Haga clic en Consola de administración de SharePoint 2010.

Nota

La Consola de administración de SharePoint 2010 y la consola de Windows PowerShell también difieren en el uso de la opción ReuseThread, que define el modo en que se usa el modelo de subprocesos. El uso de la consola de administración se define mediante esta línea, {Host.Runspace.ThreadOptions = "ReuseThread"}, que se encuentra en el archivo SharePoint.ps1. Para obtener más información, vea el tema sobre PSThreadOptions (https://go.microsoft.com/fwlink/?linkid=183145&clcid=0xC0A).

Permisos

Para poder usar la consola de administración y los cmdlets de Windows PowerShell, compruebe si cumple con los siguientes requisitos mínimos: Consulte Add-SPShellAdmin.

Si no pertenece al rol SharePoint_Shell_Access o al grupo local WSS_Admin_WPG, use el cmdlet Add-SPShellAdmin. Al usar el cmdlet Add-SPShellAdmin, se agrega el usuario al grupo WSS_Admin_WPG en todos los servidores front-end web y al rol SharePoint_Shell_Access. Si la base de datos de destino no tiene un rol SharePoint_Shell_Access, éste se creará automáticamente. Una vez ejecutado el cmdlet Add-SPShellAdmin, el usuario puede ejecutar los cmdlets de Windows PowerShell para SharePoint 2010 en un entorno de varios conjuntos o granjas de servidores.

Al ejecutar el cmdlet Add-SPShellAdmin para agregar un usuario al rol SharePoint_Shell_Access, debe tener los siguientes permisos de seguridad:

  • Acceso al rol del servidor Securityadmin en la sesión de SQL y al rol db_owner en una base de datos.

  • Permiso administrativo en el equipo local.

Nota

Normalmente, la persona que usará el cmdlet Add-SPShellAdmin debe estar asociada con la cuenta de usuario que se usó para la instalación.

Debe ejecutar el cmdlet Add-SPShellAdmin para todas las bases de datos a las que desea otorgar acceso. Si no se especifica ninguna base de datos, se usará la base de datos de configuración de la granja de servidores. Si se especifica una base de datos, se incluirá la base de datos de contenido de la granja de servidores además de la base de datos de configuración de la granja que especificó.

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

Scripts y directivas de ejecución

Aunque puede usar Windows PowerShell para realizar una tarea administrativa, el beneficio real de usar los cmdlets de Windows PowerShell es la capacidad de usar un script para automatizar una serie de tareas. Un script es un archivo de texto sin formato que contiene uno o más comandos de Windows PowerShell. Los nombres de archivo de los scripts de Windows PowerShell tienen la extensión .ps1.

Cuando use un script, tenga en cuenta que la directiva de ejecución mínima requerida para Productos de SharePoint 2010 es RemoteSigned, mientras que la directiva predeterminada para Windows PowerShell es Restricted. Si la directiva se deja como Restricted, el Shell de administración de SharePoint 2010 cambiará la directiva para Windows PowerShell a RemoteSigned. Esto significa que el Shell de administración de SharePoint 2010 debe ejecutarse con un elevado permiso administrativo al seleccionar Ejecutar como administrador. Este cambio se aplicará a todas las sesiones de Windows PowerShell.

Para obtener información adicional sobre scripts y directivas de ejecución, consulte about_scripts y about_Execution_Policies respectivamente.

Aprendizaje de Windows PowerShell

Existen varios recursos de aprendizaje de Windows PowerShell para profesionales de TI de SharePoint que no están familiarizados con Windows PowerShell.

Centro de scripting de TechNet

En el Centro de scripting de TechNet se incluyen varios recursos para obtener información sobre los conceptos básicos del uso de Windows PowerShell. También se incluyen repositorios de scripts con ejemplos de scripts usados frecuentemente con diversos productos de Microsoft. En la siguiente tabla se muestran los recursos de aprendizaje principales.

Página Descripción

Documentación de Windows PowerShell en TechNet (https://go.microsoft.com/fwlink/?linkid=187813&clcid=0xC0A)

En esta sección de la biblioteca de TechNet se incluyen copias web de los temas de Ayuda principales de Windows PowerShell. También se incluyen copias web del documento de introducción a Windows PowerShell, la ayuda de PowerShell.exe y un manual de Windows PowerShell.

Scripting con Windows PowerShell (https://go.microsoft.com/fwlink/?linkid=187815&clcid=0xC0A)

La página principal de los recursos de aprendizaje de scripting de Windows PowerShell.

Manual de usuario de Windows PowerShell (https://go.microsoft.com/fwlink/?linkid=187817&clcid=0xC0A)

Guía basada en Web de introducción a Windows PowerShell.

Referencia rápida de Windows PowerShell (https://go.microsoft.com/fwlink/?linkid=187819&clcid=0xC0A)

Copia descargable del documento de referencia rápida instalado con Windows PowerShell.

Documentos de Windows PowerShell

Windows PowerShell instala los siguientes documentos en el grupo de programas de Windows PowerShell 1.0. También se pueden instalar después de descargar el paquete de documentación de Windows PowerShell 1.0 (https://go.microsoft.com/fwlink/?linkid=187822&clcid=0xC0A).

Archivo Descripción

GettingStarted.rtf

Se describe cómo comenzar a usar Windows PowerShell.

UsersGuide.rtf

Un manual para el lenguaje y el entorno de Windows PowerShell.

QuadFold.rtf

Un documento de referencia rápida imprimible sobre la sintaxis y los comandos de Windows PowerShell usados más frecuentemente. También se encuentra disponible como descarga desde el Centro de scripting de TechNet.

Al leer estos recursos, tenga en cuenta que resulta conveniente obtener información sobre los siguientes conceptos y cmdlets antes de usar Windows PowerShell para Productos de SharePoint 2010: