SharePoint Embedded 容器类型

容器类型是一种 SharePoint Embedded 资源，用于定义 SharePoint Embedded 应用程序和一组容器之间的关系、访问权限和计费责任。 此外，容器类型定义容器集上的行为。

每个容器类型都与一个 SharePoint Embedded 应用程序（称为拥有应用程序）紧密耦合。 拥有的应用程序开发人员负责创建和管理其容器类型。 SharePoint Embedded 强制在拥有应用程序和容器类型之间建立 1：1 关系。

容器类型在每个容器实例上表示为 ContainerTypeID) (不可变属性，并在整个 SharePoint Embedded 生态系统中使用，包括：

• 访问授权：SharePoint Embedded 应用程序必须与容器类型相关联才能访问该类型的容器实例。 关联后，应用程序有权访问该类型的所有容器实例。 实际访问特权由 application-ContainerTypeID 权限设置确定。 默认情况下，拥有的应用程序对与之强耦合的容器类型的所有容器实例具有完全访问权限。 详细了解 SharePoint 嵌入式授权。
• 轻松浏览：可以创建容器类型以供试用，使开发人员能够免费浏览 SharePoint Embedded 应用程序开发并评估其功能。
• 计费：用于非试用版的容器类型可计费，必须使用 Azure 订阅创建。 对容器的使用量进行计量和收费。 详细了解 计量 和 SharePoint Embedded 计费体验。
• 可配置的行为：容器类型定义该类型的所有容器实例的选定行为。 详细了解如何设置 容器类型配置。

注意

1. 必须指定创建时要创建的容器类型的用途。 根据用途，你可能需要（也可能不需要）提供 Azure 订阅 ID。 无法将用于试用目的的容器类型集转换为生产环境;反之亦然。
2. 创建后，无法转换Standard和传递容器类型。 如果要将标准容器类型转换为通过计费，反之亦然，则必须删除并重新创建容器类型。
3. 必须使用最新版本的 SharePoint PowerShell 来配置容器类型。 有关 SharePoint Embedded Windows PowerShell的权限和最新信息，请参阅 SharePoint Embedded 命令行管理程序简介中的文档。

创建容器类型

SharePoint Embedded 有 2 种不同的容器类型，你可以创建。

1. 试用容器类型
2. Standard容器类型

创建 SharePoint Embedded 容器类型的先决条件

将使用 SharePoint Online 命令行管理程序 创建新的容器类型：

1. 下载并安装最新版本的 SharePoint Online 命令行管理程序
2. 从“开始”屏幕打开SharePoint Online 命令行管理程序，键入 sharepoint，然后选择“SharePoint Online 命令行管理程序”。
3. 通过提供与租户关联的管理员凭据，使用 Connect-SPOService cmdlet 连接到 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容器类型 - 具有计费配置文件

使用标准计费配置文件时，所有基于消耗的费用将直接计费给拥有或开发应用程序的租户。 创建标准容器类型时，开发人员租户中的管理员必须建立有效的计费配置文件。

每个开发人员租户最多可以创建 5 个容器类型，其中包括 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 应用程序。

在使用租户中设置计费配置文件

1. 在“Microsoft 365 管理中心”中，选择“设置”，然后查看“计费和许可证”部分。 选择 “激活即用即付服务”。

   

2. 选择“ 转到即用即付服务”。

3. 选择“Syntex 服务”下的“应用程序”，选择“应用和 SharePoint Embedded”

   

   [注意]Syntex 服务中配置的订阅将反映 Azure 计费门户中的消耗费用。

4. 使用仅限应用的身份验证令牌注册容器类型。

配置容器类型

开发人员管理员可以在使用此 PowerShell cmdlet 创建的 SharePoint Embedded 容器类型上设置所选设置。

此 cmdlet 允许管理员在容器类型上设置Microsoft 365 内容可发现性和共享设置。 设置适用于容器类型的所有容器实例：

Set-SPOContainerTypeConfiguration -ContainerTypeId 4f0af585-8dcc-0000-223d-661eb2c604e4 -DiscoverabilityDisabled $False

查看容器类型

开发人员管理员可以使用 查看他们在租户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

注册容器类型

若要创建容器并与之交互，必须在使用租户中 注册 容器类型。 拥有的应用程序通过调用 注册 API 来定义容器类型的权限。

删除容器类型

开发人员管理员可以删除试用版和标准容器类型。 若要删除容器类型，必须首先删除该容器类型的所有容器，包括从已删除的容器集合中删除。 若要删除容器，请参阅使用租户管理员。删除所有容器后，开发人员管理员可以使用 Remove-SPOContainerType删除容器类型。

Remove-SPOContainerType [-ContainerTypeId <ContainerTypeId>]

SharePoint Embedded 计量

若要详细了解支持的即用即付计量，请参阅 SharePoint Embedded 计量 一文。