创建和配置容器类型

适用于： 开发人员版

单击一下即可将 SharePoint Embedded MCP 服务器添加到编码代理：

添加到 Visual Studio Code

使用预发行版本？ 将服务器添加到 Visual Studio Code 预览体验计划。

对于其他 MCP 客户端，使用相同的 npx 命令注册服务器：

# Claude Code
claude mcp add spe -- npx -y @microsoft/spe-mcp start

# OpenAI Codex CLI
codex mcp add spe -- npx -y @microsoft/spe-mcp start

安装适用于 Visual Studio Code 的 SharePoint Embedded 扩展，以创建容器类型、配置拥有应用和计费、注册容器类型、创建容器以及从编辑器中的引导式视图加载示例应用：

从 Visual Studio Marketplace 获取扩展

为应用程序创建 SharePoint Embedded 容器类型，以创建容器或存储文件。 容器类型定义应用创建的容器的访问权限、计费责任和选定行为。

如果你刚刚开始，请完成 快速入门：使用 VS Code 生成你的第一个应用。 然后使用本文进行试用、标准和传递决策。

若要首先在单租户模型和多租户模型之间做出决定，请参阅 选择应用模型。

了解容器类型关系

容器类型与一个 Microsoft Entra ID 应用程序（称为拥有应用程序）紧密耦合。

SharePoint Embedded 要求一个拥有应用程序和一个容器类型之间建立一对一关系。

容器类型 ID 作为不可变属性存储在每个容器上。

SharePoint Embedded 将 ID 用于访问授权、试用浏览、计费和可配置行为。

注意

Microsoft 图形 API — Create fileStorageContainerType — 仅限委派，可由任何非来宾拥有租户的用户调用。 调用方不需要管理员角色，系统会自动分配为新容器类型的所有者。

选择试用版或生产版

在创建容器时选择容器类型用途。

以后无法将试用容器类型转换为生产容器类型。

以后无法将容器类型从标准计费更改为传递计费。

用例	容器类型
本地概念验证	试用容器类型
开发者租户支付	采用标准计费方式的容器类型
消耗租户付款	采用直通计费的容器类型

重要

如果您选择了错误的用途或计费模型，则必须重新创建容器类型。

先决条件

在创建容器类型之前，请确保你有：

• 具有 SharePoint 的 Microsoft 365 租户。
• 拥有应用的 Microsoft Entra ID 应用注册。
• 拥有租户中的非来宾成员帐户。
• 对于标准计费，需要 Azure 订阅和资源组。
• 若要以非管理员身份管理现有标准容器类型的帐单，请成为 该容器类型的所有者。 SharePoint Embedded 管理员和全局管理员可以在开发人员租户中管理任何标准计费容器类型。
• 对于标准计费设置，拥有者或参与者对 Azure 订阅的访问权限。

注意

• 通过 Microsoft Graph 创建容器类型只需要 FileStorageContainerType.Manage.All 委派的权限。 拥有租户中的任何非来宾用户都可以创建一个，并自动分配为 该容器类型的所有者。 有关租户范围的管理操作，请参阅 使用 PowerShell 创建应用。

• 对容器进行身份验证的用户必须以成员或来宾身份存在于 Microsoft Entra ID 中。 协作处理存储在容器中的 Office 文档不需要 Office 许可证，记录的异常体验（如提及）除外。

创建试用容器类型

使用试用容器类型进行评估。

可以使用 SharePoint Embedded Visual Studio Code 扩展或 Microsoft Graph 创建一个。

对于第一个应用，Visual Studio Code 路径最快。 请参阅 快速入门：使用 VS Code 生成第一个应用。

对于 Microsoft Graph，请使用计费分类创建 trial 容器类型。

以下限制适用于试用容器类型：

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

使用标准计费方式创建容器类型

当开发人员租户支付消耗费用时，使用标准计费。

每个租户总共最多可创建 25 个容器类型。 其中之一可以是免费试用容器类型;其余的为标准 (计费) 容器类型。

1. 创建或标识拥有的 Microsoft Entra ID 应用程序。
2. 使用计费分类创建容器类型 standard 。
3. 管理容器类型的计费。 SharePoint Embedded Visual Studio Code 扩展和 SharePoint Embedded 模型上下文协议 (MCP) 服务器支持标准计费容器类型的计费管理。 SharePoint Embedded 管理员和全局管理员也可 使用 PowerShell 管理帐单。
4. 记录容器类型 ID。
5. 继续在使用租户中注册。

