Enable-SPOSiteRestrictedAppAccessControl

模块:
Microsoft.Online.SharePoint.PowerShell Module

使用站点配置的模式和列表对站点强制实施应用程序限制。

语法

Default (默认值) 

Enable-SPOSiteRestrictedAppAccessControl
    -Identity <String>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

说明

使用 Enable-SPOSiteRestrictedAppAccessControl cmdlet 为单个网站启用应用程序限制强制。 必须已配置模式; Set-SPOSiteRestrictedAppAccessControlMode未设置模式时，cmdlet 失败。

站点强制只能由此 cmdlet 启用。 配置和启用是独立的：模式和列表更改永远不会启用强制。 管理员可以使用策略来 Set-SPOSiteRestrictedAppAccessControlMode 暂存策略， Set-SPOSiteRestrictedAppAccessControlList 然后显式启用它。

活动模式确定站点策略决策：

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

非活动列表将被保留，没有运行时效果。

租户交换机会限制所有站点强制。 当租户开关关闭时，站点策略无效，并且站点允许列表无法替代租户拒绝列表。 用于 Get-SPOTenantRestrictedAppAccessControl 在依赖站点策略之前确认租户切换。

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

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

Microsoft 第一方和核心应用程序被排除在应用程序限制配置和强制之外。

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

示例

示例 1

Enable-SPOSiteRestrictedAppAccessControl -Identity "https://contoso.sharepoint.com/sites/Finance"

此示例对由其 URL 标识的 Finance 站点启用应用程序限制强制。 强制执行使用已在站点上配置的模式和列表。

示例 2

Enable-SPOSiteRestrictedAppAccessControl -Identity "e1b2c3d4-5678-4abc-9def-0123456789ab"

此示例为由其 ID 标识的网站启用强制措施。 每个站点应用程序限制 cmdlet 接受 -Identity 作为站点 URL 或站点 ID。

示例 3

$url = "https://contoso.sharepoint.com/sites/Finance"
Set-SPOSiteRestrictedAppAccessControlMode -Identity $url -Mode Allow
Set-SPOSiteRestrictedAppAccessControlList -Identity $url -ListType AllowList -AddRestrictedAppIds "11111111-1111-1111-1111-111111111111"
Enable-SPOSiteRestrictedAppAccessControl -Identity $url

此示例配置模式和允许列表，然后显式启用该策略。 模式和列表更改不会启用强制，因此在最终命令运行之前不会强制执行任何操作。 允许列表中的应用程序通过应用程序限制检查;站点策略将拒绝所有其他受管理的应用程序。 现有的 Microsoft Entra 许可和 SharePoint 授权仍然适用。

示例 4

Enable-SPOSiteRestrictedAppAccessControl -Identity "https://contoso.sharepoint.com/sites/Finance" -Confirm:$false

此示例在没有交互式确认提示的情况下启用强制，用于自动化。 使用 -Confirm:$false 不会绕过验证、授权、审核或第一方保护。

参数

-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:Named
必需:True
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-WhatIf

适用：SharePoint Online

显示在 cmdlet 运行时发生的情况。 cmdlet 未运行。

参数属性

类型: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。

输入

None

输出

None

此 cmdlet 不返回对象。 用于 Get-SPOSiteRestrictedAppAccessControl 读取生成的策略。

备注

  • 如果站点上未配置任何模式，则此 cmdlet 将失败。 将模式 Allow 设置为或 Deny 在启用策略之前。
  • 站点强制只能由此 cmdlet 启用。 模式和列表更改将保留当前启用状态。
  • 空的活动允许列表会导致站点策略拒绝所有受治理的第三方和代理应用程序。 在启用网站之前，请查看活动列表 Get-SPOSiteRestrictedAppAccessControl 。
  • 在 Deny 模式下，站点策略会拒绝拒绝列表中表示的应用程序。 所有其他受控应用程序都通过应用程序限制检查。
  • 租户交换机限制所有站点强制执行，因此站点策略在租户切换关闭时无效。 站点允许列表无法替代租户拒绝列表。
  • 应用程序限制从不授予权限。 请求仍必须通过现有的 SharePoint 授权。
  • 此 cmdlet 支持-WhatIf的-ConfirmConfirmImpact.High -Confirm:$false 允许用于自动化，并且不会绕过验证、授权、审核或第一方保护。