Power Apps CLI-ympäristömuuttujat

Ympäristömuuttujien avulla voit määrittää Power Apps komentorivikäyttöliittymän todentamisen sekä komentovaihtoehdot komentosarkoissa ja CI/CD-jaksoissa. komentorivikäyttöliittymän Power Apps määrittämät ympäristömuuttujat käyttävät PA_CLI_ etuliitettä.

Note

Ympäristömuuttujat nimetään arvoiksi, jotka käyttöjärjestelmä tuo sovellusten saataville. Power Apps CLI tunnistaa tässä viittauksessa kuvatut muuttujat. Lisätietoja ympäristömuuttujien toiminnasta ja niiden hallinnasta on kohdassa Ympäristön muuttujat.

Tässä viitteessa kuvataan käyttöjärjestelmän ympäristömuuttujat, jotka määrittävät Power Apps komentorivikäyttöliittymän. Nämä muuttujat eroavat Power Platform -ratkaisuympäristön muuttujista, jotka tallentavat sovelluksen käyttämät määritysarvot.

Komentovaihtoehdon osalta komentorivikäyttöliittymä ratkaisee arvon tässä järjestyksessä:

  1. Komentorivivalinta
  2. Ympäristön muuttuja
  3. Oletusarvo, jos asetuksella on yksi
  4. Vuorovaikutteinen kehote, kun sitä tuetaan

Komentorivillä annettu asetus on tärkeämpi kuin vastaava ympäristömuuttuja.

Important

Ympäristömuuttujat voivat paljastaa salaisuuksia muille prosesseille, lokeille tai käyttöliittymähistorialle. Tallenna PA_CLI_SP_CLIENT_SECRET CI/CD-ympäristön salaiseen säilöön, peitä se lokeista etkä vahvista salaisuuksia lähteen hallintaan.

Määritä ympäristömuuttujat

Seuraavat esimerkit on määritetty PA_CLI_ENVIRONMENT_ID ennen Power Apps CLI -komennon suorittamista.

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

Ympäristömuuttuja on edelleen samasta pääteistunnosta aloitettujen komentojen käytettävissä. Käytä liittymän vakiokomentoa sen poistamiseen, kun sitä ei enää tarvita.

Todentaminen

Ympäristön muuttuja Description
PA_CLI_ACCOUNT Määrittää -tai -pa auth loginpa auth switchtilin.
PA_CLI_SP_CLIENT_ID Määrittää palvelun päänimen todentamisen Microsoft Entra sovelluksen (asiakasohjelman) tunnuksen.
PA_CLI_SP_CLIENT_SECRET Määrittää todentamisen asiakassalaisuuden palvelun päänimelle.
PA_CLI_SP_TENANT_ID Määrittää palvelun päänimen todentamisen Microsoft Entra hakemiston (vuokraajan) tunnuksen.
PA_CLI_USE_SP_AUTH Määritä arvoksi true (pienin kirjaimin), jos haluat käyttää palvelun päänimen todentamista.

PA_CLI_SP_Kolme * tunnistetietomuuttujaa vaaditaan, kun palvelun päänimitodentaminen on valittuna. Vaikka CI=true valitset myös palvelun päänimen todentamisen yhteensopivuuden vuoksi, käytä PA_CLI_USE_SP_AUTH=true tätä, jotta todennustila on eksplisiittinen.

Asennusohjeet ovat kohdassa Power Apps koodisovellusten julkaiseminen palvelun päänimellä.

Yleiset komentoasetukset

Nämä muuttujat vastaavat asetuksia, jotka ovat käytettävissä Power Apps CLI-komennoissa.

Ympäristön muuttuja Vastaava asetus Description
PA_CLI_CLOUD --cloud Valitsee kohdepilven. Kelvolliset arvot ovat:
- public (oletus)
- usgov
- usgovhigh
- usgovdod
- china
Arvojen kirjainkoolla ei ole merkitystä.
PA_CLI_ENVIRONMENT_ID --environment-id Määrittää Power Platform -ympäristön kohdetunnuksen.

Sovelluksen valmistelu

Nämä muuttujat antavat -asetukset ön pa app init.

Ympäristön muuttuja Vastaava asetus Description
PA_CLI_APP_BUILD_PATH --build-path Määrittää koontiversiohakemiston. Oletusarvo on ./dist.
PA_CLI_APP_DESCRIPTION --description Määrittää sovelluksen kuvauksen.
PA_CLI_APP_DISPLAY_NAME --display-name Määrittää sovelluksen näyttönimen.
PA_CLI_APP_FILE_ENTRY_POINT --file-entry-point Määrittää HTML-aloituskohdan koontitulosteessa. Oletusarvo on index.html.
PA_CLI_APP_TYPE --app-type Määrittää sovelluksen tyypin. Kelvolliset arvot ovat:
- CodeApp (oletus)
- MobileApp
Arvo tallennetaan -sovellukseen power.config.json , ja sitä käytetään sovellustyyppinä, kun sovellus julkaistaan.
PA_CLI_APP_URL --app-url Määrittää paikallisen sovelluksen URL-osoitteen kohteen aikana pa app init. Arvo tallennetaan in-muodossa localAppUrlpower.config.json , ja siitä tulee tulevien pa app run komentojen oletusarvoinen URL-osoite. Oletusarvo on http://localhost:3000.

Sovellusten suorittaminen

