Power Apps CLI-miljövariabler

Använd miljövariabler för att konfigurera Power Apps CLI-autentisering och ange kommandoalternativ i skript och CI/CD-pipelines. Miljövariabler som definieras av Power Apps CLI använder prefixetPA_CLI_.

Note

Miljövariabler är namngivna värden som operativsystemet gör tillgängliga för program. Power Apps CLI identifierar variablerna som beskrivs i den här referensen. Information om hur miljövariabler fungerar och hur du hanterar dem finns i om miljövariabler.

Den här referensen beskriver miljövariabler för operativsystem som konfigurerar Power Apps CLI. De här variablerna skiljer sig från miljövariabler för Power Platform-lösningen, som lagrar konfigurationsvärden som används av en app.

För ett kommandoalternativ löser CLI ett värde i den här ordningen:

  1. alternativ för kommandoraden
  2. Miljövariabel
  3. Standardvärde, om alternativet har ett
  4. Interaktiv fråga när den stöds

Ett alternativ som anges på kommandoraden har företräde framför motsvarande miljövariabel.

Important

Miljövariabler kan exponera hemligheter för andra processer, loggar eller gränssnittshistorik. Lagra PA_CLI_SP_CLIENT_SECRET i din CI/CD-plattforms hemliga butik, maskera den från loggar och checka inte in hemligheter till källkontrollen.

Ange miljövariabler

Följande exempel anges PA_CLI_ENVIRONMENT_ID innan du kör ett Power Apps CLI-kommando.

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

Miljövariabeln är fortfarande tillgänglig för kommandon som startats från samma terminalsession. Använd gränssnittets standardkommando för att ta bort det när det inte längre behövs.

Authentication

Miljövariabel Description
PA_CLI_ACCOUNT Anger kontot för pa auth login eller pa auth switch.
PA_CLI_SP_CLIENT_ID Anger Microsoft Entra program-ID (klient)-ID för autentisering med tjänstens huvudnamn.
PA_CLI_SP_CLIENT_SECRET Anger klienthemligheten för autentisering med tjänstens huvudnamn.
PA_CLI_SP_TENANT_ID Anger Microsoft Entra katalog-ID (klientorganisation) för autentisering med tjänstens huvudnamn.
PA_CLI_USE_SP_AUTH Ange värdet till true (gemener) för att använda autentisering med tjänstens huvudnamn.

De tre PA_CLI_SP_* variablerna för autentiseringsuppgifter krävs när autentisering med tjänstens huvudnamn har valts. Även om CI=true du även väljer autentisering med tjänstens huvudnamn för kompatibilitet kan du använda PA_CLI_USE_SP_AUTH=true för att göra autentiseringsläget explicit.

Installationsinstruktioner finns i Publicera Power Apps kodappar med tjänstens huvudnamn.

Globala kommandoalternativ

Dessa variabler motsvarar alternativ som är tillgängliga för Power Apps CLI-kommandon.

Miljövariabel Motsvarande alternativ Description
PA_CLI_CLOUD --cloud Väljer målmolnet. Giltiga värden är:
- public (standard)
- usgov
- usgovhigh
- usgovdod
- china
Värden är skiftlägeskänsliga.
PA_CLI_ENVIRONMENT_ID --environment-id Anger målmiljö-ID:t för Power Platform.

Appinitiering

Dessa variabler tillhandahåller alternativ till pa app init.

Miljövariabel Motsvarande alternativ Description
PA_CLI_APP_BUILD_PATH --build-path Anger utdatakatalogen för bygget. Standardvärdet är ./dist.
PA_CLI_APP_DESCRIPTION --description Anger appbeskrivningen.
PA_CLI_APP_DISPLAY_NAME --display-name Anger appens visningsnamn.
PA_CLI_APP_FILE_ENTRY_POINT --file-entry-point Anger HTML-startpunkten i byggutdata. Standardvärdet är index.html.
PA_CLI_APP_TYPE --app-type Anger apptyp. Giltiga värden är:
- CodeApp (standard)
- MobileApp
Värdet sparas i power.config.json och används som apptyp när appen publiceras.
PA_CLI_APP_URL --app-url Anger url:en för den lokala appen under pa app init. Värdet sparas som localAppUrl i power.config.json och blir standard-URL:en för framtida pa app run kommandon. Standardvärdet är http://localhost:3000.

Köra appar

Dessa variabler tillhandahåller alternativ till pa app run.

