SharePoint Embedded 容器类型

项目
07/31/2024

容器类型是一种 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。无法将用于试用目的的容器类型集转换为生产环境;反之亦然。
必须使用最新版本的 SharePoint Powershell 进行容器类型配置。

试用使用

可以出于试用/开发目的创建容器类型，并且不会链接到任何 Azure 计费配置文件。这使开发人员能够免费探索 SharePoint Embedded 应用程序开发并评估其功能。在此方案中，开发人员租户与使用租户相同。每个开发人员一次只能在其租户中的试用状态中拥有一个容器类型。容器类型最长有效期为 30 天，但在此时间段内可以随时删除。若要创建用于试用的容器类型，可以：

只需几个步骤即可使用 SharePoint Embedded Visual Studio Code 扩展创建容器类型。 Visual Studio Code 扩展还会注册容器类型并创建容器。
使用 SharePoint PowerShell。您必须是 SharePoint Embedded 管理员或全局管理员才能运行此 cmdlet。如果你是 SharePoint 管理员，请授予自己 SharePoint Embedded Admin 角色以执行这些 cmdlet。

New-SPOContainerType
[–TrialContainerType]
[ -ContainerTypeName <ContainerTypeName>]
[ -OwningApplicationId <OwningApplicationId>]

以下限制适用于试用状态中的容器类型：

最多可以创建五个容器类型的活动容器。
每个容器最多有 1 GB 的存储空间。
容器类型将在 30 天后过期，并且将删除对该容器类型的任何现有容器的访问权限。
开发人员必须永久删除试用状态中现有容器类型的所有容器，才能创建新的容器类型以供试用。这包括已删除容器集合中的容器。
容器类型仅限于在开发人员租户中工作。它不能部署在其他使用租户中。

标准/非试用版使用

还可以使用 Azure 计费配置文件（包括 Azure 订阅 ID 和区域组）创建容器类型。此容器类型处于标准状态，可计费。需要满足以下条件才能在标准状态中创建容器类型：

Azure 门户中必须存在 Azure 订阅和资源组
必须在 Microsoft Entra ID 中创建应用注册
每个开发人员租户最多可以创建五种处于标准状态的容器类型。若要创建一个，请使用以下 PowerShell cmdlet：

New-SPOContainerType
[–ContainerTypeName <ContainerTypeName>]
[-OwningApplicationId <OwningApplicationId>]
[-AzureSubscriptionId <AzureSubscriptionId>]
[-ResourceGroup <ResourceGroup>]
[-Region <Region>]

注意

将设置 SharePoint Embedded 计费关系的用户或管理员需要对 Azure 订阅具有所有者或参与者权限。

配置容器类型

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

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

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

查看容器类型

开发人员管理员可以使用此 PowerShell cmdlet 查看他们在租户上创建的所有 SharePoint Embedded 容器类型。此 cmdlet 检索并返回为租户中的 SharePoint Embedded 应用程序创建的容器类型的列表。

Get-SPOContainerType

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 来定义容器类型的权限。

删除容器类型

开发人员管理员只能删除处于试用状态的容器类型。若要删除处于试用状态的容器类型，必须先删除该容器类型的所有容器，包括从已删除的容器集合中删除容器类型。若要删除容器，请参阅使用租户管理员。删除所有容器后，开发人员管理员可以使用以下 PowerShell cmdlet 删除容器类型。

Remove-SPOContainerType
[-ContainerTypeId <ContainerTypeId>]

通过