CLI käsuviite Power Apps

Selle Power Apps CLI käsuviite abil saate kiiresti otsida käske Power Apps koodirakenduste loomiseks, arendamiseks, ühendamiseks ja avaldamiseks. CLI kasutab rühmitatud käske järgmises vormingus:

pa <command-group> <command>

Need on käsurühmad.

Käsurühm Kirjeldus
pa app Koodirakenduste loomine, käivitamine, ühendamine ja avaldamine.
pa auth Logige sisse ja hallake kontosid.
pa connection Looge ja hallake ühendusi ning tutvuge nende ressurssidega.
pa connector Otsige Power Platformi keskkonnas saadaolevaid konnektoreid.
pa solution Siit leiate Power Platformi keskkonnas saadaolevad lahendused.
pa telemetry Saate hallata CLI telemeetriasätteid.

Globaalsed suvandid

Kasutage --help mis tahes tasemel abi kuvamiseks terminalis.

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

Sobib --version installitud Power Apps CLI versiooni kuvamiseks.

pa --version

CLI käskude Power Apps

Saadaval on järgmised käsud.

Käsk Kirjeldus
pa app add data-source Saate koodirakendusele lisada konnektori või tabelandmeallika.
pa app add dataverse-api Saate koodirakendusele lisada toimingu Dataverse või funktsiooni.
pa app add flow Lisage koodirakendusse Power Automate voog.
pa app find-dataverse-api Siit saate teada, kuidas leida praeguses keskkonnas andmehalduri toiminguid ja funktsioone.
pa app get-settings Saate kuvada praegused rakendusesätted.
pa app init Koodirakenduse lähtestamine praeguses kataloogis.
pa app list Loetlege koodirakendused praeguses keskkonnas.
pa app list-environment-variables Saate loetleda koodirakenduse jaoks saadaolevad keskkonnamuutujad.
pa app list-flows Loetlege lahendusepõhised Power Automate vood praeguses keskkonnas.
pa app push Avaldage Power Apps koodirakenduse uus versioon.
pa app refresh data-source Andmeallika genereeritud failide värskendamine.
pa app remove data-source Eemaldage koodirakendusest andmeallikas.
pa app remove flow Eemaldage koodirakendusest Power Automate voog.
pa app run Käivitage koodirakenduse Power Apps kohalik host.
pa app set-setting Saate värskendada rakenduse sätteid.
pa app share Jagage koodirakendust kasutajate või teenusesubjektidega.
pa auth login Logige sisse süsteemibrauseri kaudu.
pa auth logout Logige välja ja eemaldage salvestatud autentimisteave.
pa auth status Saate kuvada sisselogitud kontod ja tuvastada aktiivse konto.
pa auth switch Aktiivse konto muutmine.
pa connection create Konnektori jaoks ühenduse loomine.
pa connection list Saate loetleda praeguse keskkonna ühendused.
pa connection list-datasets Loetlege ühenduse kaudu saadaolevad andmekomplektid.
pa connection list-procedures Loetlege SQL-i salvestatud protseduurid, mis on saadaval andmekomplektis.
pa connection list-references Loetlege lahenduse ühenduseviited.
pa connection list-tables Loetlege andmekomplektis saadaolevad tabelid.
pa connector list Praeguses Power Platformi keskkonnas saadaolevad loendikonnektorid.
pa solution list Loetlege lahendused praeguses keskkonnas.
pa telemetry disable Telemeetria kogumise keelamine.
pa telemetry enable Telemeetria kogumise lubamine.
pa telemetry status Saate kuvada praegused telemeetriasätted.

pa app add data-source

Lisab koodirakendusse konnektori või tabelandmeallika.

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

pa app add data-source parameetrid

