Power Apps referință comandă CLI

Utilizați această referință de comandă Power Apps CLI pentru a găsi rapid comenzi pentru crearea, dezvoltarea, conectarea și publicarea aplicațiilor de cod Power Apps. CLI utilizează comenzi grupate în următorul format:

pa <command-group> <command>

Acestea sunt grupurile de comenzi:

Grup de comenzi Descriere
pa app Creați, rulați, conectați și publicați aplicații de cod.
pa auth Conectați-vă și gestionați conturile.
pa connection Creați și gestionați conexiuni și descoperiți resursele lor.
pa connector Găsiți conectorii disponibili într-un mediu Power Platform.
pa solution Găsiți soluții disponibile într-un mediu Power Platform.
pa telemetry Gestionați setările de telemetrie CLI.

Opțiuni globale

Se utilizează --help la orice nivel pentru a afișa ajutorul în terminal:

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

Se utilizează --version pentru a afișa versiunea Power Apps CLI instalată:

pa --version

Power Apps comenzi CLI

Aceste comenzi sunt disponibile:

Command Descriere
pa app add data-source Adăugați un conector sau o sursă de date tabelară la aplicația de cod.
pa app add dataverse-api Adăugați o acțiune sau o funcție Dataverse în aplicația de cod.
pa app add flow Adăugați un flux de Power Automate la aplicația de cod.
pa app find-dataverse-api Găsiți acțiuni și funcții Dataverse în mediul curent.
pa app get-settings Afișați setările curente ale aplicației.
pa app init Inițializați o aplicație de cod în directorul curent.
pa app list Listați aplicațiile de cod în mediul curent.
pa app list-environment-variables Listați variabilele de mediu disponibile aplicației de cod.
pa app list-flows Listați fluxurile receptive la soluții Power Automate din mediul curent.
pa app push Publicați o versiune nouă a aplicației de cod pentru a Power Apps.
pa app refresh data-source Reîmprospătați fișierele generate pentru o sursă de date.
pa app remove data-source Eliminați o sursă de date din aplicația de cod.
pa app remove flow Eliminați un flux de Power Automate din aplicația de cod.
pa app run Porniți gazda locală Power Apps pentru aplicația de cod.
pa app set-setting Actualizați setările aplicației.
pa app share Partajați aplicația de cod cu utilizatori sau directori de serviciu.
pa auth login Conectați-vă prin browserul de sistem.
pa auth logout Deconectați-vă și eliminați informațiile de autentificare salvate.
pa auth status Afișați conturile conectate și identificați contul activ.
pa auth switch Modificați contul activ.
pa connection create Creați o conexiune pentru un conector.
pa connection list Listați conexiunile din mediul curent.
pa connection list-datasets Listați seturile de date disponibile printr-o conexiune.
pa connection list-procedures Listează procedurile stocate SQL disponibile într-un set de date.
pa connection list-references Se listează referințele de conexiune într-o soluție.
pa connection list-tables Listarea tabelelor disponibile într-un set de date.
pa connector list Listați conectorii disponibili în mediul Power Platform curent.
pa solution list Listați soluțiile din mediul curent.
pa telemetry disable Dezactivați colecția de telemetrie.
pa telemetry enable Activați colecția de telemetrie.
pa telemetry status Afișați setările curente de telemetrie.

pa app add data-source

Adaugă un conector sau o sursă de date tabelară la aplicația de cod.

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

pa app add data-source Parametrii

Parametru Descriere
--connector Identificatorul conectorului, cum shared_office365usersar fi , sau numele afișat al conectorului, cum "Utilizatori Office 365"ar fi . Dacă un nume afișat se potrivește cu mai mulți conectori, comanda listează identificatorii conectorului corespunzător, astfel încât să puteți specifica unul.
--as Dacă doriți să adăugați conectorul ca sursă de date sau action ca table sursă de date. Utilizați acest parametru cu conectori care acceptă atât tabele, cât și acțiuni, cum ar fi SharePoint și SQL Server. Pentru mai multe informații, consultați pa app add data-source observații.
--connection-id ID-ul de conexiune de utilizat pentru sursa de date.
--connection-ref Numele logic al unei referințe de conexiune, cum cr123_sharedsharepointonline_1a2b3ar fi .
--solution-id Soluția care conține referința de conexiune.
--dataset Setul de date pentru o sursă de date tabelară.
--table Tabelul de adăugat. Repetați acest parametru pentru a adăuga mai multe tabele din același conector, conexiune și set de date. Dataverse nativ acceptă un tabel pentru fiecare comandă.
--org-url URL-ul organizației Dataverse utilizat pentru a regăsi metadate de tabel Dataverse native. În modul interactiv, solicitările de comandă pentru această valoare dacă nu le furnizați ca opțiune de comandă sau variabilă de mediu.
--procedure Procedura sql stocată de adăugat.

