Power Apps premenné prostredia CLI

Použite premenné prostredia na konfiguráciu Power Apps overovania CLI a poskytovanie možností príkazov v skriptoch a kanáloch CI/CD. Premenné prostredia definované Power Apps CLI používajú predponuPA_CLI_.

Note

Premenné prostredia sú pomenované hodnoty, ktoré operačný systém sprístupňuje aplikáciám. Power Apps CLI rozpozná premenné popísané v tomto odkaze. Informácie o tom, ako fungujú premenné prostredia a ako ich spravovať, nájdete v téme Premenné prostredia.

Tento odkaz popisuje premenné prostredia operačného systému, ktoré konfigurujú Power Apps CLI. Tieto premenné sa líšia od premenných prostredia riešenia Power Platform, ktoré ukladajú hodnoty konfigurácie používané aplikáciou.

Pri možnosti príkazu vyrieši CLI hodnotu v tomto poradí:

  1. Možnosť príkazového riadka
  2. Premenná prostredia
  3. Predvolená hodnota, ak má možnosť jednu
  4. Interaktívna výzva v prípade podpory

Možnosť zadaná v príkazovom riadku má prednosť pred zodpovedajúcou premennou prostredia.

Important

Premenné prostredia môžu sprístupniť tajné kódy pre iné procesy, denníky alebo históriu prostredí. Ukladajte v ukladaní PA_CLI_SP_CLIENT_SECRET tajných kódov platformy CI/CD, maskujte ich z denníkov a neodpisujte tajné kódy k ovládaniu zdroja.

Nastavenie premenných prostredia

Nasledujúce príklady sa nastavili PA_CLI_ENVIRONMENT_ID pred spustením príkazu Power Apps CLI.

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

Premenná prostredia zostane k dispozícii pre príkazy spustené z tej istej terminálovej relácie. Ak už prostredie nepotrebujete, použite štandardný príkaz svojho používateľského prostredia na jeho odstránenie.

Overovanie

Premenná prostredia Description
PA_CLI_ACCOUNT Určuje konto pre pa auth login alebo pa auth switch.
PA_CLI_SP_CLIENT_ID Určuje ID aplikácie Microsoft Entra (klienta) pre overovanie objektom služby.
PA_CLI_SP_CLIENT_SECRET Určuje tajný kľúč klienta na overenie objektom služby.
PA_CLI_SP_TENANT_ID Určuje ID adresára Microsoft Entra (nájomník) pre overovanie objektu služby.
PA_CLI_USE_SP_AUTH Nastavte hodnotu na true (malé) na používanie overovania objektom služby.

Pri výbere overovania objektom služby sa vyžadujú tri PA_CLI_SP_* premenné poverení. Aj keď CI=true na účely kompatibility vyberá aj overovanie objektom služby, použite PA_CLI_USE_SP_AUTH=true príkaz , aby bol režim overenia explicitný.

Pokyny na nastavenie nájdete v téme Publikovanie aplikácií Power Apps kódu pomocou objektu služby.

Možnosti globálnych príkazov

Tieto premenné zodpovedajú možnostiam dostupným v rámci príkazov rozhrania Power Apps CLI.

Premenná prostredia Zodpovedajúca možnosť Description
PA_CLI_CLOUD --cloud Vyberie cieľový cloud. Platné hodnoty sú:
- public (predvolené)
- usgov
- usgovhigh
- usgovdod
- china
V hodnotách sa nerozlišujú malé a veľké písmená.
PA_CLI_ENVIRONMENT_ID --environment-id Určuje cieľové ID prostredia Power Platformy.

Inicializácia aplikácie

Tieto premenné poskytujú možnosti pre pa app initmožnosť .

Premenná prostredia Zodpovedajúca možnosť Description
PA_CLI_APP_BUILD_PATH --build-path Určuje výstupný adresár zostavy. Predvolená hodnota je ./dist.
PA_CLI_APP_DESCRIPTION --description Určuje popis aplikácie.
PA_CLI_APP_DISPLAY_NAME --display-name Určuje zobrazovaný názov aplikácie.
PA_CLI_APP_FILE_ENTRY_POINT --file-entry-point Určuje vstupný bod HTML vo výstupe zostavy. Predvolená hodnota je index.html.
PA_CLI_APP_TYPE --app-type Určuje typ aplikácie. Platné hodnoty sú:
- CodeApp (predvolené)
- MobileApp
Hodnota sa uloží power.config.json v a použije sa ako typ aplikácie pri publikovaní aplikácie.
PA_CLI_APP_URL --app-url Určuje URL adresu lokálnej aplikácie počas služby pa app init. Hodnota sa uloží ako localAppUrl in power.config.json a stane sa predvolenou URL adresou pre budúce pa app run príkazy. Predvolená hodnota je http://localhost:3000.

Spúšťanie aplikácií

Tieto premenné poskytujú možnosti pre pa app runmožnosť .

