Set-SPOContainerTypeConfiguration
在 SharePoint 嵌入中設定或更新容器類型的設定。
語法
Default (預設值)
Set-SPOContainerTypeConfiguration
-ContainerTypeId <Guid>
[-DiscoverabilityDisabled <Boolean>]
[-SharingRestricted <Boolean>]
[-ApplicationRedirectUrl <String>]
[-WhoCanShareAnonymousAllowList <Guid[]>]
[-WhoCanShareAuthenticatedGuestAllowList <Guid[]>]
[-OverrideTenantWhoCanShareAnonymousAllowList <Boolean>]
[-OverrideTenantWhoCanShareAuthenticatedGuestAllowList <Boolean>]
[-CopilotEmbeddedChatHosts <System.Collections.Generic.List`1[System.String]>]
[-AnonymousLinkExpirationInDays <Int32>]
[-IsArchiveEnabled <Boolean>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
對於輸入的任何參數，指令 Set-SPOContainerTypeConfiguration 碼會設定或更新在 SharePoint Embedded 應用程式下建立的容器類型的設定。
您必須是 SharePoint 嵌入式管理員才能執行此 cmdlet。
範例
範例 1
Set-SPOContainerTypeConfiguration -ContainerTypeId 4f0af585-8dcc-0000-223d-661eb2c604e4 -DiscoverabilityDisabled $false
範例 1 開啟了此容器類型的可發現性。 所有在此容器類型中創建的內容，皆可在 Microsoft 365 體驗中被發現，包括在 office.com、onedrive.com、推薦檔案及其他智慧發現體驗中。
範例 2
Set-SPOContainerTypeConfiguration -ContainerTypeId 4f0af585-8dcc-0000-223d-661eb2c604e4 -SharingRestricted $false
範例 2 開啟了此容器類型的開放共享模型。 任何具有編輯權限的容器成員與訪客使用者都可以分享在容器類型內建立的檔案。
範例 3
Set-SPOContainerTypeConfiguration -ContainerTypeId 4f0af585-8dcc-0000-223d-661eb2c604e4 -OverrideTenantWhoCanShareAnonymousAllowList $true -WhoCanShareAnonymousAllowList <guids>
範例 3 覆蓋租戶層級 WhoCanShareAnonymousAllowList。
範例 4
Set-SPOContainerTypeConfiguration -ContainerTypeId 4f0af585-8dcc-0000-223d-661eb2c604e4 -OverrideTenantWhoCanShareAnonymousAllowList $true –WhoCanShareAnonymousAllowList $null -OverrideTenantWhoCanShareAuthenticatedGuestAllowList $true –WhoCanShareAuthenticatedGuestAllowList $null
範例 4 覆蓋租戶層級 WhoCanShareAnonymousAllowList 和 WhoCanShareAuthenticatedGuestAllowList ，並設定空值，繞過檢查。 此舉的效果是不再限制外部分享權限僅限特定安全群組的成員。
範例 5
Set-SPOContainerTypeConfiguration -ContainerTypeId 4f0af585-8dcc-0000-223d-661eb2c604e4 -OverrideTenantWhoCanShareAuthenticatedGuestAllowList $true –WhoCanShareAuthenticatedGuestAllowList $null
範例 5 以空值覆蓋租戶層 WhoCanShareAuthenticatedGuestAllowList 級，但保持 WhoCanShareAnonymousAllowList 不動。 這不僅限制了特定安全群組成員對已認證訪客的分享權限。
範例 6
Set-SPOContainerTypeConfiguration -ContainerTypeId 4f0af585-8dcc-0000-223d-661eb2c604e4 -CopilotEmbeddedChatHosts "https://localhost:3000 https://contoso.sharepoint.com https://fabrikam.com"
此範例將容器類型的主機網址設定為 ID 4f0af585-8dcc-0000-223d-661eb2c604e4。
範例 7
Set-SPOContainerTypeConfiguration -ContainerTypeId 4f0af585-8dcc-0000-223d-661eb2c604e4 -IsArchiveEnabled $true
範例 7 啟用了對 ContainerTypeId 所有容器的歸檔與重新啟動動作的支援，適用於 4f0af585-8dcc-0000-223d-661eb2c604e4。
參數
-AnonymousLinkExpirationInDays
規定所有在設定值後建立的匿名連結，將在設定天數後失效。
價值範圍從1天到730天不等。
若要依照租戶層級設定，請將數值設為 -1。
參數屬性
| 類型: | System.Int32 |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ApplicationRedirectUrl
此參數指定應用程式應被重定向的網址。
參數屬性
| 類型: | System.String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Confirm
執行 Cmdlet 之前提示您確認。
參數屬性
| 類型: | System.Management.Automation.SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | 參見 |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ContainerTypeId
此參數指定對應 SharePoint 嵌入式應用程式的容器類型 ID。
參數屬性
| 類型: | System.Guid |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-CopilotEmbeddedChatHosts
此參數用於新增允許使用 SharePoint Embedded 應用程式宣告式代理體驗的主機網址。
參數屬性
| 類型: | System.Collections.Generic.List`1[System.String] |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-DiscoverabilityDisabled
適用：SharePoint 嵌入式
作為 Microsoft 365 的 SharePoint 管理員，您可以控制內容在 Microsoft 365 體驗中的呈現方式。 當此值為真時，SharePoint 內嵌應用程式的內容會隱藏於 Microsoft 365 環境中，包括 office.com、onedrive.com、推薦區塊或其他Microsoft智慧檔案發現功能。 如果您選擇使用 Microsoft 365 體驗，您的檔案將整合進 Microsoft 365 環境，參與智慧檔案發現。
PARAMVALUE：真 |偽
參數屬性
| 類型: | System.Boolean |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-IsArchiveEnabled
使用 -IsArchiveEnabled 旗標來啟用容器的歸檔。 檔案管理會將資料移至冷層，降低儲存成本。 在存檔期間，內容在重新啟動前無法存取。 重新激活可在前七天內立即生效，且可能長達24小時。 如果沒有包含這個標誌，該值會預設為 False，所有 archive API 呼叫都會失敗。 更新標記後，請允許在消費租戶中最多 24 小時內生效變更。
參數屬性
| 類型: | System.Boolean |
| 預設值: | False |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-OverrideTenantWhoCanShareAnonymousAllowList
此設定決定容器類型 WhoCanShareAnonymousAllowList 是否覆蓋租戶層級 WhoCanShareAnonymousAllowList。
PARAMVALUE：真 |偽
參數屬性
| 類型: | Boolean |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-OverrideTenantWhoCanShareAuthenticatedGuestAllowList
此設定決定容器類型 WhoCanShareAuthenticatedGuestAllowList 是否覆蓋租戶層級 WhoCanShareAuthenticatedGuestAllowList。
PARAMVALUE：真 |偽
參數屬性
| 類型: | System.Boolean |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-SharingRestricted
適用：SharePoint 嵌入式
SharePoint Embedded 提供基於角色的分享模型，允許開發者根據容器權限角色設定檔案分享權限，並提供限制性與開放式共享模式的選擇。 開放分享模式允許任何容器成員及擁有編輯權限的訪客用戶分享檔案。 限制性分享模式僅允許擁有者或管理者的容器成員分享檔案。
PARAMVALUE：真 |偽
參數屬性
| 類型: | System.Boolean |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-WhatIf
顯示執行 Cmdlet 時會發生什麼情況。 未執行 Cmdlet。
參數屬性
| 類型: | System.Management.Automation.SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | 威斯康辛 |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-WhoCanShareAnonymousAllowList
依容器類型設置一個特定容器類型的安全群組清單，允許這些群組允許與匿名 (未認證的) 使用者及已認證的訪客使用者分享。 此 OverrideTenantWhoCanShareAnonymousAllowList必須與 結合 。
注意事項
此允許清單僅接受安全群組，不接受 Microsoft 365 群組。
每個安全群組以其 GUID 物件 ID 表示。 若要將此清單設定為特定的安全群組，你需要輸入其 GUID 作為參數。 你可以用逗號分隔多個 GUID。 要跳過檢查並允許所有安全群組分享給任何人，請設定此允許清單和 WhoCanShareAuthenticatedGuestAllowList to null 陣列。
參數屬性
| 類型: | System.Guid[] |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-WhoCanShareAuthenticatedGuestAllowList
根據容器類型，設定可與已驗證訪客用戶共享的安全群組清單。 此 OverrideTenantWhoCanShareAuthenticatedGuestAllowList必須與 結合 。
注意事項
此允許清單僅接受安全群組，不接受 Microsoft 365 群組。
每個安全群組以其 GUID 物件 ID 表示。 若要將此清單設定為特定的安全群組，你需要輸入其 GUID 作為參數。 你可以用逗號分隔多個 GUID。 若要跳過檢查並允許所有安全群組分享給已認證的訪客，請將此允許清單設為空陣列。
參數屬性
| 類型: | System.Guid[] |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
CommonParameters
此 cmdlet 支援常見參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。