Power Apps CLI-miljøvariabler

Bruk miljøvariabler til å konfigurere Power Apps CLI-godkjenning og gi kommandoalternativer i skript og CI/CD-datasamlebånd. Miljøvariabler definert av Power Apps CLI bruker prefiksetPA_CLI_.

Note

Miljøvariabler kalles verdier som operativsystemet gjør tilgjengelig for programmer. Power Apps CLI gjenkjenner variablene som er beskrevet i denne referansen. Hvis du vil lære hvordan miljøvariabler fungerer og hvordan du administrerer dem, kan du se om miljøvariabler.

Denne referansen beskriver miljøvariabler for operativsystemet som konfigurerer Power Apps CLI. Disse variablene er forskjellige fra miljøvariabler for Power Platform-løsninger, som lagrer konfigurasjonsverdier som brukes av en app.

For et kommandoalternativ løser CLI en verdi i denne rekkefølgen:

  1. Kommandolinjealternativ
  2. Miljøvariabel
  3. Standardverdi hvis alternativet har én
  4. Interaktiv ledetekst når den støttes

Et alternativ som er angitt på kommandolinjen, har prioritet over den tilsvarende miljøvariabelen.

Important

Miljøvariabler kan vise hemmeligheter for andre prosesser, logger eller skalllogger. Lagre PA_CLI_SP_CLIENT_SECRET i CI/CD-plattformens hemmelige butikk, masker den fra logger, og ikke utfør hemmeligheter til kildekontroll.

Angi miljøvariabler

Eksemplene nedenfor er angitt PA_CLI_ENVIRONMENT_ID før du kjører en Power Apps CLI-kommando.

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

Miljøvariabelen er fortsatt tilgjengelig for kommandoer som er startet fra samme terminaløkt. Bruk skallets standardkommando til å fjerne den når det ikke lenger er nødvendig.

Autentisering

Miljøvariabel Beskrivelse
PA_CLI_ACCOUNT Angir kontoen for pa auth login eller pa auth switch.
PA_CLI_SP_CLIENT_ID Angir Microsoft Entra program-ID for tjenestekontohavergodkjenning.
PA_CLI_SP_CLIENT_SECRET Angir klienthemmeligheten for godkjenning av tjenestekontohaver.
PA_CLI_SP_TENANT_ID Angir Microsoft Entra katalog (leier) ID for tjenestekontohavergodkjenning.
PA_CLI_USE_SP_AUTH Angi verdien til true (små bokstaver) for å bruke godkjenning av tjenestekontohaver.

De tre PA_CLI_SP_* legitimasjonsvariablene kreves når tjenestekontohavergodkjenning er valgt. Selv om CI=true du også velger tjenestekontohavergodkjenning for kompatibilitet, kan du bruke PA_CLI_USE_SP_AUTH=true til å gjøre godkjenningsmodusen eksplisitt.

Hvis du vil ha instruksjoner for konfigurasjon, kan du se Publiser Power Apps kodeapper med en tjenestekontohaver.

Globale kommandoalternativer

Disse variablene tilsvarer alternativer som er tilgjengelige på tvers av Power Apps CLI-kommandoer.

Miljøvariabel Tilsvarende alternativ Beskrivelse
PA_CLI_CLOUD --cloud Velger målskyen. Gyldige verdier er:
- public (standard)
- usgov
- usgovhigh
- usgovdod
- china
Verdier skiller ikke mellom store og små bokstaver.
PA_CLI_ENVIRONMENT_ID --environment-id Angir miljø-ID-en for mål for Power Platform.

App-initialisering

Disse variablene leverer alternativer til pa app init.

Miljøvariabel Tilsvarende alternativ Beskrivelse
PA_CLI_APP_BUILD_PATH --build-path Angir build-utdatakatalogen. Standardverdien er ./dist.
PA_CLI_APP_DESCRIPTION --description Angir appbeskrivelsen.
PA_CLI_APP_DISPLAY_NAME --display-name Angir visningsnavnet for appen.
PA_CLI_APP_FILE_ENTRY_POINT --file-entry-point Angir HTML-inngangspunktet i build-utdataene. Standardverdien er index.html.
PA_CLI_APP_TYPE --app-type Angir apptypen. Gyldige verdier er:
- CodeApp (standard)
- MobileApp
Verdien lagres i power.config.json og brukes som apptype når appen publiseres.
PA_CLI_APP_URL --app-url Angir url-adressen for den lokale appen under pa app init. Verdien lagres som localAppUrl i power.config.json og blir standard URL-adresse for fremtidige pa app run kommandoer. Standardverdien er http://localhost:3000.

Kjør apper

Disse variablene leverer alternativer til pa app run.

