Power Apps CLI 命令参考

使用此 Power Apps CLI 命令引用快速查找用于创建、开发、连接和发布Power Apps代码应用的命令。 CLI 使用以下格式的分组命令：

pa <command-group> <command>

以下是命令组：

命令组	Description
pa app	创建、运行、连接和发布代码应用。
pa auth	登录和管理帐户。
pa connector	查找 Power Platform 环境中可用的连接器。
pa connection	创建和管理连接并发现其资源。
pa telemetry	管理 CLI 遥测设置。

全局选项

在任何级别使用 --help ，在终端中显示帮助：

pa --help
pa app --help
pa app init --help

用于--version显示已安装的 Power Apps CLI 版本：

pa --version

Power Apps CLI 命令

这些命令可用：

命令	Description
pa app add data-source	将连接器或表格数据源添加到代码应用。
pa app add dataverse-api	向代码应用添加 Dataverse 操作或函数。
pa app add flow	将Power Automate流添加到代码应用。
pa app find-dataverse-api	在当前环境中查找 Dataverse 操作和函数。
pa app init	初始化当前目录中的代码应用。
pa app list	列出当前环境中的代码应用。
pa app list-environment-variables	列出代码应用可用的环境变量。
pa app list-flows	列出当前环境中的解决方案感知Power Automate流。
pa app push	将新版本的代码应用发布到Power Apps。
pa app refresh data-source	刷新数据源生成的文件。
pa app remove data-source	从代码应用中删除数据源。
pa app remove flow	从代码应用中删除Power Automate流。
pa app run	启动代码应用的Power Apps本地主机。
pa app share	与用户或服务主体共享代码应用。
pa auth login	通过系统浏览器登录。
pa auth logout	注销并删除保存的身份验证信息。
pa auth status	显示已登录帐户并标识活动帐户。
pa auth switch	更改活动帐户。
pa connection create	为连接器创建连接。
pa connection list	列出当前环境中的连接。
pa connection list-datasets	列出可通过连接获取的数据集。
pa connection list-procedures	列出数据集中可用的 SQL 存储过程。
pa connection list-references	列出解决方案中的连接引用。
pa connection list-tables	列出数据集中可用的表。
pa connector list	列出当前 Power Platform 环境中可用的连接器。
pa telemetry disable	禁用遥测收集。
pa telemetry enable	启用遥测收集。
pa telemetry status	显示当前的遥测设置。

pa app add data-source

将连接器或表格数据源添加到代码应用。

pa app add data-source --connector <connector-id> [options]

pa app add data-source 参数

参数	Description
--connector	连接器标识符，例如 shared_office365users。
--connection-id	要用于数据源的连接 ID。
--connection-ref	连接引用的逻辑名称。
--solution-id	包含连接引用的解决方案。
--dataset	表格数据源的数据集。
--table	要添加的表。
--procedure	要添加的 SQL 存储过程。

pa app add dataverse-api

将 Dataverse 操作或函数添加到代码应用。

pa app add dataverse-api --api-name <operation-name>

pa app add dataverse-api 参数

参数	Description
--api-name	要添加的 Dataverse 操作或函数的名称。

了解详细信息：

• 了解如何更新 Dataverse 操作
• Dataverse 操作疑难解答

pa app add flow

将Power Automate流添加到代码应用。

pa app add flow --flow-id <flow-id>

pa app add flow 参数

参数	Description
--flow-id	要添加的Power Automate流的 ID。

命令：

• 下载流的 OpenAPI 定义。
• 生成强类型 TypeScript 模型和服务。
• 将流及其连接引用添加到 power.config.json。

如果流定义发生更改，请再次运行以下命令以重新生成最新版本的代码。

Important

运行 pa app add flow 的人员必须有权访问流及其基础连接。 如果该人员无权访问所需的连接，该命令将失败。

了解有关使用此命令的方案的详细信息：

• 了解添加Power Automate流时会发生什么情况
• 了解如何更新Power Automate流
• 查看Power Automate流的限制和注意事项

pa app find-dataverse-api

查找当前环境中的 Dataverse 操作和函数。

pa app find-dataverse-api --search <operation-name> [--json]

