referensi perintah CLI Power Apps

Gunakan referensi perintah CLI Power Apps ini untuk menemukan perintah dengan cepat untuk membuat, mengembangkan, menyambungkan, dan menerbitkan aplikasi kode Power Apps. CLI menggunakan perintah yang dikelompokkan dalam format berikut:

pa <command-group> <command>

Ini adalah grup perintah:

Grup perintah Description
pa app Membuat, menjalankan, menyambungkan, dan menerbitkan aplikasi kode.
pa auth Masuk dan kelola akun.
pa connector Temukan konektor yang tersedia di lingkungan Power Platform.
pa connection Membuat dan mengelola koneksi dan menemukan sumber dayanya.
pa solution Temukan solusi yang tersedia di lingkungan Power Platform.
pa telemetry Mengelola pengaturan telemetri CLI.

Opsi global

Gunakan --help pada tingkat apa pun untuk menampilkan bantuan di terminal:

pa --help
pa app --help
pa app init --help

Gunakan --version untuk menampilkan versi CLI Power Apps yang terinstal:

pa --version

perintah CLI Power Apps

Perintah ini tersedia:

Perintah Description
pa app add data-source Tambahkan konektor atau sumber data tabular ke aplikasi kode.
pa app add dataverse-api Tambahkan tindakan atau fungsi Dataverse ke aplikasi kode.
pa app add flow Tambahkan alur Power Automate ke aplikasi kode.
pa app find-dataverse-api Temukan tindakan dan fungsi Dataverse di lingkungan saat ini.
pa app init Menginisialisasi aplikasi kode di direktori saat ini.
pa app list Mencantumkan aplikasi kode di lingkungan saat ini.
pa app list-environment-variables Cantumkan variabel lingkungan yang tersedia untuk aplikasi kode.
pa app list-flows Mencantumkan alur Power Automate sadar solusi di lingkungan saat ini.
pa app push Terbitkan versi baru aplikasi kode ke Power Apps.
pa app refresh data-source Refresh file yang dihasilkan untuk sumber data.
pa app remove data-source Hapus sumber data dari aplikasi kode.
pa app remove flow Hapus alur Power Automate dari aplikasi kode.
pa app run Mulai host lokal Power Apps untuk aplikasi kode.
pa app share Bagikan aplikasi kode dengan pengguna atau perwakilan layanan.
pa auth login Masuk melalui browser sistem.
pa auth logout Keluar dan hapus informasi autentikasi yang disimpan.
pa auth status Tampilkan akun yang masuk dan identifikasi akun aktif.
pa auth switch Ubah akun aktif.
pa connection create Buat koneksi untuk konektor.
pa connection list Mencantumkan koneksi di lingkungan saat ini.
pa connection list-datasets Mencantumkan himpunan data yang tersedia melalui koneksi.
pa connection list-procedures Mencantumkan prosedur tersimpan SQL yang tersedia dalam himpunan data.
pa connection list-references Mencantumkan referensi koneksi dalam solusi.
pa connection list-tables Mencantumkan tabel yang tersedia dalam himpunan data.
pa connector list Mencantumkan konektor yang tersedia di lingkungan Power Platform saat ini.
pa solution list Mencantumkan solusi di lingkungan saat ini.
pa telemetry disable Nonaktifkan pengumpulan telemetri.
pa telemetry enable Aktifkan pengumpulan telemetri.
pa telemetry status Tampilkan pengaturan telemetri saat ini.

pa app add data-source

Menambahkan konektor atau sumber data tabular ke aplikasi kode.

pa app add data-source --connector <connector-id> [options]

pa app add data-source parameter

Parameter Description
--connector Pengidentifikasi konektor, seperti shared_office365users.
--connection-id ID koneksi yang digunakan untuk sumber data.
--connection-ref Nama logis referensi koneksi.
--solution-id Solusi yang berisi referensi koneksi.
--dataset Himpunan data untuk sumber data tabular.
--table Tabel yang akan ditambahkan.
--org-url URL organisasi Dataverse yang akan digunakan saat mengambil metadata tabel.
--procedure Prosedur tersimpan SQL untuk ditambahkan.

Parameter ini memiliki variabel lingkungan Solusi, konektor, dan sumber data yang sesuai.

pa app add dataverse-api

Menambahkan tindakan atau fungsi Dataverse ke aplikasi kode.

pa app add dataverse-api --api-name <operation-name>

pa app add dataverse-api parameter