Miljövariabel Motsvarande alternativ Description
PA_CLI_LOCAL_APP_URL --local-app-url Åsidosätter localAppUrl värdet från power.config.json för det aktuella kommandot utan att ändra den sparade konfigurationen. Om inget av värdena anges är http://localhost:3000standardvärdet .
PA_CLI_PORT --port Anger porten för den Power Apps lokala värden. Standardvärdet är 8080.

Dela appar

Dessa variabler tillhandahåller alternativ till pa app share.

Miljövariabel Motsvarande alternativ Description
PA_CLI_SHARE_ACCESS --access Anger åtkomstnivå. Giltiga värden är:
- play (standard)
- edit
PA_CLI_SHARE_PRINCIPAL --principal Anger en eller flera kommaavgränsade e-postadresser eller Microsoft Entra objekt-ID:t.

Lösningar, anslutningsappar och datakällor

Miljövariabel Motsvarande alternativ Description
PA_CLI_CONNECTION_DISPLAY_NAME --display-name Anger visningsnamnet när du skapar en anslutning.
PA_CLI_CONNECTION_ID --connection-id Anger ett anslutningsanslutningsinstans-ID.
PA_CLI_CONNECTION_REF --connection-ref Anger ett logiskt namn för anslutningsreferensen.
PA_CLI_CONNECTION_SEARCH --search Filtrerar resultat från pa connection list.
PA_CLI_CONNECTOR --connector Anger ett anslutnings-ID, till exempel shared_office365users.
PA_CLI_CONNECTOR_SEARCH --search Filtrerar resultat från pa connector list.
PA_CLI_DATASET --dataset Anger en datauppsättning, till exempel en SharePoint plats eller SQL-databas.
PA_CLI_DATA_SOURCE_NAME --name Anger den datakälla som ska uppdateras eller ta bort.
PA_CLI_ORG_URL --org-url Åsidosätter url:en för Dataverse-organisationen som används för att hämta metadata när du lägger till en datakälla.
PA_CLI_PROCEDURE --procedure Anger en SQL-lagrad procedur.
PA_CLI_SOLUTION_ID --solution-id Anger lösningen för pa app push, pa app add data-sourceeller pa connection list-references.
PA_CLI_SOLUTION_SEARCH --search Filtrerar resultat från pa solution list.
PA_CLI_TABLE --table Anger en tabell eller ett resursnamn för anslutningsappen.

De kommandon som accepterar varje alternativ finns i kommandoreferensen Power Apps CLI.

Dataverse-API:er och Power Automate flöden

Miljövariabel Motsvarande alternativ Description
PA_CLI_DATAVERSE_API_NAME --api-name Anger den Dataverse-åtgärd eller funktion som ska läggas till med pa app add dataverse-api.
PA_CLI_DATAVERSE_API_SEARCH_TERM --search Filtrerar Dataverse-åtgärder och funktioner efter namn med pa app find-dataverse-api.
PA_CLI_FLOW_DATA_SOURCE_NAME --flow-name Anger den flödesdatakälla som ska tas bort från appen med pa app remove flow
PA_CLI_FLOW_ID --flow-id Anger det Power Automate flöde som ska läggas till med pa app add flow.
PA_CLI_FLOW_SEARCH --search Filtrerar tillgängliga Power Automate flöden efter namn medpa app list-flows
PA_CLI_REMOVE_FLOW_ID --flow-id Anger det Power Automate flöde som ska tas bort medpa app remove flow

Telemetri- och konsolutdata

Miljövariabel Motsvarande alternativ Description
PA_CLI_CONSOLE_ONLY --console-only Ange värdet till true (gemener) med pa telemetry enable eller pa telemetry disable för att skriva telemetri endast till konsolen och skicka det inte via fjärranslutning.
PA_CLI_OUTPUT_TO_CONSOLE --output-to-console Ange värdet till true (gemener) med pa telemetry enable eller pa telemetry disable för att spegla telemetrihändelser som skickas via fjärranslutning till konsolen.
PA_CLI_TELEMETRY None Ange ett av dessa värden för att inaktivera telemetri för den aktuella processen:
- 0
- false
- no
- off
Värden är skiftlägeskänsliga och omgivande blanksteg ignoreras.

Beständiga telemetriinställningar finns i Hantera telemetriinställningar för Power Apps CLI.

Standardmiljövariabler

CLI observerar också den här standardmiljövariabeln:

Miljövariabel Description
NO_COLOR Ange den här variabeln till ett icke-giltigt värde för att inaktivera ANSI-färgutdata. Du kan också använda alternativet --no-color .
  • Last updated on