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 connection Membuat dan mengelola koneksi dan menemukan sumber dayanya.
pa connector Temukan konektor yang tersedia di lingkungan Power Platform.
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 get-settings Tampilkan pengaturan aplikasi 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 set-setting Memperbarui pengaturan aplikasi.
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, atau nama tampilan konektor, seperti "Pengguna Office 365". Jika nama tampilan cocok dengan lebih dari satu konektor, perintah mencantumkan pengidentifikasi konektor yang cocok sehingga Anda dapat menentukannya.
--as Apakah akan menambahkan konektor sebagai table atau action sumber data. Gunakan parameter ini dengan konektor yang mendukung tabel dan tindakan, seperti SharePoint dan SQL Server. Untuk informasi selengkapnya, lihat pa app add data-source komentar.
--connection-id ID koneksi yang digunakan untuk sumber data.
--connection-ref Nama logis referensi koneksi, seperti cr123_sharedsharepointonline_1a2b3.
--solution-id Solusi yang berisi referensi koneksi.
--dataset Himpunan data untuk sumber data tabular.
--table Tabel yang akan ditambahkan. Ulangi parameter ini untuk menambahkan beberapa tabel dari konektor, koneksi, dan himpunan data yang sama. Native Dataverse mendukung satu tabel per perintah.
--org-url URL organisasi Dataverse yang digunakan untuk mengambil metadata tabel Dataverse asli. Dalam mode interaktif, perintah meminta nilai ini jika Anda tidak menyediakannya sebagai opsi perintah atau variabel lingkungan.
--procedure Prosedur tersimpan SQL untuk ditambahkan.

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

pa app add data-source Komentar

Untuk menambahkan beberapa tabel konektor dalam satu perintah, ulangi --table untuk setiap tabel. Tabel harus menggunakan konektor, koneksi, dan himpunan data yang sama. Perintah menambahkan pengidentifikasi tabel duplikat hanya sekali. Anda hanya dapat menyertakan satu tabel Dataverse asli atau prosedur tersimpan SQL per perintah.

Jika operasi metadata, validasi, atau penulisan skema khusus tabel gagal, perintah masih menambahkan tabel yang valid. Ini melaporkan pesanan succeeded dan failed hasil dan mengembalikan kode keluar bukan nol jika ada tabel yang gagal. Tinjau hasilnya sebelum mencoba kembali.

Beberapa konektor, seperti SharePoint dan SQL Server, mendukung tabel dan tindakan. Untuk konektor ini, tentukan apa yang harus ditambahkan:

  • Untuk menambahkan tabel atau prosedur tersimpan SQL, gunakan --as table, atau sertakan --table atau --procedure.
  • Untuk menambahkan tindakan konektor, gunakan --as action. Anda tidak dapat menggunakan --as action dengan --dataset, --table, atau --procedure.

Jika Anda tidak menentukan apa yang harus ditambahkan, perintah meminta Tambahkan tabel? di terminal interaktif. Dalam mode non-interaktif, perintah gagal hingga Anda menentukan --as. Konektor yang hanya mendukung tindakan, seperti Pengguna Office 365, tidak perlu --as dan tidak mendukung --as table. Untuk menambahkan tindakan atau fungsi Dataverse, gunakan pa app add dataverse-api alih-alih --as action.

Di terminal interaktif, perintah meminta nilai yang diperlukan yang tidak Anda berikan sebagai opsi perintah atau variabel lingkungan. Perintah bergantung pada jenis sumber data.

Untuk Dataverse asli:

  1. Jika Anda tidak menentukan --connector, perintah akan meminta ID konektor.
  2. Perintah meminta nama logis tabel.
  3. Perintah meminta URL organisasi Dataverse saat tidak disediakan.

Native Dataverse tidak menggunakan ID koneksi, referensi koneksi, atau himpunan data.

Untuk sumber data yang didukung konektor:

