Clear-SPOSiteRestrictedAppAccessControlPolicy
從網站移除完整的應用程式限制原則。 Cmdlet 會停用強制執行,並移除使用中模式和兩個清單。
語法
Default (預設值)
Clear-SPOSiteRestrictedAppAccessControlPolicy
-Identity <String>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
使用 Clear-SPOSiteRestrictedAppAccessControlPolicy Cmdlet 將網站還原為未設定狀態。 Cmdlet 會停用強制執行、移除使用中模式和兩個清單,並清除儲存的網站原則。 清除原則之後,網站會與從未設定的網站處於相同的狀態:強制已停用,且沒有任何項目。
清除與停用不同。
Disable-SPOSiteRestrictedAppAccessControl 關閉強制,但保留使用中模式和兩個清單,以便稍後可以重新啟用相同的設定。 在您想要移除設定時也使用 Clear-SPOSiteRestrictedAppAccessControlPolicy 。 若要只清除一個清單並保留另一個清單、模式和網站啟用,請使用 Clear-SPOSiteRestrictedAppAccessControlList。
由於模式會與清單一起移除,因此在設定模式之前,無法再次啟用已清除的網站。
Enable-SPOSiteRestrictedAppAccessControl 未設定模式時失敗;啟用時模式 None 是後端拒絕的唯一組合。 使用 Set-SPOSiteRestrictedAppAccessControlMode 和 Set-SPOSiteRestrictedAppAccessControlList重建原則,然後明確啟用。 設定和啟用是正交的:模式和清單變更永遠不會開啟強制,因此系統管理員可以暫存原則然後加以啟用。 這可避免將單一識別碼新增至未設定的網站,會立即啟用允許清單並封鎖所有其他應用程式的危險情況。
清除網站原則只會影響該網站。 租用戶交換會閘道所有網站強制執行,而租用戶拒絕清單無法被網站允許清單覆寫,因此清除網站原則永遠不會還原租用戶拒絕的應用程式存取權。 用於 Clear-SPOTenantRestrictedAppAccessControlPolicy 租用戶範圍。
應用程式限制會為已擁有 Microsoft Entra 同意和 SharePoint 權限的應用程式新增 SharePoint 授權邊界。 它永遠不會授予權限,也不會取代 Entra 同意。 要求必須同時通過現有的權限模型和應用程式限制,因此清除網站原則不會授與它尚未擁有的任何應用程式存取權。
網站應用程式限制管理與一般用途 Get-SPOSite 和 Set-SPOSite cmdlet 隔離。 應用程式限制與 SiteProperties完全分離,因此 Get-SPOSite 不會載入網站原則資料,也 Set-SPOSite 無法變更它。 使用 相關連結中所列的專用應用程式限制 Cmdlet。
如需有關適用於 SharePoint Online 的 Windows PowerShell 權限和最新資訊,請參閱位於 SharePoint Online 管理命令介面 簡介的線上文件。
範例
範例 1
Clear-SPOSiteRestrictedAppAccessControlPolicy -Identity "https://contoso.sharepoint.com/sites/Finance"
此範例會從 Finance 網站移除完整的應用程式限制原則。 它會停用強制執行,並移除使用中模式、允許清單和拒絕清單。
範例 2
Clear-SPOSiteRestrictedAppAccessControlPolicy -Identity "e1b2c3d4-5678-4abc-9def-0123456789ab" -WhatIf
此範例會依網站識別碼識別網站,並在不修改原則的情況下預覽變更。 每個網站應用程式限制 Cmdlet 接受 -Identity 作為網站 URL 或網站識別碼。
範例 3
$url = "https://contoso.sharepoint.com/sites/Finance"
Clear-SPOSiteRestrictedAppAccessControlPolicy -Identity $url -Confirm:$false
Set-SPOSiteRestrictedAppAccessControlMode -Identity $url -Mode Deny
Set-SPOSiteRestrictedAppAccessControlList -Identity $url -ListType DenyList -AddRestrictedAppIds "11111111-1111-1111-1111-111111111111"
Enable-SPOSiteRestrictedAppAccessControl -Identity $url
此範例會移除現有的原則,然後從頭重建。 由於模式會在原則清除時移除,因此您必須先將模式指派給網站,才能啟用它。
參數
-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 來確認網站未設定。
備註
- 清除網站原則會停用強制執行、移除使用中模式和兩個清單,並清除已儲存的網站原則。 已清除的網站與從未設定的網站沒有區別。
- 若要保留設定以供稍後使用,請改用
Disable-SPOSiteRestrictedAppAccessControl。 它會保留使用中模式和兩個清單。 - 若要只清除一個清單,請使用 ,這
Clear-SPOSiteRestrictedAppAccessControlList會保留另一個清單、使用中模式和網站啟用。 - 清除之後,在設定模式之前,無法啟用網站。
Enable-SPOSiteRestrictedAppAccessControl未設定模式時失敗。 - 租用戶切換會控制所有網站強制執行,因此當租用戶切換關閉時,網站原則沒有作用。 網站允許清單無法覆寫租用戶拒絕清單。
- 應用程式限制絕不會授與權限。 要求仍必須通過現有的 SharePoint 授權。
- 此 Cmdlet 支援
-WhatIf和-ConfirmConfirmImpact.High。-Confirm:$false允許自動化,且不會略過驗證、授權、稽核或第一方保護。
相關連結
- Get-SPOSiteRestrictedAppAccessControl
- Set-SPOSiteRestrictedAppAccessControlMode
- Set-SPOSiteRestrictedAppAccessControlList
- Enable-SPOSiteRestrictedAppAccessControl
- Disable-SPOSiteRestrictedAppAccessControl
- Clear-SPOSiteRestrictedAppAccessControlList
- Get-SPOTenantRestrictedAppAccessControl
- SharePoint Online 管理命令介面簡介