Get-SPOSiteRestrictedAppAccessControl

返回站点的完整站点级应用程序限制策略,包括启用、活动模式以及允许列表和拒绝列表。

语法

Default (默认值)

Get-SPOSiteRestrictedAppAccessControl
    [-Identity] <String>
    [<CommonParameters>]

说明

使用 Get-SPOSiteRestrictedAppAccessControl cmdlet 读取为单个网站存储的完整应用程序限制策略。

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

网站策略包含四个部分:

  • 已启用 - 是否已启用网站强制。 站点强制执行仅由 启用。Enable-SPOSiteRestrictedAppAccessControl 模式和列表更改仅适用于配置,并保留当前启用状态。
  • Mode - 活动模式。 当模式为 Allow时,允许列表中的应用程序将通过应用程序限制检查,并且站点策略将拒绝所有其他受治理的应用程序。 当模式为 Deny时,拒绝列表中的应用程序将被站点策略拒绝,并且所有其他受治理的应用程序都将通过应用程序限制检查。 必须先显式配置模式,然后才能启用网站策略。
  • AllowList - 当模式为 Allow.
  • DenyList - 当模式为 Deny.

这两个列表始终被存储并且可以管理,无论哪种模式处于活动状态。 只有活动模式选择的列表才能参与运行时强制。 将保留非活动列表以供将来更改模式,并且没有运行时效果。 空的活动允许列表会导致站点策略拒绝所有受治理的第三方和代理应用程序。 空的活动拒绝列表意味着站点策略不拒绝任何一个。 现有的 Microsoft Entra 许可和 SharePoint 授权仍然适用。

AllowList 并 DenyList 以 GUID 数组的形式返回。 每个列表可以包含具体应用程序 ID 和父代理蓝图 ID,并且蓝图 ID 适用于蓝图应用程序本身以及从该蓝图创建的每个当前或未来的代理应用程序。 cmdlet 不需要区分这两者:每个属性将其内部类型的应用程序和蓝图条目合并到一个稳定、无重复的 GUID 列表中。

此 cmdlet 执行未缓存的读取,并且始终返回权威存储策略,而不是缓存的副本。

站点实施由租户开关控制。 当租户切换关闭时,不会强制实施任何站点策略,即使站点策略报告为 EnabledTrue. 当租户开关处于打开状态时,租户拒绝列表具有优先权,并且无法被站点允许列表替代。 用于 Get-SPOTenantRestrictedAppAccessControl 读取租户交换机和租户拒绝列表。

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

Microsoft 第一方和核心应用程序被排除在应用程序限制配置和强制之外,并且永远不会显示在站点列表中。

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

示例

示例 1

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

此示例返回由 Finance 网站(由其 URL 标识)的完整应用程序限制策略。 返回的对象包括 SiteUrl。

示例 2

Get-SPOSiteRestrictedAppAccessControl -Identity 8a1e30f6-2f52-4b9e-9d1b-2e9f6c1d40aa

对于由 ID 标识的站点,此示例返回相同的策略。 返回的对象包括 SiteUrl,因此即使输入是站点 ID ,结果仍然可识别。

示例 3

$policy = Get-SPOSiteRestrictedAppAccessControl -Identity https://contoso.sharepoint.com/sites/Finance
if ($policy.Mode -eq "Allow") {
    $policy.AllowList
} else {
    $policy.DenyList
}

此示例仅返回活动模式强制执行的列表。 另一个列表仍会存储和保留,但在更改模式之前,它不会具有运行时效果。

示例 4

$tenantPolicy = Get-SPOTenantRestrictedAppAccessControl
$policy = Get-SPOSiteRestrictedAppAccessControl -Identity https://contoso.sharepoint.com/sites/Finance
if ($tenantPolicy.Enabled -and $policy.Enabled -and $policy.Mode -eq "Allow" -and $policy.AllowList.Count -eq 0) {
    Write-Host "Enforcement is on with an empty active allow list, which blocks all governed third-party and agentic apps."
}

此示例标识启用租户交换机和站点策略的状态,活动模式为 Allow,活动允许列表为空。 在该状态下,站点策略将阻止所有受治理的第三方和代理应用。

参数

-Identity

适用:SharePoint Online

指定要读取的网站。 可以指定站点 URL 或站点 ID。

参数属性

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

参数集

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

CommonParameters

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

输入

System.String

输出

SPORestrictedAppAccessControlSitePolicy

返回具有 SPORestrictedAppAccessControlSitePolicy 以下属性的对象。

属性 类型 说明
SiteUrl String 策略所属网站的 URL。 当站点通过管道输送到 cmdlet 中或输入为站点 ID 时,此属性使结果可识别。
Enabled 布尔值 指示是否已启用网站强制。 站点强制执行也由租户开关控制。
Mode String 活动模式或 AllowDeny. 仅强制使用此模式选择的列表。
AllowList Guid[] 持久性允许列表,作为应用程序 ID 和父代理蓝图 ID 的一个稳定、无重复列表返回。
DenyList Guid[] 持久性拒绝列表,作为应用程序 ID 和父代理蓝图 ID 的一个稳定、无重复列表返回。

备注

  • 此 cmdlet 返回权威的、未缓存的策略状态。
  • 当存储的策略数据格式不正确时,cmdlet 会发出警告,并且返回的对象包括 IsPolicyDataMalformed = true。 正常的输出省略该属性。
  • 始终存储这两个列表。 仅强制执行活动模式选择的列表;非活动列表将被保留,没有运行时效果。
  • 每个列表的硬性最大值为 100 个条目,两个列表加起来的硬性最大值为 200 个条目。
  • 父代理蓝图 ID 条目适用于蓝图应用程序本身以及从该蓝图创建的每个当前或未来代理应用程序。
  • 租户交换机会限制所有站点强制。 当租户开关处于打开状态时,站点允许列表无法覆盖租户拒绝列表。
  • 配置和启用是正交的:模式和列表更改永远不会启用强制。 必须先 Enable-SPOSiteRestrictedAppAccessControl 显式配置模式才能成功。
  • 用于 Get-SPOTenantRestrictedAppAccessControl 读取租户级策略。