Power Apps spremenljivke okolja CLI

S spremenljivkami okolja lahko konfigurirate Power Apps CLI in zagotovite možnosti ukazov v skriptih in cevovodih CI/CD. Spremenljivke okolja, ki jih določa Power Apps CLI, uporabljajo predponoPA_CLI_.

Opomba

Spremenljivke okolja se imenujejo vrednosti, ki jih operacijski sistem daje na voljo aplikacijam. Power Apps CLI prepozna spremenljivke, opisane v tem sklicu. Če želite izvedeti, kako delujejo spremenljivke okolja in kako jih upravljati, glejte o spremenljivkah okolja.

Ta sklic opisuje spremenljivke okolja operacijskega sistema, ki konfigurirajo Power Apps CLI. Te spremenljivke se razlikujejo od spremenljivk okolja rešitve platforme Power Platform, ki shranjujejo vrednosti konfiguracije, ki jih uporablja aplikacija.

Za možnost ukaza CLI razreši vrednost v tem vrstnem redu:

  1. Možnost ukazne vrstice
  2. Spremenljivka okolja
  3. Privzeta vrednost, če ima možnost eno
  4. Interaktivni poziv, ko je podprt

Možnost, ki je na voljo v ukazni vrstici, ima prednost pred ustrezno spremenljivko okolja.

Pomembno

Spremenljivke okolja lahko razkrijejo skrivnosti drugim procesom, dnevnikom ali zgodovini lupine. Shranite PA_CLI_SP_CLIENT_SECRET jo v skrivno shrambo platforme CI/CD, jo zakrijte iz dnevnikov in ne zakrivajte skrivnosti za nadzor vira.

Nastavitev spremenljivk okolja

Ti primeri so nastavljeni PA_CLI_ENVIRONMENT_ID pred zagonom Power Apps CLI.

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

Spremenljivka okolja ostane na voljo za ukaze, ki so se začeli iz iste terminalske seje. Uporabite standardni ukaz lupine, da ga odstranite, ko ga ne potrebujete več.

Preverjanje pristnosti

Spremenljivka okolja Opis
PA_CLI_ACCOUNT Določa račun za ali pa auth loginpa auth switch.
PA_CLI_SP_CLIENT_ID Določa ID Microsoft Entra (odjemalca) za glavno preverjanje pristnosti storitve.
PA_CLI_SP_CLIENT_SECRET Določa skrivnost odjemalca za glavno preverjanje pristnosti storitve.
PA_CLI_SP_TENANT_ID Določa ID Microsoft Entra imenika (najemnika) za glavno preverjanje pristnosti storitve.
PA_CLI_USE_SP_AUTH Nastavite vrednost na (male true črke), če želite uporabiti glavno preverjanje pristnosti storitve.

Če izberete PA_CLI_SP_glavno preverjanje pristnosti storitve, so zahtevane tri spremenljivke * poverilnic. Čeprav izbere CI=true tudi glavno preverjanje pristnosti storitve za združljivost, uporabite za PA_CLI_USE_SP_AUTH=true izrecen način preverjanja pristnosti.

Če želite navodila za nastavitev, glejte Power Apps objaviti programe kode z glavnim ime storitve.

Možnosti globalnega ukaza

Te spremenljivke ustrezajo možnostim, ki so na voljo v Power Apps ukazih CLI.

Spremenljivka okolja Ustrezna možnost Opis
PA_CLI_CLOUD --cloud Izbere ciljni oblak. Veljavne vrednosti so:
- public (privzeto)
- usgov
- usgovhigh
- usgovdod
- china
Vrednosti ne razlikujejo med velikimi in malimi črkami.
PA_CLI_ENVIRONMENT_ID --environment-id Določa ciljni ID okolja platforme Power Platform.

Inicializacija programa

Te spremenljivke možnosti oskrbe za pa app init.

Spremenljivka okolja Ustrezna možnost Opis
PA_CLI_APP_BUILD_PATH --build-path Določa izhodni imenik gradnje. Privzeta vrednost je ./dist.
PA_CLI_APP_DESCRIPTION --description Določa opis programa.
PA_CLI_APP_DISPLAY_NAME --display-name Določa prikazano ime aplikacije.
PA_CLI_APP_FILE_ENTRY_POINT --file-entry-point Določa vstopno točko HTML v izhodu gradnje. Privzeta vrednost je index.html.
PA_CLI_APP_TYPE --app-type Določa vrsto aplikacije. Veljavne vrednosti so:
- CodeApp (privzeto)
- MobileApp
Vrednost je shranjena in power.config.json uporabljena kot vrsta programa, ko je program objavljen.
PA_CLI_APP_URL --app-url Določa lokalni URL programa med pa app init. Vrednost je shranjena kot localAppUrl in power.config.json postane privzeti URL za prihodnje ukaze pa app run . Privzeta vrednost je http://localhost:3000.

Zaženi aplikacije

Te spremenljivke možnosti oskrbe za pa app run.

