Set-SPOSiteRestrictedAppAccessControlMode

将站点级应用程序限制策略 Allow 的活动模式设置为 或 Deny,保留站点启用和这两个列表。

语法

Default (默认值)

Set-SPOSiteRestrictedAppAccessControlMode
    [-Identity] <String>
    -Mode <String>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

说明

使用 Set-SPOSiteRestrictedAppAccessControlMode cmdlet 更改网站强制执行的列表。 此 cmdlet 仅更改活动模式。 它保留站点启用以及允许列表和拒绝列表。

应用程序限制为已具有 Microsoft Entra 许可和 SharePoint 权限的应用程序添加 SharePoint 授权边界。 它从不授予权限,也不会取代 Entra 同意。 请求必须同时通过现有权限模型和应用程序限制。

活动模式选择强制执行的列表:

  • 允许 - 允许列表中的应用程序通过应用程序限制检查,并且站点策略将拒绝所有其他受管理的应用程序。 空的活动允许列表会导致站点策略拒绝所有受治理的第三方和代理应用程序。
  • 拒绝 - 站点策略拒绝拒绝列表中的应用程序,并且所有其他受管理的应用程序都通过应用程序限制检查。 空的活动拒绝列表意味着站点策略不拒绝任何一个。

这两个列表始终被存储并且可以管理,无论哪种模式处于活动状态。 只有活动模式选择的列表才能参与运行时强制。 将保留非活动列表以供将来更改模式,并且没有运行时效果。 必须先显式配置模式,然后才能启用网站策略。

由于模式开关可以更改站点上每个受治理应用程序的有效决策,因此 cmdlet 在进行更改之前会显示警告。 该警告标识当前模式、目标模式、新活动保留列表的大小以及新的默认决策,并明确指出保留这两个列表。 然后,该 cmdlet 要求您确认。 用于 -WhatIf 在不更改策略的情况下显示相同的影响。

配置和启用是正交的:模式更改永远不会启用强制。 网站强制仅通过打开 Enable-SPOSiteRestrictedAppAccessControl,因此可以暂存模式和列表,然后显式启用网站。 后端拒绝的唯一组合是使用 mode None启用。

站点强制执行也由租户开关控制。 当租户开关处于打开状态时,租户拒绝列表具有优先权,并且无法被站点允许列表替代。

自动化可以使用标准 -Confirm:$false. 禁止提示不会绕过验证、授权、审核或第一方保护。

站点应用程序限制管理与常规用途 Get-SPOSite 和 Set-SPOSite cmdlet 隔离。 Get-SPOSite 不会加载站点策略数据,也 Set-SPOSite 无法更改它。 使用 相关链接中列出的专用应用程序限制 cmdlet。

有关适用于 SharePoint Online 的 Windows PowerShell 的权限和最新信息,请参阅在线文档简介 SharePoint Online 命令行管理程序的简介。

示例

示例 1

Set-SPOSiteRestrictedAppAccessControlMode -Identity https://contoso.sharepoint.com/sites/Finance -Mode Allow

此示例将 Finance 站点 Allow的活动模式设置为 。 站点允许列表中的应用程序通过应用程序限制检查,并且站点策略将拒绝所有其他受治理的应用程序。 现有的 Microsoft Entra 许可和 SharePoint 授权仍然适用。 拒绝列表将保留,但变为非活动状态。 该 cmdlet 显示模式切换警告,并要求在应用更改之前进行确认。

示例 2

Set-SPOSiteRestrictedAppAccessControlMode -Identity https://contoso.sharepoint.com/sites/Finance -Mode Deny -WhatIf

此示例显示将 Finance 站点切换到 Deny的影响,包括当前模式、目标模式、新活动拒绝列表的大小以及新的默认决策,而无需更改策略。

示例 3

Set-SPOSiteRestrictedAppAccessControlMode -Identity 8a1e30f6-2f52-4b9e-9d1b-2e9f6c1d40aa -Mode Deny -Confirm:$false

此示例将由 ID 标识的站点切换为 Deny 不提示,以便在自动化中使用。 禁止提示不会绕过验证、授权、审核或第一方保护。

示例 4

Set-SPOSiteRestrictedAppAccessControlMode -Identity https://contoso.sharepoint.com/sites/Finance -Mode Allow
Enable-SPOSiteRestrictedAppAccessControl -Identity https://contoso.sharepoint.com/sites/Finance

此示例首先暂存模式,然后显式启用强制。 模式更改不会自行启用强制。

参数

-Confirm

适用:SharePoint Online

提示你在运行 cmdlet 之前进行确认。 此 cmdlet 使用 ConfirmImpact.High,因此它默认提示。 -Confirm:$false用于在自动化中取消提示。

参数属性

类型:System.Management.Automation.SwitchParameter
默认值:None
支持通配符:False
不显示:False
别名:cf

参数集

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

-Identity

适用:SharePoint Online

指定要配置的站点。 可以指定站点 URL 或站点 ID。

参数属性

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

参数集

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

-Mode

适用:SharePoint Online

指定站点策略的活动模式。 有效值为 Allow 和 Deny。

当模式为 Allow时,允许列表中的应用程序将通过应用程序限制检查,并且站点策略将拒绝所有其他受治理的应用程序。 当模式为 Deny时,拒绝列表中的应用程序将被站点策略拒绝,并且所有其他受治理的应用程序都将通过应用程序限制检查。 无论以哪种方式保留这两个列表。 现有的 Microsoft Entra 许可和 SharePoint 授权仍然适用。

参数属性

类型:System.String
默认值:None
接受的值:Allow, Deny
支持通配符:False
不显示:False

参数集

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

-WhatIf

适用:SharePoint Online

显示在 cmdlet 运行时发生的情况。 cmdlet 未运行。 -WhatIf 显示与确认警告相同的模式切换影响,而不更改策略。

参数属性

类型:System.Management.Automation.SwitchParameter
默认值:None
支持通配符:False
不显示:False
别名:WI

参数集

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

CommonParameters

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

输入

System.String

输出

None

备注

  • 模式更改只会更改活动模式。 它保留站点启用和两个列表。
  • 在切换之前,cmdlet 会使用当前模式、目标模式、新活动保留列表的大小以及新的默认决策发出警告。
  • 警告指出保留这两个列表,并且 cmdlet 要求确认。
  • 空的活动允许列表会导致站点策略拒绝所有受治理的第三方和代理应用程序。 空的活动拒绝列表意味着站点策略不拒绝任何一个。 现有的 Microsoft Entra 许可和 SharePoint 授权仍然适用。
  • 配置和启用是正交的。 站点强制执行仅由 启用。Enable-SPOSiteRestrictedAppAccessControl 后端拒绝的唯一组合是使用 mode None启用。
  • 租户交换机会限制所有站点强制。 当租户开关处于打开状态时,站点允许列表无法覆盖租户拒绝列表。
  • 用于 Get-SPOSiteRestrictedAppAccessControl 确认生成的模式和两个列表。