共用方式為


Add-SPShellAdmin

 

適用版本: 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 角色時,使用者便會新增到所有網頁伺服器中的 WSS_Admin_WPG 群組。如果目標資料庫沒有 SharePoint_Shell_Access 角色,則會自動建立角色。

重要

為了使用 Windows PowerShell for SharePoint 2010 產品,使用者必須是設定資料庫的 SharePoint_Shell_Access 角色成員,而且是安裝 SharePoint 2010 產品之電腦上 WSS_ADMIN_WPG 本機群組的成員。不過,執行此 Cmdlet 的結果會讓 UserName 參數所指定的使用者具有如上所述受影響資料庫的 dbo_owner 角色存取權。因此,應該謹慎規劃可授與哪些使用者這個使用權。

Parameters

參數 必要 類型 描述

UserName

必要

System.String

指定要新增到目標資料庫中 SharePoint_Shell_Access 角色的使用者名稱。

AssignmentCollection

選用

Microsoft.SharePoint.PowerShell.SPAssignmentCollection

為能適當處置物件而管理物件。使用 SPWebSPSite 等物件可能會耗用大量的記憶體,因此在 Windows PowerShell 指令碼中使用這些物件時,必須適當地管理記憶體。您可以使用 SPAssignment 物件將物件指派給變數,並在不需要時處置這些物件,以釋放記憶體。使用 SPWebSPSiteSPSiteAdministration 物件時,若未使用指派集合或 Global 參數,將會自動處置這些物件。

注意

使用 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 角色。

See Also

Reference

Get-SPShellAdmin
Remove-SPShellAdmin