Get-SPOSiteRestrictedAppAccessControl

傳回網站的完整網站層級應用程式限制原則,包括啟用、使用中模式,以及允許清單和拒絕清單。

語法

Default (預設值)

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

Description

使用 Get-SPOSiteRestrictedAppAccessControl Cmdlet 讀取針對單一網站儲存的完整應用程式限制原則。

應用程式限制會為已擁有 Microsoft Entra 同意和 SharePoint 權限的應用程式新增 SharePoint 授權邊界。 它永遠不會授予權限,也不會取代 Entra 同意。 要求必須同時通過現有的許可權模型和應用程式限制。

網站原則由四個部分組成:

  • 已啟用 - 網站強制執行是否已開啟。 網站強制執行只能由 開啟。Enable-SPOSiteRestrictedAppAccessControl 模式和清單變更僅限組態,並保留目前的啟用狀態。
  • Mode - 使用中模式。 當模式為 Allow時,允許清單中的應用程式會通過應用程式限制檢查,網站原則會拒絕所有其他受控管的應用程式。 當模式為 Deny時,拒絕清單中的應用程式會遭到網站原則拒絕,而所有其他受控管的應用程式都會通過應用程式限制檢查。 必須先明確設定模式,才能啟用網站原則。
  • 允許清單 - 當模式為 時所使用的持續清單。Allow
  • DenyList - 當模式為 時所使用的持續清單。Deny

這兩個清單一律會儲存,而且無論哪種模式處於使用中狀態,都可以進行管理。 只有使用中模式選取的清單會參與執行階段強制執行。 非使用中清單會保留以供未來模式變更使用,而且不會有執行階段影響。 空白的作用中允許清單會讓網站原則拒絕所有受規範的協力廠商和代理程式應用程式。 空的使用中拒絕清單表示網站原則不會拒絕任何一項。 現有的 Microsoft Entra 同意和 SharePoint 授權仍然適用。

AllowList ,並 DenyList 以 GUID 陣列的形式傳回。 每個清單都可以包含具體應用程式 ID 和父代理程式藍圖 ID,並且藍圖 ID 會套用至藍圖應用程式本身以及從該藍圖建立的每個目前或未來的代理程式應用程式。 Cmdlet 不會要求您區分兩者:每個屬性都會將其內部類型的應用程式和藍圖項目合併為一個穩定、無重複的 GUID 清單。

此 Cmdlet 會執行未快取的讀取,而且一律會傳回授權的已儲存原則,而不是快取的複本。

網站強制執行由租用戶切換控制。 當租用戶切換關閉時,即使網站原則報告 Enabled 為 True,系統不會強制執行任何網站原則。 當租用戶切換開啟時,租用戶拒絕清單優先,且無法被網站允許清單覆寫。 用 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

此範例會傳回由其 URL 識別之 Finance 網站的完整應用程式限制原則。 傳回的物件包含 SiteUrl。

範例 2

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

此範例會針對由其識別碼所識別的網站傳回相同的原則。 傳回的物件包含 SiteUrl,因此即使輸入是網站識別碼,結果仍然可識別。

範例 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 或網站識別碼。

參數屬性

類型: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 字串 原則所屬網站的 URL。 當網站透過管道輸送至 Cmdlet 或輸入為網站識別碼時,此屬性會讓結果保持可識別。
Enabled 布林值 指出網站強制執行是否已開啟。 網站強制執行也會由租用戶切換控制。
Mode 字串 使用中模式或 AllowDeny。 只會強制執行此模式選取的清單。
AllowList GUID[] 持續允許清單,以應用程式 ID 和父代理藍圖 ID 的一個穩定、無重複清單的形式傳回。
DenyList GUID[] 持續性拒絕清單,以應用程式識別碼和父代理程式藍圖識別碼的單一穩定、無重複清單傳回。

備註

  • 此 Cmdlet 會傳回授權的未快取原則狀態。
  • 當儲存的原則資料格式不正確時,Cmdlet 會發出警告,而傳回的物件會包含 IsPolicyDataMalformed = true。 正常的輸出會省略該屬性。
  • 這兩個清單一律會儲存。 只會強制執行使用中模式選取的清單;系統會保留非使用中清單,且不會有執行階段影響。
  • 每個清單的硬性上限為 100 個項目,而兩個清單加起來的硬性上限為 200 個項目。
  • 父代理程式藍圖 ID 項目適用於藍圖應用程式本身以及從該藍圖建立的每個目前或未來代理程式應用程式。
  • 租用戶切換閘道所有網站強制執行。 當租用戶切換開啟時,網站允許清單無法覆寫租用戶拒絕清單。
  • 設定和啟用是正交的:模式和清單變更永不開啟強制。 模式必須先明確設定 Enable-SPOSiteRestrictedAppAccessControl 才能成功。
  • 用來 Get-SPOTenantRestrictedAppAccessControl 讀取租用戶層級原則。