Disable-SPOSiteRestrictedAppAccessControl

關閉網站的應用程式限制強制執行,同時保留使用中模式和兩個清單。

語法

Default (預設值)

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

Description

使用 Disable-SPOSiteRestrictedAppAccessControl Cmdlet 關閉單一網站的應用程式限制強制執行,同時保留使用中模式和兩個清單。 您稍後可以使用 重新啟用相同的設定。Enable-SPOSiteRestrictedAppAccessControl

停用網站與清除網站不同。 若要移除模式和兩個清單,並完全清除儲存的網站原則,請使用 Clear-SPOSiteRestrictedAppAccessControlPolicy。

設定和啟用是正交的。 模式和清單變更永遠不會開啟強制執行,因此在您停用網站之後,您可以繼續暫存變更 Set-SPOSiteRestrictedAppAccessControlMode ,無論 Set-SPOSiteRestrictedAppAccessControlList 是否重新啟用強制。 網站強制執行只能由 開啟。Enable-SPOSiteRestrictedAppAccessControl

當網站停用時,網站層級的應用程式限制決策不適用於該網站的要求。 租使用者層級原則不受影響:租使用者切換閘道所有網站強制執行,而且租使用者拒絕清單無法被網站允許清單覆寫。

應用程式限制會為已擁有 Microsoft Entra 同意和 SharePoint 權限的應用程式新增 SharePoint 授權邊界。 它永遠不會授予許可,也不會取代 Entra 同意。 要求必須通過現有的權限模型和應用程式限制,因此停用網站原則不會授與它尚未擁有的任何應用程式存取權。

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

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

範例

範例 1

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

此範例會關閉 Finance 網站的應用程式限制強制執行。 保留使用中模式、允許清單和拒絕清單。

範例 2

Disable-SPOSiteRestrictedAppAccessControl -Identity "e1b2c3d4-5678-4abc-9def-0123456789ab" -WhatIf

此範例使用網站識別碼,並顯示在不變更原則的情況下會發生的情況。 每個網站應用程式限制 Cmdlet 接受 -Identity 作為網站 URL 或網站識別碼。

範例 3

$url = "https://contoso.sharepoint.com/sites/Finance"
Disable-SPOSiteRestrictedAppAccessControl -Identity $url -Confirm:$false
Get-SPOSiteRestrictedAppAccessControl -Identity $url

此範例會在沒有互動式提示的情況下停用強制執行,然後讀回原則以確認仍會儲存模式和兩個清單。 使用 -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 來讀取產生的原則。

備註

  • 停用會保留使用中模式和兩個清單。 Clear-SPOSiteRestrictedAppAccessControlPolicy用來移除模式和清單,並清除已儲存的網站原則。
  • 只有 ,網站強制才能再次開啟。Enable-SPOSiteRestrictedAppAccessControl 模式和清單變更永不開啟強制執行。
  • 租用戶切換會控制所有網站強制執行,因此當租用戶切換關閉時,網站原則沒有作用。 網站允許清單無法覆寫租用戶拒絕清單。
  • 應用程式限制絕不會授與權限。 要求仍必須通過現有的 SharePoint 授權。
  • 此 Cmdlet 支援 -WhatIf 和 -ConfirmConfirmImpact.High。 -Confirm:$false 允許自動化,且不會略過驗證、授權、稽核或第一方保護。