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 值替代租户级 WhoCanShareAnonymousAllowListWhoCanShareAuthenticatedGuestAllowList ,这些值会绕过检查。 这样做的效果是不再将外部共享权限限制为特定安全组的成员。

示例 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