从代码应用的 Power Apps 客户端库开始版本 1.1.9,基于 npm 的新 CLI 包括 create-connection 命令。 使用此命令可直接通过命令行创建连接器的连接,无需离开终端或打开 Power Apps maker portal。
该连接将在你的代码应用当前所针对的 Power Platform 环境中创建(即你运行 power-apps init 时在 power.config.json 中设置的环境)。
先决条件
- 初始化的 Power Apps 应用程序代码。 请参阅 快速入门:使用 npm CLI 创建代码应用。
- 要使用的连接器必须支持单一登录(SSO)。 请参阅限制。
Usage
从代码应用项目的根目录运行以下命令:
power-apps create-connection --api-id <connectorId> [--display-name <name>] [--json]
选项
| Option | Alias | 必需 | Description |
|---|---|---|---|
--api-id |
-a |
是的 | 连接器 API 标识符(例如,shared_office365)。 shared_teams |
--display-name |
-n |
No | 新连接的可选显示名称。 如果未指定,则使用默认值。 |
--json |
— | No | 以 JSON 格式输出结果,以便用于脚本编写。 |
例子
创建Office 365连接:
power-apps create-connection --api-id shared_office365
使用自定义显示名称创建一个 Teams 连接:
power-apps create-connection --api-id shared_teams --display-name "My Teams"
创建连接并发出 JSON 输出(在脚本和 CI 中很有用):
power-apps create-connection --api-id shared_office365 --json
成功后,该命令将输出新连接的 ID。 然后,可以在将连接器作为数据源添加到代码应用时引用该连接 ID。
局限性
- 仅支持非交互式 SSO 连接创建。
create-connection命令仅适用于单一身份验证类型符合 SSO 的连接器-通常是基于Microsoft Entra ID的连接器,例如Office 365 Outlook、SharePoint、OneDrive for Business和Microsoft Teams。 - 不支持需要用户提供的凭据或配置的连接器。 示例包括SQL Server SQL 身份验证、需要 API 密钥的自定义连接器,以及公开多个身份验证方法供用户选择的任何连接器。 若要创建这些连接,请改用 Power Apps maker 门户。