Parameter Description
--api-name Nama tindakan atau fungsi Dataverse yang akan ditambahkan.

PA_CLI_DATAVERSE_API_NAME adalah variabel lingkungan yang sesuai untuk --api-name parameter .

Pelajari lebih lanjut:

pa app add flow

Menambahkan alur Power Automate ke aplikasi kode.

pa app add flow --flow-id <flow-id>

pa app add flow parameter

Parameter Description
--flow-id ID alur Power Automate yang akan ditambahkan.

PA_CLI_FLOW_ID adalah variabel lingkungan yang sesuai untuk --flow-id parameter .

Perintah:

  • Mengunduh definisi OpenAPI alur.
  • Menghasilkan model dan layanan TypeScript yang sangat ditik.
  • Menambahkan alur dan referensi koneksinya ke power.config.json.

Jika definisi alur berubah, jalankan perintah ini lagi untuk meregenerasi kode untuk versi terbaru.

Important

Orang yang menjalankan pa app add flow harus memiliki akses ke alur dan koneksi yang mendasarinya. Perintah gagal jika orang tersebut tidak memiliki akses ke koneksi yang diperlukan.

Pelajari selengkapnya tentang skenario di mana Anda menggunakan perintah ini:

pa app find-dataverse-api

Menemukan tindakan dan fungsi Dataverse di lingkungan saat ini.

pa app find-dataverse-api --search <operation-name> [--json]

pa app find-dataverse-api parameter

Parameter Description
--search Nama operasi yang akan dicari.
--json Mengembalikan hasil sebagai JSON.

Parameter ini memiliki API Dataverse yang sesuai dan Power Automate mengalir variabel lingkungan.

Pelajari cara menemukan operasi Dataverse yang tersedia

pa app init

Menginisialisasi aplikasi kode di direktori saat ini.

pa app init [--display-name <name>] [--environment-id <environment-id>]

pa app init parameter

Parameter Description
--display-name Nama tampilan aplikasi kode.
--environment-id Lingkungan Power Platform untuk aplikasi kode.
--description Deskripsi aplikasi kode.
--build-path Direktori yang berisi aset aplikasi yang dikompilasi.
--file-entry-point Titik entri HTML dalam output build.
--app-type Jenis aplikasi. Nilai yang berlaku adalah CodeApp atau MobileApp.
--app-url URL aplikasi kode yang berjalan secara lokal.
--cloud Instans cloud Power Platform.

Parameter ini memiliki variabel lingkungan inisialisasi aplikasi yang sesuai.

Pelajari selengkapnya tentang skenario di mana Anda dapat menggunakan perintah ini:

pa app list

Mencantumkan aplikasi kode di lingkungan saat ini.

pa app list

pa app list-environment-variables

Mencantumkan variabel lingkungan yang tersedia untuk aplikasi kode.

pa app list-environment-variables

pa app list-flows

Mencantumkan alur Power Automate sadar solusi di lingkungan saat ini.

pa app list-flows [--search <term>]

Contoh:

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 parameter

Parameter Description
--search Filter alur menurut nama.

PA_CLI_FLOW_SEARCH adalah variabel lingkungan yang sesuai untuk --search parameter .

pa app push

Menerbitkan versi baru aplikasi kode ke Power Apps.

pa app push [--solution-id <solution-id>]

pa app push parameter

Parameter Description
--solution-id ID solusi untuk menambahkan aplikasi kode.
--non-interactive Menerbitkan aplikasi secara non-interaktif. Pelajari cara menerbitkan aplikasi dengan perwakilan layanan.

PA_CLI_SOLUTION_ID adalah variabel lingkungan yang akan digunakan dengan --solution-id parameter .

Pelajari cara membuat aplikasi kode dengan menggunakan CLI Power Apps.

pa app refresh data-source

Menyegarkan file yang dihasilkan untuk sumber data.

pa app refresh data-source --name <data-source-name>

pa app refresh data-source parameter

Parameter Description
--name Nama sumber data yang akan di-refresh.

pa app remove data-source

Menghapus sumber data dari aplikasi kode.

pa app remove data-source --connector <connector-id> --name <data-source-name> [--force]

pa app remove data-source parameter

Parameter Description
--connector Pengidentifikasi konektor untuk sumber data.
--name Nama sumber data yang akan dihapus.
--force Hapus sumber data tanpa meminta konfirmasi.

pa app remove flow

Menghapus alur Power Automate dari aplikasi kode.

