Add-SPShellAdmin

Syntax

Add-SPShellAdmin
   [-UserName] <String>
   [-AssignmentCollection <SPAssignmentCollection>]
   [-Confirm]
   [-Database <SPDatabasePipeBind>]
   [-WhatIf]
   [<CommonParameters>]

Description

Al ejecutar este cmdlet para agregar un usuario al rol SharePoint_Shell_Access, debe pertenecer al rol fijo de servidor securityadmin en la instancia de SQL Server y al rol fijo de base de datos db_owner en todas las bases de datos pertinentes, y debe disponer de permisos administrativos locales en el equipo local.

Este cmdlet solo se ha diseñado para su uso con una base de datos que use la autenticación de Windows. No es necesario usarlo para bases de datos que usan la autenticación de SQL; de hecho, esto podría generar un mensaje de error.

Use el cmdlet Add-SPShellAdmin para agregar un usuario al rol SharePoint_Shell_Access, como se muestra a continuación:

-- Si solo especifica el usuario, este se agregará al rol de la base de datos de configuración del conjunto o la granja de servidores.

-- Si usa el parámetro database, el usuario se agregará al rol en la base de datos de configuración de la granja de servidores, en la base de datos de contenido de Administración central y en la base de datos especificada. El uso del parámetro database es el método preferido, ya que la mayoría de las operaciones administrativas requieren acceso a la base de datos de contenido de Administración central.

El usuario se agrega al grupo WSS_Admin_WPG en todos los servidores web cuando se agrega al rol SharePoint_Shell_Access. Si la base de datos de destino no tiene un rol SharePoint_Shell_Access, este se creará automáticamente.

Para usar Windows PowerShell para productos de SharePoint, un usuario debe ser miembro del rol de SharePoint_Shell_Access en la base de datos de configuración y miembro del grupo local de WSS_ADMIN_WPG en el equipo donde está instalado SharePoint Products.

Sin embargo, el resultado de ejecutar este cmdlet es que el usuario especificado con el parámetro UserName tendrá el rol SPDataAccess , si existe, o db_owner rol, si el rol SPDataAccess no existe, en las bases de datos afectadas, como se describió anteriormente. Por lo tanto, debe planear detenidamente qué usuarios recibirán este acceso.

Por lo tanto, debe planear detenidamente qué usuarios recibirán este acceso.

Para obtener permisos y la información más reciente sobre Windows PowerShell para productos de SharePoint, consulte la documentación en línea en https://go.microsoft.com/fwlink/p/?LinkId=251831.

Ejemplos

------------------EJEMPLO 1------------------

Add-SPShellAdmin -UserName CONTOSO\User1

En este ejemplo se agrega un nuevo usuario llamado User1 al rol SharePoint_Shell_Access únicamente en la base de datos de configuración del conjunto de servidores y, además, se garantiza que el usuario se agrega al grupo local WSS_Admin_WPG en todos los servidores del conjunto.

------------------EJEMPLO 2------------------

Add-SPShellAdmin -UserName CONTOSO\User1 -database 4251d855-3c15-4501-8dd1-98f960359fa6

En este ejemplo, se agrega un nuevo usuario denominado User1 al rol SharePoint_Shell_Access en la base de datos de contenido especificada y en la base de datos de configuración; para ello, se pasa un GUID de base de datos al cmdlet.

------------------EJEMPLO 3------------------

Get-SPDatabase | Where-Object {$_.WebApplication -like "SPAdministrationWebApplication"} | Add-SPShellAdmin CONTOSO\User1

En este ejemplo, se agrega un nuevo usuario llamado User1 al rol SharePoint_Shell_Access en la base de datos de contenido de Administración central especificada y en la base de datos de configuración.

------------------EJEMPLO 4------------------

Get-SPDatabase | ?{$_.Name -eq "WSS_Content"} | Add-SPShellAdmin -Username CONTOSO\User1

En este ejemplo, se agrega un nuevo usuario denominado User1 al rol SharePoint_Shell_Access en la base de datos de contenido especificada y en la base de datos de configuración; para ello, se pasa el nombre de la base de datos al cmdlet.

Parámetros

-AssignmentCollection

-Confirm

-Database

-UserName

-WhatIf