Spremenljivka okolja Ustrezna možnost Opis
PA_CLI_LOCAL_APP_URL --local-app-url Preglasi vrednost localAppUrl za trenutni power.config.json ukaz, ne da bi spremenil shranjeno konfiguracijo. Če nobena vrednost ni nastavljena, je privzeta vrednost http://localhost:3000.
PA_CLI_PORT --port Določa vrata za Power Apps gostitelja. Privzeta vrednost je 8080.

Skupna raba aplikacij

Te spremenljivke možnosti oskrbe za pa app share.

Spremenljivka okolja Ustrezna možnost Opis
PA_CLI_SHARE_ACCESS --access Določa raven dostopa. Veljavne vrednosti so:
- play (privzeto)
- edit
PA_CLI_SHARE_PRINCIPAL --principal Določa enega ali več e-poštnih naslovov, ločenih z vejico, Microsoft Entra ID-ji predmetov.

Rešitve, povezovalniki in viri podatkov

Spremenljivka okolja Ustrezna možnost Opis
PA_CLI_CONNECTION_DISPLAY_NAME --display-name Določa prikazano ime pri ustvarjanju povezave.
PA_CLI_CONNECTION_ID --connection-id Določa ID primerka povezave povezovalnika.
PA_CLI_CONNECTION_REF --connection-ref Določa logično ime sklica povezave.
PA_CLI_CONNECTION_SEARCH --search Filtrira rezultate iz .pa connection list
PA_CLI_CONNECTOR --connector Določa ID povezovalnika, na primer shared_office365users.
PA_CLI_CONNECTOR_SEARCH --search Filtrira rezultate iz .pa connector list
PA_CLI_DATASET --dataset Določa nabor podatkov, kot je SharePoint mesto ali zbirka podatkov SQL.
PA_CLI_DATA_SOURCE_NAME --name Določa vir podatkov, ki ga želite osvežiti ali odstraniti.
PA_CLI_ORG_URL --org-url Preglasi URL organizacije Dataverse, ki se uporablja za pridobivanje metapodatkov pri dodajanju vira podatkov.
PA_CLI_PROCEDURE --procedure Določa shranjeno proceduro SQL.
PA_CLI_SOLUTION_ID --solution-id Določa rešitev za , pa app pushpa app add data-sourceali pa connection list-references.
PA_CLI_SOLUTION_SEARCH --search Filtrira rezultate iz .pa solution list
PA_CLI_TABLE --table Določa ime vira tabele ali povezovalnika.

Za ukaze, ki sprejemajo posamezno možnost, glejte sklic Power Apps ukaza CLI.

Dataverse API-ji in Power Automate tokov

Spremenljivka okolja Ustrezna možnost Opis
PA_CLI_DATAVERSE_API_NAME --api-name Določa dejanje ali funkcijo Dataverse, ki jo želite dodati z aplikacijo pa, ki doda dataverse-api.
PA_CLI_DATAVERSE_API_SEARCH_TERM --search Filtrira dejanja in funkcije Dataverse po imenu z .pa app find-dataverse-api
PA_CLI_FLOW_DATA_SOURCE_NAME --flow-name Določa vir podatkov o toku, ki ga želite odstraniti iz aplikacije z pa app remove flow
PA_CLI_FLOW_ID --flow-id Določa potek Power Automate, ki ga želite dodati z pa app add flow.
PA_CLI_FLOW_SEARCH --search Filtrira razpoložljive tokove Power Automate po imenu zpa app list-flows
PA_CLI_REMOVE_FLOW_ID --flow-id Določa potek Power Automate, ki ga želite odstraniti zpa app remove flow

Telemetrija in izhod konzole

Spremenljivka okolja Ustrezna možnost Opis
PA_CLI_CONSOLE_ONLY --console-only Nastavite vrednost na (male true črke) s telemetrijo pa telemetry enablepa telemetry disable ali napišite telemetrijo le konzoli in je ne pošljite oddaljeno.
PA_CLI_OUTPUT_TO_CONSOLE --output-to-console Nastavite vrednost na (male true črke) z ali pa telemetry disablepa telemetry enable za zrcaljenje oddaljeno poslanih dogodkov telemetrije v konzolo.
PA_CLI_TELEMETRY Brez Če želite onemogočiti telemetrijo za trenutni proces, nastavite eno od teh vrednosti:
- 0
- false
- no
- off
Vrednosti ne razlikujejo med velikimi in malimi črkami, okoliški presledki pa so prezrti.

Za nastavitve trajne telemetrije glejte Upravljanje nastavitev telemetrije za Power Apps CLI.

Standardne spremenljivke okolja

CLI tudi opozarja na to standardno spremenljivko okolja:

Spremenljivka okolja Opis
NO_COLOR Če želite onemogočiti izhod barve ANSI, nastavite to spremenljivko na vrednost, ki ni veljavna. Uporabite lahko tudi --no-color to možnost.