Miljøvariabel Tilsvarende alternativ Beskrivelse
PA_CLI_LOCAL_APP_URL --local-app-url Overstyrer localAppUrl verdien fra power.config.json for gjeldende kommando uten å endre den lagrede konfigurasjonen. Hvis ingen av verdiene er angitt, er http://localhost:3000standardverdien .
PA_CLI_PORT --port Angir porten for den Power Apps lokale verten. Standardverdien er 8080.

Dele apper

Disse variablene leverer alternativer til pa app share.

Miljøvariabel Tilsvarende alternativ Beskrivelse
PA_CLI_SHARE_ACCESS --access Angir tilgangsnivået. Gyldige verdier er:
- play (standard)
- edit
PA_CLI_SHARE_PRINCIPAL --principal Angir én eller flere kommadelte e-postadresser eller Microsoft Entra objekt-ID-er.

Løsninger, koblinger og datakilder

Miljøvariabel Tilsvarende alternativ Beskrivelse
PA_CLI_CONNECTION_DISPLAY_NAME --display-name Angir visningsnavnet når du oppretter en tilkobling.
PA_CLI_CONNECTION_ID --connection-id Angir en tilkoblingsforekomst-ID for tilkobling.
PA_CLI_CONNECTION_REF --connection-ref Angir et logisk navn for tilkoblingsreferanse.
PA_CLI_CONNECTION_SEARCH --search Filtrerer resultater fra pa connection list.
PA_CLI_CONNECTOR --connector Angir en koblings-ID, for eksempel shared_office365users.
PA_CLI_CONNECTOR_SEARCH --search Filtrerer resultater fra pa connector list.
PA_CLI_DATASET --dataset Angir et datasett, for eksempel et SharePoint område eller en SQL-database.
PA_CLI_DATA_SOURCE_NAME --name Angir datakilden som skal oppdateres eller fjernes.
PA_CLI_ORG_URL --org-url Overstyrer nettadressen til den dataverse organisasjonen som brukes til å hente metadata når du legger til en datakilde.
PA_CLI_PROCEDURE --procedure Angir en SQL-lagret prosedyre.
PA_CLI_SOLUTION_ID --solution-id Angir løsningen for pa app push, pa app add data-sourceeller pa connection list-references.
PA_CLI_SOLUTION_SEARCH --search Filtrerer resultater fra pa solution list.
PA_CLI_TABLE --table Angir et tabell- eller koblingsressursnavn.

Hvis du vil se kommandoene som godtar hvert alternativ, kan du se kommandoreferansen Power Apps CLI.

Dataverse API-er og Power Automate flyter

Miljøvariabel Tilsvarende alternativ Beskrivelse
PA_CLI_DATAVERSE_API_NAME --api-name Angir datavershandlingen eller funksjonen som skal legges til med pa-appen, og legg til datavers-api.
PA_CLI_DATAVERSE_API_SEARCH_TERM --search Filtrerer dataverse handlinger og funksjoner etter navn med pa app find-dataverse-api.
PA_CLI_FLOW_DATA_SOURCE_NAME --flow-name Angir flytdatakilden som skal fjernes fra appen med pa app remove flow
PA_CLI_FLOW_ID --flow-id Angir Power Automate flyten som skal legges til med pa app add flow.
PA_CLI_FLOW_SEARCH --search Filtrerer tilgjengelige Power Automate flyter etter navn medpa app list-flows
PA_CLI_REMOVE_FLOW_ID --flow-id Angir Power Automate flyten som skal fjernes medpa app remove flow

Telemetri og konsollutdata

Miljøvariabel Tilsvarende alternativ Beskrivelse
PA_CLI_CONSOLE_ONLY --console-only Angi verdien til true (små bokstaver) med pa telemetry enable eller pa telemetry disable skrive telemetri bare til konsollen og ikke sende den eksternt.
PA_CLI_OUTPUT_TO_CONSOLE --output-to-console Angi verdien til true (små bokstaver) med pa telemetry enable eller pa telemetry disable for å speile eksternt sendte telemetrihendelser til konsollen.
PA_CLI_TELEMETRY Ingen Angi en av disse verdiene for å deaktivere telemetri for gjeldende prosess:
- 0
- false
- no
- off
Verdier skiller mellom store og små bokstaver, og omkringliggende mellomrom ignoreres.

Hvis du vil ha vedvarende telemetriinnstillinger, kan du se Behandle telemetriinnstillinger for Power Apps CLI.

Standard miljøvariabler

CLI observerer også denne standard miljøvariabelen:

Miljøvariabel Beskrivelse
NO_COLOR Angi denne variabelen til en verdi som ikke er gyldig for å deaktivere ANSI-fargeutdata. Du kan også bruke --no-color alternativet.
  • Last updated on