Set-SPOContainerTypeConfiguration
设置或更新 SharePoint Embedded 中容器类型的配置设置。
语法
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>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
说明
对于传入的任何参数, Set-SPOContainerTypeConfiguration
cmdlet 设置或更新在 SharePoint Embedded 应用程序下创建的容器类型的设置。
您必须是 SharePoint Embedded 管理员才能运行此 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 使用 null 值替代租户级 WhoCanShareAnonymousAllowList
和 WhoCanShareAuthenticatedGuestAllowList
,这些值会绕过检查。 这样做的效果是不再将外部共享权限限制为特定安全组的成员。
示例 5
Set-SPOContainerTypeConfiguration -ContainerTypeId 4f0af585-8dcc-0000-223d-661eb2c604e4 -OverrideTenantWhoCanShareAuthenticatedGuestAllowList $true -WhoCanShareAuthenticatedGuestAllowList $null
示例 5 使用 null 值替代租户级别 WhoCanShareAuthenticatedGuestAllowList
,同时保持 WhoCanShareAnonymousAllowList
不受影响。 这样做的效果是不再将共享给经过身份验证的来宾的权限限制为特定安全组的成员。
示例 6
Set-SPOContainerTypeConfiguration -ContainerTypeId 4f0af585 -CopilotEmbeddedChatHosts "http://localhost:3000 https://contoso.sharepoint.com https://fabrikam.com"
此示例设置 Id 为 Id 为 4f0af585 的容器类型的主机 URL。
参数
-AnonymousLinkExpirationInDays
指定在设置值后创建的所有匿名链接将在设置的天数后过期。
该值可以是 1 到 730 天。
若要遵循租户级别设置,请将值设置为 -1。
类型: | Int32 |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-ApplicationRedirectUrl
此参数指定应用程序应重定向到的 URL。
类型: | String |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-ContainerTypeId
此参数指定与 SharePoint Embedded 应用程序相对应的容器类型的 ID。
类型: | Guid |
Position: | Named |
默认值: | None |
必需: | True |
接受管道输入: | False |
接受通配符: | False |
-CopilotEmbeddedChatHosts
此参数用于添加允许使用 SharePoint Embedded 应用程序的声明性代理体验的主机 URL。
类型: | System.Collections.Generic.List`1[System.String] |
Position: | 3 |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-DiscoverabilityDisabled
作为 Microsoft 365 中的 SharePoint 管理员,您可以控制内容在 Microsoft 365 体验中的显示方式。 如果此值为 true,SharePoint Embedded 应用程序内容将在整个 Microsoft 365 环境中隐藏,包括 office.com、onedrive.com、推荐部分中的内容,或通过其他Microsoft智能文件发现功能。 如果选择使用 Microsoft 365 体验,你的文件将集成到 Microsoft 365 环境中,并参与智能文件发现。
PARAMVALUE:True |假
类型: | Boolean |
Position: | Named |
默认值: | True |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
适用于: | SharePoint Embedded |
-OverrideTenantWhoCanShareAnonymousAllowList
此设置确定容器类型 WhoCanShareAnonymousAllowList
是否替代租户级 WhoCanShareAnonymousAllowList
。
PARAMVALUE:True |假
类型: | Boolean |
Position: | Named |
默认值: | False |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-OverrideTenantWhoCanShareAuthenticatedGuestAllowList
此设置确定容器类型 WhoCanShareAuthenticatedGuestAllowList
是否替代租户级 WhoCanShareAuthenticatedGuestAllowList
。
PARAMVALUE:True |假
类型: | Boolean |
Position: | Named |
默认值: | False |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-SharingRestricted
SharePoint Embedded 提供基于角色的共享模型,使开发人员能够基于容器权限角色配置文件共享权限,从而在限制性和开放共享模型之间进行选择。 开放共享模型允许任何具有编辑权限的容器成员和来宾用户共享文件。 限制性共享模型仅允许属于所有者或管理员的容器成员共享文件。
PARAMVALUE:True |假
类型: | Boolean |
Position: | Named |
默认值: | True |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
适用于: | SharePoint Embedded |
-WhoCanShareAnonymousAllowList
设置允许与匿名 (未经身份验证的) 用户以及经过身份验证的来宾用户共享的安全组的特定于容器类型的安全组列表。 这必须与 一起 OverrideTenantWhoCanShareAnonymousAllowList
设置。
注意
此允许列表仅接受安全组,而不接受Microsoft 365 组。
每个安全组由其 GUID 对象 ID 表示。 若要将此列表设置为特定安全组,需要输入其 GUID 作为 参数。 可以使用逗号将其分隔,从而输入多个 GUID。 若要跳过检查并允许所有安全组共享给任何人,请将此允许列表和 WhoCanShareAuthenticatedGuestAllowList
设置为 null 数组。
类型: | Guid[] |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-WhoCanShareAuthenticatedGuestAllowList
设置允许在容器级别与经过身份验证的来宾用户共享的安全组的特定于容器类型的安全组列表。 这必须与 一起 OverrideTenantWhoCanShareAuthenticatedGuestAllowList
设置。
注意
此允许列表仅接受安全组,而不接受Microsoft 365 组。
每个安全组由其 GUID 对象 ID 表示。 若要将此列表设置为特定安全组,需要输入其 GUID 作为 参数。 可以使用逗号将其分隔,从而输入多个 GUID。 若要跳过检查并允许所有安全组共享给经过身份验证的来宾,请将此允许列表设置为 null 数组。
类型: | Guid[] |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |