Power Apps CLI ingurune aldagaiak

Erabili ingurune aldagaiak Power Apps CLI autentifikazioa konfiguratzeko eta agindu aukerak eskaintzeko script eta CI/CD pipelineetan. Power Apps CLI bidez definitutako ingurune aldagaiek aurrizki hau PA_CLI_ erabiltzen dute.

Oharra

Ingurumen-aldagaiak balio izendatuak dira, sistema eragileak aplikazioei eskuragarri jartzen dizkienak. Power Apps CLI-k erreferentzia honetan deskribatutako aldagaiak ezagutzen ditu. Ingurumen aldagaiek nola funtzionatzen duten eta nola kudeatu ikasteko, begiratu Ingurumen Aldagaiak.

Erreferentzia honek sistema eragilearen ingurune aldagaiak deskribatzen ditu, Power Apps CLI konfiguratzen dutenak. Aldagai hauek desberdinak dira Power Platform-en soluzio ingurune aldagaietatik, aplikazio batek erabiltzen dituen konfigurazio balioak gordetzen dituztenak.

Komando aukera baterako, CLIak balio bat honela konpontzen du ordena honetan:

  1. Komando-lerroko aukera
  2. Ingurunearen aldagaia
  3. Balio lehenetsia, aukerak balio bat badu
  4. Interaktiboaren promptua, onartzen denean

Komando lerroan emandako aukera batek bere ingurune aldagaiaren gainetik lehentasuna du.

Garrantzitsua da

Ingurune aldagaiek beste prozesu, log edo shell historiaren sekretuak agerian jar ditzakete. Gorde PA_CLI_SP_CLIENT_SECRET zure CI/CD plataformaren sekretu biltegian, ezkutatu logetatik eta ez konprometitu sekretuak iturburu-kontrolera.

Inguruneko aldagaiak ezarri

Hurrengo adibideak Power Apps CLI komando bat exekutatu aurretik ezarri PA_CLI_ENVIRONMENT_ID dira.

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

Ingurune aldagaia eskuragarri mantentzen da terminal saio berean hasitako komandoentzat. Erabili zure maskorraren komando estandarra kentzeko behar ez denean.

Autentifikazioa

Ingurunearen aldagaia Azalpena
PA_CLI_ACCOUNT Kontua zehazten pa auth login du edo pa auth switch.
PA_CLI_SP_CLIENT_ID Microsoft Entra aplikazioaren (bezeroaren) IDa zehazten du zerbitzu nagusiaren autentifikaziorako.
PA_CLI_SP_CLIENT_SECRET Bezeroaren sekretua zehazten du zerbitzu nagusiaren autentifikaziorako.
PA_CLI_SP_TENANT_ID Microsoft Entra direktorioaren (tenant) ID-a zehazten du zerbitzu nagusiaren autentifikaziorako.
PA_CLI_USE_SP_AUTH Ezarri balioa true (txikia) zerbitzu nagusiaren autentifikazioa erabiltzeko.

Hiru PA_CLI_SP_* kredentzial-aldagaiak beharrezkoak dira zerbitzu nagusiaren autentifikazioa hautatzean. Zerbitzu CI=true nagusiaren autentifikazioa ere hautatzen du bateragarritasunagatik, baina erabiltzen PA_CLI_USE_SP_AUTH=true da autentifikazio modua argi egiteko.

Konfigurazio argibideak ikusteko, ikusi Publish Power Apps code apps with a service principle.

Agindu globaleko aukerak

Aldagai hauek Power Apps CLI komandoetan eskuragarri dauden aukerei dagokie.

Ingurunearen aldagaia Dagokion aukera Azalpena
PA_CLI_CLOUD --cloud Helburu hodeia hautatzen du. Balio baliodunak honako hauek dira:
- public (lehenetsia)
- usgov
- usgovhigh
- usgovdod
- china
Balioak maiuskula-gutxi bereizgarriak dira.
PA_CLI_ENVIRONMENT_ID --environment-id Power Platform ingurune ID-a zehazten du.

Aplikazioaren hasiera

Aldagai hauek aukera ematen dizkiete pa app init.

Ingurunearen aldagaia Dagokion aukera Azalpena
PA_CLI_APP_BUILD_PATH --build-path Eraikuntza irteera direktorioa zehazten du. Lehenetsia da ./dist.
PA_CLI_APP_DESCRIPTION --description Aplikazioaren deskribapena zehazten du.
PA_CLI_APP_DISPLAY_NAME --display-name Aplikazioaren bistaratze-izena zehazten du.
PA_CLI_APP_FILE_ENTRY_POINT --file-entry-point HTML sarrera puntua eraikuntzaren emaitzan zehazten du. Lehenetsia da index.html.
PA_CLI_APP_TYPE --app-type Aplikazio mota zehazten du. Balio baliodunak honako hauek dira:
- CodeApp (lehenetsia)
- MobileApp
Balioa gordetzen power.config.json da eta aplikazio mota gisa erabiltzen da aplikazioa argitaratzen denean.
PA_CLI_APP_URL --app-url Tokiko aplikazioaren URLa zehazten du .pa app init Balioa honela localAppUrlpower.config.json gordetzen da eta etorkizuneko pa app run komandoetarako URL lehenetsia bihurtzen da. Lehenetsia da http://localhost:3000.