Premenná prostredia Zodpovedajúca možnosť Description
PA_CLI_LOCAL_APP_URL --local-app-url Prepíše localAppUrl hodnotu power.config.json pre aktuálny príkaz bez zmeny uloženej konfigurácie. Ak nie je nastavená žiadna hodnota, predvolená hodnota je http://localhost:3000.
PA_CLI_PORT --port Určuje port pre Power Apps lokálneho hostiteľa. Predvolená hodnota je 8080.

Zdieľanie aplikácií

Tieto premenné poskytujú možnosti pre pa app sharemožnosť .

Premenná prostredia Zodpovedajúca možnosť Description
PA_CLI_SHARE_ACCESS --access Určuje úroveň prístupu. Platné hodnoty sú:
- play (predvolené)
- edit
PA_CLI_SHARE_PRINCIPAL --principal Určuje jednu alebo viacero e-mailových adries oddelených čiarkou alebo Microsoft Entra ID objektov.

Riešenia, konektory a zdroje údajov

Premenná prostredia Zodpovedajúca možnosť Description
PA_CLI_CONNECTION_DISPLAY_NAME --display-name Určuje zobrazovaný názov pri vytváraní pripojenia.
PA_CLI_CONNECTION_ID --connection-id Určuje ID inštancie pripojenia konektora.
PA_CLI_CONNECTION_REF --connection-ref Určuje logický názov odkazu na pripojenie.
PA_CLI_CONNECTION_SEARCH --search Filtre sú výsledkom .pa connection list
PA_CLI_CONNECTOR --connector Určuje ID konektora, napríklad shared_office365users.
PA_CLI_CONNECTOR_SEARCH --search Filtre sú výsledkom .pa connector list
PA_CLI_DATASET --dataset Určuje množinu údajov, napríklad SharePoint lokalitu alebo databázu SQL.
PA_CLI_DATA_SOURCE_NAME --name Určuje zdroj údajov, ktorý sa má obnoviť alebo odstrániť.
PA_CLI_ORG_URL --org-url Prepíše URL adresu organizácie Dataverse, ktorá sa používa na načítanie metaúdajov pri pridávaní zdroja údajov.
PA_CLI_PROCEDURE --procedure Určuje uloženú procedúru SQL.
PA_CLI_SOLUTION_ID --solution-id Určuje riešenie pre pa app push, pa app add data-sourcealebo pa connection list-references.
PA_CLI_SOLUTION_SEARCH --search Filtre sú výsledkom .pa solution list
PA_CLI_TABLE --table Určuje názov zdroja tabuľky alebo konektora.

Príkazy, ktoré prijímajú jednotlivé možnosti, nájdete v článku Referenčné informácie k príkazom rozhrania Power Apps CLI.

Rozhrania API a postupy Power Automate Dataverse

Premenná prostredia Zodpovedajúca možnosť Description
PA_CLI_DATAVERSE_API_NAME --api-name Určuje akciu alebo funkciu Dataverse, ktoré sa majú pridať s aplikáciou pa pridať dataverse-api.
PA_CLI_DATAVERSE_API_SEARCH_TERM --search Filtruje akcie a funkcie Dataverse podľa názvu pomocou .pa app find-dataverse-api
PA_CLI_FLOW_DATA_SOURCE_NAME --flow-name Určuje zdroj údajov toku údajov, ktorý sa má odstrániť z aplikácie pomocou pa app remove flow
PA_CLI_FLOW_ID --flow-id Určuje Power Automate postup, ktorý sa má pridať s pa app add flow.
PA_CLI_FLOW_SEARCH --search Filtruje dostupné Power Automate postupy podľa názvu pomocoupa app list-flows
PA_CLI_REMOVE_FLOW_ID --flow-id Určuje Power Automate tok, ktorý sa má odstrániť pomocoupa app remove flow

Výstup z telemetrie a konzoly

Premenná prostredia Zodpovedajúca možnosť Description
PA_CLI_CONSOLE_ONLY --console-only Nastavte hodnotu na true (malé písmená) s telemetriou pa telemetry enable alebo pa telemetry disable na zápis iba do konzoly a nie na vzdialené odoslanie.
PA_CLI_OUTPUT_TO_CONSOLE --output-to-console Nastavte hodnotu na true (malé písmená) so pa telemetry enable vzdialene odoslanými telemetrické udalosti do konzoly alebo pa telemetry disable na zrkadlenie.
PA_CLI_TELEMETRY Žiadne Ak chcete zakázať telemetriu pre aktuálny proces, nastavte jednu z týchto hodnôt:
- 0
- false
- no
- off
Hodnoty nerozlišujú malé a veľké písmená a okolité medzery sa ignorujú.

Ak chcete zobraziť trvalé nastavenia telemetrie, prečítajte si tému Spravovanie nastavení telemetrie pre Power Apps CLI.

Štandardné premenné prostredia

Cli tiež podotýka túto štandardnú premennú prostredia:

Premenná prostredia Description
NO_COLOR Ak chcete zakázať výstup farby ANSI, nastavte túto premennú na hodnotu nonempty. Môžete použiť aj túto --no-color možnosť.