Acești parametri au variabile corespondente Soluții, conectori și surse de date de mediu.

pa app add data-source Observaţii

Pentru a adăuga mai multe tabele conectoare într-o comandă, repetați --table pentru fiecare tabel. Tabelele trebuie să utilizeze același conector, conexiune și set de date. Comanda adaugă identificatori de tabel dublați o singură dată. Puteți include un singur tabel Dataverse nativ sau o procedură stocată SQL pentru fiecare comandă.

Dacă o operațiune de validare sau scriere a schemei specifice tabelului nu reușește, comanda adaugă în continuare tabelele valide. Acesta raportează rezultate ordonate succeeded și failed rezultate și returnează un cod de ieșire non-zero dacă un tabel nu reușește. Examinați rezultatele înainte de a reîncerca.

Unii conectori, cum ar fi SharePoint și SQL Server, acceptă atât tabele, cât și acțiuni. Pentru acești conectori, specificați ce se adaugă:

  • Pentru a adăuga tabele sau o procedură stocată SQL, utilizați --as tablesau includeți --table sau --procedure.
  • Pentru a adăuga acțiunile conectorului, utilizați --as action. Nu puteți utiliza --as action cu --dataset, --tablesau --procedure.

Dacă nu specificați ce să adăugați, comanda întreabă Adăugați un tabel? într-un terminal interactiv. În modul non-interactiv, comanda nu reușește până când specificați --as. Conectorii care acceptă doar acțiuni, cum ar fi Utilizatori Office 365, nu au nevoie --as și nu acceptă --as table. Pentru a adăuga acțiuni sau funcții Dataverse, utilizați pa app add dataverse-api în loc de --as action.

Într-un terminal interactiv, solicitările de comandă pentru valorile obligatorii pe care nu le furnizați ca opțiuni de comandă sau variabile de mediu. Solicitările depind de tipul sursei de date.

Pentru dataverse native:

  1. Dacă nu specificați --connector, comanda solicită ID-ul conectorului.
  2. Comanda solicită numele logic al tabelului.
  3. Comanda solicită URL-ul organizației Dataverse atunci când nu este furnizată.

Dataverse nativ nu utilizează un ID de conexiune, o referință de conexiune sau un set de date.

Pentru sursele de date susținute de conectori:

Alegeți tipul conectorului și al sursei de date

  1. Dacă nu specificați --connector, comanda solicită ID-ul conectorului.
  2. Dacă conectorul acceptă atât tabele, cât și acțiuni și nimic altceva nu determină ce să adăugați, comanda întreabă Adăugați un tabel?

Alegeți conexiunea

Comanda vă întreabă Utilizați o referință de conexiune în locul ID-ului de conexiune? Aceasta ignoră această întrebare atunci când furnizați un ID de conexiune sau o referință de conexiune.

  • Dacă selectați Da, comanda solicită numele logic al referinței de conexiune.
  • Dacă selectați Nu, comanda listează conexiunile pentru conector. Selectați (Introduceți manual...) pentru a introduce un ID de conexiune care nu se află în listă.

Alegeți datele

  • Dacă adăugați acțiuni, comanda ignoră procedura stocată, setul de date și solicitările de tabel.

  • Dacă adăugați tabele sau o procedură stocată:

    1. Pentru SQL Server, comanda vă întreabă dacă adăugați o procedură stocată. Dacă sunteți, aceasta vă solicită numele procedurii stocate.
    2. Comanda listează seturile de date disponibile prin conexiune. Selectați (Introduceți manual...) pentru a introduce un set de date care nu se află în listă.
    3. Dacă nu adăugați o procedură stocată, comanda deschide o listă de tabele care poate fi căutată în setul de date. Puteți selecta mai multe tabele.

Atunci când utilizați o referință de conexiune, setul de date și listele de tabele provin din conexiunea la care indică referința.

pa app add data-source Exemple

Adăugați o sursă de date răspunzând la solicitările:

pa app add data-source

Adăugați un tabel Dataverse nativ:

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

