共用方式為


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

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

See Also

Reference

Revoke-SPObjectSecurity
Get-SPServiceApplicationSecurity