Power Apps variabel lingkungan CLI

Gunakan variabel lingkungan untuk mengonfigurasi autentikasi CLI Power Apps dan menyediakan opsi perintah dalam skrip dan alur CI/CD. Variabel lingkungan yang ditentukan oleh CLI Power Apps menggunakan awalanPA_CLI_.

Note

Variabel lingkungan diberi nama nilai yang disediakan sistem operasi untuk aplikasi. Power Apps CLI mengenali variabel yang dijelaskan dalam referensi ini. Untuk mempelajari cara kerja variabel lingkungan dan cara mengelolanya, lihat tentang Variabel Lingkungan.

Referensi ini menjelaskan variabel lingkungan sistem operasi yang mengonfigurasi CLI Power Apps. Variabel ini berbeda dari variabel lingkungan solusi Power Platform, yang menyimpan nilai konfigurasi yang digunakan oleh aplikasi.

Untuk opsi perintah, CLI menyelesaikan nilai dalam urutan ini:

Pilihan baris perintah
Variabel Lingkungan
Nilai default, jika opsi memilikinya
Prompt interaktif, saat didukung

Opsi yang disediakan pada baris perintah lebih diutamakan daripada variabel lingkungan yang sesuai.

Important

Variabel lingkungan dapat mengekspos rahasia ke proses, log, atau riwayat shell lainnya. Simpan PA_CLI_SP_CLIENT_SECRET di penyimpanan rahasia platform CI/CD Anda, masking dari log, dan jangan terapkan rahasia ke kontrol sumber.

Mengatur variabel lingkungan

Contoh berikut diatur PA_CLI_ENVIRONMENT_ID sebelum menjalankan perintah CLI Power Apps.

PowerShell
Bash

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

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

Variabel lingkungan tetap tersedia untuk perintah yang dimulai dari sesi terminal yang sama. Gunakan perintah standar shell Anda untuk menghapusnya saat tidak lagi diperlukan.

Authentication

Variabel Lingkungan	Deskripsi
`PA_CLI_ACCOUNT`	Menentukan akun untuk `pa auth login` atau `pa auth switch`.
`PA_CLI_SP_CLIENT_ID`	Menentukan ID aplikasi Microsoft Entra (klien) untuk autentikasi perwakilan layanan.
`PA_CLI_SP_CLIENT_SECRET`	Menentukan rahasia klien untuk autentikasi perwakilan layanan.
`PA_CLI_SP_TENANT_ID`	Menentukan ID direktori Microsoft Entra (penyewa) untuk autentikasi perwakilan layanan.
`PA_CLI_USE_SP_AUTH`	Atur nilai ke `true` (huruf kecil) untuk menggunakan autentikasi perwakilan layanan.

Tiga PA_CLI_SP_* variabel kredensial diperlukan saat autentikasi perwakilan layanan dipilih. Meskipun CI=true juga memilih autentikasi perwakilan layanan untuk kompatibilitas, gunakan PA_CLI_USE_SP_AUTH=true untuk membuat mode autentikasi menjadi eksplisit.

Untuk petunjuk penyiapan, lihat Menerbitkan aplikasi kode Power Apps dengan perwakilan layanan.

Opsi perintah global

Variabel ini sesuai dengan opsi yang tersedia di seluruh perintah CLI Power Apps.

Variabel Lingkungan	Opsi yang sesuai	Deskripsi
`PA_CLI_CLOUD`	`--cloud`	Memilih cloud target. Nilai yang valid adalah: - `public` (default) - `usgov` - `usgovhigh` - `usgovdod` - `china` Nilai tidak peka huruf besar/kecil.
`PA_CLI_ENVIRONMENT_ID`	`--environment-id`	Menentukan ID lingkungan Power Platform target.

Inisialisasi aplikasi

Variabel ini menyediakan opsi ke pa app init.

Variabel Lingkungan	Opsi yang sesuai	Deskripsi
`PA_CLI_APP_BUILD_PATH`	`--build-path`	Menentukan direktori output build. Defaultnya adalah `./dist`.
`PA_CLI_APP_DESCRIPTION`	`--description`	Menentukan deskripsi aplikasi.
`PA_CLI_APP_DISPLAY_NAME`	`--display-name`	Menentukan nama tampilan aplikasi.
`PA_CLI_APP_FILE_ENTRY_POINT`	`--file-entry-point`	Menentukan titik entri HTML dalam output build. Defaultnya adalah `index.html`.
`PA_CLI_APP_TYPE`	`--app-type`	Menentukan jenis aplikasi. Nilai yang valid adalah: - `CodeApp` (default) - `MobileApp` Nilai disimpan dan `power.config.json` digunakan sebagai jenis aplikasi saat aplikasi diterbitkan.
`PA_CLI_APP_URL`	`--app-url`	Menentukan URL aplikasi lokal selama `pa app init`. Nilai disimpan sebagai `localAppUrl` dalam `power.config.json` dan menjadi URL default untuk perintah mendatang `pa app run` . Defaultnya adalah `http://localhost:3000`.

Jalankan aplikasi

Variabel ini menyediakan opsi ke pa app run.