Nämä muuttujat antavat -asetukset ön pa app run.

Ympäristön muuttuja Vastaava asetus Description
PA_CLI_LOCAL_APP_URL --local-app-url Ohittaa nykyisen komennon localAppUrl arvon power.config.json kohteesta muuttamatta tallennettua määritystä. Jos kumpaakaan arvoa ei ole määritetty, oletusarvo on http://localhost:3000.
PA_CLI_PORT --port Määrittää paikallisen Power Apps isännän portin. Oletusarvo on 8080.

Jaa sovelluksia

Nämä muuttujat antavat -asetukset ön pa app share.

Ympäristön muuttuja Vastaava asetus Description
PA_CLI_SHARE_ACCESS --access Määrittää käyttöoikeustason. Kelvolliset arvot ovat:
- play (oletus)
- edit
PA_CLI_SHARE_PRINCIPAL --principal Määrittää yhden tai useamman pilkuin eroteltujen sähköpostiosoitteiden tai Microsoft Entra objektitunnukset.

Ratkaisut, liittimet ja tietolähteet

Ympäristön muuttuja Vastaava asetus Description
PA_CLI_CONNECTION_DISPLAY_NAME --display-name Määrittää näyttönimen yhteyttä luotaessa.
PA_CLI_CONNECTION_ID --connection-id Määrittää liittimen yhteysesiintymän tunnuksen.
PA_CLI_CONNECTION_REF --connection-ref Määrittää yhteysviittauksen loogisen nimen.
PA_CLI_CONNECTION_SEARCH --search Suodattimien tulokset ovat peräisin kohteesta pa connection list.
PA_CLI_CONNECTOR --connector Määrittää liittimen tunnuksen, kuten shared_office365users.
PA_CLI_CONNECTOR_SEARCH --search Suodattimien tulokset ovat peräisin kohteesta pa connector list.
PA_CLI_DATASET --dataset Määrittää tietojoukon, kuten SharePoint sivuston tai SQL-tietokannan.
PA_CLI_DATA_SOURCE_NAME --name Määrittää tietolähteen, joka päivitetään tai poistetaan.
PA_CLI_ORG_URL --org-url Ohittaa Dataverse-organisaation URL-osoitteen, jota käytetään metatietojen noutamiseen tietolähdettä lisättäessä.
PA_CLI_PROCEDURE --procedure Määrittää SQL:n tallennetun toimintosarjan.
PA_CLI_SOLUTION_ID --solution-id Määrittää kohteen , pa app add data-sourcetai pa connection list-referencesratkaisunpa app push.
PA_CLI_SOLUTION_SEARCH --search Suodattimien tulokset ovat peräisin kohteesta pa solution list.
PA_CLI_TABLE --table Määrittää taulukon tai liittimen resurssin nimen.

Jos komento tukee kutakin vaihtoehtoa, katso komentoviittaus Power Apps CLI.

Dataverse-ohjelmointirajapinnat ja Power Automate työnkulut

Ympäristön muuttuja Vastaava asetus Description
PA_CLI_DATAVERSE_API_NAME --api-name Määrittää Dataverse-toiminnon tai -funktion, joka lisätään pa-sovelluksen avulla, ja lisää dataverse-api.
PA_CLI_DATAVERSE_API_SEARCH_TERM --search Suodattaa Dataverse-toiminnot ja -funktiot nimen mukaan toiminnolla pa app find-dataverse-api.
PA_CLI_FLOW_DATA_SOURCE_NAME --flow-name Määrittää työnkulun tietolähteen, joka poistetaan sovelluksesta pa app remove flow
PA_CLI_FLOW_ID --flow-id Määrittää työnkulun Power Automate lisättäväksi kohteen kanssapa app add flow.
PA_CLI_FLOW_SEARCH --search Suodattaa käytettävissä olevat Power Automate työnkulut nimen mukaanpa app list-flows
PA_CLI_REMOVE_FLOW_ID --flow-id Määrittää poistettavan Power Automate työnkulunpa app remove flow

Telemetria ja konsolin tuloste

Ympäristön muuttuja Vastaava asetus Description
PA_CLI_CONSOLE_ONLY --console-only Määritä arvoksi true (pienin kirjaimin) telemetrialla tai pa telemetry disable telemetrian kirjoitus vain konsoliin. Älä lähetä sitä etäyhteydelläpa telemetry enable.
PA_CLI_OUTPUT_TO_CONSOLE --output-to-console Määritä arvoksi true (pienin kirjaimin) konsoliin lähetetyillä telemetriatapahtumilla pa telemetry enable tai pa telemetry disable vastaamaan sitä.
PA_CLI_TELEMETRY Ei mitään Poista telemetria käytöstä nykyisessä prosessissa määrittämällä jokin näistä arvoista:
- 0
- false
- no
- off
Arvoilla ei ole kirjainkokoa eikä ympäröiviä välilyöntejä oteta huomioon.

Katso pysyvät telemetria-asetukset artikkelista Power Apps CLI:n telemetria-asetusten hallinta.

Vakioympäristömuuttujat

Komentorivikäyttöliittymässä noudatetaan myös tätä vakioympäristömuuttujaa:

Ympäristön muuttuja Description
NO_COLOR Jos haluat poistaa ANSI-väritulosteen käytöstä, määritä tälle muuttujalle ei-mikään arvo. Voit myös käyttää - --no-color vaihtoehtoa.
  • Last updated on