Exekutatu aplikazioak

Aldagai hauek aukera ematen dizkiete pa app run.

Ingurunearen aldagaia Dagokion aukera Azalpena
PA_CLI_LOCAL_APP_URL --local-app-url Uneko aginduaren power.config.json balioa gainditzen localAppUrl du gordetako konfigurazioa aldatu gabe. Balio biak ez badaude ezarrita, lehenetsia da http://localhost:3000.
PA_CLI_PORT --port Power Apps tokiko ostalariaren portua zehazten du. Lehenetsia da 8080.

Partekatu aplikazioak

Aldagai hauek aukera ematen dizkiete pa app share.

Ingurunearen aldagaia Dagokion aukera Azalpena
PA_CLI_SHARE_ACCESS --access Sarbide maila zehazten du. Balio baliodunak honako hauek dira:
- play (lehenetsia)
- edit
PA_CLI_SHARE_PRINCIPAL --principal Komak bereizita dauden posta helbide bat edo gehiago edo Microsoft Entra objektu IDak zehazten ditu.

Soluzioak, konektoreak eta datu iturriak

Ingurunearen aldagaia Dagokion aukera Azalpena
PA_CLI_CONNECTION_DISPLAY_NAME --display-name Konexio bat sortzean bistaratze-izena zehazten du.
PA_CLI_CONNECTION_ID --connection-id Konektore konexio instantzia ID bat zehazten du.
PA_CLI_CONNECTION_REF --connection-ref Konexio erreferentzia logiko izen bat zehazten du.
PA_CLI_CONNECTION_SEARCH --search Iragazkiak .pa connection list
PA_CLI_CONNECTOR --connector Konektore ID bat zehazten du, adibidez shared_office365users.
PA_CLI_CONNECTOR_SEARCH --search Iragazkiak .pa connector list
PA_CLI_DATASET --dataset Datu-multzo bat zehazten du, hala nola SharePoint gune edo SQL datu-basea.
PA_CLI_DATA_SOURCE_NAME --name Eguneratu edo kendu behar den datu iturria zehazten du.
PA_CLI_ORG_URL --org-url Dataverse antolaketa URLa gainidazten du datu iturri bat gehitzen denean metadatuak berreskuratzeko erabiltzen dena.
PA_CLI_PROCEDURE --procedure SQL biltegiratze prozedura bat zehazten du.
PA_CLI_SOLUTION_ID --solution-id Soluzioa zehazten du pa app push, pa app add data-source, edo pa connection list-references.
PA_CLI_SOLUTION_SEARCH --search Iragazkiak .pa solution list
PA_CLI_TABLE --table Taula edo konektore baliabideen izena zehazten du.

Aukera bakoitza onartzen duten komandoetarako, ikusi Power Apps CLI komando erreferentzia.

Dataverse APIak eta Power Automate fluxuak

Ingurunearen aldagaia Dagokion aukera Azalpena
PA_CLI_DATAVERSE_API_NAME --api-name Data verse-ren ekintza edo funtzioa zehazten du , pa aplikazioarekin gehitu dataverse-api-rekin.
PA_CLI_DATAVERSE_API_SEARCH_TERM --search Dataverse-ko ekintzak eta funtzioak izenaren arabera iragazten ditu pa app find-dataverse-api.
PA_CLI_FLOW_DATA_SOURCE_NAME --flow-name Aplikaziotik kendu behar den fluxu datu iturria zehazten du pa app remove flow
PA_CLI_FLOW_ID --flow-id Power Automate fluxua pa app add flowgehitzeko zehazten du .
PA_CLI_FLOW_SEARCH --search Power Automate erabilgarri dauden fluxuak izenaren arabera iragazten ditu honelapa app list-flows
PA_CLI_REMOVE_FLOW_ID --flow-id Power Automate fluxua zehazten du kentzekopa app remove flow

Telemetria eta kontsola irteera

Ingurunearen aldagaia Dagokion aukera Azalpena
PA_CLI_CONSOLE_ONLY --console-only Ezarri true balioa (letra minuskula) edo pa telemetry disablepa telemetry enable telemetria kontsolara bakarrik idazteko eta ez urrunetik bidaltzeko.
PA_CLI_OUTPUT_TO_CONSOLE --output-to-console Ezarri true balioa (minuskula) edo pa telemetry enablepa telemetry disable kontsolara urrunetik bidalitako telemetria gertaerak islatzeko.
PA_CLI_TELEMETRY Bat ere ez Ezarri balio hauetako bat une honetan dagoen prozesurako telemetria desgaitzeko:
- 0
- false
- no
- off
Balioak maiuskulak ez dira bereizgarriak, eta inguruko espazioak alde batera uzten dira.

Telemetria iraunkorren ezarpenak ikusteko, ikusi Power Apps CLI-rako telemetria ezarpenak kudeatu.

Ingurune aldagai estandarrak

CLI-k ingurune aldagai estandar hau ere behatzen du:

Ingurunearen aldagaia Azalpena
NO_COLOR Aldagai hau ezarri balio ez-huts batean ANSI kolore irteera desgaitzeko. Aukera hori ere erabil --no-color dezakezu.