Power Apps CLI aplinkos kintamieji

Naudodami aplinkos kintamuosius konfigūruokite Power Apps CLI autentifikavimą ir pateikite komandų parinktis scenarijuose ir CI/CD srautuose. Aplinkos kintamieji, apibrėžti Power Apps CLI, naudoja prefiksąPA_CLI_.

Pastaba

Aplinkos kintamieji yra pavadintos reikšmės, kurias operacinė sistema suteikia programoms. Power Apps CLI atpažįsta šioje nuorodoje aprašytus kintamuosius. Norėdami sužinoti, kaip veikia aplinkos kintamieji ir kaip juos valdyti, žr. apie aplinkos kintamuosius.

Šioje nuorodoje aprašomi operacinės sistemos aplinkos kintamieji, kurie konfigūruoja Power Apps CLI. Šie kintamieji skiriasi nuo "Power Platform" sprendimų aplinkos kintamųjų, kuriuose saugomos programos naudojamos konfigūracijos reikšmės.

Naudojant komandos parinktį CLI išsprendžia reikšmę tokia tvarka:

  1. Komandų eilutės parinktis
  2. Aplinkos kintamasis
  3. Numatytoji reikšmė, jei parinktis yra
  4. Interaktyvus raginimas, kai palaikoma

Komandų eilutėje pateikta parinktis turi pirmenybę prieš atitinkamą aplinkos kintamąjį.

Svarbu

Aplinkos kintamieji gali atskleisti paslaptis kitiems procesams, žurnalams arba apvalkalo retrospektyvai. Saugokite PA_CLI_SP_CLIENT_SECRET SAVO CI / CD platformos slaptoje saugykloje, užmaskuokite ją nuo žurnalų ir neįteikite slaptų duomenų šaltinio valdymui.

Aplinkos kintamųjų nustatymas

Toliau pateikti pavyzdžiai, nustatyti PA_CLI_ENVIRONMENT_ID prieš vykdant komandą Power Apps CLI.

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

Aplinkos kintamasis išlieka pasiekiamas to paties terminalo seanso komandoms. Naudokite standartinę apvalkalo komandą, kad ją pašalintumėte, kai jos nebereikia.

Autentifikavimas

Aplinkos kintamasis Aprašas
PA_CLI_ACCOUNT Nurodo paskyrą, skirtą pa auth login arba pa auth switch.
PA_CLI_SP_CLIENT_ID Nurodo pagrindinio tarnybos autentifikavimo Microsoft Entra programos (kliento) ID.
PA_CLI_SP_CLIENT_SECRET Nurodo pagrindinio tarnybos autentifikavimo kliento slaptą informaciją.
PA_CLI_SP_TENANT_ID Nurodo pagrindinio tarnybos autentifikavimo Microsoft Entra katalogo (nuomotojo) ID.
PA_CLI_USE_SP_AUTH Nustatykite reikšmę ( true mažosiomis raidėmis), kad būtų naudojamas sistemos tarnybos autentifikavimas.

Kai pasirenkamas pagrindinis tarnybos autentifikavimas, būtini trys PA_CLI_SP_* kredencialų kintamieji. Nors CI=true dėl suderinamumo taip pat pasirenka pagrindinį tarnybos autentifikavimą, naudokite PA_CLI_USE_SP_AUTH=true autentifikuoti autentifikavimo režimą.

Sąrankos instrukcijas žr. Power Apps kodo programų publikavimas naudojant pagrindinį tarnybos pavadinimą.

Visuotinės komandų parinktys

Šie kintamieji atitinka parinktis, pasiekiamas Power Apps CLI komandose.

Aplinkos kintamasis Atitinkama parinktis Aprašas
PA_CLI_CLOUD --cloud Pasirenka tikslinį debesį. Leistinos reikšmės:
- public (numatytoji reikšmė)
- usgov
- usgovhigh
- usgovdod
- china
Reikšmės neskifizuojamos mažosiomis ir mažosiomis raidėmis.
PA_CLI_ENVIRONMENT_ID --environment-id Nurodo tikslinės "Power Platform" aplinkos ID.

Taikomosios programos inicijavimas

Šie kintamieji pateikia parinktis .pa app init

Aplinkos kintamasis Atitinkama parinktis Aprašas
PA_CLI_APP_BUILD_PATH --build-path Nurodo komponavimo versijos išvesties katalogą. Numatytoji reikšmė yra ./dist.
PA_CLI_APP_DESCRIPTION --description Nurodo taikomosios programos aprašą.
PA_CLI_APP_DISPLAY_NAME --display-name Nurodo taikomosios programos rodomą pavadinimą.
PA_CLI_APP_FILE_ENTRY_POINT --file-entry-point Nurodo HTML įvesties tašką komponavimo versijos išvestyje. Numatytoji reikšmė yra index.html.
PA_CLI_APP_TYPE --app-type Nurodo taikomosios programos tipą. Leistinos reikšmės:
- CodeApp (numatytoji reikšmė)
- MobileApp
Reikšmė įrašoma power.config.json ir naudojama kaip taikomosios programos tipas publikuojant programą.
PA_CLI_APP_URL --app-url Nurodo vietinės taikomosios programos URL per pa app init. Reikšmė įrašoma kaip localAppUrl ir power.config.json tampa numatytuoju būsimų pa app run komandų URL. Numatytoji reikšmė yra http://localhost:3000.

Paleisti programėles

