cli környezeti változók Power Apps

Környezeti változók használatával konfigurálhatja Power Apps CLI-hitelesítést, és parancsbeállításokat adhat meg szkriptekben és CI/CD-folyamatokban. A Power Apps parancssori felület által definiált környezeti változók az PA_CLI_ előtagot használják.

Note

A környezeti változók nevesített értékek, amelyeket az operációs rendszer elérhetővé tesz az alkalmazások számára. Power Apps parancssori felület felismeri az ebben a hivatkozásban leírt változókat. A környezeti változók működéséről és kezelésük módjáról a környezeti változókról olvashat.

Ez a hivatkozás az Power Apps parancssori felületét konfiguráló operációsrendszer-környezeti változókat ismerteti. Ezek a változók eltérnek a Power Platform megoldás környezeti változóitól, amelyek az alkalmazás által használt konfigurációs értékeket tárolják.

Parancsbeállítás esetén a parancssori felület a következő sorrendben old fel egy értéket:

  1. Parancssori lehetőség
  2. Környezet változó
  3. Alapértelmezett érték, ha a beállítás rendelkezik
  4. Interaktív üzenet, ha támogatott

A parancssorban megadott beállítás elsőbbséget élvez a megfelelő környezeti változóval szemben.

Important

A környezeti változók titkos kulcsokat tehetnek közzé más folyamatok, naplók vagy rendszerhéjelőzmények számára. Tárolja PA_CLI_SP_CLIENT_SECRET a CI-/CD-platform titkos tárolójában, maszkolja a naplókból, és ne véglegesítse a titkos kulcsokat a forráskezeléshez.

Környezeti változók beállítása

Az alábbi példák Power Apps parancssori felületi parancs futtatása előtt állíthatók bePA_CLI_ENVIRONMENT_ID.

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

A környezeti változó továbbra is elérhető marad az ugyanazon terminál munkamenetből indított parancsok számára. Ha már nincs rá szükség, távolítsa el a rendszerhéj szabványos parancsát.

Authentication

Környezet változó Description
PA_CLI_ACCOUNT Megadja a fiók vagy a pa auth loginpa auth switch.
PA_CLI_SP_CLIENT_ID Megadja a szolgáltatásnév-hitelesítéshez tartozó Microsoft Entra alkalmazás (ügyfél) azonosítóját.
PA_CLI_SP_CLIENT_SECRET Megadja a szolgáltatásnév-hitelesítés ügyfélkulcsát.
PA_CLI_SP_TENANT_ID Megadja a szolgáltatásnév-hitelesítés Microsoft Entra címtár (bérlő) azonosítóját.
PA_CLI_USE_SP_AUTH Állítsa az értéket true (kisbetűsre) a szolgáltatásnév-hitelesítés használatához.

A szolgáltatásnév-hitelesítés kiválasztásakor a három PA_CLI_SP_* hitelesítőadat-változóra van szükség. Bár CI=true a kompatibilitás érdekében a szolgáltatásnév hitelesítését is kiválasztja, PA_CLI_USE_SP_AUTH=true a hitelesítési mód explicitvá tétele.

A beállítási utasításokért lásd: Power Apps kódalkalmazások közzététele szolgáltatásnévvel.

Globális parancsbeállítások

Ezek a változók megfelelnek az Power Apps parancssori felület parancsai között elérhető beállításoknak.

Környezet változó Megfelelő beállítás Description
PA_CLI_CLOUD --cloud Kiválasztja a célfelhőt. Az érvényes értékek a következők:
- public (alapértelmezett)
- usgov
- usgovhigh
- usgovdod
- china
Az értékek nem érzékenyek a kis- és nagybetűkre.
PA_CLI_ENVIRONMENT_ID --environment-id Megadja a power platform célkörnyezet-azonosítóját.

Alkalmazás inicializálása

Ezek a változók a .pa app init

Környezet változó Megfelelő beállítás Description
PA_CLI_APP_BUILD_PATH --build-path A build kimeneti könyvtárát adja meg. Az alapértelmezett érték a ./dist.
PA_CLI_APP_DESCRIPTION --description Megadja az alkalmazás leírását.
PA_CLI_APP_DISPLAY_NAME --display-name Megadja az alkalmazás megjelenítendő nevét.
PA_CLI_APP_FILE_ENTRY_POINT --file-entry-point Megadja a HTML-belépési pontot a buildkimenetben. Az alapértelmezett érték a index.html.
PA_CLI_APP_TYPE --app-type Az alkalmazás típusát adja meg. Az érvényes értékek a következők:
- CodeApp (alapértelmezett)
- MobileApp
Az érték az alkalmazás közzétételekor alkalmazástípusként lesz mentve power.config.json és használva.
PA_CLI_APP_URL --app-url A helyi alkalmazás URL-címét adja meg a alatt pa app init. Az érték a következő módon lesz mentve localAppUrlpower.config.json , és a jövőbeli pa app run parancsok alapértelmezett URL-címe lesz. Az alapértelmezett érték a http://localhost:3000.

Alkalmazások futtatása

Ezek a változók a .pa app run