Adăugați acțiunile unui conector care acceptă și tabele:

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

Adăugați un SharePoint list utilizând numele afișat al conectorului:

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

Adăugați mai multe tabele SQL din același set de date:

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

Adăugați un tabel printr-o referință de conexiune și selectați setul de date și tabelul atunci când solicitările de comandă:

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

Adaugă o acțiune sau o funcție Dataverse în aplicația de cod.

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

pa app add dataverse-api Parametrii

Parametru Descriere
--api-name Numele acțiunii sau funcției Dataverse de adăugat.

PA_CLI_DATAVERSE_API_NAME este variabila de mediu corespunzătoare pentru --api-name parametru.

Mai multe informații:

pa app add flow

Adaugă un flux de Power Automate la aplicația de cod.

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

pa app add flow Parametrii

Parametru Descriere
--flow-id ID-ul fluxului de Power Automate de adăugat.

PA_CLI_FLOW_ID este variabila de mediu corespunzătoare pentru --flow-id parametru.

Comanda:

  • Descarcă definiția OpenAPI a fluxului.
  • Generează modele și servicii TypeScript tastate puternic.
  • Adaugă fluxul și referințele sale de conexiune la power.config.json.

Dacă se modifică o definiție de flux, rulați din nou această comandă pentru a regenera codul pentru cea mai recentă versiune.

Important

Persoana care rulează pa app add flow trebuie să aibă acces la flux și la conexiunile sale subiacente. Comanda nu reușește dacă persoana nu are acces la o conexiune necesară.

Aflați mai multe despre scenariile în care utilizați această comandă:

pa app find-dataverse-api

Găsește acțiunile și funcțiile Dataverse în mediul curent.

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

pa app find-dataverse-api Parametrii

Parametru Descriere
--search Numele operațiunii de căutat.
--json Returnați rezultatele ca JSON.

Acești parametri corespund API-urilor Dataverse și Power Automate variabilelor de mediu.

Aflați cum să găsiți operațiunile Dataverse disponibile.

pa app get-settings

Afișează setările curente pentru aplicația de cod.

pa app get-settings [--json]

pa app get-settings Parametrii

Parametru Descriere
--json Returnați setările aplicației ca JSON.

Rulați această comandă dintr-un proiect de aplicație de cod inițializat care conține un power.config.json fișier.

pa app init

Inițializează o aplicație de cod în directorul curent.

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

pa app init Parametrii

Parametru Descriere
--display-name Numele afișat al aplicației de cod.
--environment-id Mediul Power Platform pentru aplicația de cod.
--description Descrierea aplicației de cod.
--build-path Directorul care conține activele aplicației compilate.
--file-entry-point Punctul de intrare HTML din ieșirea compilării.
--app-type Tipul aplicației. Valorile valide sunt CodeApp și MobileApp.
--app-url URL-ul aplicației de cod care rulează local.
--cloud Instanța cloud Power Platform.

Acești parametri au variabile de mediu de inițializare a aplicațiilor corespunzătoare.

Aflați mai multe despre scenariile în care puteți utiliza această comandă:

pa app list

Listează aplicațiile de cod în mediul curent.

pa app list

pa app list-environment-variables

Listează variabilele de mediu disponibile aplicației de cod.

pa app list-environment-variables

pa app list-flows

Listează fluxurile de Power Automate de soluții în mediul curent.

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

Exemplu:

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 Parametrii

Parametru Descriere
--search Filtrați fluxurile după nume.

PA_CLI_FLOW_SEARCH este variabila de mediu corespunzătoare pentru --search parametru.

pa app push

Publică o versiune nouă a aplicației de cod pentru a Power Apps.

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

pa app push Parametrii

Parametru Descriere
--solution-id ID-ul soluției la care să adăugați aplicația de cod.
--non-interactive Publică aplicația non-interactiv. Aflați cum să publicați aplicații cu o entitate principală de serviciu.

Se utilizează PA_CLI_SOLUTION_ID ca variabilă de mediu cu --solution-id parametrul.

Aflați cum să creați o aplicație de cod utilizând Power Apps CLI.

pa app refresh data-source

Reîmprospătează fișierele generate pentru o sursă de date.

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

pa app refresh data-source Parametrii

Parametru Descriere
--name Numele sursei de date de reîmprospătat.

pa app remove data-source

Elimină o sursă de date din aplicația de cod.

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

pa app remove data-source Parametrii