Šie kintamieji pateikia parinktis .pa app run

Aplinkos kintamasis Atitinkama parinktis Aprašas
PA_CLI_LOCAL_APP_URL --local-app-url Nepakeis dabartinės komandos reikšmės power.config.json nekeisdama localAppUrl įrašytos konfigūracijos. Jei nei viena reikšmė nenustatyta, numatytoji reikšmė yra http://localhost:3000.
PA_CLI_PORT --port Nurodo Power Apps vietinio pagrindinio kompiuterio prievadą. Numatytoji reikšmė yra 8080.

Bendrinti programėles

Šie kintamieji pateikia parinktis .pa app share

Aplinkos kintamasis Atitinkama parinktis Aprašas
PA_CLI_SHARE_ACCESS --access Nurodo prieigos lygį. Leistinos reikšmės:
- play (numatytoji reikšmė)
- edit
PA_CLI_SHARE_PRINCIPAL --principal Nurodo vieną ar kelis kableliais atskirtus el. pašto adresus arba Microsoft Entra objektų IP.

Sprendimai, jungtys ir duomenų šaltiniai

Aplinkos kintamasis Atitinkama parinktis Aprašas
PA_CLI_CONNECTION_DISPLAY_NAME --display-name Nurodo rodomą vardą kuriant ryšį.
PA_CLI_CONNECTION_ID --connection-id Nurodo jungties ryšio egzemplioriaus ID.
PA_CLI_CONNECTION_REF --connection-ref Nurodo ryšio nuorodos loginį pavadinimą.
PA_CLI_CONNECTION_SEARCH --search Filtruoja rezultatus iš pa connection list.
PA_CLI_CONNECTOR --connector Nurodo jungties ID, pvz shared_office365users., .
PA_CLI_CONNECTOR_SEARCH --search Filtruoja rezultatus iš pa connector list.
PA_CLI_DATASET --dataset Nurodo duomenų rinkinį, pvz., SharePoint svetainę arba SQL duomenų bazę.
PA_CLI_DATA_SOURCE_NAME --name Nurodo duomenų šaltinį, kurį reikia atnaujinti arba pašalinti.
PA_CLI_ORG_URL --org-url Perrašo "Dataverse" organizacijos URL, naudojamą metaduomenims gauti įtraukiant duomenų šaltinį.
PA_CLI_PROCEDURE --procedure Nurodo SQL išsaugotą procedūrą.
PA_CLI_SOLUTION_ID --solution-id Nurodo , pa app add data-sourcearba pa connection list-references.pa app push
PA_CLI_SOLUTION_SEARCH --search Filtruoja rezultatus iš pa solution list.
PA_CLI_TABLE --table Nurodo lentelės arba jungties ištekliaus pavadinimą.

Apie komandas, kurios priima kiekvieną parinktį, žr. Power Apps CLI komandos nuoroda.

"Dataverse" API ir Power Automate srautai

Aplinkos kintamasis Atitinkama parinktis Aprašas
PA_CLI_DATAVERSE_API_NAME --api-name Nurodo "Dataverse" veiksmą arba funkciją, kurią galima įtraukti su pa programa, įtraukiant "dataverse-api".
PA_CLI_DATAVERSE_API_SEARCH_TERM --search Filtruoja "Dataverse" veiksmus ir funkcijas pagal pavadinimą naudojant pa app find-dataverse-api.
PA_CLI_FLOW_DATA_SOURCE_NAME --flow-name Nurodo srauto duomenų šaltinį, kurį reikia pašalinti iš programos naudojant pa app remove flow
PA_CLI_FLOW_ID --flow-id Nurodo Power Automate srautą, kurį reikia įtraukti į pa app add flow.
PA_CLI_FLOW_SEARCH --search Filtruoja galimus Power Automate srautus pagal pavadinimąpa app list-flows
PA_CLI_REMOVE_FLOW_ID --flow-id Nurodo Power Automate srautą, kurį reikia pašalinti naudojantpa app remove flow

Telemetrijos ir konsolės išvestis

Aplinkos kintamasis Atitinkama parinktis Aprašas
PA_CLI_CONSOLE_ONLY --console-only Nustatykite reikšmę ( true mažosiomis raidėmis) naudodami pa telemetry enable arba pa telemetry disable rašydami telemetriją tik konsolėje, o ne siųsti nuotoliniu būdu.
PA_CLI_OUTPUT_TO_CONSOLE --output-to-console Nustatykite reikšmę ( true mažosiomis raidėmis) su pa telemetry enable arba pa telemetry disable dubliuoti nuotoliniu būdu į konsolę siunčiamus telemetrijos įvykius.
PA_CLI_TELEMETRY Nėra, Nustatykite vieną iš šių reikšmių, kad išjungtumėte dabartinio proceso telemetriją:
- 0
- false
- no
- off
Reikšmės yra neskiebtos mažosiomis ir atvirkščiai, o aplinkinių tarpų nepaisoma.

Nuolatinių telemetrijos parametrų ieškokite Power Apps CLI telemetrijos parametrų valdymas.

Standartiniai aplinkos kintamieji

CLI taip pat stebi šį standartinį aplinkos kintamąjį:

Aplinkos kintamasis Aprašas
NO_COLOR Nustatykite šį kintamąjį kaip neįveikimo reikšmę, kad išjungtumėte ANSI spalvų išvestį. Taip pat galite naudoti šią --no-color parinktį.