Revoke-SPObjectSecurity
**適用先:**SharePoint Server 2016
Removes a security principal from a SPObjectSecurity object.
構文
Revoke-SPObjectSecurity [-Identity] <SPObjectSecurity> [-Principal] <SPClaim> [[-Rights] <String[]>] [-AssignmentCollection <SPAssignmentCollection>]
Revoke-SPObjectSecurity [-Identity] <SPObjectSecurity> -All <SwitchParameter> [-AssignmentCollection <SPAssignmentCollection>]
Detailed Description
このコマンドレットには、複数のパラメーター セットが含まれています。使用できるのは、1 つのパラメーター セットのパラメーターだけであり、異なるパラメーター セットのパラメーターを組み合わせることはできません。パラメーター セットの使用法に関する詳しい情報については、「コマンドレット パラメーター セット」を参照してください。
The Revoke-SPObjectSecurity cmdlet to remove a security principal, such as a user, from a SPObjectSecurity object. An SPObjectSecurity object is a common object that is used to represent the security access control list (ACL) of SharePoint administrative objects, in particular service applications.
Windows PowerShell for SharePoint 製品のアクセス許可と最新情報については、「Windows PowerShell for SharePoint Server 2016 リファレンス」のオンライン ドキュメントをご覧ください。
パラメーター
| Parameter | Required | Type | Description |
|---|---|---|---|
Identity |
Required |
Microsoft.SharePoint.Administration.AccessControl.SPObjectSecurity |
Specifies the SPObjectSecurity object from which the security principal is removed. You can use the Get- SPServiceApplicationSecurity cmdlet to get a SPObjectSecurity object . |
Principal |
Required |
Microsoft.SharePoint.Administration.Claims.SPClaim |
Specifies the principal for whom the rights are removed. The type must a valid name a principal; for example, Full Control. |
Rights |
Optional |
System.String[] |
Specifies the rights of the principal to revoke. The type must a valid array of strings that represents the rights of the principal to revoke. |
All |
Required |
System.Management.Automation.SwitchParameter |
Specifies that all security principals are removed from the specified SPObjectSecurity object. |
AssignmentCollection |
Optional |
Microsoft.SharePoint.PowerShell.SPAssignmentCollection |
適切な破棄を行うためにオブジェクトを管理します。 SPWeb や SPSite などのオブジェクトの使用によって大量のメモリが使用される場合があるので、Windows PowerShell スクリプトでこれらのオブジェクトを使用するには適切なメモリ管理が必要です。メモリの解放が必要になった場合は、 SPAssignment オブジェクトを使用して、変数へのオブジェクトの割り当てとオブジェクトの破棄を行うことができます。割り当てコレクションまたは Global パラメーターが使用されていない場合、 SPWeb 、 SPSite 、または SPSiteAdministration オブジェクトが使用されていると、オブジェクトは自動的に破棄されます。 注意 Global パラメーターが使用されている場合は、オブジェクトはすべてグローバル ストアに格納されます。 Stop-SPAssignment コマンドを使用してオブジェクトの使用または破棄を直接行わないと、メモリ不足のシナリオになる場合があります。 |
Input Types
Return Types
例
------------------EXAMPLE------------------
$security = Get-SPServiceApplicationSecurity $serviceApp -AdminRevoke-SPObjectSecurity $security "domain\user"Set-SPServiceApplicationSecurity $serviceApp -Admin $security
This example retrieves the SPObjectSecurity object corresponding to the administrator ACL on a service application, and removes a user from that ACL. The removed an administrator for the service application $serviceApp.