Pilih jenis konektor dan sumber data

  1. Jika Anda tidak menentukan --connector, perintah akan meminta ID konektor.
  2. Jika konektor mendukung tabel dan tindakan dan tidak ada yang lain yang menentukan apa yang harus ditambahkan, perintah meminta Tambahkan tabel?

Pilih koneksi

Perintah bertanya Apakah Anda menggunakan referensi koneksi alih-alih ID koneksi? Ini melewati pertanyaan ini ketika Anda memberikan ID koneksi atau referensi koneksi.

  • Jika Anda memilih Ya, perintah meminta nama logika referensi koneksi.
  • Jika Anda memilih Tidak, perintah mencantumkan koneksi Anda untuk konektor. Pilih (Masukkan secara manual...) untuk memasukkan ID koneksi yang tidak ada dalam daftar.

Pilih data

  • Jika Anda menambahkan tindakan, perintah melewati prosedur tersimpan, himpunan data, dan perintah tabel.

  • Jika Anda menambahkan tabel atau prosedur tersimpan:

    1. Untuk SQL Server, perintah menanyakan apakah Anda menambahkan prosedur tersimpan. Jika ya, ia meminta nama prosedur tersimpan.
    2. Perintah mencantumkan himpunan data yang tersedia melalui koneksi. Pilih (Masukkan secara manual...) untuk memasukkan himpunan data yang tidak ada dalam daftar.
    3. Kecuali Anda menambahkan prosedur tersimpan, perintah akan membuka daftar tabel yang dapat dicari dalam himpunan data. Anda dapat memilih lebih dari satu tabel.

Saat Anda menggunakan referensi koneksi, himpunan data dan daftar tabel berasal dari koneksi tempat referensi menunjuk.

pa app add data-source contoh

Tambahkan sumber data dengan menjawab perintah:

pa app add data-source

Tambahkan tabel Dataverse asli:

pa app add data-source --connector dataverse --table account

Tambahkan tindakan konektor yang juga mendukung tabel:

pa app add data-source \
  --connector shared_sharepointonline \
  --connection-id <connection-id> \
  --as action

Tambahkan Daftar SharePoint dengan menggunakan nama tampilan konektor:

pa app add data-source \
  --connector "SharePoint" \
  --connection-id <connection-id> \
  --dataset <site-url> \
  --table <list-name>

Tambahkan beberapa tabel SQL dari himpunan data yang sama:

pa app add data-source \
  --connector shared_sql \
  --connection-id <connection-id> \
  --dataset <server-name,database-name> \
  --table "[dbo].[Customers]" \
  --table "[dbo].[Orders]"

Tambahkan tabel melalui referensi koneksi, dan pilih himpunan data dan tabel saat perintah:

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

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 sesuai dengan API Dataverse dan Power Automate mengalir variabel lingkungan.

Pelajari cara menemukan operasi Dataverse yang tersedia.

pa app get-settings

Menampilkan pengaturan saat ini untuk aplikasi kode.

pa app get-settings [--json]

pa app get-settings parameter

Parameter Description
--json Mengembalikan pengaturan aplikasi sebagai JSON.

Jalankan perintah ini dari proyek aplikasi kode yang diinisialisasi yang berisi power.config.json file.

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.

Gunakan PA_CLI_SOLUTION_ID sebagai variabel lingkungan 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 digunakan dengan 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 set-setting

Memperbarui satu atau beberapa pengaturan untuk aplikasi kode.

pa app set-setting --show-header <true|false> [--json]

pa app set-setting parameter

Parameter Description
--show-header Tampilkan atau sembunyikan header aplikasi. Nilai yang berlaku adalah true atau false.
--json Mengembalikan pengaturan aplikasi yang diperbarui sebagai JSON.

Jalankan perintah ini dari proyek aplikasi kode yang diinisialisasi yang berisi power.config.json file. Perintah menulis pengaturan ke appSettings di power.config.json. Jalankan pa app push untuk menerbitkan pengaturan sehingga pemutar menerapkannya pada runtime.

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.

Gunakan PA_CLI_SOLUTION_ID 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, Anda akan melihat hasil dalam 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, Anda akan melihat hasil dalam 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