Get-SPOTenantRestrictedAppAccessControl

傳回租用戶層級應用程式限制原則,包括租用戶強制切換和受限制應用程式識別碼的全租用戶拒絕清單。

語法

Default (預設值)

Get-SPOTenantRestrictedAppAccessControl

Description

使用 Get-SPOTenantRestrictedAppAccessControl Cmdlet 閱讀貴組織的完整租用戶應用程式限制原則。

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

租用戶原則由兩個部分組成:

  • 已啟用 - 應用程式限制的主要強制參數。 當此參數關閉時,不會強制執行租用戶拒絕清單和所有網站層級原則。 儲存的租用戶與站台設定會保留。 再次開啟開關時,租用戶會拒絕清單和網站原則,其網站層級 Enabled 旗標是 True 使用相同的組態繼續強制執行。
  • RestrictedAppIds - 全租用戶的拒絕清單。 當切換開啟時,此清單中的應用程式會遭到拒絕,且網站層級允許清單無法覆寫該清單。

租用戶拒絕清單可以包含具體應用程式 ID 和父代理程式藍圖 ID。 藍圖 ID 適用於藍圖應用程式本身以及從該藍圖建立的每個目前或未來的代理程式應用程式。 Cmdlet 不會要求您區分兩者: RestrictedAppIds 將內部鍵入的項目合併為一個穩定、無 Guid[]重複的項目。

此 Cmdlet 會傳回授權的未快取原則狀態。

租用戶應用程式限制管理與一般用途 Get-SPOTenant 和 Set-SPOTenant cmdlet 隔離。 應用程式限制不會 Tenant 公開為屬性,因此 Get-SPOTenant 不會傳回原則,也 Set-SPOTenant 無法變更它。 使用 相關連結中所列的專用應用程式限制 Cmdlet。

Microsoft 第一方和核心應用程式會排除在應用程式限制設定和強制之外,而且永遠不會出現在租用戶拒絕清單中。

如需有關適用於 SharePoint Online 的 Windows PowerShell 權限和最新資訊,請參閱位於 SharePoint Online 管理命令介面 簡介的線上文件。

範例

範例 1

Get-SPOTenantRestrictedAppAccessControl

此範例會傳回完整的租用戶應用程式限制原則,顯示是否已啟用強制執行,以及租用戶拒絕清單上有哪些應用程式識別碼。

範例 2

(Get-SPOTenantRestrictedAppAccessControl).RestrictedAppIds

此範例只會從租用戶拒絕清單中傳回受限制的應用程式識別碼。

範例 3

$policy = Get-SPOTenantRestrictedAppAccessControl
if (-not $policy.Enabled) {
    Write-Host "Application Restrictions enforcement is off. Site policies aren't enforced."
}

此範例會將租用戶原則儲存在變數中,並檢查主要交換器。 由於租用戶交換器會控制所有網站層級強制執行,因此停用的交換器表示未強制執行任何網站原則,包括網站層級 Enabled 旗標為 True的原則。

範例 4

$policy = Get-SPOTenantRestrictedAppAccessControl
if ($policy.Enabled -and $policy.RestrictedAppIds.Count -eq 0) {
    Write-Host "Enforcement is on, but the tenant deny list is empty and denies nothing."
}

此範例會識別已啟用的租用戶切換,其中包含空白的租用戶拒絕清單。 此狀態有效。 在新增應用程式識別碼之前,租用戶拒絕清單不會拒絕任何內容;網站層級 Enabled 旗標為 的 True 網站原則仍可強制執行。

輸入

None

輸出

SPORestrictedAppAccessControlTenantPolicy

會傳回具有 SPORestrictedAppAccessControlTenantPolicy 下列屬性的物件。

屬性 類型 描述
Enabled 布林值 指出租用戶應用程式限制強制執行開關是否已打開。 時 False,不會強制執行租用戶拒絕清單和所有網站層級原則。
RestrictedAppIds GUID[] 全租用戶的拒絕清單,傳回為應用程式識別碼和父代理藍圖識別碼的一個穩定、無重複的清單。

備註

  • 租用戶切換是應用程式限制的主要強制切換。 關閉該功能會停止強制執行網站層級 Enabled 旗標為 True的每個網站原則,而不只是租用戶拒絕清單。
  • 當租用戶切換開啟時,租用戶拒絕清單優先於網站原則,且無法被網站允許清單覆寫。
  • 租用戶範圍是僅限拒絕且具有單一清單,因此在租用戶領域沒有模式和清單類型選取。
  • 租用戶拒絕清單的硬性最多有 100 個應用程式識別碼。
  • 設定和啟用是獨立的: 變更拒絕清單永遠不會開啟或關閉租用戶開關。
  • 用來 Get-SPOSiteRestrictedAppAccessControl 閱讀個別網站的原則。