Administración de Productos de SharePoint 2010 mediante 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.

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.

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.

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.

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).

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:

• Get-Command (https://go.microsoft.com/fwlink/?linkid=171069\&clcid=0xC0A)

• Get-Member (https://go.microsoft.com/fwlink/?linkid=171070\&clcid=0xC0A)

• Get-Help (https://go.microsoft.com/fwlink/?linkid=171068\&clcid=0xC0A).

• Alias (https://go.microsoft.com/fwlink/?linkid=113207\&clcid=0xC0A)

• Canalizaciones en Windows PowerShell (https://go.microsoft.com/fwlink/?linkid=187808\&clcid=0xC0A)

• Conjuntos de parámetros de cmdlets (https://go.microsoft.com/fwlink/?linkid=187810\&clcid=0xC0A)

• Foreach-Object (https://go.microsoft.com/fwlink/?linkid=187812\&clcid=0xC0A)

• Where-Object (https://go.microsoft.com/fwlink/?linkid=187811\&clcid=0xC0A)