容器类型是一种 SharePoint Embedded 资源，用于定义 SharePoint Embedded 应用程序和一组容器之间的关系、访问权限和计费责任。 此外，容器类型定义容器集上的行为。
每个容器类型都与一个 SharePoint Embedded 应用程序（称为拥有应用程序）紧密耦合。 拥有的应用程序开发人员负责创建和管理其容器类型。 SharePoint Embedded 要求拥有的应用程序与容器类型之间具有 1：1 的关系。
容器类型在每个容器实例上表示为 ContainerTypeID) (不可变属性，并在整个 SharePoint Embedded 生态系统中使用，包括：
- 访问授权：SharePoint Embedded 应用程序必须与容器类型相关联才能访问该类型的容器实例。 关联后，应用程序有权访问该类型的所有容器实例。 实际访问特权由 application-ContainerTypeID 权限设置确定。 默认情况下，拥有的应用程序对与之强耦合的容器类型的所有容器实例具有完全访问权限。 详细了解 SharePoint 嵌入式授权。
- 轻松浏览：可以创建容器类型以供试用，使开发人员能够免费探索 SharePoint Embedded 应用程序开发并评估其功能。
- 计费：用于非试用版的容器类型可计费，必须使用 Azure 订阅创建。 对容器的使用量进行计量和收费。 详细了解 计量 和 SharePoint Embedded 计费体验。
- 可配置的行为：容器类型定义该类型的所有容器实例的选定行为。 详细了解如何设置 容器类型配置。
注意
- 必须指定创建时要创建的容器类型的用途。 根据用途，你可能需要（也可能不需要）提供 Azure 订阅 ID。 无法将用于试用目的的容器类型集转换为生产环境，反之亦然。
- Standard和传递容器类型在创建后无法转换。 如果要将标准容器类型转换为通过计费，反之亦然，则必须删除并重新创建容器类型。
- 必须使用最新版本的 SharePoint PowerShell 来配置容器类型。 有关 SharePoint Embedded Windows PowerShell的权限和最新信息，请参阅 SharePoint Embedded 命令行管理程序简介中的文档。
创建容器类型
SharePoint Embedded 有 2 种不同的容器类型，你可以创建。
创建 SharePoint Embedded 容器类型的先决条件
将使用 SharePoint Online 命令行管理程序 创建新的容器类型：
- 下载并安装最新版本的 SharePoint Online 命令行管理程序
- 从“开始”屏幕打开SharePoint Online 命令行管理程序，键入 sharepoint，然后选择“SharePoint Online 命令行管理程序”。
- 通过提供与租户关联的管理员凭据，使用
Connect-SPOServicecmdlet 连接到 SPO 服务。 有关如何 使用 Connect-SPOService 的信息，请参阅链接的文档。
租户要求
Microsoft 365 租户中需要 SharePoint 的活动实例。
要对 SharePoint 嵌入式容器类型和容器进行身份验证的用户必须位于 Entra ID (成员和来宾)
注意
无需 Office 许可证即可协作处理存储在容器中的Microsoft Office 文档。
角色和权限
- 为 SharePoint Embedded 设置计费关系的管理员需要对 Azure 订阅拥有所有者或参与者权限。
- 管理员需要具有 SharePoint Embedded 管理员或全局管理员角色才能作计费 cmdlet。
Azure 订阅
对于标准计费容器类型，全局管理员或 SharePoint Embedded 管理员需要设置：
- 现有的 SharePoint 租户
- 租户中的 Azure 订阅
- 附加到 Azure 订阅的资源组
试用容器类型
可以出于试用/开发目的创建容器类型，并且不会链接到任何 Azure 计费配置文件。 这使开发人员能够免费探索 SharePoint Embedded 应用程序开发并评估其功能。 对于试用容器类型，开发人员租户与使用租户相同。 每个开发人员一次只能在其租户中的试用状态中拥有一个容器类型。 试用容器类型最长有效期为 30 天，但在此期间可以随时删除。
若要创建用于试用的容器类型，可以：
使用 SharePoint Embedded Visual Studio Code 扩展只需几个步骤即可创建容器类型。 Visual Studio Code扩展注册容器类型并创建容器。
使用 SharePoint PowerShell。 您必须是 SharePoint Embedded 管理员或全局管理员才能运行以下 cmdlet。 如果你是 SharePoint 管理员，请为自己授予 SharePoint Embedded 管理员 角色，以便执行这些 cmdlet。
New-SPOContainerType [–TrialContainerType] [-ContainerTypeName] <String> [-OwningApplicationId] <String> [-ApplicationRedirectUrl] <String> [<CommonParameters>]
以下限制适用于试用容器类型：
- 最多可以创建五个容器类型的容器。 这包括活动容器和回收站中的容器。
- 每个容器最多有 1 GB 的存储空间。
- 容器类型将在 30 天后过期，并且将删除对该容器类型的任何现有容器的访问权限。
- 开发人员必须永久删除试用状态中现有容器类型的所有容器，才能创建新的容器类型以供试用。 这包括已删除容器集合中的容器。
- 容器类型仅限于在开发人员租户中工作。 它不能部署在其他使用租户中。
Standard容器类型 (非试用版)
SharePoint Embedded 中的标准容器类型定义应用程序与其容器之间的关系、访问权限和计费配置文件。 它确定应用程序与容器（包括访问权限）的交互方式，并与计费配置文件相关联，以实现非试用目的。 每个租户一次可以有 25 个容器类型。
计费配置文件
SharePoint Embedded 是一种基于消费的即用即付 (PAYG) 产品/服务，这意味着你只需为使用的内容付费。 SharePoint Embedded 提供了两种计费模型，开发 SharePoint Embedded 应用程序的租户可以针对各自的容器类型进行选择，并根据其独特的业务需求对其进行定制。 这两种计费模型是Standard计费和直通计费。
Standard容器类型 - 具有计费配置文件
使用标准计费配置文件时，所有基于消耗的费用将直接计费给拥有或开发应用程序的租户。 创建标准容器类型时，开发人员租户中的管理员必须建立有效的计费配置文件。
每个开发人员租户最多可以创建五种容器类型，包括 1 个试用容器类型和 4 个标准容器类型或 5 个标准容器类型。 Standard容器类型是使用 New-SPOContainerType cmdlet 创建的。
需要满足以下条件才能创建标准容器类型：
- 使用 SharePoint PowerShell。 您必须是 SharePoint Embedded 管理员或全局管理员才能运行此 cmdlet。 如果你是 SharePoint 管理员，请为自己授予 SharePoint Embedded 管理员 角色，以便执行这些 cmdlet。
- Azure 门户中必须存在 Azure 订阅和资源组才能正常计费。
- 必须在Microsoft Entra ID 中创建应用注册。
若要使用 Azure 计费配置文件创建标准容器类型，请使用以下 cmdlet：
New-SPOContainerType [-ContainerTypeName] <String> [-OwningApplicationId] <String> [-ApplicationRedirectUrl] <String> [<CommonParameters>]
创建容器类型后，添加 Azure 计费配置文件。
Add-SPOContainerTypeBilling –ContainerTypeId <ContainerTypeId> -AzureSubscriptionId <AzureSubscriptionId> -ResourceGroup <ResourceGroup> -Region <Region>
注意
为 SharePoint Embedded 设置计费关系的用户或管理员必须具有 Azure 订阅的所有者或参与者权限。
每个容器类型都必须有一个拥有的应用程序。
单一拥有的应用一次只能拥有一种容器类型。
Azure 订阅可以附加到任意数量的容器类型。
如果上述 cmdlet 失败并出现 SubscriptionNotRegistered 错误，这是因为 Microsoft.Syntex 未在订阅中注册为资源提供程序。 cmdlet 将代表你发送资源提供程序注册请求，但需要几分钟才能完成。 请等待 5-10 分钟，然后重试，直到 cmdlet 成功。
Standard容器类型 - 直通计费
使用直通计费时，基于消耗的费用将直接计费给已注册使用 SharePoint Embedded 应用程序的租户 (使用租户) 。 开发人员租户中的管理员在创建直通 SharePoint Embedded 容器类型时不需要设置 Azure 计费配置文件。
对于打算直接向客户计费的容器类型，请使用 标志 -IsPassThroughBilling。 对于直接面向客户的计费容器类型，无需附加计费配置文件。
若要创建直通计费标准容器类型，请使用以下 cmdlet：
New-SPOContainerType [-ContainerTypeName] <String> [-OwningApplicationId] <String> [-ApplicationRedirectUrl] <String> [-IsPassThroughBilling] [<CommonParameters>]
在使用租户中注册容器类型后，使用租户管理员 (SharePoint 管理员 或全局管理员) 需要在使用租户中设置计费配置文件，以使用 SharePoint Embedded 应用程序。
在使用租户中设置计费配置文件
在“Microsoft 365 管理中心”中，选择“设置”，然后查看“计费和许可证”部分。 选择 “激活即用即付服务”。
选择“ 转到即用即付服务”。
选择“Syntex 服务”下的“应用程序”，选择“应用和 SharePoint Embedded”
[注意]Syntex 服务中配置的订阅将反映 Azure 计费门户中的消耗费用。
使用仅限应用的身份验证令牌注册容器类型。
配置容器类型
开发人员管理员可以为已创建的 SharePoint Embedded 容器类型配置所选设置。 下表列出了可用的设置。
| 设置 | 说明 |
|---|---|
| ApplicationRedirectUrl | 指定应用程序文件重定向到的 URL。 |
| CopilotEmbeddedChatHosts | 添加允许使用 SharePoint Embedded 应用程序的声明性代理体验的主机 URL。 |
| DiscoverabilityDisabled | 确定 SharePoint Embedded 应用程序中的内容是否跨 Microsoft 365 体验可见。 |
| 共享受限 | 使用基于角色的访问配置 SharePoint Embedded 容器的共享权限。 支持开放和限制性共享模型。 当限制性共享设置为 true 时，只有管理员和所有者才能共享容器中的文件。 |
Set-SPOContainerType cmdlet 允许管理员更新应用程序重定向 URL。 Set-SPOContainerTypeConfiguration cmdlet 允许管理员添加主机 URL，在容器类型上设置Microsoft 365 内容可发现性和共享设置。 该设置适用于容器类型的所有容器实例。
示例 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 -CopilotEmbeddedChatHosts "https://localhost:3000 https://contoso.sharepoint.com https://fabrikam.com"
此示例使用 ID 4f0af585-8dcc-0000-223d-661eb2c604e4设置容器类型的主机 URL。
查看容器类型
开发人员管理员可以使用 Get-SPOContainerType 查看他们在租户上创建的所有 SharePoint Embedded 容器类型。 此 cmdlet 检索并返回为租户中的 SharePoint Embedded 应用程序创建的容器类型的列表。
Get-SPOContainerType [<CommonParameters>]
cmdlet 的示例 Get-SPOContainerType 输出
ContainerTypeId : 4f0af585-8dcc-0000-223d-661eb2c604e4
ContainerTypeName : ContosoLegal
OwningApplicationId : a735e4af-b86e-0000-93ba-1faded6c39e1
Classification : Standard
AzureSubscriptionId : 564e9025-f7f5-xxx9-9ddd-4cdxxxx1755
ResourceGroup : prod-resources
Region : EastUS
更新容器类型
开发人员管理员可以使用 Set-SPOContainerType 更新其租户中的 SharePoint Embedded 容器类型。 此 cmdlet 更改试用、标准或直接面向客户的计费容器类型的一个或多个属性值。 可以使用它更新基本信息，例如容器类型名称或计费详细信息。
若要更新基本信息，您必须是 SharePoint Embedded 管理员。 若要更改计费信息，需要所有者或参与者对现有计费订阅和与容器类型关联的新计费订阅的访问权限。
无法更新以下属性：容器类型 ID 和拥有应用程序 ID。
示例 1
Set-SPOContainerType -ContainerTypeId da1d89b3-b4cf-4c0a-8e1c-0d131c57544f -OwningApplicationId 12a9d93c-18d7-46a0-b43e-28d20addd56a - ContainerTypeName 'Red Container Type'
示例 1 将容器类型名称设置为“红色容器类型”
示例 2
Set-SPOContainerType -ContainerTypeId da1d89b3-b4cf-4c0a-8e1c-0d131c57544f –Azure Subscription 12a9d93c-18d7-46a0-b43e-28d20addd56a -ResourceGroup RG200
在示例 2 中，更新了容器类型的计费配置文件。
注册容器类型
若要创建容器并与之交互，必须在使用租户中 注册 容器类型。 拥有的应用程序通过调用 注册 API 来定义容器类型的权限。
删除容器类型
开发人员管理员可以删除试用版和标准容器类型。 若要删除容器类型，必须先删除该容器类型的所有容器，包括已删除容器集合中的容器。 若要删除容器，请参阅使用租户管理员。删除所有容器后，开发人员管理员可以使用 Remove-SPOContainerType删除容器类型。
Remove-SPOContainerType [-ContainerTypeId <ContainerTypeId>]
SharePoint Embedded 计量
若要详细了解支持的即用即付计量，请参阅 SharePoint Embedded 计量 一文。