Power Apps CLI vides mainīgie

Izmantojiet vides mainīgos, lai konfigurētu Power Apps CLI autentifikāciju un nodrošinātu komandu opcijas skriptos un CI/CD cauruļvados. Vides mainīgie, ko definē Power Apps CLI, izmanto prefiksuPA_CLI_.

Piezīme

Vides mainīgie ir nosauktas vērtības, kuras operētājsistēma padara pieejamas lietojumprogrammām. Power Apps CLI atpazīst šajā atsaucē aprakstītos mainīgos. Lai uzzinātu, kā darbojas vides mainīgie un kā tos pārvaldīt, skatiet informāciju par vides mainīgajiem.

Šī atsauce apraksta operētājsistēmas vides mainīgos, kas konfigurē Power Apps CLI. Šie mainīgie atšķiras no Power Platform risinājuma vides mainīgajiem, kas glabā konfigurācijas vērtības, ko izmanto lietotne.

Komandu opcijai CLI atrisina vērtību šādā secībā:

  1. Komandrindas opcija
  2. Vides mainīgā vērtība
  3. Noklusētā vērtība, ja opcijai tāda ir
  4. Interaktīva uzvedne, kad tas ir atbalstīts

Opcija, kas tiek piedāvāta komandrindā, ir svarīgāka par atbilstošo vides mainīgo.

Svarīgi

Vides mainīgie var atklāt noslēpumus citiem procesiem, žurnāliem vai čaulas vēsturei. Glabā PA_CLI_SP_CLIENT_SECRET savas CI/CD platformas slepenajā krātuvē, maskē to no žurnāliem un nenodod noslēpumus avota kontrolei.

Vides mainīgo iestatīšana

Šie piemēri ir pirms PA_CLI_ENVIRONMENT_ID Power Apps CLI komandas palaišanas.

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

Vides mainīgais joprojām ir pieejams komandām, kas sāktas tajā pašā termināļa sesijā. Izmanto sava čaulas standarta komandu, lai to noņemtu, kad tas vairs nav vajadzīgs.

Autentifikācija

Vides mainīgā vērtība Apraksts
PA_CLI_ACCOUNT Norāda kontu vai pa auth loginpa auth switch.
PA_CLI_SP_CLIENT_ID Norāda Microsoft Entra lietojumprogrammas (klienta) ID pakalpojuma principa autentifikācijai.
PA_CLI_SP_CLIENT_SECRET Norāda klienta noslēpumu pakalpojuma galvenā autentifikācijai.
PA_CLI_SP_TENANT_ID Norāda Microsoft Entra direktorija (tenanta) ID pakalpojuma galvenā autentifikācijai.
PA_CLI_USE_SP_AUTH Iestatiet vērtību uz true (mazajiem burtiem), lai izmantotu Service Principal autentifikāciju.

Izvēloties pakalpojuma galvenā autentifikāciju, nepieciešami trīs PA_CLI_SP_* akreditācijas mainīgie. Lai gan CI=true tiek izvēlēta arī pakalpojuma galvenā autentifikācija savietojamības dēļ, to izmanto, PA_CLI_USE_SP_AUTH=true lai padarītu autentifikācijas režīmu skaidru.

Iestatīšanas instrukcijas skatiet sadaļā Publicēt Power Apps code lietotnes ar servisa principu.

Globālās komandu opcijas

Šie mainīgie atbilst opcijām, kas pieejamas Power Apps CLI komandās.

Vides mainīgā vērtība Atbilstošā iespēja Apraksts
PA_CLI_CLOUD --cloud Izvēlas mērķa mākoni. Derīgās vērtības ir:
- public (noklusējums)
- usgov
- usgovhigh
- usgovdod
- china
Vērtības nav jūtīgas pret lielo reģistroloģiju.
PA_CLI_ENVIRONMENT_ID --environment-id Norāda mērķa Power Platform vides ID.

Lietotnes inicializācija

Šie mainīgie nodrošina opcijas uz pa app init.

Vides mainīgā vērtība Atbilstošā iespēja Apraksts
PA_CLI_APP_BUILD_PATH --build-path Norāda būvēšanas izvades direktoriju. Noklusējums ir ./dist.
PA_CLI_APP_DESCRIPTION --description Norāda lietotnes aprakstu.
PA_CLI_APP_DISPLAY_NAME --display-name Norāda lietotnes rādīšanas nosaukumu.
PA_CLI_APP_FILE_ENTRY_POINT --file-entry-point Norāda HTML ieejas punktu būves izvadē. Noklusējums ir index.html.
PA_CLI_APP_TYPE --app-type Norāda lietotnes veidu. Derīgās vērtības ir:
- CodeApp (noklusējums)
- MobileApp
Vērtība tiek saglabāta power.config.json un izmantota kā lietotnes veids, kad lietotne tiek publicēta.
PA_CLI_APP_URL --app-url Norāda lokālo lietotnes URL laikā pa app init. Vērtība tiek saglabāta un localAppUrlpower.config.json kļūst par noklusējuma URL turpmākajām pa app run komandām. Noklusējums ir http://localhost:3000.

Palaist lietotnes