Variabel Lingkungan	Opsi yang sesuai	Deskripsi
`PA_CLI_LOCAL_APP_URL`	`--local-app-url`	Mengambil alih `localAppUrl` nilai dari `power.config.json` untuk perintah saat ini tanpa mengubah konfigurasi tersimpan. Jika tidak ada nilai yang diatur, defaultnya adalah `http://localhost:3000`.
`PA_CLI_PORT`	`--port`	Menentukan port untuk host lokal Power Apps. Defaultnya adalah `8080`.

Variabel ini menyediakan opsi ke pa app share.

Variabel Lingkungan	Opsi yang sesuai	Deskripsi
`PA_CLI_SHARE_ACCESS`	`--access`	Menentukan tingkat akses. Nilai yang valid adalah: - `play` (default) - `edit`
`PA_CLI_SHARE_PRINCIPAL`	`--principal`	Menentukan satu atau beberapa alamat email yang dipisahkan koma atau ID objek Microsoft Entra.

Solusi, konektor, dan sumber data

Variabel Lingkungan	Opsi yang sesuai	Deskripsi
`PA_CLI_CONNECTION_DISPLAY_NAME`	`--display-name`	Menentukan nama tampilan saat membuat koneksi.
`PA_CLI_CONNECTION_ID`	`--connection-id`	Menentukan ID instans koneksi konektor.
`PA_CLI_CONNECTION_REF`	`--connection-ref`	Menentukan nama logika referensi koneksi.
`PA_CLI_CONNECTION_SEARCH`	`--search`	Memfilter hasil dari `pa connection list`.
`PA_CLI_CONNECTOR`	`--connector`	Menentukan ID konektor, seperti `shared_office365users`.
`PA_CLI_CONNECTOR_SEARCH`	`--search`	Memfilter hasil dari `pa connector list`.
`PA_CLI_DATASET`	`--dataset`	Menentukan himpunan data, seperti situs SharePoint atau database SQL.
`PA_CLI_DATA_SOURCE_NAME`	`--name`	Menentukan sumber data untuk di-refresh atau dihapus.
`PA_CLI_ORG_URL`	`--org-url`	Mengambil alih URL organisasi Dataverse yang digunakan untuk mengambil metadata saat menambahkan sumber data.
`PA_CLI_PROCEDURE`	`--procedure`	Menentukan prosedur tersimpan SQL.
`PA_CLI_SOLUTION_ID`	`--solution-id`	Menentukan solusi untuk `pa app push`, `pa app add data-source`, atau `pa connection list-references`.
`PA_CLI_SOLUTION_SEARCH`	`--search`	Memfilter hasil dari `pa solution list`.
`PA_CLI_TABLE`	`--table`	Menentukan nama sumber daya tabel atau konektor.

Untuk perintah yang menerima setiap opsi, lihat referensi perintah CLI Power Apps.

API Dataverse dan alur Power Automate

Variabel Lingkungan	Opsi yang sesuai	Deskripsi
`PA_CLI_DATAVERSE_API_NAME`	`--api-name`	Menentukan tindakan atau fungsi Dataverse untuk ditambahkan dengan aplikasi pa menambahkan dataverse-api.
`PA_CLI_DATAVERSE_API_SEARCH_TERM`	`--search`	Memfilter tindakan dan fungsi Dataverse menurut nama dengan `pa app find-dataverse-api`.
`PA_CLI_FLOW_DATA_SOURCE_NAME`	`--flow-name`	Menentukan sumber data aliran yang akan dihapus dari aplikasi dengan `pa app remove flow`
`PA_CLI_FLOW_ID`	`--flow-id`	Menentukan alur Power Automate untuk ditambahkan dengan `pa app add flow`.
`PA_CLI_FLOW_SEARCH`	`--search`	Memfilter alur Power Automate yang tersedia menurut nama dengan`pa app list-flows`
`PA_CLI_REMOVE_FLOW_ID`	`--flow-id`	Menentukan alur Power Automate yang akan dihapus`pa app remove flow`

Output telemetri dan konsol

Variabel Lingkungan	Opsi yang sesuai	Deskripsi
`PA_CLI_CONSOLE_ONLY`	`--console-only`	Atur nilai ke `true` (huruf kecil) dengan `pa telemetry enable` atau `pa telemetry disable` untuk menulis telemetri hanya ke konsol dan tidak mengirimkannya dari jarak jauh.
`PA_CLI_OUTPUT_TO_CONSOLE`	`--output-to-console`	Atur nilai ke `true` (huruf kecil) dengan `pa telemetry enable` atau `pa telemetry disable` untuk mencerminkan peristiwa telemetri yang dikirim dari jarak jauh ke konsol.
`PA_CLI_TELEMETRY`	None	Atur salah satu nilai ini untuk menonaktifkan telemetri untuk proses saat ini: - `0` - `false` - `no` - `off` Nilai tidak peka huruf besar/kecil, dan ruang sekitarnya diabaikan.

Untuk pengaturan telemetri persisten, lihat Mengelola pengaturan telemetri untuk CLI Power Apps.

Variabel lingkungan standar

CLI juga mengamati variabel lingkungan standar ini:

Variabel Lingkungan	Deskripsi
`NO_COLOR`	Atur variabel ini ke nilai yang tidak ada guna menonaktifkan output warna ANSI. Anda juga dapat menggunakan opsi .`--no-color`

Saran dan Komentar

Apakah halaman ini membantu?

Last updated on 2026-09-01