Power Apps miljøvariabler for kommandolinjegrænsefladen

Brug miljøvariabler til at konfigurere Power Apps CLI-godkendelse og angive kommandoindstillinger i scripts og CI/CD-pipelines. Miljøvariabler, der er defineret af Power Apps kommandolinjegrænsefladen, bruger præfiksetPA_CLI_.

Bemærkning

Miljøvariabler kaldes værdier, som operativsystemet gør tilgængelige for programmer. Power Apps CLI genkender de variabler, der er beskrevet i denne reference. Hvis du vil vide, hvordan miljøvariabler fungerer, og hvordan du administrerer dem, skal du se om miljøvariabler.

Denne reference beskriver miljøvariabler for operativsystemet, der konfigurerer kommandolinjegrænsefladen for Power Apps. Disse variabler adskiller sig fra miljøvariabler for Power Platform-løsningen, som gemmer konfigurationsværdier, der bruges af en app.

For en kommandoindstilling fortolker kommandolinjegrænsefladen en værdi i denne rækkefølge:

  1. Kommandolinjeindstilling
  2. Miljøvariabel
  3. Standardværdi, hvis indstillingen har en
  4. Interaktiv prompt, når den understøttes

En indstilling, der er angivet på kommandolinjen, har forrang frem for den tilsvarende miljøvariabel.

Vigtigt!

Miljøvariabler kan vise hemmeligheder for andre processer, logge eller shellhistorik. Gem PA_CLI_SP_CLIENT_SECRET i din CI/CD-platforms hemmelige lager, maskér det fra logge, og bekræft ikke hemmeligheder til kildestyring.

Indstil miljøvariabler

Følgende eksempler angivesPA_CLI_ENVIRONMENT_ID, før du kører en Power Apps kommandolinjegrænsefladekommando.

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

Miljøvariablen forbliver tilgængelig for kommandoer, der er startet fra den samme terminalsession. Brug din shells standardkommando til at fjerne den, når den ikke længere er nødvendig.

Godkendelse

Miljøvariabel Beskrivelse
PA_CLI_ACCOUNT Angiver kontoen for pa auth login eller pa auth switch.
PA_CLI_SP_CLIENT_ID Angiver det Microsoft Entra program-id (klient) for godkendelse af tjenesteprincipal.
PA_CLI_SP_CLIENT_SECRET Angiver klienthemmeligheden for godkendelse af tjenesteprincipal.
PA_CLI_SP_TENANT_ID Angiver det Microsoft Entra mappe-id (lejer) for godkendelse af tjenesteprincipal.
PA_CLI_USE_SP_AUTH Angiv værdien til true (med små bogstaver) for at bruge godkendelse af tjenesteprincipal.

De tre PA_CLI_SP_* legitimationsoplysninger er påkrævet, når godkendelse af tjenesteprincipal er valgt. Selvom CI=true du også vælger godkendelse af tjenesteprincipal for kompatibilitet, skal du bruge PA_CLI_USE_SP_AUTH=true til at gøre godkendelsestilstanden eksplicit.

Du kan finde konfigurationsvejledninger under Publicer Power Apps kodeapps med en tjenesteprincipal.

Globale kommandoindstillinger

Disse variabler svarer til indstillinger, der er tilgængelige på tværs af Power Apps kommandolinjegrænsefladekommandoer.

Miljøvariabel Tilsvarende indstilling Beskrivelse
PA_CLI_CLOUD --cloud Vælger destinationsskyen. Gyldige værdier er:
- public (standard)
- usgov
- usgovhigh
- usgovdod
- china
Der skelnes ikke mellem store og små bogstaver i værdier.
PA_CLI_ENVIRONMENT_ID --environment-id Angiver destinationen for Power Platform-miljø-id'et.

Appinitialisering

Disse variabler leverer indstillinger til pa app init.

Miljøvariabel Tilsvarende indstilling Beskrivelse
PA_CLI_APP_BUILD_PATH --build-path Angiver mappen med buildoutput. Standarden er ./dist.
PA_CLI_APP_DESCRIPTION --description Angiver appbeskrivelsen.
PA_CLI_APP_DISPLAY_NAME --display-name Angiver det viste navn på appen.
PA_CLI_APP_FILE_ENTRY_POINT --file-entry-point Angiver HTML-indgangspunktet i buildoutputtet. Standarden er index.html.
PA_CLI_APP_TYPE --app-type Angiver apptypen. Gyldige værdier er:
- CodeApp (standard)
- MobileApp
Værdien gemmes i power.config.json og bruges som apptype, når appen udgives.
PA_CLI_APP_URL --app-url Angiver URL-adressen til den lokale app under pa app init. Værdien gemmes som localAppUrl i power.config.json og bliver standard-URL-adressen for fremtidige pa app run kommandoer. Standarden er http://localhost:3000.

