Revoke-SPObjectSecurity
**Gilt für:**SharePoint Server 2016
**Letztes Änderungsdatum des Themas:**2015-03-09
Removes a security principal from a SPObjectSecurity object.
Syntax
Revoke-SPObjectSecurity [-Identity] <SPObjectSecurity> [-Principal] <SPClaim> [[-Rights] <String[]>] [-AssignmentCollection <SPAssignmentCollection>]
Revoke-SPObjectSecurity [-Identity] <SPObjectSecurity> -All <SwitchParameter> [-AssignmentCollection <SPAssignmentCollection>]
Detailed Description
Das Cmdlet umfasst mehrere Parametersätze. Sie können nur Parameter aus einem der Parametersätze verwenden und können Parameter aus unterschiedlichen Parametersätzen nicht miteinander kombinieren. Weitere Informationen zur Verwendung von Parametersätzen finden Sie unter Cmdlet-Parametersätze.
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.
Informationen zu Berechtigungen sowie Aktuelles zu Windows PowerShell für SharePoint-Produkte finden Sie in der Onlinedokumentation in der Referenz zu Windows PowerShell für SharePoint Server 2016.
Parameter
| 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 |
Verwaltet Objekte zum Zweck der ordnungsgemäßen Beseitigung. Die Verwendung von Objekten wie beispielsweise SPWeb oder SPSite kann sehr viel Arbeitsspeicher erfordern, und für die Verwendung dieser Objekte in Windows PowerShell-Skripts muss der Arbeitsspeicher entsprechend verwaltet werden. Mit dem SPAssignment -Objekt können Sie einer Variablen Objekte zuweisen und die Objekte beseitigen, wenn sie nicht mehr benötigt werden, um Arbeitsspeicher freizugeben. Wenn die Objekte SPWeb , SPSite oder SPSiteAdministration verwendet werden, werden diese automatisch beseitigt, falls keine Zuweisungsauflistung oder kein Global -Parameter verwendet wird. Hinweis Wenn der Global -Parameter verwendet wird, sind alle Objekte im globalen Speicher enthalten. Es kann vorkommen, dass nicht genügend Arbeitsspeicher vorhanden ist, falls Objekte nicht sofort verwendet werden oder mit dem Befehl Stop-SPAssignment beseitigt werden. |
Input Types
Return Types
Beispiel
------------------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.