使用環境變數來設定 Power Apps CLI 認證，並在腳本和 CI/CD 管線中提供指令選項。 由 Power Apps CLI 定義的環境變數會使用 前綴。PA_CLI_
Note
環境變數是作業系統提供給應用程式的命名值。 Power Apps CLI 能辨識此參考中描述的變數。 想了解環境變數的運作方式以及如何管理它們，請參考 環境變數。
本參考文獻描述了用來配置 Power Apps CLI 的作業系統環境變數。 這些變數與 Power Platform 解決方案的環境變數不同，後者是儲存應用程式使用的設定值。
對於指令選項，CLI 會依以下順序解析一個值：
- 命令行選項
- 環境變數
- 預設值，如果選項有預設值
- 互動提示（支援時）
命令列中提供的選項優先於對應的環境變數。
Important
環境變數可以將秘密暴露給其他程序、日誌或 shell 歷史。 把秘密存放 PA_CLI_SP_CLIENT_SECRET 在你的 CI/CD 平台的秘密儲存庫，對日誌隱藏起來，並且不要向原始碼控制提交秘密。
設定環境變數
以下範例設定PA_CLI_ENVIRONMENT_ID在執行 Power Apps CLI 指令之前。
$env:PA_CLI_ENVIRONMENT_ID = "<environment-id>"
pa app list
環境變數仍可保留給從同一終端機會話開始的指令。 當你不再需要時，使用你外殼的標準指令來移除它。
驗證
| 環境變數 | Description |
|---|---|
PA_CLI_ACCOUNT |
指定 的 pa auth loginpa auth switch或 的帳號。 |
PA_CLI_SP_CLIENT_ID |
指定 Microsoft Entra 應用程式（客戶端）ID 用於服務主體認證。 |
PA_CLI_SP_CLIENT_SECRET |
指定服務主體認證的客戶端秘密。 |
PA_CLI_SP_TENANT_ID |
指定 Microsoft Entra 目錄（租戶）ID 用於服務主體認證。 |
PA_CLI_USE_SP_AUTH |
將值設為 true （小寫）以使用服務主體認證。 |
當選擇服務主體認證時，必須使用三個 PA_CLI_SP_* 的憑證變數。 雖然 CI=true 也選擇服務主體認證以促進相容性，但請用 PA_CLI_USE_SP_AUTH=true 以明確化認證模式。
關於設定說明，請參見「發佈帶有服務主體的 Power Apps 程式碼應用程式」。
全域指令選項
這些變數對應於 Power Apps CLI 指令中可用的選項。
| 環境變數 | 對應選項 | Description |
|---|---|---|
PA_CLI_CLOUD |
--cloud |
選擇目標雲。 有效值為： - public (預設)- usgov- usgovhigh- usgovdod- china數值不區分大小寫。 |
PA_CLI_ENVIRONMENT_ID |
--environment-id |
指定目標 Power Platform 環境 ID。 |
應用程式初始化
這些變數為 提供了選項。pa app init
| 環境變數 | 對應選項 | Description |
|---|---|---|
PA_CLI_APP_BUILD_PATH |
--build-path |
指定建置輸出目錄。 預設值為 ./dist。 |
PA_CLI_APP_DESCRIPTION |
--description |
指定應用程式描述。 |
PA_CLI_APP_DISPLAY_NAME |
--display-name |
指定應用程式的顯示名稱。 |
PA_CLI_APP_FILE_ENTRY_POINT |
--file-entry-point |
指定建置輸出中的 HTML 入口點。 預設值為 index.html。 |
PA_CLI_APP_TYPE |
--app-type |
指定應用程式類型。 有效值為： - CodeApp (預設)- MobileApp這個數值會儲存在 power.config.json 應用程式中，並在應用程式發佈時作為應用程式類型使用。 |
PA_CLI_APP_URL |
--app-url |
在 期間指定本地應用程式的 URL pa app init。 這個值會被儲存，localAppUrlpower.config.json成為未來pa app run指令的預設網址。 預設值為 http://localhost:3000。 |
執行應用程式
這些變數為 提供了選項。pa app run
| 環境變數 | 對應選項 | Description |
|---|---|---|
PA_CLI_LOCAL_APP_URL |
--local-app-url |
在不更改儲存的設定的情況下，覆蓋 localAppUrl 目前指令的 power.config.json 值。 若兩個值皆未設定，預設為 http://localhost:3000。 |
PA_CLI_PORT |
--port |
指定 Power Apps 本地主機的埠口。 預設值為 8080。 |
共用應用程式
這些變數為 提供了選項。pa app share
| 環境變數 | 對應選項 | Description |
|---|---|---|
PA_CLI_SHARE_ACCESS |
--access |
指定存取層級。 有效值為： - play (預設)- edit |
PA_CLI_SHARE_PRINCIPAL |
--principal |
指定一個或多個逗號分隔的電子郵件地址或 Microsoft Entra 物件 ID。 |
解決方案、連接器與資料來源
| 環境變數 | 對應選項 | Description |
|---|---|---|
PA_CLI_CONNECTION_DISPLAY_NAME |
--display-name |
在建立連線時指定顯示名稱。 |
PA_CLI_CONNECTION_ID |
--connection-id |
指定連接器連接實例 ID。 |
PA_CLI_CONNECTION_REF |
--connection-ref |
指定連線參考邏輯名稱。 |
PA_CLI_CONNECTION_SEARCH |
--search |
篩選結果來自 pa connection list。 |
PA_CLI_CONNECTOR |
--connector |
指定連接器 ID，例如 shared_office365users。 |
PA_CLI_CONNECTOR_SEARCH |
--search |
篩選結果來自 pa connector list。 |
PA_CLI_DATASET |
--dataset |
指定一個資料集，例如 SharePoint 網站或 SQL 資料庫。 |
PA_CLI_DATA_SOURCE_NAME |
--name |
指定要重新整理或移除的資料來源。 |
PA_CLI_ORG_URL |
--org-url |
在新增資料來源時，會覆蓋用於擷取元資料的 Dataverse 組織 URL。 |
PA_CLI_PROCEDURE |
--procedure |
指定 SQL 儲存程序。 |
PA_CLI_SOLUTION_ID |
--solution-id |
指定 、 pa app pushpa app add data-source、 或 pa connection list-references的解。 |
PA_CLI_SOLUTION_SEARCH |
--search |
篩選結果來自 pa solution list。 |
PA_CLI_TABLE |
--table |
指定資料表或連接器資源名稱。 |
關於接受每個選項的指令，請參閱 Power Apps CLI 指令參考。
Dataverse API 與 Power Automate 流程
| 環境變數 | 對應選項 | Description |
|---|---|---|
PA_CLI_DATAVERSE_API_NAME |
--api-name |
指定要在 app、add dataverse-api 中新增的 Dataverse 動作或函式。 |
PA_CLI_DATAVERSE_API_SEARCH_TERM |
--search |
以名稱 pa app find-dataverse-api過濾資料宇宙的動作與函式。 |
PA_CLI_FLOW_DATA_SOURCE_NAME |
--flow-name |
指定要從應用程式中移除的流量資料來源，且 pa app remove flow |
PA_CLI_FLOW_ID |
--flow-id |
指定要加入 pa app add flow的 Power Automate 流程。 |
PA_CLI_FLOW_SEARCH |
--search |
依名稱篩選可用的 Power Automate 流程，並用pa app list-flows |
PA_CLI_REMOVE_FLOW_ID |
--flow-id |
指定要移除的 Power Automate 流程pa app remove flow |
遙測與控制台輸出
| 環境變數 | 對應選項 | Description |
|---|---|---|
PA_CLI_CONSOLE_ONLY |
--console-only |
將值設為true（小寫），或pa telemetry enablepa telemetry disable只寫入遙測資料給控制台，且不遠端傳送。 |
PA_CLI_OUTPUT_TO_CONSOLE |
--output-to-console |
將值設為 true （小寫）並搭配 pa telemetry enable ，或 pa telemetry disable 將遠端傳送的遙測事件鏡像到主控台。 |
PA_CLI_TELEMETRY |
None | 設定以下其中一個值以停用目前程序的遙測： - 0- false- no- off數值不區分大小寫，周圍空格則被忽略。 |
關於持續遙測設定，請參見 Power Apps CLI 的「管理遙測設定」。
標準環境變數
CLI 也會觀察這個標準環境變數：
| 環境變數 | Description |
|---|---|
NO_COLOR |
將此變數設為非空值以停用 ANSI 色彩輸出。 你也可以使用這個 --no-color 選項。 |