Revoke-SPObjectSecurity
適用版本： SharePoint Foundation 2010, SharePoint Server 2010
上次修改主題的時間： 2015-03-09
移除 SPObjectSecurity 物件的安全性主體。
Syntax
Revoke-SPObjectSecurity [-Identity] <SPObjectSecurity> [-Principal] <SPClaim> [[-Rights] <String[]>] [-AssignmentCollection <SPAssignmentCollection>]
Revoke-SPObjectSecurity [-Identity] <SPObjectSecurity> -All <SwitchParameter> [-AssignmentCollection <SPAssignmentCollection>]
詳細描述
Revoke-SPObjectSecurity Cmdlet 會移除 SPObjectSecurity 物件的安全性主體 (例如使用者)。在特定的服務應用程式中，SPObjectSecurity 物件是一種常用物件，用來代表 SharePoint 管理物件的安全性存取控制清單 (ACL)。
Parameters
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Identity |
必要 |
Microsoft.SharePoint.Administration.AccessControl.SPObjectSecurity |
指定要移除其安全性主體的 SPObjectSecurity 物件。您可以使用 Get-SPServiceApplicationSecurity Cmdlet 取得 SPObjectSecurity 物件。 |
Principal |
必要 |
Microsoft.SharePoint.Administration.Claims.SPClaim |
指定要移除其權限的主體。 其類型必須是有效的主體名稱，例如 [完全控制]。 |
Rights |
選用 |
System.String[] |
指定要撤銷的主體權限。 此類型必須是有效的字串陣列，代表要撤銷的主體權限。 |
All |
必要 |
System.Management.Automation.SwitchParameter |
指定要從指定 SPObjectSecurity 物件移除的所有安全性主體。 |
AssignmentCollection |
選用 |
Microsoft.SharePoint.PowerShell.SPAssignmentCollection |
為能適當處置物件而管理物件。使用 SPWeb 或 SPSite 等物件可能會耗用大量的記憶體，因此在 Windows PowerShell 指令碼中使用這些物件時，必須適當地管理記憶體。您可以使用 SPAssignment 物件將物件指派給變數，並在不需要時處置這些物件，以釋放記憶體。使用 SPWeb、SPSite 或 SPSiteAdministration 物件時，若未使用指派集合或 Global 參數，將會自動處置這些物件。 注意 使用 Global 參數時，所有物件會包含在全域儲存區內。若未立即使用物件，或未使用 Stop-SPAssignment 命令處置物件，將會發生記憶體不足的狀況。 |
輸入類型
傳回類型
Example
------------------範例------------------
$security = Get-SPServiceApplicationSecurity $serviceApp -Admin
Revoke-SPObjectSecurity $security "domain\user"
Set-SPServiceApplicationSecurity $serviceApp -Admin $security
此範例會擷取對應於服務應用程式上之管理員 ACL 的 SPObjectSecurity 物件，並且從該 ACL 移除使用者。移除的是服務應用程式 $serviceApp 的管理員。