注意

如果计费设置失败， SubscriptionNotRegistered请等待几分钟，然后重试。 资源提供程序注册可能需要 Microsoft.Syntex 一些时间。

创建传递计费容器类型

当消费租户支付消费费用时，使用传递计费。

1. 创建或标识拥有的 Microsoft Entra ID 应用程序。
2. 使用计费分类创建容器类型 directToCustomer 。
3. 在使用租户中注册容器类型。
4. 让使用租户中的计费管理员或全局管理员激活即用即付服务。

重要

使用租户必须完成计费设置，然后才能成功使用直通应用程序。

使用租户中的计费管理员或全局管理员在 Microsoft 365 管理中心中激活即用即付服务。 在“设置>计费和许可证”中，选择“激活即用即付服务”。

在“ Syntex 服务”下，选择“ 应用”，然后选择“ SharePoint Embedded ”以启用应用计费。

配置拥有的 Microsoft Entra ID 应用

配置应用，使其只能拥有一个容器类型。

请求 SharePoint Embedded 访问的 Microsoft Graph 权限。

请求 Microsoft Graph FileStorageContainerTypeReg.Selected 应用程序权限，以在使用租户上注册容器类型。

使用与开发和生产客户端匹配的重定向 URI。

使用适用于委派或仅应用流的凭据。

有关身份验证的详细信息，请参阅 配置身份验证和授权。

设置基本属性

属性	指南
容器类型名称	使用映射到工作负载的持久名称。
拥有应用程序 ID	使用拥有此类型的应用注册。
应用程序重定向 URL	使用此应用中的文件应重定向到的 URL。
计费模式	在创建时选择试用、标准计费或传递计费。

警告

以后无法更新容器类型 ID 和拥有应用程序 ID。

配置容器类型行为

创建后，开发人员可以配置所选行为。

可用的设置包括：

• urlTemplate
• isDiscoverabilityEnabled
• isSharingRestricted

使用 Microsoft Graph 更新 fileStorageContainerType API 进行受支持的容器类型更新。 有关租户范围的管理设置，请参阅 使用 PowerShell 创建应用。

重要

更新容器类型的设置最多可能需要 24 小时 才能复制到所有使用租户。 如果使用租户应用了设置替代，则这些替代将保持不变。 某些设置仅适用于新内容，不适用于现有内容。

查看和更新容器类型

使用 Microsoft Graph 列出和更新容器类型。

非管理员容器类型所有者可以更新他们拥有的容器类型。 他们还可以 创建和管理标准计费配置文件。

所有者需要对 Azure 订阅的所有者或参与者访问权限才能更改计费。

使用 Microsoft Graph 管理容器类型

还可以使用 fileStorageContainerType Microsoft Graph API 管理容器类型。

操作	API
创建容器类型	Create fileStorageContainerType
列出容器类型	列出 fileStorageContainerType
更新容器类型	更新 fileStorageContainerType
删除容器类型	删除 fileStorageContainerType

列表结果按所有权进行筛选。 非管理员用户只能看到已授予其权限的容器类型，而 SharePoint Embedded 管理员和全局管理员将看到租户中的每种容器类型。 有关可以配置的设置，请参阅 fileStorageContainerTypeSettings。

只能删除试用容器类型;尚不支持删除标准容器类型。 在删除容器类型之前，请删除该类型的每个容器，包括已删除容器集合中的容器。

了解计费依赖关系

对于标准计费，开发人员租户附加 Azure 订阅和资源组。

对于传递计费，使用租户开通按量付费服务。

有关详细信息，请参阅 SharePoint Embedded 计量 和 SharePoint Embedded 计费管理。

链接到多租户载入

多租户应用通常具有一个拥有租户和一个或多个使用租户。

对每个使用租户使用此序列：

1. 在拥有租户中创建容器类型。
2. 请求使用租户管理员授予管理员同意。
3. 注册容器类型应用程序权限。
4. 在使用者租户付款时配置传递计费。
5. 验证容器创建和访问权限。

后续步骤

在 “注册应用程序权限”中注册权限。