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

Commands

以下是可用的指令:

命令 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 的本地主機來管理 code 應用程式。
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 動作或函式的名稱。

瞭解詳情:

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 者必須能接觸到流程及其底層連結。 如果使用者無法存取所需的連線,指令就會失敗。

了解更多使用此指令的情境:

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 Code 應用程式的 Power Platform 環境。
--build-path 包含已編譯應用程式資產的目錄。
--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>]

範例:

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

移除 Code App 中的 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 本地執行程式碼應用程式的網址。

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 備註

Code 應用程式必須已經發佈,並且有成功 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
--display-name 連線的顯示名稱。
--json 回傳結果為 JSON。

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 telemetry disable

關閉遙測收集。

pa telemetry disable

pa telemetry enable

啟用遙測收集。

pa telemetry enable

pa telemetry status

顯示目前的遙測設定。

pa telemetry status