Set-SPOSiteRestrictedAppAccessControlMode

將網站層級應用程式限制原則的使用中模式設定為 Allow 或 Deny,保留網站啟用和兩個清單。

語法

Default (預設值)

Set-SPOSiteRestrictedAppAccessControlMode
    [-Identity] <String>
    -Mode <String>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

使用 Set-SPOSiteRestrictedAppAccessControlMode Cmdlet 來變更網站強制執行的清單。 此 Cmdlet 只會變更使用中模式。 它會保留網站啟用以及允許清單和拒絕清單。

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

使用中模式會選取要強制執行的清單:

  • 允許 - 允許清單中的應用程式通過應用程式限制檢查,網站原則會拒絕所有其他受控管的應用程式。 空白的作用中允許清單會讓網站原則拒絕所有受規範的協力廠商和代理程式應用程式。
  • 拒絕 - 網站原則會拒絕拒絕清單中的應用程式,且所有其他受控管的應用程式都會通過應用程式限制檢查。 空的使用中拒絕清單表示網站原則不會拒絕任何一項。

這兩個清單一律會儲存,而且無論哪種模式處於使用中狀態,都可以進行管理。 只有使用中模式選取的清單會參與執行階段強制執行。 非使用中清單會保留以供未來模式變更使用,而且不會有執行階段影響。 必須先明確設定模式,才能啟用網站原則。

因為模式切換可以變更網站上每個受管理應用程式的有效決策,所以 Cmdlet 會在進行變更之前顯示警告。 警告會識別目前模式、目標模式、新作用中保留清單的大小,以及新的預設決策,並明確指出這兩個清單都會保留。 接著,Cmdlet 會要求您確認。 用 -WhatIf 來顯示相同的影響而不變更原則。

設定和啟用是正交的:模式變更永遠不會開啟強制。 網站強制執行僅由 Enable-SPOSiteRestrictedAppAccessControl開啟 ,因此您可以暫存模式和清單,然後明確啟用網站。 後端拒絕的唯一組合是使用 mode None啟用。

網站強制執行也會由租用戶切換控制。 當租用戶切換開啟時,租用戶拒絕清單優先,且無法被網站允許清單覆寫。

自動化可以使用標準 -Confirm:$false. 隱藏提示不會略過驗證、授權、稽核或第一方保護。

網站應用程式限制管理與一般用途 Get-SPOSite 和 Set-SPOSite cmdlet 隔離。 Get-SPOSite 不會載入網站原則資料,也 Set-SPOSite 無法變更它。 使用 相關連結中所列的專用應用程式限制 Cmdlet。

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

範例

範例 1

Set-SPOSiteRestrictedAppAccessControlMode -Identity https://contoso.sharepoint.com/sites/Finance -Mode Allow

此範例會將 Finance 網站的使用中模式設定為 Allow。 網站允許清單中的應用程式通過應用程式限制檢查,網站原則拒絕所有其他受控管的應用程式。 現有的 Microsoft Entra 同意和 SharePoint 授權仍然適用。 拒絕清單會保留,但會變成非使用中。 Cmdlet 會顯示模式切換警告,並在套用變更之前要求確認。

範例 2

Set-SPOSiteRestrictedAppAccessControlMode -Identity https://contoso.sharepoint.com/sites/Finance -Mode Deny -WhatIf

此範例顯示將 Finance 網站切換至 Deny的影響,包括目前模式、目標模式、新作用中拒絕清單的大小,以及新的預設決策,而不變更原則。

範例 3

Set-SPOSiteRestrictedAppAccessControlMode -Identity 8a1e30f6-2f52-4b9e-9d1b-2e9f6c1d40aa -Mode Deny -Confirm:$false

此範例會將由其識別碼識別的網站切換至 Deny 不提示,以用於自動化。 隱藏提示不會略過驗證、授權、稽核或第一方保護。

範例 4

Set-SPOSiteRestrictedAppAccessControlMode -Identity https://contoso.sharepoint.com/sites/Finance -Mode Allow
Enable-SPOSiteRestrictedAppAccessControl -Identity https://contoso.sharepoint.com/sites/Finance

此範例會先暫存模式,然後明確開啟強制執行。 模式變更不會自行開啟強制。

參數

-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:0
必要:True
來自管線的值:True
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Mode

適用對象:SharePoint Online

指定網站原則的作用中模式。 有效值為 Allow 和 Deny。

當模式為 Allow時,允許清單中的應用程式會通過應用程式限制檢查,網站原則會拒絕所有其他受控管的應用程式。 當模式為 Deny時,拒絕清單中的應用程式會遭到網站原則拒絕,而所有其他受控管的應用程式都會通過應用程式限制檢查。 無論如何,這兩個清單都會保留。 現有的 Microsoft Entra 同意和 SharePoint 授權仍然適用。

參數屬性

類型:System.String
預設值:None
接受的值:Allow, Deny
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-WhatIf

適用對象:SharePoint Online

顯示執行 Cmdlet 時會發生什麼情況。 Cmdlet 未執行。 -WhatIf 顯示與確認警告相同的模式切換影響,而不變更原則。

參數屬性

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

輸入

System.String

輸出

None

備註

  • 模式變更只會變更使用中模式。 它會保留網站啟用和這兩個清單。
  • 在切換之前,Cmdlet 會以目前模式、目標模式、新作用中保留清單的大小,以及新的預設決策發出警告。
  • 警告指出這兩個清單都會保留,而 Cmdlet 會要求確認。
  • 空白的作用中允許清單會讓網站原則拒絕所有受規範的協力廠商和代理程式應用程式。 空的使用中拒絕清單表示網站原則不會拒絕任何一項。 現有的 Microsoft Entra 同意和 SharePoint 授權仍然適用。
  • 設定和啟用是正交的。 網站強制執行只能由 開啟。Enable-SPOSiteRestrictedAppAccessControl 後端拒絕的唯一組合是使用 mode None啟用。
  • 租用戶切換閘道所有網站強制執行。 當租用戶切換開啟時,網站允許清單無法覆寫租用戶拒絕清單。
  • 用 Get-SPOSiteRestrictedAppAccessControl 來確認結果模式和兩個清單。