Add-SPShellAdmin

项目
10/14/2016

适用于： SharePoint Foundation 2010, SharePoint Server 2010

上一次修改主题： 2015-03-09

向指定数据库的 SharePoint_Shell_Access 角色添加用户。

Syntax

Add-SPShellAdmin [-UserName] <String> [-AssignmentCollection <SPAssignmentCollection>] [-Confirm [<SwitchParameter>]] [-database <SPDatabasePipeBind>] [-WhatIf [<SwitchParameter>]]

详细说明

重要

在运行此 cmdlet 以将用户添加到 SharePoint_Shell_Access 角色中时，您必须拥有 SQL Server 实例上 securityadmin 固定服务器角色和所有受影响数据库上 db_owner 固定服务器角色中的成员身份，并且在本地计算机上必须拥有本地管理权限。
此 cmdlet 仅用于使用 Windows 身份验证的数据库。使用 SQL 身份验证的数据库不必使用此 cmdlet；如果使用可能会发出错误消息。

按照以下操作，使用 Add-SPShellAdmin cmdlet 将用户添加到 SharePoint_Shell_Access 角色中：

如果您仅指定用户，用户将添加到服务器场配置数据库的角色中。
如果您使用 database 参数，用户将添加到服务器场配置数据库、管理中心内容数据库和指定数据库的角色中。由于大多数管理操作都需要访问管理中心内容数据库，因此使用 database 参数是首选的方法。

在将用户添加到 SharePoint_Shell_Access 角色后，该用户将添加到所有 Web 服务器上的 WSS_Admin_WPG 组中。如果目标数据库没有 SharePoint_Shell_Access 角色，则会自动创建该角色。

重要

若要对 SharePoint 2010 产品使用 Windows PowerShell，用户必须是配置数据库上 SharePoint_Shell_Access 角色的成员，并且是安装了 SharePoint 2010 产品的计算机上 WSS_ADMIN_WPG 本地组的成员。但是，运行此 cmdlet 的结果是，使用 UserName 参数指定的用户将具有上述受影响的数据库上的 dbo_owner 角色访问权限。因此，您应该仔细规划向哪些用户授予此访问权限。

Parameters

参数	是否必需	类型	说明
UserName	必需	System.String	指定要添加到目标数据库的 SharePoint_Shell_Access 角色的用户名。
AssignmentCollection	可选	Microsoft.SharePoint.PowerShell.SPAssignmentCollection	管理对象以便正确进行处理。使用 SPWeb 或 SPSite 等对象可能会耗用大量内存，而且在 Windows PowerShell 脚本中使用这些对象需要正确管理内存。通过使用 SPAssignment 对象，可以将对象分配给变量，然后在不需要这些对象时对它们进行处理，以释放内存。在使用 SPWeb、SPSite 或 SPSiteAdministration 对象时，如果不使用分配集合或 Global 参数，则会自动处理这些对象。 Note 在使用 Global 参数时，所有对象均包含在全局存储中。如果未立即使用对象，或未通过使用 Stop-SPAssignment 命令来处理对象，则可能会发生内存不足的情况。
Confirm	可选	System.Management.Automation.SwitchParameter	在执行命令之前提示您确认。有关详细信息，请键入以下命令：get-help about_commonparameters
database	可选	Microsoft.SharePoint.PowerShell.SPDatabasePipeBind	指定要向其添加用户的 SharePoint_Shell_Access 角色所属的数据库或数据库对象的 GUID。如果未指定 database 参数，则使用配置数据库。将始终包含服务器场配置数据库，即使指定了其他数据库也是如此。
WhatIf	可选	System.Management.Automation.SwitchParameter	显示一条描述命令作用的消息，而不执行命令。有关详细信息，请键入以下命令：get-help about_commonparameters

输入类型

返回类型

Example

-------------------示例 1-------------------------

Add-SPShellAdmin -UserName CONTOSO\User1

此示例将名为 User1 的新用户仅添加到服务器场配置数据库中的 SharePoint_Shell_Access 角色，同时确保将该用户添加到服务器场的每台服务器上的 WSS_Admin_WPG 本地组。

-------------------示例 2-------------------------

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

此示例通过将数据库 GUID 传递到 cmdlet，从而将名为 User1 的新用户同时添加到指定内容数据库和配置数据库的 SharePoint_Shell_Access 角色中。

-------------------示例 3-------------------------

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

此示例将名为 User1 的新用户同时添加到指定管理中心内容数据库和配置数据库的 SharePoint_Shell_Access 角色。

-------------------示例 4-------------------------

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

此示例通过将数据库名称传递到 cmdlet，从而将名为 User1 的新用户同时添加到指定内容数据库和配置数据库的 SharePoint_Shell_Access 角色中。

通过