Grant-SPObjectSecurity
適用版本： SharePoint Foundation 2010, SharePoint Server 2010
上次修改主題的時間： 2015-03-09
新增安全性主體至 SPObjectSecurity 物件。
Syntax
Grant-SPObjectSecurity [-Identity] <SPObjectSecurity> [-Principal] <SPClaim> [-Rights] <String[]> [-AssignmentCollection <SPAssignmentCollection>] [-Replace <SwitchParameter>]
詳細描述
Grant-SPObjectSecurity Cmdlet 會新增安全性主體 (例如使用者) 至 SPObjectSecurity 物件。在特定的服務應用程式中，SPObjectSecurity 物件是一種常用物件，用來代表 SharePoint 管理物件的安全性存取控制清單 (ACL)。
如需 Windows PowerShell for SharePoint 產品的權限及最新資訊，請參閱線上說明文件 (https://go.microsoft.com/fwlink/?LinkId=163185)。
Parameters
| 參數 | 必要 | 輸入 | 描述 |
|---|---|---|---|
Identity |
必要 |
Microsoft.SharePoint.Administration.AccessControl.SPObjectSecurity |
指定要新增安全性主體的目標 SPObjectSecurity 物件。您可以使用 Get-SPServiceApplicationSecurity Cmdlet 取得 SPObjectSecurity 物件。 |
Principal |
必要 |
Microsoft.SharePoint.Administration.Claims.SPClaim |
指定要套用權限的主體。 其類型必須是有效的主體名稱，例如 [完全控制]。 |
Rights |
必要 |
System.String[] |
指定要授與主體的權限。 此類型必須是有效的字串陣列，代表授與主體的權限。 |
AssignmentCollection |
選用 |
Microsoft.SharePoint.PowerShell.SPAssignmentCollection |
為能適當處置物件而管理物件。使用 SPWeb 或 SPSite 等物件可能會耗用大量的記憶體，因此在 Windows PowerShell 指令碼中使用這些物件時，必須適當地管理記憶體。您可以使用 SPAssignment 物件將物件指派給變數，並在不需要時處置這些物件，以釋放記憶體。使用 SPWeb、SPSite 或 SPSiteAdministration 物件時，若未使用指派集合或 Global 參數，將會自動處置這些物件。 使用 Global 參數時，所有物件會包含在全域儲存區內。若未立即使用物件，或未使用 Stop-SPAssignment 命令處置物件，將會發生記憶體不足的狀況。 |
Replace |
選用 |
System.Management.Automation.SwitchParameter |
以指定的新權限取代 SPObjectSecurity 物件上現有的權限。若未指定此參數，新的權限會新增至現有的權限。 |
輸入類型
傳回類型
Example
------------------範例------------------
$security = Get-SPServiceApplicationSecurity $serviceApp -Admin
Grant-SPObjectSecurity $security $principal "Full Control"
Set-SPServiceApplicationSecurity $serviceApp -Admin $security
此範例會擷取對應於服務應用程式上之管理員 ACL 的 SPObjectSecurity 物件，並新增使用者主體到該 ACL。新使用者是服務應用程式 $serviceApp 的管理員。