Set-SPOApplication

参考

模块:: Microsoft.Online.SharePoint.PowerShell

设置或更新 SharePoint Embedded 应用程序的一个或多个配置。

语法

Set-SPOApplication
   [-OwningApplicationId] <Guid>
   [[-SharingCapability] <SharingCapabilities>]
   [[-OverrideTenantSharingCapability] <Boolean>]
   [[-CopilotEmbeddedChatHosts] <System.Collections.Generic.List`1[System.String]>]
   [<CommonParameters>]

Set-SPOApplication
   [[-OwningApplicationId] <Guid>]
   [[-SharingCapability] <SharingCapability>]
   [[-OverrideTenantSharingCapability] <Boolean>][[-CopilotEmbeddedChatHosts] <String>]

说明

Set-SPOApplication cmdlet 用于设置由 OwningApplicationId确定的特定应用程序的配置属性。

您必须是 SharePoint Embedded 管理员才能运行此 cmdlet。

注意

Microsoft Loop的 OwningApplicationId 为 a187e399-0c36-4b98-8f04-1edc167a0996。 Microsoft Designer的 OwningApplicationId 为 5e2795e3-ce8c-4cfb-b302-35fe5cd01597。

若要邀请组织外部的人员，请确保已启用 Microsoft Entra B2B。

示例

示例 1

Set-SPOApplication -OwningApplicationId 423poi45-jikl-9bnm-b302-1234ghy56789 -OverrideTenantSharingCapability $false

此示例禁用重写共享功能，使此 SharePoint Embedded 应用程序的共享设置与 SharePoint Online 的共享功能保持一致。

示例 2

Set-SPOApplication -OwningApplicationId 423poi45-jikl-9bnm-b302-1234ghy56789 -OverrideTenantSharingCapability $true -SharingCapability Disabled

此示例启用重写，将 SharePoint Embedded 应用程序中的文件共享限制为仅限内部公司用户，而不管更广泛的 SharePoint Online 租户设置如何。

示例 3

Set-SPOTenant -EnableAzureADB2BIntegration $true
Set-SPOApplication -OwningApplicationId 423poi45-jikl-9bnm-b302-1234ghy56789 -OverrideTenantSharingCapability $true -SharingCapability ExternalUserandGuestSharing

此示例演示如何在 SharePoint Embedded 应用程序中为外部用户启用文件共享。请注意，必须启用 B2B 集成才能允许来宾邀请访问 SharePoint Embedded 应用程序。

示例 4

Set-SPOApplication -OwningApplicationId 423poi45 -CopilotEmbeddedChatHosts "http://localhost:3000 https://contoso.sharepoint.com https://fabrikam.com"

此示例设置 ID 为 Id 为 423poi45 的应用程序的主机 URL。

参数

-CopilotEmbeddedChatHosts

此参数用于添加允许使用 SharePoint Embedded 应用程序的声明性代理体验的主机 URL。这始终是应用程序的开发人员设置的允许 URL 的子集。若要检查允许 URL 的列表，请使用 Get-SPOApplication cmdlet。

类型:	System.Collections.Generic.List`1[System.String]
Position:	3
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-OverrideTenantSharingCapability

此设置允许应用程序独立设置其共享功能，覆盖 SharePoint Online 的租户级设置。选项：

错误 (默认) - 应用程序遵循租户级共享功能
True - 应用程序的共享设置独立于租户级别的共享功能

类型:	Boolean
Position:	2
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-OwningApplicationId

此参数指定 SharePoint Embedded 应用程序的 ID。

类型:	Guid
Position:	0
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-SharingCapability

确定 SharePoint Embedded 应用程序的可用共享级别。

有效值为：

ExternalUserAndGuestSharing（默认值）- 同时启用外部用户共享（通过电子邮件共享）和来宾链接共享。
已禁用 - 外部用户共享 (通过电子邮件共享) 和来宾链接共享均处于禁用状态。
ExternalUserSharingOnly - 已启用外部用户共享 (通过电子邮件共享) ，但来宾链接共享已禁用。
ExistingExternalUserSharingOnly - 仅组织目录中已有的来宾。

默认设置为“无”，这意味着应用程序遵循 SharePoint Online 租户级别的共享设置。使用 Get-SPOTenant cmdlet 查看这些设置。

类型:	SharingCapabilities
接受的值:	Disabled, ExternalUserSharingOnly, ExternalUserAndGuestSharing, ExistingExternalUserSharingOnly
Position:	1
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

通过