Clear-SPOTenantRestrictedAppAccessControlPolicy

關閉租用戶應用程式限制強制執行切換,並清除全租用戶拒絕清單。

語法

Default (預設值)

Clear-SPOTenantRestrictedAppAccessControlPolicy
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

使用 Clear-SPOTenantRestrictedAppAccessControlPolicy Cmdlet 重設租用戶的應用程式限制原則。 Cmdlet 會停用租用戶強制執行切換,並在一次作業中清除全租用戶的拒絕清單。

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

租用戶切換會閘道、租用戶拒絕清單和所有網站層級強制。 關閉該功能會停止強制執行網站層級 Enabled 旗標為 True的每個網站原則,而不只是租用戶拒絕清單。 Cmdlet 會在確認之前警告此影響。

租用戶範圍是僅拒絕單一清單,因此沒有個別的清除清單 Cmdlet。 若要清空拒絕清單,同時讓已啟用網站原則的租用戶切換保持開啟,請使用 Set-SPOTenantRestrictedAppAccessControlList移除其應用程式識別碼。 用 Clear-SPOTenantRestrictedAppAccessControlPolicy 來完全移除租用戶原則。

當您想要完全移除租用戶設定時,請使用此 Cmdlet。 如果您想要停止強制執行,但保留拒絕清單以供日後使用,請改用 Disable-SPOTenantRestrictedAppAccessControl 。 如果您只想移除選取的應用程式識別碼,請搭配-RemoveRestrictedAppIds使用Set-SPOTenantRestrictedAppAccessControlList。

移除識別碼不需要 Microsoft Graph,因此租使用者拒絕清單上過時或已刪除的應用程式會與清單的其餘部分一起清除。

租用戶應用程式限制管理與一般用途 Get-SPOTenant 和 Set-SPOTenant cmdlet 隔離。 應用程式限制不會 Tenant 公開為屬性,因此 Get-SPOTenant 不會傳回原則,也 Set-SPOTenant 無法變更它。

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

範例

範例 1

Clear-SPOTenantRestrictedAppAccessControlPolicy

此範例會關閉租用戶強制執行參數,並清除租用戶拒絕清單。 Cmdlet 會警告說,這也會停止強制執行網站層級 Enabled 旗標 True為 的每個網站原則,然後提示確認。

範例 2

Clear-SPOTenantRestrictedAppAccessControlPolicy -WhatIf

此範例顯示如果清除租用戶原則而不變更儲存的租用戶原則會發生什麼情況。

範例 3

Get-SPOTenantRestrictedAppAccessControl
Clear-SPOTenantRestrictedAppAccessControlPolicy -Confirm:$false
Get-SPOTenantRestrictedAppAccessControl

此範例會讀取目前的租用戶原則,清除原則而不提示確認,然後再次讀取原則以確認其 Enabled 為 False 和 RestrictedAppIds 為空。 隱藏提示不會略過驗證、授權、稽核或第一方保護。

參數

-Confirm

適用對象:SharePoint Online

執行 Cmdlet 之前提示您確認。 此 Cmdlet 會使用 ConfirmImpact.High,因此預設會提示。 -Confirm:$false用來隱藏自動化中的提示。 隱藏提示不會略過驗證、授權、稽核或第一方保護。

參數屬性

類型:System.Management.Automation.SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False
別名:CF

參數集

(All)
Position:Named
必要:False
來自管線的值: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-SPOTenantRestrictedAppAccessControl 確認產生的租用戶原則。

備註

  • 此 Cmdlet 會停用租用戶切換,並清除租用戶拒絕清單。 若要在保留拒絕清單的同時停止強制執行,請使用 Disable-SPOTenantRestrictedAppAccessControl。
  • 租用戶切換會閘道、租用戶拒絕清單和所有網站層級強制。 關閉該功能會停止強制執行網站層級 Enabled 旗標為 True的每個網站原則,而不只是租用戶拒絕清單。 Cmdlet 會在確認之前警告此影響。
  • 租用戶範圍是僅限拒絕的單一清單,因此租用戶領域沒有個別的清除清單 Cmdlet。
  • 清除不會呼叫 Microsoft Graph,因此過時或刪除的應用程式識別碼會與清單的其餘部分一起移除。
  • 此 Cmdlet 不會移除網站原則設定。 用 Clear-SPOSiteRestrictedAppAccessControlPolicy 來清除個別網站的原則。