Környezet változó Megfelelő beállítás Description
PA_CLI_LOCAL_APP_URL --local-app-url Felülbírálja az localAppUrl aktuális parancs értékét power.config.json a mentett konfiguráció módosítása nélkül. Ha egyik érték sem van beállítva, az alapértelmezett érték a .http://localhost:3000
PA_CLI_PORT --port A Power Apps helyi gazdagép portjának megadása. Az alapértelmezett érték a 8080.

Alkalmazások megosztása

Ezek a változók a .pa app share

Környezet változó Megfelelő beállítás Description
PA_CLI_SHARE_ACCESS --access Megadja a hozzáférési szintet. Az érvényes értékek a következők:
- play (alapértelmezett)
- edit
PA_CLI_SHARE_PRINCIPAL --principal Egy vagy több vesszővel elválasztott e-mail-címet vagy Microsoft Entra objektumazonosítót ad meg.

Megoldások, összekötők és adatforrások

Környezet változó Megfelelő beállítás Description
PA_CLI_CONNECTION_DISPLAY_NAME --display-name Megadja a megjelenítendő nevet a kapcsolat létrehozásakor.
PA_CLI_CONNECTION_ID --connection-id Az összekötő kapcsolatpéldány-azonosítóját adja meg.
PA_CLI_CONNECTION_REF --connection-ref Megadja a kapcsolathivatkozás logikai nevét.
PA_CLI_CONNECTION_SEARCH --search A szűrők eredményei a következőből származnak pa connection list: .
PA_CLI_CONNECTOR --connector Az összekötő azonosítóját adja meg, például shared_office365users.
PA_CLI_CONNECTOR_SEARCH --search A szűrők eredményei a következőből származnak pa connector list: .
PA_CLI_DATASET --dataset Adatkészletet, például SharePoint helyet vagy SQL-adatbázist ad meg.
PA_CLI_DATA_SOURCE_NAME --name Megadja a frissíteni vagy eltávolítani kívánt adatforrást.
PA_CLI_ORG_URL --org-url Felülbírálja a dataverse-szervezet adatforrás hozzáadásakor a metaadatok lekéréséhez használt URL-címét.
PA_CLI_PROCEDURE --procedure Sql-alapú tárolt eljárást határoz meg.
PA_CLI_SOLUTION_ID --solution-id Megadja az pa app push, pa app add data-sourcevagy pa connection list-references.
PA_CLI_SOLUTION_SEARCH --search A szűrők eredményei a következőből származnak pa solution list: .
PA_CLI_TABLE --table Tábla- vagy összekötő-erőforrásnevet ad meg.

Az egyes beállításokat elfogadó parancsokért tekintse meg a Power Apps parancssori felület parancsainak hivatkozását.

Dataverse API-k és Power Automate folyamatok

Környezet változó Megfelelő beállítás Description
PA_CLI_DATAVERSE_API_NAME --api-name Megadja a Dataverse-műveletet vagy függvényt, amely hozzáadható a pa-alkalmazás add dataverse-api-jával.
PA_CLI_DATAVERSE_API_SEARCH_TERM --search A Dataverse-műveleteket és -függvényeket név szerint szűri a következővel pa app find-dataverse-api: .
PA_CLI_FLOW_DATA_SOURCE_NAME --flow-name Megadja az alkalmazásból eltávolítandó adatfolyam-adatforrást a következővel: pa app remove flow
PA_CLI_FLOW_ID --flow-id A hozzáadandó Power Automate folyamatot adja megpa app add flow.
PA_CLI_FLOW_SEARCH --search Az elérhető Power Automate folyamatok szűrése név szerint a következővel:pa app list-flows
PA_CLI_REMOVE_FLOW_ID --flow-id Megadja az eltávolítandó Power Automate folyamatotpa app remove flow

Telemetria és konzolkimenet

Környezet változó Megfelelő beállítás Description
PA_CLI_CONSOLE_ONLY --console-only Állítsa be az értéket true (kisbetűs) pa telemetry enable értékre, és pa telemetry disable csak a konzolra írja a telemetriát, és ne küldje el távolról.
PA_CLI_OUTPUT_TO_CONSOLE --output-to-console Állítsa be az értéket true (kisbetűsre) a konzolra távolról küldött telemetriai események tükrözéséhez pa telemetry enable vagy pa telemetry disable tükrözéséhez.
PA_CLI_TELEMETRY Nincs Az alábbi értékek egyikének beállításával tiltsa le az aktuális folyamat telemetriáját:
- 0
- false
- no
- off
Az értékek nem érzékenyek a kis- és nagybetűkre, a környező szóközöket pedig figyelmen kívül hagyja a rendszer.

Az állandó telemetriai beállításokról a Power Apps parancssori felület telemetriai beállításainak kezelése című témakörben olvashat.

Standard környezeti változók

A parancssori felület ezt a szabványos környezeti változót is megfigyeli:

Környezet változó Description
NO_COLOR Állítsa ezt a változót egy nem megfelelő értékre az ANSI-színkimenet letiltásához. Ezt a lehetőséget is használhatja --no-color .