Pembolehubah persekitaran CLI Power Apps

Gunakan pembolehubah persekitaran untuk mengkonfigurasi pengesahan CLI Power Apps dan menyediakan pilihan arahan dalam skrip dan saluran CI/CD. Pembolehubah persekitaran yang ditakrifkan oleh CLI Power Apps menggunakan PA_CLI_ awalan.

Nota

Pembolehubah persekitaran ialah nilai yang dinamakan yang disediakan oleh sistem operasi kepada aplikasi. Power Apps CLI mengenal pasti pembolehubah yang diterangkan dalam rujukan ini. Untuk mengetahui bagaimana pembolehubah persekitaran berfungsi dan cara menguruskannya, lihat tentang Pembolehubah Persekitaran.

Rujukan ini menerangkan pembolehubah persekitaran sistem operasi yang mengkonfigurasi Power Apps CLI. Pembolehubah ini berbeza daripada pembolehubah persekitaran penyelesaian Power Platform, yang menyimpan nilai konfigurasi yang digunakan oleh aplikasi.

Untuk pilihan arahan, CLI menyelesaikan nilai mengikut susunan berikut:

Pilihan baris arahan
Pemboleh ubah persekitaran
Nilai lalai, jika pilihan memilikinya
Arahan interaktif, apabila disokong

Pilihan yang disediakan pada baris arahan akan mengatasi pembolehubah persekitaran yang sepadan.

Penting

Pembolehubah persekitaran boleh mendedahkan rahsia kepada proses lain, log, atau sejarah shell. Simpan PA_CLI_SP_CLIENT_SECRET dalam stor rahsia platform CI/CD anda, sembunyikan daripada log, dan jangan masukkan rahsia ke kawalan sumber.

Tetapkan pembolehubah persekitaran

Contoh berikut ditetapkan PA_CLI_ENVIRONMENT_ID sebelum menjalankan arahan Power Apps CLI.

Powershell
Bash

$env:PA_CLI_ENVIRONMENT_ID = "<environment-id>"
pa app list

export PA_CLI_ENVIRONMENT_ID="<environment-id>"
pa app list

Pembolehubah persekitaran kekal tersedia untuk arahan yang dimulakan dari sesi terminal yang sama. Gunakan arahan standard shell anda untuk mengeluarkannya apabila ia tidak lagi diperlukan.

Pengesahan

Pemboleh ubah persekitaran	Perihalan
`PA_CLI_ACCOUNT`	Menentukan akaun untuk `pa auth login` atau `pa auth switch`.
`PA_CLI_SP_CLIENT_ID`	Menentukan ID aplikasi (klien) Microsoft Entra untuk pengesahan prinsipal perkhidmatan.
`PA_CLI_SP_CLIENT_SECRET`	Menentukan rahsia klien untuk pengesahan prinsipal perkhidmatan.
`PA_CLI_SP_TENANT_ID`	Menentukan ID direktori Microsoft Entra (penyewa) untuk pengesahan prinsipal perkhidmatan.
`PA_CLI_USE_SP_AUTH`	Tetapkan nilai kepada `true` (huruf kecil) untuk menggunakan pengesahan prinsipal perkhidmatan.

Tiga PA_CLI_SP_pembolehubah kelayakan * diperlukan apabila pengesahan prinsipal perkhidmatan dipilih. Walaupun CI=true juga memilih pengesahan prinsipal perkhidmatan untuk keserasian, gunakan PA_CLI_USE_SP_AUTH=true untuk menjadikan mod pengesahan secara eksplisit.

Untuk arahan persediaan, lihat Terbitkan aplikasi kod Power Apps dengan prinsipal perkhidmatan.

Pilihan arahan global

Pembolehubah ini sepadan dengan pilihan yang tersedia merentasi arahan CLI Power Apps.

