Set-SPOSiteRestrictedAppAccessControlList

在一次不可部分完成更新中新增或移除網站的應用程式限制允許或拒絕清單中的應用程式識別碼。

語法

Default (預設值)

Set-SPOSiteRestrictedAppAccessControlList
    [-Identity] <String>
    -ListType <String>
    [-AddRestrictedAppIds <Guid[]>]
    [-RemoveRestrictedAppIds <Guid[]>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

使用 Set-SPOSiteRestrictedAppAccessControlList Cmdlet 變更一個網站清單的內容。 新增和移除會在一個保留網站啟用和作用中模式的不可部分完成更新中套用。

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

用 -ListType 來明確識別目標清單。 這兩個清單一律會儲存,而且無論哪種模式處於使用中狀態,都可以進行管理。 只有使用中模式選取的清單會參與執行階段強制執行,因此新增或移除非使用中清單中的項目不會變更目前的強制執行。 非使用中清單會保留以供未來模式變更使用。

使用中模式決定變更在執行階段的意義。 當模式為 Allow時,允許清單中的應用程式會通過應用程式限制檢查,且網站原則會拒絕所有其他受控管的應用程式;空的使用中允許清單會造成網站原則拒絕所有受控管的協力廠商和代理程式應用程式。 當模式為 Deny時,拒絕清單中的應用程式會遭到網站原則拒絕,而所有其他受控管的應用程式都會通過應用程式限制檢查;空的現用拒絕清單表示網站原則不會拒絕任何應用程式。

至少需要其中一個 -AddRestrictedAppIds 或 -RemoveRestrictedAppIds ,且 ID 不能同時出現在兩者中,且會在新增之前套用移除。

您僅提供應用程式識別碼。 每個清單都可以包含具體應用程式 ID 和父代理程式藍圖 ID,後端會對每個新增的 ID 進行分類,並在內部儲存其類型。 父代理藍圖 ID 可套用至藍圖應用程式本身,以及從該藍圖建立的每個目前或未來代理程式應用程式。 在作用中拒絕清單中,藍圖識別碼會使網站原則拒絕該完整的應用程式系列。 在有效的允許清單中,它可讓完整的應用程式系列通過應用程式限制檢查。 現有的 Microsoft Entra 同意和 SharePoint 授權仍然適用。

新增識別碼會使用與租用戶 Cmdlet 相同的大量 Microsoft Graph 分類和第一方排除。 Microsoft 第一方和核心應用程式會遭到拒絕,無法分類的識別碼會遭到拒絕,而且大量新增為全有或全無,因此不會保留一組特定的識別碼。

移除項目 -ListType 只需要 和 -RemoveRestrictedAppIds。 移除不會呼叫 Microsoft Graph,因此您仍可移除已刪除或過時的應用程式識別碼。 如果目標清單中未提供所提供的識別碼,Cmdlet 會傳回驗證錯誤。

設定和啟用是正交的:清單變更永遠不會開啟強制。 網站強制執行僅由 Enable-SPOSiteRestrictedAppAccessControl開啟 ,因此您可以暫存清單,然後明確啟用網站。 模式必須先明確設定 Enable-SPOSiteRestrictedAppAccessControl 才能成功。

網站強制執行也會由租用戶切換控制。 當租用戶切換開啟時,租用戶拒絕清單優先,且無法被網站允許清單覆寫。

自動化可以使用標準 -Confirm:$false. 隱藏提示不會略過驗證、授權、稽核或第一方保護。

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

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

範例

範例 1

Set-SPOSiteRestrictedAppAccessControlList -Identity https://contoso.sharepoint.com/sites/Finance -ListType AllowList -AddRestrictedAppIds 11111111-1111-1111-1111-111111111111

此範例會將一個應用程式識別碼新增至 Finance 網站的允許清單。 網站的啟用和使用中模式會保留。 如果識別碼是 Microsoft 第一方或核心應用程式,或無法分類,則新增會遭到拒絕。

範例 2

Set-SPOSiteRestrictedAppAccessControlList -Identity https://contoso.sharepoint.com/sites/Finance -ListType DenyList -AddRestrictedAppIds 22222222-2222-2222-2222-222222222222,33333333-3333-3333-3333-333333333333 -RemoveRestrictedAppIds 44444444-4444-4444-4444-444444444444

此範例會在一次不可部分完成更新中新增兩個應用程式識別碼,並移除第三個應用程式識別碼。 在新增之前套用移除。 網站啟用和使用中模式保持不變。

參數

-AddRestrictedAppIds

適用對象:SharePoint Online

指定要新增至 -ListType清單的應用程式識別碼。 您僅提供應用程式 ID;後端會將每個新增的 ID 分類為一般應用程式或父代理藍圖,並在內部儲存類型。

新增會使用共用的大量 Microsoft Graph 分類。 第一方或核心應用程式和無法分類的 ID 會遭到拒絕,大量新增會是全部或皆不。

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

參數屬性

類型:

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

-Identity

適用對象:SharePoint Online

指定要設定的網站。 您可以指定網站 URL 或網站識別碼。

參數屬性

類型:System.String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:0
必要:True
來自管線的值:True
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-ListType

適用對象:SharePoint Online

指定要變更的清單。 有效值為 AllowList 和 DenyList。 項目變動必須明確識別目標清單。

參數屬性

類型:System.String
預設值:None
接受的值:AllowList, DenyList
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-RemoveRestrictedAppIds

適用對象:SharePoint Online

指定要從 所識別 -ListType清單中移除的應用程式識別碼。 在新增之前套用移除。

移除項目不會呼叫 Microsoft Graph,因此仍可移除已刪除或過時的應用程式識別碼。 如果目標清單中未提供所提供的識別碼,Cmdlet 會傳回驗證錯誤。

至少需要其中一個 -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。

輸入

System.String

輸出

None

備註

  • 新增和移除會在一個保留網站啟用和作用中模式的不可部分完成更新中套用。
  • 至少需要其中一個 -AddRestrictedAppIds 或 -RemoveRestrictedAppIds ,且 ID 不能同時出現在兩者中,且會在新增之前套用移除。
  • 每個清單的硬性上限為 100 個項目,而兩個清單加起來的硬性上限為 200 個項目。 一般應用程式 ID 和父代理程式藍圖 ID 都會耗用相同的配額。
  • 在清單中新增或移除使用中模式未強制執行的項目不會變更目前的強制執行。
  • 設定和啟用是正交的。 網站強制執行只能由 Enable-SPOSiteRestrictedAppAccessControl開啟,且必須先明確設定模式,該 Cmdlet 才會成功。
  • 租用戶切換閘道所有網站強制執行。 當租用戶切換開啟時,網站允許清單無法覆寫租用戶拒絕清單。
  • 用 Get-SPOSiteRestrictedAppAccessControl 來確認結果清單,以及 Clear-SPOSiteRestrictedAppAccessControlList 清除整個清單。