pa app remove flow [--flow-name <name> | --flow-id <flow-id>] [--force]

pa app remove flow parameter

Parameter Description
--flow-name Nama alur Power Automate yang akan dihapus.
--flow-id ID alur Power Automate yang akan dihapus.
--force Hapus alur tanpa meminta konfirmasi.

PA_CLI_FLOW_DATA_SOURCE_NAME dan PA_CLI_REMOVE_FLOW_ID merupakan variabel lingkungan yang sesuai untuk menggunakan parameter ini.

Pelajari cara menghapus alur

pa app run

Memulai host lokal Power Apps untuk aplikasi kode.

pa app run [--port <port>] [--local-app-url <url>]

pa app run parameter

Parameter Description
--port Port untuk host lokal.
--local-app-url URL aplikasi kode yang berjalan secara lokal.

Parameter ini memiliki variabel lingkungan Jalankan aplikasi yang sesuai.

pa app share

Berbagi aplikasi kode dengan pengguna atau perwakilan layanan.

pa app share --principal <principal> [--access play|edit]

pa app share parameter

Parameter Description
--principal Alamat email yang dipisahkan koma atau ID objek Microsoft Entra untuk dibagikan oleh pengguna atau perwakilan layanan.
--access Tingkat akses yang akan diberikan: play (default) atau edit.

Parameter ini memiliki variabel lingkungan Share apps yang sesuai.

pa app share Komentar

Aplikasi kode harus sudah diterbitkan dan memiliki ID aplikasi dari perintah yang berhasil pa app push . Berikan edit akses saat perwakilan layanan perlu menjalankan pa app push.

Saat berbagi dengan perwakilan layanan, gunakan ID objek Aplikasi Perusahaan, bukan ID objek Pendaftaran Aplikasi.

pa auth login

Masuk melalui browser sistem.

pa auth login

Untuk mengisi akun terlebih dahulu di halaman masuk, gunakan:

pa auth login --account user@contoso.com

pa auth login parameter

Parameter Description
--account Akun yang akan diisi sebelumnya pada halaman masuk.

PA_CLI_ACCOUNT adalah variabel lingkungan yang sesuai untuk --account parameter .

pa auth logout

Keluar dan menghapus informasi autentikasi yang disimpan.

pa auth logout

Note

Perintah ini mengeluarkan Anda dari semua akun. Ini tidak dapat mengeluarkan Anda hanya dari satu akun. Untuk mengubah akun mana yang aktif, gunakan pa auth switch sebagai gantinya.

Pelajari cara keluar

pa auth status

Menampilkan akun yang masuk dan mengidentifikasi akun aktif.

Untuk menampilkan status autentikasi sebagai JSON, gunakan:

pa auth status --json

pa auth status parameter

Parameter Description
--json Mengembalikan status autentikasi sebagai JSON.

Pelajari cara memeriksa akun mana yang aktif

pa auth switch

Mengubah akun aktif.

pa auth switch --account user@contoso.com

pa auth switch parameter

Parameter Description
--account Akun yang akan aktif.

PA_CLI_ACCOUNT adalah variabel lingkungan yang sesuai untuk --account parameter .

Pelajari selengkapnya tentang kapan Anda dapat menggunakan perintah ini:

pa connection create

Membuat koneksi untuk konektor.

pa connection create --connector <connector-id> [--display-name <name>] [--json]

pa connection create parameter

Parameter Alias Required Description
--connector - Yes Pengidentifikasi konektor, seperti shared_office365 atau shared_teams.
--display-name -n No Nama tampilan untuk koneksi. Jika Anda tidak memberikan nama, CLI menggunakan nama default.
--json - No Mengembalikan hasil sebagai JSON.

pa connection create contoh

Buat koneksi Office 365 Outlook:

pa connection create --connector shared_office365

Buat koneksi Microsoft Teams dengan nama tampilan kustom:

pa connection create --connector shared_teams --display-name "My Teams"

Buat koneksi dan kembalikan hasilnya sebagai JSON:

pa connection create --connector shared_office365 --json

pa connection create keluaran

Ketika perintah berhasil, perintah mengembalikan ID koneksi. Gunakan ID koneksi saat Anda menambahkan konektor sebagai sumber data ke aplikasi kode.

Pelajari cara membuat koneksi dari CLI Power Apps

pa connection list

Mencantumkan koneksi di lingkungan saat ini.

pa connection list [--search <term>] [--json]

pa connection list parameter

