使用此 Power Apps CLI 命令引用快速查找用于创建、开发、连接和发布Power Apps代码应用的命令。 CLI 使用以下格式的分组命令：
pa <command-group> <command>
以下是命令组：
| 命令组 | Description |
|---|---|
pa app |
创建、运行、连接和发布代码应用。 |
pa auth |
登录和管理帐户。 |
pa connection |
创建和管理连接并发现其资源。 |
pa connector |
查找 Power Platform 环境中可用的连接器。 |
pa solution |
查找 Power Platform 环境中可用的解决方案。 |
pa telemetry |
管理 CLI 遥测设置。 |
全局选项
在任何级别使用 --help ，在终端中显示帮助：
pa --help
pa app --help
pa app init --help
用于--version显示已安装的 Power Apps CLI 版本：
pa --version
Power Apps CLI 命令
这些命令可用：
pa app add data-source
将连接器或表格数据源添加到代码应用。
pa app add data-source --connector <connector-id> [options]
pa app add data-source 参数
| 参数 | Description |
|---|---|
--connector |
连接器标识符，例如 shared_office365users，或连接器显示名称，例如 "Office 365 用户"。 如果显示名称与多个连接器匹配，该命令将列出匹配的连接器标识符，以便可以指定一个连接器。 |
--as |
是将连接器添加为 table 数据源还是 action 数据源。 将此参数用于支持表和操作的连接器，例如SharePoint和SQL Server。 有关详细信息，请参阅 pa app add data-source 备注。 |
--connection-id |
要用于数据源的连接 ID。 |
--connection-ref |
连接引用的逻辑名称，例如 cr123_sharedsharepointonline_1a2b3。 |
--solution-id |
包含连接引用的解决方案。 |
--dataset |
表格数据源的数据集。 |
--table |
要添加的表。 重复此参数，从同一连接器、连接和数据集添加多个表。 本机 Dataverse 支持每个命令一个表。 |
--org-url |
用于检索本机 Dataverse 表元数据的 Dataverse 组织 URL。 在交互模式下，如果未将其作为命令选项或环境变量提供，则命令提示符会提示此值。 |
--procedure |
要添加的 SQL 存储过程。 |
这些参数具有相应的 解决方案、连接器和数据源环境变量 。
pa app add data-source 言论
若要在一个命令中添加多个连接器表，请对每个表重复此操作 --table 。 表必须使用相同的连接器、连接和数据集。 该命令仅添加重复的表标识符一次。 每个命令只能包含一个本机 Dataverse 表或 SQL 存储过程。
如果特定于表的元数据、验证或架构写入操作失败，该命令仍会添加有效表。 它会报告有序 succeeded 结果， failed 并在任何表失败时返回非零退出代码。 在重试之前查看结果。
某些连接器（例如SharePoint和SQL Server）支持表和操作。 对于这些连接器，请指定要添加的内容：
- 若要添加表或 SQL 存储过程，请使用
--as table或包括或包括或--procedure。--table - 若要添加连接器的操作，请使用
--as action。 不能与--as action--dataset、--table或--procedure.
如果未指定要添加的内容，命令将在交互式终端中询问“添加表”。 在非交互模式下，命令将失败，直到指定 --as。 仅支持操作（如Office 365 用户）的连接器不需要--as也不支持--as table。 若要添加 Dataverse 操作或函数，请使用 pa app add dataverse-api 而不是 --as action。
在交互式终端中，命令提示符输入未作为命令选项或环境变量提供所需的值。 提示取决于数据源的类型。
对于本机 Dataverse：
- 如果未指定
--connector，该命令将请求连接器 ID。 - 该命令请求表逻辑名称。
- 未提供 Dataverse 组织 URL 时，该命令会请求该 URL。
本机 Dataverse 不使用连接 ID、连接引用或数据集。
对于连接器支持的数据源：
选择连接器和数据源类型
- 如果未指定
--connector，该命令将请求连接器 ID。 - 如果连接器同时支持表和操作，而其他任何操作都确定要添加的内容，则命令会询问 “添加表”？
选择连接
该命令询问 你是否使用连接引用而不是连接 ID？ 当你提供连接 ID 或连接引用时，它会跳过此问题。
- 如果选择 “是”，则命令会请求连接引用逻辑名称。
- 如果选择 “否”，该命令会列出连接器的连接。 选择 “手动输入...” 以输入不在列表中的连接 ID。
选择数据
如果要添加操作，该命令将跳过存储过程、数据集和表提示。
如果要添加表或存储过程：
- 对于SQL Server，该命令询问是否要添加存储过程。 如果是，它会请求存储过程名称。
- 该命令列出可通过连接获取的数据集。 选择 “手动输入...” 以输入不在列表中的数据集。
- 除非要添加存储过程，否则此命令将打开数据集中表的可搜索列表。 可以选择多个表。
使用连接引用时，数据集和表列表来自引用指向的连接。
pa app add data-source 示例
通过回答提示添加数据源：
pa app add data-source
添加本机 Dataverse 表：
pa app add data-source --connector dataverse --table account
添加还支持表的连接器的操作：
pa app add data-source \
--connector shared_sharepointonline \
--connection-id <connection-id> \
--as action
使用连接器显示名称添加SharePoint list：
pa app add data-source \
--connector "SharePoint" \
--connection-id <connection-id> \
--dataset <site-url> \
--table <list-name>
从同一数据集中添加多个 SQL 表：
pa app add data-source \
--connector shared_sql \
--connection-id <connection-id> \
--dataset <server-name,database-name> \
--table "[dbo].[Customers]" \
--table "[dbo].[Orders]"
通过连接引用添加表，并在命令提示符下选择数据集和表：
pa app add data-source \
--connector shared_sharepointonline \
--connection-ref <connection-reference-logical-name> \
--solution-id <solution-id> \
--as table
pa app add dataverse-api
将 Dataverse 操作或函数添加到代码应用。
pa app add dataverse-api --api-name <operation-name>
pa app add dataverse-api 参数
| 参数 | Description |
|---|---|
--api-name |
要添加的 Dataverse 操作或函数的名称。 |
PA_CLI_DATAVERSE_API_NAME 是参数的 --api-name 相应环境变量。
了解详细信息：
pa app add flow
将Power Automate流添加到代码应用。
pa app add flow --flow-id <flow-id>
pa app add flow 参数
| 参数 | Description |
|---|---|
--flow-id |
要添加的Power Automate流的 ID。 |
PA_CLI_FLOW_ID 是参数的 --flow-id 相应环境变量。
命令：
- 下载流的 OpenAPI 定义。
- 生成强类型 TypeScript 模型和服务。
- 将流及其连接引用添加到
power.config.json。
如果流定义发生更改，请再次运行以下命令以重新生成最新版本的代码。
Important
运行 pa app add flow 的人员必须有权访问流及其基础连接。 如果该人员无权访问所需的连接，该命令将失败。
了解有关使用此命令的方案的详细信息：
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 API 和Power Automate流环境变量。
pa app get-settings
显示代码应用的当前设置。
pa app get-settings [--json]
pa app get-settings 参数
| 参数 | Description |
|---|---|
--json |
以 JSON 形式返回应用设置。 |
从包含 power.config.json 文件的初始化代码应用项目运行以下命令。
pa app init
初始化当前目录中的代码应用。
pa app init [--display-name <name>] [--environment-id <environment-id>]
pa app init 参数
| 参数 | Description |
|---|---|
--display-name |
代码应用的显示名称。 |
--environment-id |
代码应用的 Power Platform 环境。 |
--description |
代码应用的说明。 |
--build-path |
包含已编译的应用资产的目录。 |
--file-entry-point |
生成输出中的 HTML 入口点。 |
--app-type |
应用类型。 有效值为 CodeApp 和 MobileApp。 |
--app-url |
本地运行的代码应用的 URL。 |
--cloud |
Power Platform 云实例。 |
这些参数具有相应的 应用初始化 环境变量。
详细了解可以使用此命令的方案：
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_CLI_FLOW_SEARCH 是参数的 --search 相应环境变量。
pa app push
将新版本的代码应用发布到Power Apps。
pa app push [--solution-id <solution-id>]
pa app push 参数
| 参数 | Description |
|---|---|
--solution-id |
要向其添加代码应用的解决方案的 ID。 |
--non-interactive |
以非交互方式发布应用。 了解如何使用服务主体发布应用。 |
PA_CLI_SOLUTION_ID用作具有参数的--solution-id环境变量。
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_CLI_FLOW_DATA_SOURCE_NAME 是 PA_CLI_REMOVE_FLOW_ID 用于这些参数的相应环境变量。
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 set-setting
更新代码应用的一个或多个设置。
pa app set-setting --show-header <true|false> [--json]
pa app set-setting 参数
| 参数 | Description |
|---|---|
--show-header |
显示或隐藏应用标头。 有效值为 true 和 false。 |
--json |
以 JSON 形式返回更新的应用设置。 |
从包含 power.config.json 文件的初始化代码应用项目运行以下命令。 该命令将设置 appSettings 写入到中 power.config.json。 运行 pa app push 以发布设置，以便玩家在运行时应用它。
pa app share
与用户或服务主体共享代码应用。
pa app share --principal <principal> [--access play|edit]
pa app share 参数
| 参数 | Description |
|---|---|
--principal |
要与之共享的用户或服务主体的逗号分隔电子邮件地址或Microsoft Entra对象 ID。 |
--access |
要授予的访问级别： play （默认）或 edit。 |
这些参数具有相应的 Share 应用 环境变量。
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_CLI_ACCOUNT 是参数的 --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_CLI_ACCOUNT 是参数的 --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。
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_CLI_SOLUTION_ID--solution-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_CLI_CONNECTOR_SEARCH 是与参数一起使用的 --search 相应环境变量。
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 solution list
列出当前环境中的解决方案，包括其友好名称、唯一名称和解决方案 ID。
pa solution list [--search <term>] [--json]
pa solution list 参数
| 参数 | Description |
|---|---|
--search |
按友好名称或唯一名称筛选解决方案。 筛选器是不区分大小写的子字符串匹配项。 |
--json |
以 JSON 形式返回完整的解决方案列表。 |
PA_CLI_SOLUTION_SEARCH 是参数的 --search 相应环境变量。
在交互式终端中，你将看到 20 行页的结果。 按 Enter 显示下一页。 按 Esc 或 Q 退出。 重定向输出或包含 --json时，该命令将返回完整列表。
pa telemetry disable
禁用遥测收集。
pa telemetry disable
pa telemetry enable
启用遥测收集。
pa telemetry enable
pa telemetry status
显示当前的遥测设置。
pa telemetry status