Clear-SPOSiteRestrictedAppAccessControlList

清除網站的應用程式限制允許或拒絕清單,同時保留其他清單、使用中模式和網站啟用。

語法

Default (預設值)

Clear-SPOSiteRestrictedAppAccessControlList
    -Identity <String>
    -ListType <String>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

使用 Clear-SPOSiteRestrictedAppAccessControlList Cmdlet 清除單一網站上的允許清單或拒絕清單。 清除一個清單會保留另一個清單、使用中模式和網站啟用。 若要移除完整的原則,請使用 Clear-SPOSiteRestrictedAppAccessControlPolicy。

網站會儲存這兩個清單,但只有使用中模式選取的清單會參與強制執行:

  • 允許 模式會強制執行允許清單。 列出的應用程式通過應用程式限制檢查,網站原則拒絕所有其他受控管的應用程式。
  • 拒絕 模式會強制執行拒絕清單。 網站原則會拒絕列出的應用程式,而所有其他受管理的應用程式都會通過應用程式限制檢查。

當清除清單是使用中模式強制執行的清單時,Cmdlet 會在確認前發出警告。 清除作用中的允許清單會導致網站原則拒絕所有受治理的協力廠商和代理程式應用程式。 清除作用中拒絕清單表示網站原則不再拒絕任何受管理的應用程式。 此警告僅描述應用程式限制原則決策,絕不表示授與應用程式存取權。 現有的 Microsoft Entra 同意和 SharePoint 授權仍然適用。 該警告也會說明變更是否立即生效,或在下次啟用強制時生效。

清除非使用中清單不會變更目前的強制執行,但仍支援 -WhatIf-Confirm和 ,並且會進行稽核。

設定和啟用是正交的。 清單變更永遠不會開啟強制執行,因此清除未啟用網站上的清單會使網站停用,並在下次使用 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

Clear-SPOSiteRestrictedAppAccessControlList -Identity "https://contoso.sharepoint.com/sites/Finance" -ListType DenyList

此範例會清除 Finance 網站上的拒絕清單。 它會保留允許清單、使用中模式和網站啟用。 如果為使用中模式,Cmdlet Deny 會警告網站原則不再拒絕該清單中受管理的應用程式。 現有的 Microsoft Entra 同意和 SharePoint 授權仍然適用。

範例 2

Clear-SPOSiteRestrictedAppAccessControlList -Identity "e1b2c3d4-5678-4abc-9def-0123456789ab" -ListType AllowList -WhatIf

此範例會依網站識別碼識別網站,並預覽清除允許清單而不變更原則。 每個網站應用程式限制 Cmdlet 接受 -Identity 作為網站 URL 或網站識別碼。

範例 3

$url = "https://contoso.sharepoint.com/sites/Finance"
Clear-SPOSiteRestrictedAppAccessControlList -Identity $url -ListType AllowList
Set-SPOSiteRestrictedAppAccessControlList -Identity $url -ListType AllowList -AddRestrictedAppIds "11111111-1111-1111-1111-111111111111"

此範例會從頭重新建置允許清單。 由於清單變更僅限設定,因此兩個命令都不會變更網站是否已啟用。

範例 4

Clear-SPOSiteRestrictedAppAccessControlList -Identity "https://contoso.sharepoint.com/sites/Finance" -ListType DenyList -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

-ListType

適用對象:SharePoint Online

指定要清除的清單。 項目變動必須明確識別目標清單。 有效的值為:

  • AllowList
  • DenyList

參數屬性

類型:System.String
預設值:None
接受的值:AllowList, DenyList
支援萬用字元: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 來讀取產生的原則。

備註

  • 清除一個清單會保留另一個清單、使用中模式和網站啟用。
  • 清除使用中模式強制執行的清單會變更 [應用程式限制] 原則決策。 空白的作用中允許清單會讓網站原則拒絕所有受規範的協力廠商和代理程式應用程式。 空的使用中拒絕清單表示網站原則不會拒絕任何一項。 現有的 Microsoft Entra 同意和 SharePoint 授權仍然適用。 Cmdlet 會在確認之前發出警告,並說明變更是立即生效,還是下次啟用強制時生效。
  • 清除非使用中清單不會變更目前的強制執行,但作業仍支援 -WhatIf 和 -Confirm 且會稽核。
  • 清單變更永不開啟強制執行。 網站強制執行只能由 開啟。Enable-SPOSiteRestrictedAppAccessControl
  • 租用戶切換會控制所有網站強制執行,因此當租用戶切換關閉時,網站原則沒有作用。 網站允許清單無法覆寫租用戶拒絕清單。
  • 應用程式限制絕不會授與權限。 要求仍必須通過現有的 SharePoint 授權。
  • 此 Cmdlet 支援 -WhatIf 和 -ConfirmConfirmImpact.High。 -Confirm:$false 允許自動化,且不會略過驗證、授權、稽核或第一方保護。