Revoke-SPObjectSecurity

參考

模組:: SharePointServer

適用於:: SharePoint Server 2013, SharePoint Server 2016

移除 SPObjectSecurity 物件的安全性主體。

Syntax

Revoke-SPObjectSecurity
      [-Identity] <SPObjectSecurity>
      [-Principal] <SPClaim>
      [[-Rights] <String[]>]
      [-AssignmentCollection <SPAssignmentCollection>]
      [<CommonParameters>]

Revoke-SPObjectSecurity
      [-Identity] <SPObjectSecurity>
      [-All]
      [-AssignmentCollection <SPAssignmentCollection>]
      [<CommonParameters>]

Description

此 Cmdlet 包含一個以上的參數集。您可能只會使用到一個參數集中的參數，而且您無法合併不同參數集中的參數。如需如何使用參數集的詳細資訊，請參閱 Cmdlet 參數集。

Revoke-SPObjectSecurity從 SPObjectSecurity 物件移除安全性主體的 Cmdlet，例如使用者。 SPObjectSecurity 物件是常見的物件，用來代表安全性存取控制清單， (ACL) SharePoint 系統管理物件，特別是服務應用程式。

如需 SharePoint 產品Windows PowerShell的許可權和最新資訊，請參閱 () 線上檔 https://go.microsoft.com/fwlink/p/?LinkId=251831 https://go.microsoft.com/fwlink/p/?LinkId=251831 。

範例

------------------範例------------------

$security = Get-SPServiceApplicationSecurity $serviceApp -Admin
Revoke-SPObjectSecurity $security "domain\user"
Set-SPServiceApplicationSecurity $serviceApp -Admin $security

此範例會擷取對應至服務應用程式上系統管理員 ACL 的 SPObjectSecurity 物件，並從該 ACL 中移除使用者。移除的是服務應用程式 $serviceApp 的管理員。

參數

-All

指定要從指定 SPObjectSecurity 物件移除的所有安全性主體。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server 2013, SharePoint Server 2016

-AssignmentCollection

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

使用 Global 參數時，所有物件會包含在全域儲存區內。如果不立即使用物件，或使用 Stop-SPAssignment 命令加以捨棄，則可能會有記憶體不足的狀況發生。

Type:	SPAssignmentCollection
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	SharePoint Server 2013, SharePoint Server 2016

-Identity

指定要移除其安全性主體的 SPObjectSecurity 物件。您可以使用 Cmdlet Get-SPServiceApplicationSecurity 來取得 SPObjectSecurity 物件。

Type:	SPObjectSecurity
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	SharePoint Server 2013, SharePoint Server 2016

-Principal

指定要移除其權限的主體。

其類型必須是有效的主體名稱，例如 [完全控制]。

Type:	SPClaim
Position:	2
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server 2013, SharePoint Server 2016

-Rights

指定要撤銷的主體權限。

此類型必須是有效的字串陣列，代表要撤銷的主體權限。

Type:	String[]
Position:	3
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server 2013, SharePoint Server 2016