Pemboleh ubah persekitaran	Pilihan yang sepadan	Perihalan
`PA_CLI_CLOUD`	`--cloud`	Memilih awan sasaran. Nilai yang sah ialah: - `public` (lalai) - `usgov` - `usgovhigh` - `usgovdod` - `china` Nilai tidak sensitif huruf besar/kecil.
`PA_CLI_ENVIRONMENT_ID`	`--environment-id`	Menentukan ID persekitaran Power Platform sasaran.

Inisialisasi aplikasi

Pembolehubah ini membekalkan pilihan kepada pa app init.

Pemboleh ubah persekitaran	Pilihan yang sepadan	Perihalan
`PA_CLI_APP_BUILD_PATH`	`--build-path`	Menentukan direktori output binaan. Lalai adalah `./dist`.
`PA_CLI_APP_DESCRIPTION`	`--description`	Menentukan penerangan aplikasi.
`PA_CLI_APP_DISPLAY_NAME`	`--display-name`	Menentukan nama paparan aplikasi.
`PA_CLI_APP_FILE_ENTRY_POINT`	`--file-entry-point`	Menentukan titik kemasukan HTML dalam output binaan. Lalai adalah `index.html`.
`PA_CLI_APP_TYPE`	`--app-type`	Menentukan jenis aplikasi. Nilai yang sah ialah: - `CodeApp` (lalai) - `MobileApp` Nilai disimpan dan `power.config.json` digunakan sebagai jenis aplikasi apabila aplikasi diterbitkan.
`PA_CLI_APP_URL`	`--app-url`	Menentukan URL aplikasi tempatan semasa `pa app init`. Nilai disimpan sebagai `localAppUrl` dalam `power.config.json` dan menjadi URL lalai untuk arahan akan datang `pa app run` . Lalai adalah `http://localhost:3000`.

Jalankan aplikasi

Pembolehubah ini membekalkan pilihan kepada pa app run.

Pemboleh ubah persekitaran	Pilihan yang sepadan	Perihalan
`PA_CLI_LOCAL_APP_URL`	`--local-app-url`	Menggantikan `localAppUrl` nilai dari `power.config.json` untuk arahan semasa tanpa mengubah konfigurasi yang disimpan. Jika tiada nilai ditetapkan, lalai adalah `http://localhost:3000`.
`PA_CLI_PORT`	`--port`	Menentukan port untuk hos tempatan Power Apps. Lalai adalah `8080`.

Pembolehubah ini membekalkan pilihan kepada pa app share.

Pemboleh ubah persekitaran	Pilihan yang sepadan	Perihalan
`PA_CLI_SHARE_ACCESS`	`--access`	Menentukan tahap akses. Nilai yang sah ialah: - `play` (lalai) - `edit`
`PA_CLI_SHARE_PRINCIPAL`	`--principal`	Menentukan satu atau lebih alamat emel yang dipisahkan koma atau ID objek Microsoft Entra.

Penyelesaian, penyambung, dan sumber data

