Revoke-SPObjectSecurity

从 SPObjectSecurity 对象中删除安全主体。

语法

RevokeOne

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

RevokeAll

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

说明

此 cmdlet 包含多个参数集。 只能使用一个参数集中的参数,而不能结合使用不同参数集中的参数。 若要详细了解如何使用参数集,请参阅 Cmdlet 参数集

用于 Revoke-SPObjectSecurity 从 SPObjectSecurity 对象中删除安全主体(例如用户)的 cmdlet。 SPObjectSecurity 对象是用于表示 SharePoint 管理对象(特别是服务应用程序)的安全访问控制列表 (ACL) 的常见对象。

有关 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

适用:SharePoint Server 2013、SharePoint Server 2016

指定将从指定 SPObjectSecurity 对象删除所有安全主体。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

RevokeAll
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-AssignmentCollection

适用:SharePoint Server 2013、SharePoint Server 2016

管理对象以便正确进行处理。 使用 SPWeb 或 SPSite 等对象可能会耗用大量内存,而且在 Windows PowerShell 脚本中使用这些对象需要正确管理内存。 通过使用 SPAssignment 对象,可以将对象分配给变量,然后在不需要这些对象时对它们进行处理,以释放内存。 在使用 SPWeb、SPSite 或 SPSiteAdministration 对象时,如果不使用分配集合或 Global 参数,则会自动处理这些对象。

使用全局参数时,所有对象均包含在全局存储中。 如果未立即使用对象,或未通过使用 Stop-SPAssignment 命令来处理对象,则可能会发生内存不足的情况。

参数属性

类型:SPAssignmentCollection
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:True
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Identity

适用:SharePoint Server 2013、SharePoint Server 2016

指定将从其中删除安全主体的 SPObjectSecurity 对象。 可以使用 Get-SPServiceApplicationSecurity cmdlet 获取 SPObjectSecurity 对象 。

参数属性

类型:SPObjectSecurity
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:1
必需:True
来自管道的值:True
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Principal

适用:SharePoint Server 2013、SharePoint Server 2016

指定要删除其权限的主体。

键入的值必须是有效的主体名称;例如,Full Control。

参数属性

类型:SPClaim
默认值:None
支持通配符:False
不显示:False

参数集

RevokeOne
Position:2
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Rights

适用:SharePoint Server 2013、SharePoint Server 2016

指定要取消的主体权限。

键入的值必须是表示要取消的主体权限的有效字符串数组。

参数属性

类型:

String[]

默认值:None
支持通配符:False
不显示:False

参数集

RevokeOne
Position:3
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

CommonParameters

此 cmdlet 支持通用参数:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息,请参阅 about_CommonParameters