Enable-SPOSiteRestrictedAppAccessControl

模組:
Microsoft.Online.SharePoint.PowerShell Module

使用網站的設定模式和清單，開啟網站的應用程式限制強制執行。

語法

Default (預設值) 

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

Description

使用 Enable-SPOSiteRestrictedAppAccessControl Cmdlet 以開啟單一網站的應用程式限制強制執行。 模式必須已設定; Set-SPOSiteRestrictedAppAccessControlMode未設定任何模式時，Cmdlet 會失敗。

只有這個 Cmdlet 才能開啟網站強制。 設定和啟用是獨立的：模式和清單變更永不開啟強制。 系統管理員可以使用 來Set-SPOSiteRestrictedAppAccessControlModeSet-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"

此範例會開啟由其識別碼所識別網站的強制執行。 每個網站應用程式限制 Cmdlet 接受 -Identity 作為網站 URL 或網站識別碼。

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

參數屬性

類型: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 允許自動化，且不會略過驗證、授權、稽核或第一方保護。