Parameter Description
--search Memfilter koneksi menurut nama.
--json Mengembalikan hasil sebagai JSON.

Parameter ini memiliki variabel lingkungan Solusi, konektor, dan sumber data yang sesuai.

pa connection list-datasets

Mencantumkan himpunan data yang tersedia melalui koneksi.

pa connection list-datasets --connector <connector-id> [--connection-id <connection-id>]

pa connection list-datasets parameter

Parameter Description
--connector Pengidentifikasi konektor.
--connection-id ID koneksi yang digunakan saat mencantumkan himpunan data.

pa connection list-procedures

Mencantumkan prosedur tersimpan SQL yang tersedia dalam himpunan data.

pa connection list-procedures --connection-id <connection-id> --dataset <dataset>

pa connection list-procedures parameter

Parameter Description
--connection-id ID koneksi yang akan digunakan saat mencantumkan prosedur tersimpan.
--dataset Himpunan data yang berisi prosedur tersimpan.

pa connection list-references

Mencantumkan referensi koneksi dalam solusi.

pa connection list-references --solution-id <solution-id>

pa connection list-references parameter

Parameter Description
--solution-id ID solusi yang berisi referensi koneksi.

PA_CLI_SOLUTION_ID adalah variabel lingkungan yang sesuai untuk digunakan dengan --solution-id parameter .

pa connection list-tables

Mencantumkan tabel yang tersedia dalam himpunan data.

pa connection list-tables --connector <connector-id> [--connection-id <connection-id>] [--dataset <dataset>]

pa connection list-tables parameter

Parameter Description
--connector Pengidentifikasi konektor.
--connection-id ID koneksi yang akan digunakan saat mencantumkan tabel.
--dataset Himpunan data yang berisi tabel.

pa connector list

Mencantumkan konektor yang tersedia di lingkungan Power Platform saat ini.

pa connector list [--search <term>] [--json]

pa connector list parameter

Parameter Description
--search Filter konektor menurut nama atau nama tampilan.
--json Mengembalikan daftar konektor lengkap sebagai JSON.

PA_CLI_CONNECTOR_SEARCH adalah variabel lingkungan yang sesuai untuk digunakan dengan --search parameter .

pa connector list keluaran

Di terminal interaktif, hasil muncul di halaman 20 baris. Tekan Enter untuk memperlihatkan halaman berikutnya. Tekan Esc atau Q untuk keluar. Saat Anda mengalihkan output atau menyertakan --json, perintah mengembalikan daftar lengkap.

Secara default, perintah mengembalikan tabel dengan kolom berikut:

Column Description
Nama Tampilan Nama tampilan konektor, seperti Office 365 Outlook.
Connector Pengidentifikasi konektor, seperti shared_office365. Gunakan nilai ini dengan --connector opsi .pa connection create

Saat Anda menggunakan --json parameter , output JSON menyertakan bidang berikut:

Field Description
id ID konektor.
name Pengidentifikasi konektor, seperti shared_office365.
displayName Nama tampilan konektor.
description Deskripsi konektor.
isTabular Menunjukkan apakah konektor mendukung operasi data tabular.

pa connector list contoh

Cantumkan semua konektor yang tersedia:

pa connector list

Cari konektor:

pa connector list --search teams

Kembalikan daftar konektor sebagai JSON:

pa connector list --json

Pelajari cara mencantumkan konektor yang tersedia

pa solution list

Mencantumkan solusi di lingkungan saat ini, termasuk nama yang mudah diingat, nama unik, dan ID solusinya.

pa solution list [--search <term>] [--json]

pa solution list parameter

Parameter Description
--search Filter solusi berdasarkan nama yang mudah diingat atau nama unik. Filter adalah kecocokan substring yang tidak peka huruf besar/kecil.
--json Mengembalikan daftar solusi lengkap sebagai JSON.

PA_CLI_SOLUTION_SEARCH adalah variabel lingkungan yang sesuai untuk --search parameter .

Di terminal interaktif, hasil muncul di halaman 20 baris. Tekan Enter untuk memperlihatkan halaman berikutnya. Tekan Esc atau Q untuk keluar. Saat Anda mengalihkan output atau menyertakan --json, perintah mengembalikan daftar lengkap.

pa telemetry disable

Menonaktifkan koleksi telemetri.

pa telemetry disable

pa telemetry enable

Mengaktifkan koleksi telemetri.

pa telemetry enable

pa telemetry status

Menampilkan pengaturan telemetri saat ini.

pa telemetry status