Revoke-SPObjectSecurity
**適用版本:**SharePoint Server 2016
**上次修改主題的時間:**2015-03-09
移除 SPObjectSecurity 物件的安全性主體。
語法
Revoke-SPObjectSecurity [-Identity] <SPObjectSecurity> [-Principal] <SPClaim> [[-Rights] <String[]>] [-AssignmentCollection <SPAssignmentCollection>]
Revoke-SPObjectSecurity [-Identity] <SPObjectSecurity> -All <SwitchParameter> [-AssignmentCollection <SPAssignmentCollection>]
詳細描述
此 Cmdlet 包含一個以上的參數集。您可能只使用一個參數集中的參數,但不可以結合不同參數集的參數。如需如何使用參數集的詳細資訊,請參閱 Cmdlet Parameter Sets。
Revoke-SPObjectSecurity Cmdlet 會移除 SPObjectSecurity 物件的安全性主體 (例如使用者)。在特定的服務應用程式中, SPObjectSecurity 物件是一種常用物件,用來代表 SharePoint 管理物件的安全性存取控制清單 (ACL)。
如需 Windows PowerShell for SharePoint 產品的權限及最新資訊,請參閱線上文件 Windows PowerShell for SharePoint Server 2016 參考。
參數
參數 | 必要 | 類型 | 說明 |
---|---|---|---|
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 命令處置物件,將會發生記憶體不足的狀況。 |
AutoGenParams
參數 | 必要 | 類型 | 說明 |
---|---|---|---|
Identity |
必要 |
Microsoft.SharePoint.Administration.AccessControl.SPObjectSecurity |
|
Principal |
必要 |
Microsoft.SharePoint.Administration.Claims.SPClaim |
|
Rights |
選用 |
System.String[] |
|
All |
必要 |
System.Management.Automation.SwitchParameter |
|
AssignmentCollection |
選用 |
Microsoft.SharePoint.PowerShell.SPAssignmentCollection |
輸入類型
傳回類型
範例
------------------範例------------------
$security = Get-SPServiceApplicationSecurity $serviceApp -AdminRevoke-SPObjectSecurity $security "domain\user"Set-SPServiceApplicationSecurity $serviceApp -Admin $security
此範例會擷取對應於服務應用程式上之管理員 ACL 的 SPObjectSecurity 物件,並且從該 ACL 移除使用者。移除的是服務應用程式 $serviceApp
的管理員。
另請參閱
Grant-SPObjectSecurity
Get-SPServiceApplicationSecurity
https://msdn.microsoft.com/zh-tw/library/ff607645(v=office.16)