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清除整個清單。
相關連結
- Get-SPOSiteRestrictedAppAccessControl
- Set-SPOSiteRestrictedAppAccessControlMode
- Enable-SPOSiteRestrictedAppAccessControl
- Disable-SPOSiteRestrictedAppAccessControl
- Clear-SPOSiteRestrictedAppAccessControlList
- Clear-SPOSiteRestrictedAppAccessControlPolicy
- Get-SPOTenantRestrictedAppAccessControl
- SharePoint Online 管理命令介面簡介