pa app find-dataverse-api 参数

参数	Description
--search	要搜索的操作名称。
--json	以 JSON 形式返回结果。

了解如何查找可用的 Dataverse 操作

pa app init

初始化当前目录中的代码应用。

pa app init [--display-name <name>] [--environment-id <environment-id>]

pa app init 参数

参数	Description
--display-name	代码应用的显示名称。
--environment-id	代码应用的 Power Platform 环境。
--build-path	包含已编译的应用资产的目录。
--cloud	Power Platform 云实例。

详细了解可以使用此命令的方案：

• 查看添加 Dataverse 操作或函数的先决条件
• 查看添加Power Automate流的先决条件
• 了解如何初始化代码应用
• 了解初始化代码应用时登录的工作原理

pa app list

列出当前环境中的代码应用。

pa app list

pa app list-environment-variables

列出代码应用可用的环境变量。

pa app list-environment-variables

pa app list-flows

列出当前环境中的解决方案感知Power Automate流。

pa app list-flows [--search <term>]

Example:

pa app list-flows

Name                    Status   Modified On   Flow ID
──────────────────────────────────────────────────────────────────────────────
Approval Workflow       Started  2026-01-15    a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1
Send Notification       Started  2026-02-01    b1b1b1b1-cccc-dddd-eeee-f2f2f2f2f2f2

Total flows: 2

pa app list-flows 参数

参数	Description
--search	按名称筛选流。

pa app push

将新版本的代码应用发布到Power Apps。

pa app push [--solution-id <solution-id>]

pa app push 参数

参数	Description
--solution-id	要向其添加代码应用的解决方案的 ID。
--non-interactive	以非交互方式发布应用。 了解如何使用服务主体发布应用。

了解如何使用 Power Apps CLI 创建代码应用。

pa app refresh data-source

刷新数据源生成的文件。

pa app refresh data-source --name <data-source-name>

pa app refresh data-source 参数

参数	Description
--name	要刷新的数据源的名称。

pa app remove data-source

从代码应用中删除数据源。

pa app remove data-source --connector <connector-id> --name <data-source-name> [--force]

pa app remove data-source 参数

参数	Description
--connector	数据源的连接器标识符。
--name	要删除的数据源的名称。
--force	在不提示确认的情况下删除数据源。

pa app remove flow

从代码应用中删除Power Automate流。

pa app remove flow [--flow-name <name> | --flow-id <flow-id>] [--force]

pa app remove flow 参数

参数	Description
--flow-name	要删除的Power Automate流的名称。
--flow-id	要删除的Power Automate流的 ID。
--force	在不提示确认的情况下删除流。

了解如何删除流

pa app run

启动代码应用的Power Apps本地主机。

pa app run [--port <port>] [--local-app-url <url>]

pa app run 参数

参数	Description
--port	本地主机的端口。
--local-app-url	本地运行的代码应用的 URL。

pa app share

与用户或服务主体共享代码应用。

pa app share --principal <principal> [--access play|edit]

pa app share 参数

参数	Description
--principal	要与之共享的用户或服务主体的逗号分隔电子邮件地址或Microsoft Entra对象 ID。
--access	要授予的访问级别： play （默认）或 edit。

pa app share 言论

代码应用必须已发布，并且具有来自成功 pa app push 命令的应用 ID。 当服务主体需要运行时edit授予pa app push访问权限。

与服务主体共享时，请使用企业应用程序对象 ID，而不是应用注册对象 ID。

pa auth login

通过系统浏览器登录。

pa auth login

若要在登录页上预填充帐户，请使用：

pa auth login --account user@contoso.com

pa auth login 参数

参数	Description
--account	在登录页上预填充的帐户。

• 了解如何登录
• 了解如何切换活动帐户

pa auth logout

注销并删除保存的身份验证信息。

pa auth logout

Note

此命令会注销 所有 帐户。 它不能只注销一个帐户。 若要更改哪个帐户处于活动状态，请改用 pa auth switch 。

了解如何注销

pa auth status

显示已登录帐户并标识活动帐户。

若要将身份验证状态显示为 JSON，请使用：

pa auth status --json

pa auth status 参数

