Add-SPShellAdmin

Agrega un usuario al rol SharePoint_Shell_Access para la base de datos especificada.

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

Administra objetos para su correcta eliminación. El uso de objetos como SPWeb o SPSite puede requerir una gran cantidad de memoria y su uso en scripts de Windows PowerShell requiere una administración adecuada de la memoria. Mediante el uso del objeto SPAssignment se pueden asignar objetos a una variable y eliminar los objetos cuando ya no sean necesarios para liberar memoria. Cuando se usan los objetos SPWeb, SPSite o SPSiteAdministration, los objetos se eliminan automáticamente si no se usa una colección de asignaciones o el parámetro Global.

Cuando se usa el parámetro Global, todos los objetos se guardan en el almacén global. Si los objetos no se usan de forma inmediata o se eliminan mediante el comando Stop-SPAssignment, puede producirse un error de memoria insuficiente.

Type:SPAssignmentCollection
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Confirm

Le pide confirmación antes de ejecutar el comando. Para obtener más información, escriba el siguiente comando: get-help about_commonparameters

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Database

Especifica el GUID de la base de datos o del objeto de base de datos que incluye el rol SharePoint_Shell_Access al que desea agregar el usuario. Si no se especifica el parámetro database, se usará la base de datos de configuración. La base de datos de configuración del conjunto de servidores siempre se incluye, incluso si se especifica otra base de datos.

Type:SPDatabasePipeBind
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-UserName

Especifica el nombre del usuario que se desea agregar al rol SharePoint_Shell_Access en la base de datos de destino.

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-WhatIf

Muestra un mensaje que describe el efecto del comando en lugar de ejecutar dicho comando. Para obtener más información, escriba el siguiente comando: get-help about_commonparameters

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition