CLI keskkonnamuutujate Power Apps

Keskkonnamuutujate abil saate konfigureerida Power Apps CLI autentimist ning pakkuda skriptides ja CI/CD konveierites käsusuvandeid. Power Apps CLI määratletud keskkonnamuutujad kasutavad eesliidetPA_CLI_.

Märkus.

Keskkonnamuutujad on nimega väärtused, mille operatsioonisüsteem rakendustele kättesaadavaks teeb. Power Apps CLI tuvastab selles viites kirjeldatud muutujad. Teavet keskkonnamuutujate toimimise ja haldamise kohta leiate teemast Keskkonnamuutujad.

Selles viites kirjeldatakse operatsioonisüsteemi keskkonnamuutujaid, mis konfigureerivad Power Apps CLI. Need muutujad erinevad Power Platformi lahenduse keskkonnamuutujatest, mis salvestavad rakenduse kasutatavad konfiguratsiooniväärtused.

Käsusuvandi korral lahendab CLI väärtuse järgmises järjestuses:

  1. Käsurea suvand
  2. Keskkonnamuutuja
  3. Vaikeväärtus, kui suvandil on see
  4. Interaktiivne viip, kui seda toetatakse

Käsureal olev suvand alistab vastava keskkonnamuutuja.

Oluline

Keskkonnamuutujad võivad avaldada saladusi teistele protsessidele, logidele või kestaajaloole. Talletage PA_CLI_SP_CLIENT_SECRET oma CI/CD platvormi salasalves, maskeerige see logidest ja ärge kinnitage saladusi allikajuhtimisele.

Keskkonnamuutujate määramine

Järgmised näited on määratud PA_CLI_ENVIRONMENT_ID enne käsu Power Apps CLI käivitamist.

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

Keskkonnamuutuja jääb kättesaadavaks sama terminaliseansi käivitatud käskudele. Kui kesta pole enam vaja, eemaldage see kesta standardkäsu abil.

Autentimine

Keskkonnamuutuja Kirjeldus
PA_CLI_ACCOUNT Määrab või konto.pa auth loginpa auth switch
PA_CLI_SP_CLIENT_ID Määrab teenusesubjekti autentimise Microsoft Entra rakenduse (kliendi) ID.
PA_CLI_SP_CLIENT_SECRET Määrab teenusesubjekti autentimise klientrakenduse saladuse.
PA_CLI_SP_TENANT_ID Määrab teenusesubjekti autentimise Microsoft Entra kataloogi (rentniku) ID.
PA_CLI_USE_SP_AUTH Määrake teenusesubjekti autentimiseks väärtus true (väiketähtedega).

Kui valitud on teenusesubjekti autentimine, on identimisteabe kolm PA_CLI_SP_muutujat * nõutavad. Kuigi CI=true valitakse ühilduvuse jaoks ka teenusesubjekti autentimine, kasutage PA_CLI_USE_SP_AUTH=true autentimisrežiimi otseste valikute tegemiseks.

Häälestusjuhised leiate teemast Power Apps koodirakenduste avaldamine teenusesubjektiga.

Globaalsed käsusuvandid

Need muutujad vastavad suvanditele, mis on saadaval kõigis Power Apps CLI käskudes.

Keskkonnamuutuja Vastav suvand Kirjeldus
PA_CLI_CLOUD --cloud Valib sihtpilvteenuse. Kehtivad väärtused on järgmised:
- public (vaikesäte)
- usgov
- usgovhigh
- usgovdod
- china
Väärtused on tõstutundetud.
PA_CLI_ENVIRONMENT_ID --environment-id Määrab Power Platformi sihtkeskkonna ID.

Rakenduse lähtestamine

Need muutujad pakuvad teenusekomplekti .pa app init

Keskkonnamuutuja Vastav suvand Kirjeldus
PA_CLI_APP_BUILD_PATH --build-path Määrab järgu väljundkausta. Vaikeväärtus on ./dist.
PA_CLI_APP_DESCRIPTION --description Määrab rakenduse kirjelduse.
PA_CLI_APP_DISPLAY_NAME --display-name Määrab rakenduse kuvatava nime.
PA_CLI_APP_FILE_ENTRY_POINT --file-entry-point Määrab järgu väljundis HTML-i sisenemispunkti. Vaikeväärtus on index.html.
PA_CLI_APP_TYPE --app-type Määrab rakenduse tüübi. Kehtivad väärtused on järgmised:
- CodeApp (vaikesäte)
- MobileApp
Väärtus salvestatakse power.config.json ja seda kasutatakse rakenduse avaldamisel rakenduse tüübina.
PA_CLI_APP_URL --app-url Määrab kohaliku rakenduse URL-i .pa app init Väärtus salvestatakse kujul localAppUrl sisse power.config.json ja sellest saab tulevaste pa app run käskude vaike-URL. Vaikeväärtus on http://localhost:3000.

Rakenduste käivitamine

Need muutujad pakuvad teenusekomplekti .pa app run

