Set-SPOApplication
设置或更新 SharePoint Embedded 应用程序的一个或多个配置。
语法
Default (默认值)
Set-SPOApplication
[-OwningApplicationId] <Guid>
[[-SharingCapability] <SharingCapabilities>]
[[-OverrideTenantSharingCapability] <Boolean>]
[[-CopilotEmbeddedChatHosts] <System.Collections.Generic.List`1[System.String]>]
[<CommonParameters>]
说明
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 "https://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] |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | 3 |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-OverrideTenantSharingCapability
此设置允许应用程序独立设置其共享功能,覆盖 SharePoint Online 的租户级设置。 选项:
- 错误 (默认) - 应用程序遵循租户级共享功能
- True - 应用程序的共享设置独立于租户级别的共享功能
参数属性
| 类型: | System.Boolean |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | 2 |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-OwningApplicationId
此参数指定 SharePoint Embedded 应用程序的 ID。
参数属性
| 类型: | System.Guid |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | 0 |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-SharingCapability
确定 SharePoint Embedded 应用程序的可用共享级别。
有效值为:
- ExternalUserAndGuestSharing(默认值)- 同时启用外部用户共享(通过电子邮件共享)和来宾链接共享。
- 已禁用 - 外部用户共享 (通过电子邮件共享) 和来宾链接共享均处于禁用状态。
- ExternalUserSharingOnly - 已启用外部用户共享 (通过电子邮件共享) ,但来宾链接共享已禁用。
- ExistingExternalUserSharingOnly - 仅组织目录中已有的来宾。
默认设置为“无”,这意味着应用程序遵循 SharePoint Online 租户级别的共享设置。 使用 Get-SPOTenant cmdlet 查看这些设置。
参数属性
| 类型: | Microsoft.Online.SharePoint.TenantManagement.SharingCapabilities |
| 默认值: | None |
| 接受的值: | Disabled, ExternalUserSharingOnly, ExternalUserAndGuestSharing, ExistingExternalUserSharingOnly |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | 1 |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
CommonParameters
此 cmdlet 支持通用参数:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息,请参阅 about_CommonParameters。