参数	Description
--json	以 JSON 形式返回身份验证状态。

了解如何检查哪个帐户处于活动状态

pa auth switch

更改活动帐户。

pa auth switch --account user@contoso.com

pa auth switch 参数

参数	Description
--account	要激活的帐户。

详细了解何时可以使用此命令：

• 了解如何检查哪个帐户处于活动状态
• 了解如何切换活动帐户
• 了解如何注销

pa connection create

为连接器创建连接。

pa connection create --connector <connector-id> [--display-name <name>] [--json]

pa connection create 参数

参数	别名	必需	Description
--connector	-	是的	连接器标识符，例如 shared_office365 或 shared_teams。
--display-name	-n	否	连接的显示名称。 如果未提供名称，CLI 将使用默认名称。
--json	-	否	以 JSON 形式返回结果。

pa connection create 示例

创建Office 365 Outlook连接：

pa connection create --connector shared_office365

使用自定义显示名称创建Microsoft Teams连接：

pa connection create --connector shared_teams --display-name "My Teams"

创建连接并将结果作为 JSON 返回：

pa connection create --connector shared_office365 --json

pa connection create 输出

命令成功后，它将返回连接 ID。 将连接器作为数据源添加到代码应用时，请使用连接 ID。

了解如何从 Power Apps CLI 创建连接

pa connection list

列出当前环境中的连接。

pa connection list [--search <term>] [--json]

pa connection list 参数

参数	Description
--search	按名称筛选连接。
--json	以 JSON 形式返回结果。

pa connection list-datasets

列出可通过连接获取的数据集。

pa connection list-datasets --connector <connector-id> [--connection-id <connection-id>]

pa connection list-datasets 参数

参数	Description
--connector	连接器标识符。
--connection-id	列出数据集时要使用的连接 ID。

pa connection list-procedures

列出数据集中可用的 SQL 存储过程。

pa connection list-procedures --connection-id <connection-id> --dataset <dataset>

pa connection list-procedures 参数

参数	Description
--connection-id	列出存储过程时要使用的连接 ID。
--dataset	包含存储过程的数据集。

pa connection list-references

列出解决方案中的连接引用。

pa connection list-references --solution-id <solution-id>

pa connection list-references 参数

参数	Description
--solution-id	包含连接引用的解决方案的 ID。

pa connection list-tables

列出数据集中可用的表。

pa connection list-tables --connector <connector-id> [--connection-id <connection-id>] [--dataset <dataset>]

pa connection list-tables 参数

参数	Description
--connector	连接器标识符。
--connection-id	列出表时要使用的连接 ID。
--dataset	包含表的数据集。

pa connector list

列出当前 Power Platform 环境中可用的连接器。

pa connector list [--search <term>] [--json]

pa connector list 参数

参数	Description
--search	按名称或显示名称筛选连接器。
--json	以 JSON 形式返回完整的连接器列表。

pa connector list 输出

在交互式终端中，结果显示在 20 行的页面中。 按 Enter 显示下一页。 按 Esc 或 Q 退出。 重定向输出或包含 --json时，该命令将返回完整列表。

默认情况下，该命令返回具有以下列的表：

列	Description
显示名称	连接器的显示名称，例如Office 365 Outlook。
Connector	连接器标识符，例如 shared_office365。 将此值与选项一--connector起使用pa connection create。

使用 --json 参数时，JSON 输出包括以下字段：

领域	Description
id	连接器 ID。
name	连接器标识符，例如 shared_office365。
displayName	连接器显示名称。
description	连接器说明。
isTabular	指示连接器是否支持表格数据操作。

pa connector list 示例

列出所有可用的连接器：

pa connector list

搜索连接器：

pa connector list --search teams

以 JSON 形式返回连接器列表：

pa connector list --json

了解如何列出可用的连接器

pa telemetry disable

禁用遥测收集。

pa telemetry disable

pa telemetry enable

启用遥测收集。

pa telemetry enable

pa telemetry status

显示当前的遥测设置。

pa telemetry status

相关信息

• 快速入门：使用 Power Apps CLI 创建代码应用
• 使用 Power Apps CLI 登录和管理帐户
• 将数据源添加到代码应用