Parameeter Kirjeldus
--connector Konnektori identifikaator (nt shared_office365users) või konnektori kuvatav nimi (nt "Office 365 kasutajad". Kui kuvatav nimi vastab mitmele konnektorile, loetleb käsk vastava konnektori identifikaatorid, et saaksite selle määrata.
--as Kas lisada konnektor andmeallikana table või andmeallikana action . Kasutage seda parameetrit konnektoritega, mis toetavad nii tabeleid kui ka toiminguid (nt SharePoint ja SQL Server). Lisateabe saamiseks vt märkusipa app add data-source.
--connection-id Andmeallika jaoks kasutatav ühenduse ID.
--connection-ref Ühenduseviite loogikanimi (nt cr123_sharedsharepointonline_1a2b3.
--solution-id Lahendus, mis sisaldab ühenduse viidet.
--dataset Tabelina esitatud andmeallika andmekomplekt.
--table Lisatav tabel. Korrake seda parameetrit, et lisada mitu tabelit samast konnektorist, ühendusest ja andmekomplektist. Native Dataverse toetab ühte tabelit käsu kohta.
--org-url Dataverse'i organisatsiooni URL, mida kasutatakse dataverse'i tabeli metaandmete toomiseks. Interaktiivses režiimis küsib käsk selle väärtuse kohta, kui te seda käsusuvandi või keskkonnamuutujana ei esita.
--procedure Lisatav SQL-i salvestatud protseduur.

Nendel parameetritel on vastavad lahendused, konnektorid ja andmeallikate keskkonnamuutujad.

pa app add data-source Märkused

Mitme konnektoritabeli lisamiseks ühte käsku korrake --table seda iga tabeli puhul. Tabelites peab olema sama konnektor, ühendus ja andmekomplekt. Käsk lisab tabeli identifikaatorite duplikaadid ainult üks kord. Käsule saate kaasata ainult ühe omaandmetabeli või SQL-i salvestatud protseduuri.

Kui tabelikohased metaandmed, valideerimine või skeemi kirjutamistoiming nurjub, lisab käsk endiselt sobivad tabelid. See teatab järjestatud succeeded ja failed tulemid ning tagastab nullist erinev väljumiskoodi, kui mõni tabel nurjub. Vaadake tulemid enne uuesti proovimist üle.

Mõned konnektorid (nt SharePoint ja SQL Server) toetavad nii tabeleid kui ka toiminguid. Nende konnektorite puhul määrake, mida lisada:

  • Tabelite või SQL-i salvestatud protseduuri lisamiseks kasutage --as tablevõi lisage --table või --procedure.
  • Konnektori toimingute lisamiseks kasutage .--as action Te ei saa kasutada --as action operatsioonisüsteemis --dataset, --tablevõi --procedure.

Kui te ei määra, mida lisada, küsib käsk interaktiivses terminalis käsku Kas soovite tabeli lisada? Mitte-interaktiivses režiimis käsk ei tööta enne, kui olete määranud --as. Konnektorid, mis toetavad ainult toiminguid (nt Office 365 kasutajad), ei vaja --as ega toeta .--as table Dataverse'i toimingute või funktsioonide lisamiseks kasutage pa app add dataverse-api funktsiooni .--as action

Interaktiivses terminalis küsib käsk nõutavaid väärtusi, mida te ei esita käsusuvandite või keskkonnamuutujatena. Viibad sõltuvad andmeallika tüübist.

Omaandmevärv:

  1. Kui te ei määra --connector, küsib käsk konnektori ID-d.
  2. Käsk küsib tabeli loogikanime.
  3. Käsk küsib Dataverse'i organisatsiooni URL-i, kui seda pole esitatud.

Native Dataverse ei kasuta ühenduse ID-d, ühenduseviidet ega andmekomplekti.

Konnektoriga varundatud andmeallikate korral tehke järgmist.

Konnektori ja andmeallika tüübi valimine

  1. Kui te ei määra --connector, küsib käsk konnektori ID-d.
  2. Kui konnektor toetab nii tabeleid kui ka toiminguid ja miski muu ei määratle, mida lisada, küsitakse käsult Lisa tabel?

Valige ühendus

Käsk küsib, kas kasutate ühenduse ID asemel ühenduse viidet? See jätab selle küsimuse vahele, kui sisestate ühenduse ID või ühenduse viite.

  • Kui valite jah, küsib käsk ühenduseviite loogikanime.
  • Kui valite Ei, kuvatakse käsul konnektori ühendused. Valige (Sisestage käsitsi...), et sisestada ühenduse ID, mida loendis pole.

Valige andmed

  • Toimingute lisamisel jätab käsk salvestatud protseduuri, andmekomplekti ja tabeliviibad vahele.

  • Kui lisate tabeleid või salvestatud toiminguid, tehke järgmist.

    1. SQL Server puhul küsib käsk, kas lisate salvestatud protseduuri. Kui olete, küsib see salvestatud protseduuri nime.
    2. Käsuga loetletakse ühenduse kaudu saadaolevad andmekomplektid. Valige (Sisesta käsitsi...), et sisestada andmekomplekt, mida loendis pole.
    3. Kui te ei lisa salvestatud protseduuri, avab käsk andmekomplektis otsitava tabeliloendi. Saate valida mitu tabelit.

Kui kasutate ühenduseviidet, pärinevad andmekomplektid ja tabeliloendid ühendusest, millele viiteviide viitab.

pa app add data-source Näited

Andmeallika lisamiseks vastake viipadele:

pa app add data-source

Lisage omatabel Dataverse:

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

Lisage konnektori toimingud, mis toetavad ka tabeleid.

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

SharePoint list lisamiseks kasutage konnektori kuvatavat nime.

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

Lisage mitu SQL-tabelit samast andmekomplektist:

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

Lisage tabel läbi ühendusviite ning valige andmekomplekt ja tabel, kui käsk küsib:

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

Lisab koodirakendusse toimingu Dataverse või funktsiooni.

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

pa app add dataverse-api parameetrid

Parameeter Kirjeldus
--api-name Lisatava toimingu või funktsiooni Dataverse nimi.

PA_CLI_DATAVERSE_API_NAME on parameetri vastav keskkonnamuutuja --api-name .

Lisateave:

pa app add flow

Lisab koodirakendusse Power Automate voo.

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

pa app add flow parameetrid

Parameeter Kirjeldus
--flow-id Lisatava Power Automate voo ID.

PA_CLI_FLOW_ID on parameetri vastav keskkonnamuutuja --flow-id .

Käsk:

  • Laadib alla voo OpenAPI määratluse.
  • Genereerib tugevalt tipitud TypeScripti mudelid ja teenused.
  • Lisab voo ja selle ühendusviited ile power.config.json.

Kui voomääratlus muutub, käivitage see käsk uuesti, et genereerida uusima versiooni kood.

NB!

Käitajal pa app add flow peab olema juurdepääs voole ja selle aluseks olevatele ühendustele. Käsk nurjub, kui isikul puudub juurdepääs nõutavale ühendusele.

Lisateave stsenaariumide kohta, kus seda käsku kasutate.

pa app find-dataverse-api

Otsib praeguses keskkonnas andmehalduri toiminguid ja funktsioone.

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

pa app find-dataverse-api parameetrid

Parameeter Kirjeldus
--search Otsitava toimingu nimi.
--json Tagasta tulemid JSON-ina.

Need parameetrid vastavad dataverse API-dele ja Power Automate voogude keskkonnamuutujatele.

Siit saate teada, kuidas leida saadaolevaid Andmeverse'i toiminguid.

pa app get-settings

Kuvab koodirakenduse praegused sätted.

pa app get-settings [--json]

pa app get-settings parameetrid

Parameeter Kirjeldus
--json Tagastage rakenduse sätted JSON-ina.

Käivitage see käsk lähtestatud koodirakenduse projektist, mis sisaldab power.config.json faili.

pa app init

Lähtestab koodirakenduse praeguses kataloogis.

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

pa app init parameetrid

Parameeter Kirjeldus
--display-name Koodirakenduse kuvatav nimi.
--environment-id Koodirakenduse Power Platformi keskkond.
--description Koodirakenduse kirjeldus.
--build-path Kompileeritud rakenduse varasid sisaldav kataloog.
--file-entry-point Järguväljundi HTML-sisenemispunkt.
--app-type Rakenduse tüüp. Kehtivad väärtused on CodeApp ja MobileApp.
--app-url Kohalikult töötava koodirakenduse URL.
--cloud Power Platformi pilveeksemplar.

Nendel parameetritel on vastavad rakenduse lähtestamise keskkonnamuutujad.

Lisateave stsenaariumide kohta, kus saate seda käsku kasutada.

pa app list

Loetleb koodirakendused praeguses keskkonnas.

pa app list

pa app list-environment-variables

Loetleb koodirakenduse jaoks saadaolevad keskkonnamuutujad.

pa app list-environment-variables

pa app list-flows

Loetleb lahendusepõhised Power Automate vood praeguses keskkonnas.

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

Näide:

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 parameetrid

Parameeter Kirjeldus
--search Voo filtreerimine nime järgi.

PA_CLI_FLOW_SEARCH on parameetri vastav keskkonnamuutuja --search .

pa app push

Avaldab koodirakenduse uue versiooni Power Apps.

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

pa app push parameetrid

Parameeter Kirjeldus
--solution-id Lahenduse ID koodirakenduse lisamiseks.
--non-interactive Avaldab rakenduse mitte interaktiivselt. Saate teada, kuidas avaldada rakendusi teenusesubjektiga.

Kasutage PA_CLI_SOLUTION_ID parameetriga --solution-id keskkonnamuutujana.

Siit saate teada, kuidas luua Power Apps CLI abil koodirakendust.

pa app refresh data-source

Värskendab andmeallika genereeritud failid.

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

pa app refresh data-source parameetrid

Parameeter Kirjeldus
--name Värskendatava andmeallika nimi.

pa app remove data-source

Eemaldab koodirakendusest andmeallika.

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

pa app remove data-source parameetrid

Parameeter Kirjeldus
--connector Andmeallika konnektori identifikaator.
--name Eemaldatava andmeallika nimi.
--force Eemaldage andmeallikas ilma kinnitust küsimata.

pa app remove flow

Eemaldab koodirakendusest Power Automate voo.

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

pa app remove flow parameetrid

Parameeter Kirjeldus
--flow-name Eemaldatava Power Automate voo nimi.
--flow-id Eemaldatava Power Automate voo ID.
--force Eemaldage voog ilma kinnitust küsimata.

PA_CLI_FLOW_DATA_SOURCE_NAME ja PA_CLI_REMOVE_FLOW_ID on vastavad keskkonnamuutujad, mida nende parameetritega kasutada.

Siit saate teada, kuidas voog eemaldada.

pa app run

Käivitab koodirakenduse Power Apps kohaliku hosti.

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

pa app run parameetrid

Parameeter Kirjeldus
--port Kohaliku hosti port.
--local-app-url Kohalikult töötava koodirakenduse URL.

Nendel parameetritel on vastavad käitusrakenduste keskkonnamuutujad.

pa app set-setting

Värskendab koodirakenduse ühe või mitu sätet.

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

pa app set-setting parameetrid

Parameeter Kirjeldus
--show-header Saate kuvada või peita rakenduse päise. Kehtivad väärtused on true ja false.
--json Tagastage värskendatud rakendusesätted JSON-ina.

Käivitage see käsk lähtestatud koodirakenduse projektist, mis sisaldab power.config.json faili. Käsuga kirjutatakse säte appSettings 'isse power.config.json. Käivita pa app push , et avaldada säte nii, et pleier rakendaks selle käitusajal.

pa app share

Jagab koodirakendust kasutajate või teenusesubjektidega.

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

pa app share parameetrid

Parameeter Kirjeldus
--principal Kasutajate või teenusesubjektide ühiskasutatavad komaeraldusega meiliaadressid või Microsoft Entra objekti ID-d.
--access Antav juurdepääsutase: play (vaikesäte) või edit.

Nendel parameetritel on vastavad jagamisrakenduste keskkonnamuutujad.

pa app share Märkused

Koodirakendus peab olema juba avaldatud ja sellel peab olema õnnestunud pa app push käsu rakenduse ID. Juurdepääsu andmine edit , kui teenusesubjekt peab töötama pa app push.

Teenusesubjektiga ühiskasutuse korral kasutage ettevõtterakenduse objekti ID-t, mitte rakenduse registreerimise objekti ID-t.

pa auth login

Logib sisse süsteemibrauseri kaudu.

pa auth login

Konto eeltäitmiseks sisselogimislehel kasutage järgmist.

pa auth login --account user@contoso.com

pa auth login parameetrid

Parameeter Kirjeldus
--account Sisselogimislehel eeltäidetav konto.

PA_CLI_ACCOUNT on parameetri vastav keskkonnamuutuja --account .

pa auth logout

Logib välja ja eemaldab salvestatud autentimisteabe.

pa auth logout

Märkus.

See käsk logib teid kõigist kontodest välja. See ei saa teid ainult ühest kontost välja logida. Aktiivse konto muutmiseks kasutage pa auth switch seda.

Lisateave väljalogimise kohta

pa auth status

Kuvab sisselogitud kontod ja tuvastab aktiivse konto.

Autentimisoleku kuvamiseks JSON-ina kasutage järgmist.

pa auth status --json

pa auth status parameetrid

Parameeter Kirjeldus
--json Tagastab autentimisoleku JSON-ina.

Siit saate teada, kuidas kontrollida, milline konto on aktiivne

pa auth switch

Muudab aktiivset kontot.

pa auth switch --account user@contoso.com

pa auth switch parameetrid

Parameeter Kirjeldus
--account Konto, mille soovite aktiivseks muuta.

PA_CLI_ACCOUNT on parameetri vastav keskkonnamuutuja --account .

Lisateave selle kohta, millal saate seda käsku kasutada.

pa connection create

Loob konnektori jaoks ühenduse.

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

pa connection create parameetrid

Parameeter Pseudonüüm Nõutav Kirjeldus
--connector - Jah Konnektori identifikaator (nt shared_office365 või shared_teams).
--display-name -n Ei Ühenduse kuvatav nimi. Kui te nime ei sisesta, kasutab CLI vaikenime.
--json - Ei Tagastab tulemi JSON-ina.

pa connection create Näited

Office 365 Outlook ühenduse loomine:

pa connection create --connector shared_office365

Looge Microsoft Teams ühendus kohandatud kuvatava nimega:

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

Looge ühendus ja tagastage tulem JSON-ina:

pa connection create --connector shared_office365 --json

pa connection create väljund

Kui käsk õnnestub, tagastab see ühenduse ID. Kasutage ühenduse ID-t, kui lisate konnektori koodirakendusse andmeallikana.

Siit saate teada, kuidas luua ühendus Power Apps CLI kaudu

pa connection list

Loetleb praeguse keskkonna ühendused.

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

pa connection list parameetrid

Parameeter Kirjeldus
--search Saate ühendusi nime järgi filtreerida.
--json Tagasta tulemid JSON-ina.

Nendel parameetritel on vastavad lahendused, konnektorid ja andmeallikate keskkonnamuutujad.

pa connection list-datasets

Loetleb ühenduse kaudu saadaolevad andmekomplektid.

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

pa connection list-datasets parameetrid

Parameeter Kirjeldus
--connector Konnektori identifikaator.
--connection-id Andmekomplektide loetlemisel kasutatav ühenduse ID.

pa connection list-procedures

Loetleb SQL-i salvestatud protseduurid, mis on saadaval andmekomplektis.

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

pa connection list-procedures parameetrid

Parameeter Kirjeldus
--connection-id Salvestatud protseduuride loetlemisel kasutatav ühenduse ID.
--dataset Salvestatud protseduure sisaldav andmekomplekt.

pa connection list-references

Loetleb lahenduse ühenduseviited.

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

pa connection list-references parameetrid

Parameeter Kirjeldus
--solution-id Ühenduseviiteid sisaldava lahenduse ID.

Kasutage PA_CLI_SOLUTION_ID koos parameetriga --solution-id .

pa connection list-tables

Loetleb andmekomplektis saadaolevad tabelid.

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

pa connection list-tables parameetrid

Parameeter Kirjeldus
--connector Konnektori identifikaator.
--connection-id Tabelite loetlemisel kasutatav ühenduse ID.
--dataset Tabeleid sisaldav andmekomplekt.

pa connector list

Loetleb praeguses Power Platformi keskkonnas saadaolevad konnektorid.

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

pa connector list parameetrid

Parameeter Kirjeldus
--search Saate konnektoreid filtreerida nime või kuvatava nime järgi.
--json Tagastage täielik konnektoriloend JSON-ina.

PA_CLI_CONNECTOR_SEARCH on vastav keskkonnamuutuja, mida parameetriga --search kasutada.

pa connector list väljund

Interaktiivses terminalis kuvatakse tulemid 20 reaga lehtedel. Järgmise lehe kuvamiseks vajutage sisestusklahvi (Enter). Väljumiseks vajutage paoklahvi (Esc ) või klahvi Q . Väljundi ümbersuunamisel või kaasamisel --jsontagastab käsk täieliku loendi.

Vaikimisi tagastab käsk järgmiste veergudega tabeli.

Veerg Kirjeldus
Kuvatav nimi Konnektori kuvatav nimi (nt Office 365 Outlook).
Konnektor Konnektori identifikaator( nt shared_office365. Kasutage seda väärtust suvandiga --connectorpa connection create.

Parameetri kasutamisel --json sisaldab JSON-väljund järgmisi välju.

Väli Kirjeldus
id Konnektori ID.
name Konnektori identifikaator( nt shared_office365.
displayName Konnektori kuvatav nimi.
description Konnektori kirjeldus.
isTabular Näitab, kas konnektor toetab tabeli andmetoiminguid.

pa connector list Näited

Loetle kõik saadaolevad konnektorid:

pa connector list

Otsi konnektoreid:

pa connector list --search teams

Tagasta konnektoriloend JSON-ina:

pa connector list --json

Saadaolevate konnektorite loetlemine

pa solution list

Loetleb praeguse keskkonna lahendused (sh nende sõbralik nimi, kordumatu nimi ja lahenduse ID).

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

pa solution list parameetrid

Parameeter Kirjeldus
--search Saate lahendusi filtreerida sõbraliku nime või kordumatu nime järgi. Filter on tõstutundetu alamstringi vaste.
--json Tagastab täieliku lahenduseloendi JSON-ina.

PA_CLI_SOLUTION_SEARCH on parameetri vastav keskkonnamuutuja --search .

Interaktiivses terminalis kuvatakse tulemid 20 reaga lehtedel. Järgmise lehe kuvamiseks vajutage sisestusklahvi (Enter). Väljumiseks vajutage paoklahvi (Esc ) või klahvi Q . Väljundi ümbersuunamisel või kaasamisel --jsontagastab käsk täieliku loendi.

pa telemetry disable

Keelab telemeetria kogumise.

pa telemetry disable

pa telemetry enable

Lubab telemeetria kogumise.

pa telemetry enable

pa telemetry status

Kuvab praegused telemeetriasätted.

pa telemetry status