Pemboleh ubah persekitaran	Pilihan yang sepadan	Perihalan
`PA_CLI_AS`	`--as`	Menentukan sama ada `pa app add data-source` menambah penyambung yang menyokong kedua-dua jadual dan tindakan sebagai jadual atau sebagai tindakan. Nilai yang sah ialah: - `table` - `action` Nilai tidak sensitif huruf besar/kecil.
`PA_CLI_CONNECTION_DISPLAY_NAME`	`--display-name`	Menentukan nama paparan semasa mencipta sambungan.
`PA_CLI_CONNECTION_ID`	`--connection-id`	Menentukan ID instans sambungan penyambung.
`PA_CLI_CONNECTION_REF`	`--connection-ref`	Menentukan nama logik rujukan sambungan.
`PA_CLI_CONNECTION_SEARCH`	`--search`	Menapis hasil daripada `pa connection list`.
`PA_CLI_CONNECTOR`	`--connector`	Menentukan ID penyambung, seperti `shared_office365users`, atau nama paparan penyambung, seperti `Office 365 Users`.
`PA_CLI_CONNECTOR_SEARCH`	`--search`	Menapis hasil daripada `pa connector list`.
`PA_CLI_DATASET`	`--dataset`	Menentukan set data, seperti tapak SharePoint atau pangkalan data SQL.
`PA_CLI_DATA_SOURCE_NAME`	`--name`	Menentukan sumber data untuk disegarkan atau dibuang.
`PA_CLI_ORG_URL`	`--org-url`	Menggantikan URL organisasi Dataverse yang digunakan untuk mendapatkan metadata apabila menambah sumber data.
`PA_CLI_PROCEDURE`	`--procedure`	Menentukan prosedur tersimpan SQL.
`PA_CLI_SOLUTION_ID`	`--solution-id`	Menentukan penyelesaian untuk `pa app push`, `pa app add data-source`, atau `pa connection list-references`.
`PA_CLI_SOLUTION_SEARCH`	`--search`	Menapis hasil daripada `pa solution list`.
`PA_CLI_TABLE`	`--table`	Menentukan satu jadual atau nama sumber penyambung. Untuk menambah beberapa jadual penyambung, ulangi `--table` parameter baris arahan. Untuk maklumat lanjut, lihat `pa app add data-source` ulasan.

Untuk arahan yang menerima setiap pilihan, lihat rujukan arahan Power Apps CLI.

API Dataverse dan aliran Power Automate

Pemboleh ubah persekitaran	Pilihan yang sepadan	Perihalan
`PA_CLI_DATAVERSE_API_NAME`	`--api-name`	Menentukan tindakan atau fungsi Dataverse untuk ditambah dengan aplikasi PA menambah dataverse-api.
`PA_CLI_DATAVERSE_API_SEARCH_TERM`	`--search`	Menapis tindakan dan fungsi Dataverse mengikut nama dengan `pa app find-dataverse-api`.
`PA_CLI_FLOW_DATA_SOURCE_NAME`	`--flow-name`	Menentukan sumber data aliran yang akan dikeluarkan dari aplikasi dengan `pa app remove flow`
`PA_CLI_FLOW_ID`	`--flow-id`	Menentukan aliran Power Automate untuk ditambah dengan `pa app add flow`.
`PA_CLI_FLOW_SEARCH`	`--search`	Menapis aliran Power Automate yang tersedia mengikut nama dengan`pa app list-flows`
`PA_CLI_REMOVE_FLOW_ID`	`--flow-id`	Menentukan aliran Power Automate yang akan dikeluarkan dengan`pa app remove flow`

Telemetri dan output konsol

Pemboleh ubah persekitaran	Pilihan yang sepadan	Perihalan
`PA_CLI_CONSOLE_ONLY`	`--console-only`	Tetapkan nilai kepada `true` (huruf kecil) dengan `pa telemetry enable` atau `pa telemetry disable` menulis telemetri hanya ke konsol dan tidak menghantarnya secara jauh.
`PA_CLI_OUTPUT_TO_CONSOLE`	`--output-to-console`	Tetapkan nilai kepada `true` (huruf kecil) dengan `pa telemetry enable` atau `pa telemetry disable` untuk mencerminkan peristiwa telemetri yang dihantar jauh ke konsol.
`PA_CLI_TELEMETRY`	Tiada	Tetapkan salah satu nilai ini untuk mematikan telemetri bagi proses semasa: - `0` - `false` - `no` - `off` Nilai tidak sensitif huruf besar/kecil, dan ruang sekeliling diabaikan.

Untuk tetapan telemetri berterusan, lihat Urus tetapan telemetri untuk Power Apps CLI.

Pembolehubah persekitaran standard

CLI juga memerhati pembolehubah persekitaran piawai ini:

Pemboleh ubah persekitaran	Perihalan
`NO_COLOR`	Tetapkan pembolehubah ini kepada nilai yang tidak kosong untuk mematikan output warna ANSI. Anda juga boleh menggunakan pilihan ini `--no-color` .

Maklum balas

Adakah halaman ini membantu?

Last updated on 2026-10-02