Set-SPOContainerTypeConfiguration

设置或更新 SharePoint Embedded 中容器类型的配置设置。

语法

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>]
    [-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-8dcc-0000-223d-661eb2c604e4 -CopilotEmbeddedChatHosts "https://localhost:3000 https://contoso.sharepoint.com https://fabrikam.com"

本示例设置 Id 为 Id 4f0af585-8dcc-0000-223d-661eb2c604e4 的容器类型的主机 URL。

参数

-AnonymousLinkExpirationInDays

指定在设置值后创建的所有匿名链接将在设置的天数后过期。

该值可以是 1 到 730 天。

若要遵循租户级别设置,请将值设置为 -1。

参数属性

类型:System.Int32
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-ApplicationRedirectUrl

此参数指定应用程序应重定向到的 URL。

参数属性

类型:System.String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Confirm

提示你在运行 cmdlet 之前进行确认。

参数属性

类型:System.Management.Automation.SwitchParameter
默认值:None
支持通配符:False
不显示:False
别名:cf

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-ContainerTypeId

此参数指定与 SharePoint Embedded 应用程序相对应的容器类型的 ID。

参数属性

类型:System.Guid
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-CopilotEmbeddedChatHosts

此参数用于添加允许使用 SharePoint Embedded 应用程序的声明性代理体验的主机 URL。

参数属性

类型:

System.Collections.Generic.List`1[System.String]

默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-DiscoverabilityDisabled

适用:SharePoint Embedded

作为 Microsoft 365 中的 SharePoint 管理员,您可以控制内容在 Microsoft 365 体验中的显示方式。 如果此值为 true,SharePoint Embedded 应用程序内容将在整个 Microsoft 365 环境中隐藏,包括 office.com、onedrive.com、推荐部分中的内容,或通过其他Microsoft智能文件发现功能。 如果选择使用 Microsoft 365 体验,你的文件将集成到 Microsoft 365 环境中,并参与智能文件发现。

PARAMVALUE:True |假

参数属性

类型:System.Boolean
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-OverrideTenantWhoCanShareAnonymousAllowList

此设置确定容器类型 WhoCanShareAnonymousAllowList 是否替代租户级 WhoCanShareAnonymousAllowList

PARAMVALUE:True |假

参数属性

类型:Boolean
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-OverrideTenantWhoCanShareAuthenticatedGuestAllowList

此设置确定容器类型 WhoCanShareAuthenticatedGuestAllowList 是否替代租户级 WhoCanShareAuthenticatedGuestAllowList

PARAMVALUE:True |假

参数属性

类型:System.Boolean
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-SharingRestricted

适用:SharePoint Embedded

SharePoint Embedded 提供基于角色的共享模型,使开发人员能够基于容器权限角色配置文件共享权限,从而在限制性和开放共享模型之间进行选择。 开放共享模型允许任何具有编辑权限的容器成员和来宾用户共享文件。 限制性共享模型仅允许属于所有者或管理员的容器成员共享文件。

PARAMVALUE:True |假

参数属性

类型: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 设置为 null 数组。

参数属性

类型:

System.Guid[]

默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-WhoCanShareAuthenticatedGuestAllowList

设置允许在容器级别与经过身份验证的来宾用户共享的安全组的特定于容器类型的安全组列表。 这必须与 一起 OverrideTenantWhoCanShareAuthenticatedGuestAllowList设置。

注意

此允许列表仅接受安全组,而不接受Microsoft 365 组。

每个安全组由其 GUID 对象 ID 表示。 若要将此列表设置为特定安全组,需要输入其 GUID 作为 参数。 可以使用逗号将其分隔,从而输入多个 GUID。 若要跳过检查并允许所有安全组共享给经过身份验证的来宾,请将此允许列表设置为 null 数组。

参数属性

类型:

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

输入

None

输出

System.Object