设置 Power BI Embedded

  • 项目

适用范围：️ 应用拥有数据 用户拥有数据

如果要开始使用 Power BI Embedded 与他人共享报表，请使用 Power BI 嵌入式分析设置工具开始。 本文介绍如何进行此操作。

若要使用 Power BI 嵌入式分析，需要在 Azure 中注册 Microsoft Entra 应用程序。 Microsoft Entra 应用为 Power BI REST 资源建立权限，并允许访问 Power BI REST API。

先决条件

要设置 Power BI 嵌入式分析环境，需要以下项之一：

准备阶段

注册应用之前，请确定以下哪种解决方案最符合你的需求：

为客户嵌入内容

如果要创建专为客户设计的应用，请使用为客户嵌入内容解决方案（也称为“应用拥有数据”）。 用户无需登录到 Power BI 或拥有 Power BI 许可证即可使用应用。 应用使用主用户帐户（用于登录 Power BI 的 Power BI Pro 许可证）或服务主体向 Power BI 进行身份验证。

“为客户嵌入内容”解决方案通常由独立软件供应商 (ISVs) 和为第三方创建应用程序的开发人员使用。

为组织嵌入内容

如果要创建要求用户使用其凭据对 Power BI 进行身份验证的应用程序，请使用为组织嵌入内容解决方案（也称为“用户拥有数据”）。

“为组织嵌入内容”解决方案通常由企业和大型组织使用，适用于内部用户。

有关这两个解决方案的详细信息，请参阅什么是 Power BI 嵌入式分析解决方案？。

设置你的环境

了解这两个嵌入选项后，你可以使用设置工具来创建你的 Power BI Embedded 环境。

如果更喜欢手动设置环境，请跳过以下部分中的步骤。 相反，请按照本文后面的手动注册中的步骤操作。

重要

如果要为 GCC 嵌入，请按照手动注册中的说明进行操作。

若要使用工具设置环境，请转到 Power BI 嵌入式分析设置工具。 选择所需的嵌入选项。

Screenshot of the Power BI embedded analytics setup tool. The options for embedding for your customers or for your organization are highlighted.

步骤 1 - 登录 Power BI

  1. 在设置工具的“步骤 1”下，选择“登录”。 此步骤将使你登录到 Power BI。 如果系统提示选择帐户，请使用属于你的 Power BI 租户的用户登录。 将以此用户的身份注册 Microsoft Entra 应用。

    Screenshot of the Power BI embedded analytics setup tool. Under Step 1, the Sign in button is highlighted.

    注意

    如果已登录，请验证你登录时使用的是否是要用于创建 Microsoft Entra 应用的用户。 若要更改用户，请选择“退出登录”。工具重启后，使用正确的用户登录。

  2. 选择“下一步”转到下一步骤。

    Screenshot of the Power BI embedded analytics setup tool after a user has signed in to Power BI. The Next button in highlighted.

步骤 2 - 注册应用程序

你将通过此步骤在 Azure 中注册 Microsoft Entra 应用程序。 Microsoft Entra 应用为 Power BI REST 资源建立权限，并允许访问 Power BI REST API。 以后可以随时更改这些设置。

  1. 要为客户注册应用程序，请填写以下字段：

    • 应用程序名称 - 为应用程序指定名称。

    • API 访问 - 选择应用程序所需的 Power BI API（也称为作用域）。 可选择“全选”来选择所有 API。 有关 Power BI 访问权限的详细信息，请参阅 Microsoft 标识平台终结点中的权限和许可。

    Screenshot of the Power BI embedded analytics setup tool. The step for registering an app is visible, with an app name box and API access options.

  2. 选择注册。

  3. Microsoft Entra 应用的“应用程序 ID”显示在“摘要”框中。 复制该值以供将来使用。

    Screenshot of the Power BI embedded analytics setup tool, with a Summary box on the right. Information in the box includes an application ID.

步骤 3 - 创建工作区（可选）

在 Power BI 服务中创建工作区：

  • 如果已有 Power BI 工作区，请选择“跳过”。

  • 若要创建工作区，请输入工作区的名称，然后选择“创建工作区”。 工作区名称和 ID 将显示在“摘要”框中。 复制这些值以供将来使用。

    提示

    为了使“嵌入式分析示例应用”能够按预期方式运行，需要使用该工具创建工作区。

步骤 4 - 导入内容（可选）

选择以下选项之一：

  • 如果有自己的 Power BI 应用，则可以选择“跳过”。

  • 如果要使用示例报表创建示例 Power BI 应用，请选择“示例 Power BI 报表”，然后选择“导入”。

  • 如果要使用自己的报表创建示例 Power BI 应用，请选择“上传 .pbix 文件”，浏览文件，然后选择“导入”。

步骤 5 - 授予权限（仅限“为客户嵌入内容”）

选择“授予权限”，然后在对话框中选择“接受”。 通过此步骤，你的 Microsoft Entra 应用可以通过已登录的用户访问你选择的 API（也称为范围）。 此用户也称为“主用户”。

下载示例应用（可选）

如果使用此工具创建了 Power BI 工作区并将内容上传到了该工作区，则可选择“下载示例应用程序”。

注意

如果跳过了可选阶段，仍然可以下载示例 Power BI 应用。 但是，下载的应用中的代码将缺少在注册过程中填写的属性。 例如，如果未创建工作区，则示例应用不包含工作区 ID。

请确保复制了“摘要”框中的所有信息。 Power BI 嵌入环境已准备就绪，可供使用。

手动注册

如果未使用 Power BI 嵌入式分析设置工具，请使用本部分中的过程手动注册 Microsoft Entra 应用。 但仅当要创建以下解决方案之一时，才执行这些步骤：

  • “为组织嵌入内容”应用程序
  • 使用服务主体的“为客户嵌入内容”应用程序

有关如何在 Microsoft Entra ID 中注册应用程序的详细信息，请参阅将应用程序注册到 Microsoft 标识平台。

  1. 登录 Azure 门户。

  2. 在页面右上角选择你的帐户，从而选择你的 Microsoft Entra 租户。

  3. 选择“应用注册”。 如果无法看到此选项，请进行搜索。

  4. 在“应用注册”中，选择“新注册”。

  5. 填写以下字段：

    • 名称 - 为应用程序指定名称。

    • 支持的帐户类型 - 选择可使用该应用程序的用户。

  6. （可选）在“重定向 URI”框中，添加一个重定向 URL。

  7. 选择“注册”。 注册应用后，你将转到应用的“概述”页，可以在其中获取应用程序 ID。

相关内容

更多疑问？ 尝试咨询 Power BI 社区。