Parametru Descriere
--connector Identificatorul conectorului pentru sursa de date.
--name Numele sursei de date de eliminat.
--force Eliminați sursa de date fără a solicita confirmarea.

pa app remove flow

Elimină un flux de Power Automate din aplicația de cod.

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

pa app remove flow Parametrii

Parametru Descriere
--flow-name Numele Power Automate flux de eliminat.
--flow-id ID-ul fluxului de Power Automate de eliminat.
--force Eliminați fluxul fără a solicita confirmarea.

PA_CLI_FLOW_DATA_SOURCE_NAME și PA_CLI_REMOVE_FLOW_ID sunt variabile de mediu corespunzătoare de utilizat cu acești parametri.

Aflați cum să eliminați un flux.

pa app run

Pornește gazda locală Power Apps pentru aplicația de cod.

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

pa app run Parametrii

Parametru Descriere
--port Portul pentru gazda locală.
--local-app-url URL-ul aplicației de cod care rulează local.

Acești parametri au variabile de mediu rulare corespunzătoare.

pa app set-setting

Actualizează una sau mai multe setări pentru aplicația de cod.

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

pa app set-setting Parametrii

Parametru Descriere
--show-header Afișați sau ascundeți antetul aplicației. Valorile valide sunt true și false.
--json Returnați setările de aplicație actualizate ca JSON.

Rulați această comandă dintr-un proiect de aplicație de cod inițializat care conține un power.config.json fișier. Comanda scrie setarea în appSettings .power.config.json Rulați pa app push pentru a publica setarea astfel încât jucătorul să o aplice la momentul rulării.

pa app share

Partajează aplicația de cod cu utilizatori sau directori de serviciu.

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

pa app share Parametrii

Parametru Descriere
--principal Adrese de e-mail separate prin virgulă sau ID-uri de obiect Microsoft Entra pentru ca utilizatorii sau principalii de serviciu să le partajeze.
--access Nivelul de acces de acordat: play (implicit) sau edit.

Acești parametri au variabile de mediu de partajare a aplicațiilor corespunzătoare.

pa app share Observaţii

Aplicația de cod trebuie să fie publicată deja și să aibă un ID de aplicație dintr-o comandă reușită pa app push . Acordați edit acces atunci când o entitate principală de serviciu trebuie să ruleze pa app push.

Atunci când partajați cu un cont principal de serviciu, utilizați ID-ul obiectului Aplicație Enterprise, nu ID-ul obiectului Înregistrare aplicații.

pa auth login

Se conectează prin browserul de sistem.

pa auth login

Pentru a prepopula contul pe pagina de conectare, utilizați:

pa auth login --account user@contoso.com

pa auth login Parametrii

Parametru Descriere
--account Contul care va fi prepopulat pe pagina de conectare.

PA_CLI_ACCOUNT este variabila de mediu corespunzătoare pentru --account parametru.

pa auth logout

Deconectează-te și elimină informațiile de autentificare salvate.

pa auth logout

Notă

Această comandă vă deconectează de la toate conturile. Nu vă poate deconecta de la un singur cont. Pentru a schimba contul care este activ, utilizați pa auth switch în schimb.

Aflați cum să vă deconectați

pa auth status

Afișează conturile conectate și identifică contul activ.

Pentru a afișa starea de autentificare ca JSON, utilizați:

pa auth status --json

pa auth status Parametrii

Parametru Descriere
--json Returnați starea de autentificare ca JSON.

Aflați cum să verificați ce cont este activ

pa auth switch

Modifică contul activ.

pa auth switch --account user@contoso.com

pa auth switch Parametrii

Parametru Descriere
--account Contul care va fi activ.

PA_CLI_ACCOUNT este variabila de mediu corespunzătoare pentru --account parametru.

Aflați mai multe despre momentul când puteți utiliza această comandă:

pa connection create

Creează o conexiune pentru un conector.

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

pa connection create Parametrii

Parametru Alias Obligatoriu Descriere
--connector - Da Identificatorul conectorului, cum shared_office365 ar fi sau shared_teams.
--display-name -n Nu Numele afișat al conexiunii. Dacă nu furnizați un nume, CLI utilizează un nume implicit.
--json - Nu Returnează rezultatul ca JSON.

pa connection create Exemple

Creați o conexiune Office 365 Outlook:

pa connection create --connector shared_office365

Creați o conexiune Microsoft Teams cu un nume afișat particularizat:

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