Šie mainīgie nodrošina opcijas uz pa app run.

Vides mainīgā vērtība Atbilstošā iespēja Apraksts
PA_CLI_LOCAL_APP_URL --local-app-url Pārraksta localAppUrl vērtību no pašreizējā power.config.json komandā, nemainot saglabāto konfigurāciju. Ja neviena no vērtībām nav iestatīta, noklusējuma vērtība ir http://localhost:3000.
PA_CLI_PORT --port Norāda portu Power Apps lokālajam hostam. Noklusējums ir 8080.

Koplietošanas lietotnes

Šie mainīgie nodrošina opcijas uz pa app share.

Vides mainīgā vērtība Atbilstošā iespēja Apraksts
PA_CLI_SHARE_ACCESS --access Norāda piekļuves līmeni. Derīgās vērtības ir:
- play (noklusējums)
- edit
PA_CLI_SHARE_PRINCIPAL --principal Norāda vienu vai vairākas komatu atdalītas e-pasta adreses vai Microsoft Entra objektu ID.

Risinājumi, savienotāji un datu avoti

Vides mainīgā vērtība Atbilstošā iespēja Apraksts
PA_CLI_CONNECTION_DISPLAY_NAME --display-name Norāda displeja nosaukumu, veidojot savienojumu.
PA_CLI_CONNECTION_ID --connection-id Norāda savienotāja savienojuma instances ID.
PA_CLI_CONNECTION_REF --connection-ref Norāda savienojuma atsauces loģisko nosaukumu.
PA_CLI_CONNECTION_SEARCH --search Filtri iegūst no pa connection list.
PA_CLI_CONNECTOR --connector Norāda savienotāja ID, piemēram shared_office365users, .
PA_CLI_CONNECTOR_SEARCH --search Filtri iegūst no pa connector list.
PA_CLI_DATASET --dataset Norāda datu kopu, piemēram, SharePoint vietni vai SQL datubāzi.
PA_CLI_DATA_SOURCE_NAME --name Norāda datu avotu, kuru atsvaidzināt vai noņemt.
PA_CLI_ORG_URL --org-url Pārraksta Dataverse organizācijas URL, ko izmanto metadatu iegūšanai, pievienojot datu avotu.
PA_CLI_PROCEDURE --procedure Norāda SQL glabājamu procedūru.
PA_CLI_SOLUTION_ID --solution-id Nosaka risinājumu , pa app pushpa app add data-source, vai pa connection list-references.
PA_CLI_SOLUTION_SEARCH --search Filtri iegūst no pa solution list.
PA_CLI_TABLE --table Norāda tabulas vai savienotāja resursa nosaukumu.

Par komandām, kas pieņem katru opciju, skatiet Power Apps CLI komandu atsauci.

Dataverse API un Power Automate plūsmas

Vides mainīgā vērtība Atbilstošā iespēja Apraksts
PA_CLI_DATAVERSE_API_NAME --api-name Norāda Dataverse darbību vai funkciju, ko pievienot ar pa app add dataverse-api.
PA_CLI_DATAVERSE_API_SEARCH_TERM --search Filtrē Dataverse darbības un funkcijas pēc nosaukuma ar pa app find-dataverse-api.
PA_CLI_FLOW_DATA_SOURCE_NAME --flow-name Norāda plūsmas datu avotu, kas jānoņem no lietotnes ar pa app remove flow
PA_CLI_FLOW_ID --flow-id Norāda Power Automate plūsmu, ko pievienot ar pa app add flow.
PA_CLI_FLOW_SEARCH --search Filtrē pieejamās Power Automate plūsmas pēc nosaukuma arpa app list-flows
PA_CLI_REMOVE_FLOW_ID --flow-id Norāda Power Automate plūsmu, ar kuru noņemtpa app remove flow

Telemetrija un konsoles izvade

Vides mainīgā vērtība Atbilstošā iespēja Apraksts
PA_CLI_CONSOLE_ONLY --console-only Iestatiet vērtību uz true (mazajiem burtiem) ar pa telemetry enable vai pa telemetry disable lai telemetrija rakstītu tikai konsolē un nesūtītu to attālināti.
PA_CLI_OUTPUT_TO_CONSOLE --output-to-console Iestatiet vērtību uz true (mazajiem burtiem) kopā ar pa telemetry enable vai pa telemetry disable lai spoguļotu attālināti nosūtītus telemetrijas notikumus uz konsoli.
PA_CLI_TELEMETRY Neviens Iestatiet vienu no šīm vērtībām, lai atspējotu telemetriju pašreizējam procesam:
- 0
- false
- no
- off
Vērtības ir reģistrjutīgas, un apkārtējās telpas tiek ignorētas.

Par pastāvīgajiem telemetrijas iestatījumiem skatiet sadaļu Pārvaldīt telemetrijas iestatījumus Power Apps CLI.

Standarta vides mainīgie

CLI arī novēro šo standarta vides mainīgo:

Vides mainīgā vērtība Apraksts
NO_COLOR Iestatiet šo mainīgo uz nenulles vērtību, lai atspējotu ANSI krāsu izvadi. Tu vari arī izmantot šo --no-color opciju.