Power Apps CLI 命令參考

使用此 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 指令

以下指令可用：

命令	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 get-settings`	顯示目前的應用程式設定。
`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 set-setting`	更新應用程式設定。
`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 solution list`	列出目前環境下的解決方案。
`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`，或連接器顯示名稱，例如 `"Office 365 使用者"`。如果顯示名稱與多個連接器相符，指令會列出相應的連接器識別碼，方便你指定其中一個。
`--as`	要不要把連接器當作`tableaction`資料來源加入。將此參數用於支援資料表與動作的連接器，例如 SharePoint 和 SQL Server。欲了解更多資訊，請參閱 `pa app add data-source` 備註。
`--connection-id`	用於資料來源的連線 ID。
`--connection-ref`	連接參考的邏輯名稱，例如 `cr123_sharedsharepointonline_1a2b3`。
`--solution-id`	包含連接參考的解。
`--dataset`	表格資料來源的資料集。
`--table`	要補充表格。重複這個參數，從同一連接器、連線和資料集中加入多個資料表。原生 Dataverse 支援每個指令一個資料表。
`--org-url`	Dataverse 組織 URL 用於擷取原生 Dataverse 資料表元資料。在互動模式下，如果你沒有提供這個值作為命令選項或環境變數，命令會提示這個值。
`--procedure`	還有 SQL 儲存程序要補充。

這些參數對應的解決方案、連接器及資料來源環境變數。

`pa app add data-source` 備註

要在同一指令中加入多個連接器資料表，對每個資料表重複 --table 此步驟。資料表必須使用相同的連接器、連線和資料集。此指令只會新增一次重複的資料表識別碼。每個指令只能包含一個原生 Dataverse 資料表或 SQL 儲存程序。

如果資料表特定的元資料、驗證或結構寫入操作失敗，該指令仍會新增有效的資料表。它會回報訂單 succeeded 和 failed 結果，如果有任何資料表失敗，還會回傳一個非零的退出碼。重試前請先檢視結果。

有些連接器，如 SharePoint 和 SQL Server，支援資料表與動作。對於這些連接器，請指定要添加的內容：

若要新增資料表或 SQL 儲存程序，請使用 --as table、或包含 --table 或 --procedure。
要加入連接器的動作，請使用 --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 時，指令會要求輸入。

原生 Dataverse 不使用連線 ID、連線參考或資料集。

對於連接器支援的資料來源：

選擇連接器和資料來源類型

如果你沒指定 --connector，指令會要求輸入連接器 ID。
如果連接器同時支援資料表和動作，且沒有其他指令決定要新增什麼，指令就會問「 新增資料表？」

選擇連結

指令會問 ：你是不是用連線參考而不是連線 ID？ 當你提供連線 ID 或連線參考時，會跳過這個問題。

如果你選擇 「是」，指令會要求你輸入連線參考邏輯名稱。
如果你選擇 「否」，指令會列出你連接器的連接。選擇 （手動輸入...） 以輸入一個不在列表中的連線 ID。

選擇資料

如果你要新增動作，這個指令會跳過儲存程序、資料集和資料表提示。
如果你要新增資料表或儲存程序：
1. 對於 SQL Server，指令會詢問你是否正在新增儲存程序。如果是的話，它會要求儲存程序名稱。
2. 指令列出透過連線可用的資料集。選擇 （手動輸入...） 以輸入不在列表中的資料集。
3. 除非你要加入儲存程序，否則這個指令會開啟資料集中可搜尋的資料表清單。你可以選擇多個表格。

當你使用連線參考時，資料集和表格清單會來自參考所指向的連結。

`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 流程的環境變數。

了解如何查找可用的 Dataverse 作業。

`pa app get-settings`

顯示 code app 目前的設定。

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`	Code 應用程式的 Power Platform 環境。
`--description`	代碼應用程式的描述。
`--build-path`	包含已編譯應用程式資產的目錄。
`--file-entry-point`	就是建置輸出中的 HTML 入口。
`--app-type`	應用程式類型。有效值為 `CodeApp` 和 `MobileApp`。
`--app-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>]

範例：

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`	非互動式發佈應用程式。學會用服務主體發佈應用程式。

作為環境--solution-id變數，搭配PA_CLI_SOLUTION_ID參數。

學習如何使用 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_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`	本地執行程式碼應用程式的網址。

這些參數對應的 Run 應用程式環境變數。

`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 檔案的初始化程式碼應用程式專案執行此指令。指令會將設定寫入 appSettingspower.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`。

這些參數對應的環境變數。

`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_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` 參數

參數	別名	Required	Description
`--connector`	-	Yes	連接器識別碼，例如 `shared_office365` 或 `shared_teams`。
`--display-name`	`-n`	No	連線的顯示名稱。如果你沒有提供名稱，CLI 會使用預設名稱。
`--json`	-	No	會以 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_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時，指令會回傳完整清單。

預設情況下，該指令會回傳一個包含以下欄位的表格：

Column	Description
顯示名稱	連接器的顯示名稱，例如 Office 365 Outlook。
連接器	連接器識別碼，例如 `shared_office365`。使用此值，選項 `--connector` 為 `pa connection create`。

當你使用該 --json 參數時，JSON 輸出包含以下欄位：

Field	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 對應的環境變數。

`pa telemetry disable`

關閉遙測收集。

pa telemetry disable

`pa telemetry enable`

啟用遙測收集。

pa telemetry enable

`pa telemetry status`

顯示目前的遙測設定。

pa telemetry status

意見反應

此頁面對您有幫助嗎？

Last updated on 2026-10-02

Power Apps CLI 命令參考

全域選項

Power Apps CLI 指令

pa app add data-source

pa app add data-source 參數

pa app add data-source 備註

針對原生 Dataverse：

對於連接器支援的資料來源：

pa app add data-source 範例

pa app add dataverse-api

pa app add dataverse-api 參數

pa app add flow

pa app add flow 參數

pa app find-dataverse-api

pa app find-dataverse-api 參數

pa app get-settings

pa app get-settings 參數

pa app init

pa app init 參數

pa app list

pa app list-environment-variables

pa app list-flows

pa app list-flows 參數

pa app push

pa app push 參數

pa app refresh data-source

pa app refresh data-source 參數

pa app remove data-source

pa app remove data-source 參數

pa app remove flow

pa app remove flow 參數

pa app run

pa app run 參數

pa app set-setting

pa app set-setting 參數

pa app share

pa app share 參數

pa app share 備註

pa auth login

pa auth login 參數

pa auth logout

pa auth status

pa auth status 參數

pa auth switch

pa auth switch 參數

pa connection create

pa connection create 參數

pa connection create 範例

pa connection create輸出

pa connection list

pa connection list 參數

pa connection list-datasets

pa connection list-datasets 參數

pa connection list-procedures

pa connection list-procedures 參數

pa connection list-references

pa connection list-references 參數

pa connection list-tables

pa connection list-tables 參數

pa connector list

pa connector list 參數

pa connector list輸出

pa connector list 範例

pa solution list

pa solution list 參數

pa telemetry disable

pa telemetry enable

pa telemetry status

相關信息