Creați o conexiune și returnați rezultatul ca JSON:

pa connection create --connector shared_office365 --json

pa connection create ieșire

Atunci când comanda reușește, returnează ID-ul de conexiune. Utilizați ID-ul de conexiune atunci când adăugați conectorul ca sursă de date la aplicația de cod.

Aflați cum să creați o conexiune din Power Apps CLI

pa connection list

Listează conexiunile din mediul curent.

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

pa connection list Parametrii

Parametru Descriere
--search Filtrați conexiunile după nume.
--json Returnați rezultatele ca JSON.

Acești parametri au variabile corespondente Soluții, conectori și surse de date de mediu.

pa connection list-datasets

Listează seturile de date disponibile printr-o conexiune.

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

pa connection list-datasets Parametrii

Parametru Descriere
--connector Identificatorul conectorului.
--connection-id ID-ul de conexiune de utilizat la listarea seturilor de date.

pa connection list-procedures

Listează procedurile stocate SQL disponibile într-un set de date.

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

pa connection list-procedures Parametrii

Parametru Descriere
--connection-id ID-ul de conexiune de utilizat la listarea procedurilor stocate.
--dataset Setul de date care conține procedurile stocate.

pa connection list-references

Listează referințele de conexiune într-o soluție.

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

pa connection list-references Parametrii

Parametru Descriere
--solution-id ID-ul soluției care conține referințele de conexiune.

Se utilizează PA_CLI_SOLUTION_ID cu --solution-id parametrul.

pa connection list-tables

Listează tabelele disponibile într-un set de date.

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

pa connection list-tables Parametrii

Parametru Descriere
--connector Identificatorul conectorului.
--connection-id ID-ul de conexiune de utilizat la listarea tabelelor.
--dataset Setul de date care conține tabelele.

pa connector list

Listează conectorii disponibili în mediul Power Platform curent.

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

pa connector list Parametrii

Parametru Descriere
--search Filtrați conectorii după nume sau după numele afișat.
--json Returnați lista completă de conectori ca JSON.

PA_CLI_CONNECTOR_SEARCH este variabila de mediu corespunzătoare de utilizat cu --search parametrul.

pa connector list ieșire

Într-un terminal interactiv, vedeți rezultate în pagini cu 20 de rânduri. Apăsați pe Enter pentru a afișa pagina următoare. Apăsați Esc sau Q pentru a ieși. Atunci când redirecționați rezultatul sau includeți --json, comanda returnează lista completă.

În mod implicit, comanda returnează un tabel cu următoarele coloane:

Coloană Descriere
Nume afișat Numele afișat al conectorului, cum ar fi Office 365 Outlook.
Conector Identificatorul conectorului, cum shared_office365ar fi . Utilizați această valoare cu opțiunea --connectorpa connection create.

Atunci când utilizați --json parametrul, rezultatul JSON include următoarele câmpuri:

Câmp Descriere
id ID-ul conectorului.
name Identificatorul conectorului, cum shared_office365ar fi .
displayName Numele afișat al conectorului.
description Descrierea conectorului.
isTabular Arată dacă conectorul acceptă operațiuni de date tabelare.

pa connector list Exemple

Listați toți conectorii disponibili:

pa connector list

Căutați conectori:

pa connector list --search teams

Returnați lista conectorilor ca JSON:

pa connector list --json

Aflați cum să listați conectorii disponibili

pa solution list

Listează soluțiile din mediul curent, inclusiv numele prietenos, numele unic și ID-ul soluției.

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

pa solution list Parametrii

Parametru Descriere
--search Filtrați soluțiile după numele prietenos sau după numele unic. Filtrul este o potrivire subșir insensibilă la litere mari și mici.
--json Returnați lista completă de soluții ca JSON.

PA_CLI_SOLUTION_SEARCH este variabila de mediu corespunzătoare pentru --search parametru.

Într-un terminal interactiv, vedeți rezultate în pagini cu 20 de rânduri. Apăsați pe Enter pentru a afișa pagina următoare. Apăsați Esc sau Q pentru a ieși. Atunci când redirecționați rezultatul sau includeți --json, comanda returnează lista completă.

pa telemetry disable

Dezactivează colecția de telemetrie.

pa telemetry disable

pa telemetry enable

Activează colecția de telemetrie.

pa telemetry enable

pa telemetry status

Afișează setările curente de telemetrie.

pa telemetry status
  • Ultima actualizare pe