以下是最新版本的指令:
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 格式回傳結果。 |
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 雲端實例。 |
了解更多可以使用此指令的情境:
- 檢視新增 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>]
範例:
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