Kør apps

Disse variabler leverer indstillinger til pa app run.

Miljøvariabel Tilsvarende indstilling Beskrivelse
PA_CLI_LOCAL_APP_URL --local-app-url Tilsidesætter værdien localAppUrl fra power.config.json for den aktuelle kommando uden at ændre den gemte konfiguration. Hvis ingen af værdierne er angivet, er http://localhost:3000standarden .
PA_CLI_PORT --port Angiver porten for den Power Apps lokale vært. Standarden er 8080.

Del apps

Disse variabler leverer indstillinger til pa app share.

Miljøvariabel Tilsvarende indstilling Beskrivelse
PA_CLI_SHARE_ACCESS --access Angiver adgangsniveauet. Gyldige værdier er:
- play (standard)
- edit
PA_CLI_SHARE_PRINCIPAL --principal Angiver en eller flere kommaseparerede mailadresser eller Microsoft Entra objekt-id'er.

Løsninger, connectors og datakilder

Miljøvariabel Tilsvarende indstilling Beskrivelse
PA_CLI_CONNECTION_DISPLAY_NAME --display-name Angiver det viste navn, når der oprettes en forbindelse.
PA_CLI_CONNECTION_ID --connection-id Angiver et forekomst-id for forbindelsesforbindelsen.
PA_CLI_CONNECTION_REF --connection-ref Angiver et logisk navn for forbindelsesreferencen.
PA_CLI_CONNECTION_SEARCH --search Filtrerer resultater fra pa connection list.
PA_CLI_CONNECTOR --connector Angiver et connector-id, f.eks shared_office365users. .
PA_CLI_CONNECTOR_SEARCH --search Filtrerer resultater fra pa connector list.
PA_CLI_DATASET --dataset Angiver et datasæt, f.eks. et SharePoint websted eller en SQL-database.
PA_CLI_DATA_SOURCE_NAME --name Angiver den datakilde, der skal opdateres eller fjernes.
PA_CLI_ORG_URL --org-url Tilsidesætter den URL-adresse til Dataverse-organisationen, der bruges til at hente metadata, når du tilføjer en datakilde.
PA_CLI_PROCEDURE --procedure Angiver en lagret SQL-procedure.
PA_CLI_SOLUTION_ID --solution-id Angiver 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 Angiver navnet på en tabel- eller connectorressource.

Du kan se de kommandoer, der accepterer hver indstilling, i Power Apps CLI-kommandoreference.

Dataverse API'er og Power Automate flow

Miljøvariabel Tilsvarende indstilling Beskrivelse
PA_CLI_DATAVERSE_API_NAME --api-name Angiver den Dataverse-handling eller -funktion, der skal tilføjes med pa-appen add dataverse-api.
PA_CLI_DATAVERSE_API_SEARCH_TERM --search Filtrerer Dataverse-handlinger og -funktioner efter navn med pa app find-dataverse-api.
PA_CLI_FLOW_DATA_SOURCE_NAME --flow-name Angiver den flowdatakilde, der skal fjernes fra appen med pa app remove flow
PA_CLI_FLOW_ID --flow-id Angiver det Power Automate flow, der skal tilføjes med pa app add flow.
PA_CLI_FLOW_SEARCH --search Filtrerer de tilgængelige Power Automate flow efter navn medpa app list-flows
PA_CLI_REMOVE_FLOW_ID --flow-id Angiver det Power Automate flow, der skal fjernes medpa app remove flow

Telemetri og konsoloutput

Miljøvariabel Tilsvarende indstilling Beskrivelse
PA_CLI_CONSOLE_ONLY --console-only Angiv værdien til true (med små bogstaver) med pa telemetry enable eller pa telemetry disable kun til at skrive telemetri til konsollen og ikke sende den eksternt.
PA_CLI_OUTPUT_TO_CONSOLE --output-to-console Angiv værdien til true (små bogstaver) med pa telemetry enable eller pa telemetry disable for at afspejle fjernsendt telemetrihændelser til konsollen.
PA_CLI_TELEMETRY Ingen Angiv en af disse værdier for at deaktivere telemetri for den aktuelle proces:
- 0
- false
- no
- off
Der skelnes mellem store og små bogstaver i værdier, og omgivende mellemrum ignoreres.

Du kan finde faste telemetriindstillinger under Administrer telemetriindstillinger for Power Apps-kommandolinjegrænsefladen.

Standardmiljøvariabler

Kommandolinjegrænsefladen overholder også denne standardmiljøvariabel:

Miljøvariabel Beskrivelse
NO_COLOR Angiv denne variabel til en nonempty-værdi for at deaktivere ANSI-farveoutput. Du kan også bruge indstillingen --no-color .
  • Last updated on