Set-SPOTenantRestrictedAppAccessControlList

在一次不可部分完成更新中,新增或移除全租用戶的應用程式限制拒絕清單中的應用程式識別碼。

語法

Default (預設值)

Set-SPOTenantRestrictedAppAccessControlList
    [-AddRestrictedAppIds <Guid[]>]
    [-RemoveRestrictedAppIds <Guid[]>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

使用 Set-SPOTenantRestrictedAppAccessControlList Cmdlet 變更應用程式限制的全租用戶拒絕清單。

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

這兩個參數都會套用在一個保留租用戶強制執行切換的不可部分完成更新中。 至少需要其中一個 -AddRestrictedAppIds or -RemoveRestrictedAppIds ,且相同的 ID 不能同時出現在兩個參數中。 在新增之前套用移除。

您僅提供應用程式識別碼。 您無法識別識別碼是一般應用程式還是父代理程式藍圖:後端會對每個新增的識別碼進行分類,並將其儲存在適當的內部清單中。 租用戶拒絕清單上的父代理藍圖 ID 會封鎖藍圖應用程式本身以及從該藍圖建立的每個目前或未來的代理程式應用程式。

新增的識別碼會使用 Microsoft Graph 進行分類。 無法分類的 Microsoft 第一方和核心應用程式及識別碼會遭到拒絕。 大量新增為全部或皆不:如果拒絕任何提供的 ID,則不會保留任何 ID。 移除不會使用 Microsoft Graph,因此一律可以移除過時或已刪除的應用程式識別碼。

合併的租用戶拒絕清單有最多 100 個應用程式識別碼。

設定和啟用是正交的: 清單變更永遠不會開啟或關閉租用戶開關。 使用 Enable-SPOTenantRestrictedAppAccessControl 和 Disable-SPOTenantRestrictedAppAccessControl 變更強制執行。

移除最後一個項目會留下一個啟用的開關,其中包含空的拒絕清單,該拒絕不會拒絕任何內容。 允許該狀態是因為在清理期間是合法的,但 Cmdlet 會警告並指出您Disable-SPOTenantRestrictedAppAccessControlClear-SPOTenantRestrictedAppAccessControlPolicy明確關閉應用程式限制。

租用戶範圍是僅限拒絕且具有單一清單,因此沒有模式 Cmdlet、沒有 -ListType 參數,也沒有個別的清除清單 Cmdlet。

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

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

範例

範例 1

Set-SPOTenantRestrictedAppAccessControlList -AddRestrictedAppIds 11111111-1111-1111-1111-111111111111

此範例會將一個應用程式識別碼新增至租用戶拒絕清單。 後端會將 ID 分類,並將其儲存為一般應用程式或父代理程式藍圖。 租用戶強制執行切換不會變更。

範例 2

Set-SPOTenantRestrictedAppAccessControlList -AddRestrictedAppIds 11111111-1111-1111-1111-111111111111, 22222222-2222-2222-2222-222222222222 -RemoveRestrictedAppIds 33333333-3333-3333-3333-333333333333

此範例會在單一不可部分完成更新中新增兩個應用程式識別碼,並移除第三個應用程式識別碼。 在新增之前套用移除。 如果新增的其中一個識別碼是第一方或核心應用程式,或無法分類,則完整作業會失敗,且不會保留任何內容。

範例 3

Set-SPOTenantRestrictedAppAccessControlList -RemoveRestrictedAppIds 33333333-3333-3333-3333-333333333333 -Confirm:$false

此範例會在不提示確認的情況下移除應用程式 ID,這在自動化中很有用。 移除不會呼叫 Microsoft Graph,因此仍可移除已刪除或過時應用程式的識別碼。 隱藏提示不會略過驗證、授權、稽核或第一方保護。

範例 4

Set-SPOTenantRestrictedAppAccessControlList -AddRestrictedAppIds 44444444-4444-4444-4444-444444444444 -WhatIf

此範例顯示如果在不變更預存租用戶原則的情況下新增應用程式識別碼會發生什麼情況。

參數

-AddRestrictedAppIds

適用對象:SharePoint Online

指定要新增至租用戶拒絕清單的應用程式識別碼。 每個提供的識別碼都會使用 Microsoft Graph 進行分類,並在內部儲存為一般應用程式或父代理程式藍圖。 第一方或核心應用程式和無法分類的 ID 會遭到拒絕,而且新增為全有或全無。

至少需要其中一個 -AddRestrictedAppIds or -RemoveRestrictedAppIds ,且 ID 不能同時出現在兩個參數中。 合併的租用戶拒絕清單不能超過 100 個識別碼。

參數屬性

類型:

System.Guid[]

預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值: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

-RemoveRestrictedAppIds

適用對象:SharePoint Online

指定要從租用戶拒絕清單中移除的應用程式識別碼。 移除會在新增之前套用,且不使用 Microsoft Graph,因此一律可以移除過時或刪除的應用程式識別碼。

至少需要其中一個 -AddRestrictedAppIds or -RemoveRestrictedAppIds ,且 ID 不能同時出現在兩個參數中。

參數屬性

類型:

System.Guid[]

預設值:None
支援萬用字元:False
不要顯示:False

參數集

(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 讀取產生的租用戶原則。

備註

  • 新增和移除會套用為單一不可部分完成的更新。 在新增之前套用移除。
  • 大量新增為全部或全無。 如果提供的任何識別碼是第一方或核心應用程式或無法分類,則不會保留任何識別碼。
  • 合併的租用戶拒絕清單有最多 100 個應用程式識別碼。
  • 系統管理員僅提供 ID。 後端會對每個新增的 ID 進行分類,並將其儲存為一般應用程式或父代理程式藍圖。
  • 父代理程式藍圖 ID 會封鎖藍圖應用程式以及從中建立的每個目前或未來的代理程式應用程式。
  • 設定和啟用是正交的: 清單變更永遠不會翻轉租用戶切換。
  • 移除最後一個項目會留下一個啟用的開關,其中包含空白的拒絕清單,不會拒絕任何內容。 Cmdlet 會提出警告並指向 Disable-SPOTenantRestrictedAppAccessControl 或 Clear-SPOTenantRestrictedAppAccessControlPolicy。
  • 用 Set-SPOSiteRestrictedAppAccessControlList 來變更個別網站的清單。