Keskkonnamuutuja Vastav suvand Kirjeldus
PA_CLI_LOCAL_APP_URL --local-app-url Alistab localAppUrl praeguse käsu väärtuse power.config.json salvestatud konfiguratsiooni muutmata. Kui kumbki väärtus pole seatud, on http://localhost:3000vaikeväärtus .
PA_CLI_PORT --port Määrab Power Apps kohaliku hosti pordi. Vaikeväärtus on 8080.

Rakenduste ühiskasutus

Need muutujad pakuvad teenusekomplekti .pa app share

Keskkonnamuutuja Vastav suvand Kirjeldus
PA_CLI_SHARE_ACCESS --access Määrab pääsutaseme. Kehtivad väärtused on järgmised:
- play (vaikesäte)
- edit
PA_CLI_SHARE_PRINCIPAL --principal Määrab ühe või mitu komaeraldusega meiliaadressi või Microsoft Entra objekti ID-sid.

Lahendused, konnektorid ja andmeallikad

Keskkonnamuutuja Vastav suvand Kirjeldus
PA_CLI_CONNECTION_DISPLAY_NAME --display-name Määrab ühenduse loomisel kuvatava nime.
PA_CLI_CONNECTION_ID --connection-id Määrab konnektori ühenduse eksemplari ID.
PA_CLI_CONNECTION_REF --connection-ref Määrab ühenduseviite loogikanime.
PA_CLI_CONNECTION_SEARCH --search Filtreerib tulemid asukohast pa connection list.
PA_CLI_CONNECTOR --connector Määrab konnektori ID, nt shared_office365users.
PA_CLI_CONNECTOR_SEARCH --search Filtreerib tulemid asukohast pa connector list.
PA_CLI_DATASET --dataset Määrab andmekomplekti (nt SharePoint saidi või SQL-andmebaasi).
PA_CLI_DATA_SOURCE_NAME --name Määrab värskendatava või eemaldatava andmeallika.
PA_CLI_ORG_URL --org-url Alistab Dataverse'i organisatsiooni URL-i, mida kasutatakse andmeallika lisamisel metaandmete toomiseks.
PA_CLI_PROCEDURE --procedure Määrab SQL-i salvestatud protseduuri.
PA_CLI_SOLUTION_ID --solution-id Määrab , pa app pushpa app add data-sourcevõi pa connection list-references.
PA_CLI_SOLUTION_SEARCH --search Filtreerib tulemid asukohast pa solution list.
PA_CLI_TABLE --table Määrab tabeli või konnektori ressursi nime.

Iga suvandiga nõustuvate käskude kohta leiate teavet CLI Power Apps käsuviitest.

Dataverse API-d ja Power Automate vood

Keskkonnamuutuja Vastav suvand Kirjeldus
PA_CLI_DATAVERSE_API_NAME --api-name Määrab toimingu Dataverse või funktsiooni, mille lisate funktsiooniga pa app add dataverse-api.
PA_CLI_DATAVERSE_API_SEARCH_TERM --search Filtreerib andmeversi toimingud ja funktsioonid nime järgi.pa app find-dataverse-api
PA_CLI_FLOW_DATA_SOURCE_NAME --flow-name Määrab voo andmeallika, mille abil rakendusest eemaldada pa app remove flow
PA_CLI_FLOW_ID --flow-id Määrab lisatava Power Automate voopa app add flow.
PA_CLI_FLOW_SEARCH --search Filtreerib saadaolevad Power Automate vood nime järgipa app list-flows
PA_CLI_REMOVE_FLOW_ID --flow-id Määrab eemaldatava Power Automate voopa app remove flow

Telemeetria ja konsooli väljund

Keskkonnamuutuja Vastav suvand Kirjeldus
PA_CLI_CONSOLE_ONLY --console-only Määrake väärtuseks true (väiketähed) ainult konsoolis pa telemetry enable telemeetria kirjutamiseks või pa telemetry disable kirjutamiseks, mitte kaugühenduse kaudu saatmiseks.
PA_CLI_OUTPUT_TO_CONSOLE --output-to-console Seadke väärtuseks true (väiketähed) pa telemetry enablepa telemetry disable kaugsaatmisega telemeetriasündmuste peegelduse peegelduse konsooli.
PA_CLI_TELEMETRY Pole Määrake üks järgmistest väärtustest praeguse protsessi telemeetria keelamiseks:
- 0
- false
- no
- off
Väärtused on tõstutundetud ja ümbritsevaid tühikuid ignoreeritakse.

Püsiva telemeetria sätete kohta leiate teavet artiklist Power Apps CLI telemeetriasätete haldamine.

Standardsed keskkonnamuutujad

CLI jälgib ka seda standardset keskkonnamuutujat:

Keskkonnamuutuja Kirjeldus
NO_COLOR AnSI värviväljundi keelamiseks seadke selle muutuja väärtuseks mittetühja väärtus. Saate kasutada ka seda suvandit --no-color .
  • Last updated on