Variables d'entorn CLI de Power Apps

Utilitza variables d'entorn per configurar l'autenticació CLI de Power Apps i proporciona opcions de comandes en scripts i pipelines CI/CD. Les variables d'entorn definides per la CLI de Power Apps utilitzen el PA_CLI_ prefix.

Nota

Les variables d'entorn són valors anomenats que el sistema operatiu posa a disposició de les aplicacions. Power Apps CLI reconeix les variables descrites en aquesta referència. Per aprendre com funcionen les variables d'entorn i com gestionar-les, consulta Variables d'entorn.

Aquesta referència descriu variables de l'entorn del sistema operatiu que configuren la CLI de Power Apps. Aquestes variables són diferents de les variables d'entorn de solució de Power Platform, que emmagatzemen valors de configuració utilitzats per una aplicació.

Per a una opció de comanda, la CLI resol un valor en aquest ordre:

  1. Opció de línia de comandes
  2. Variable d'entorn
  3. Valor per defecte, si l'opció en té un
  4. Prompt interactiu, quan sigui compatible

Una opció proporcionada a la línia d'ordres té prioritat sobre la seva variable d'entorn corresponent.

Important

Les variables d'entorn poden exposar secrets a altres processos, registres o historial de la shell. Emmagatzema PA_CLI_SP_CLIENT_SECRET al magatzem secret de la teva plataforma CI/CD, amaga-ho dels registres i no comprometis els secrets al control de versió.

Variables d'entorn de conjunt

Els següents exemples es mostren PA_CLI_ENVIRONMENT_ID abans d'executar una comanda CLI de Power Apps.

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

La variable d'entorn continua disponible per a comandes iniciades des de la mateixa sessió terminal. Fes servir l'ordre estàndard de la teva carcassa per treure-la quan ja no la necessitis.

Autenticació

Variable d'entorn Descripció
PA_CLI_ACCOUNT Especifica el compte per pa auth login a o pa auth switch.
PA_CLI_SP_CLIENT_ID Especifica l'ID de l'aplicació Microsoft Entra (client) per a l'autenticació del principal de servei.
PA_CLI_SP_CLIENT_SECRET Especifica el secret del client per a l'autenticació del principal de servei.
PA_CLI_SP_TENANT_ID Especifica l'ID de directori (llogater) de Microsoft Entra per a l'autenticació del principal de servei.
PA_CLI_USE_SP_AUTH Configura el valor a true (minúscula) per utilitzar l'autenticació del principal de servei.

Les tres PA_CLI_SP_variables de credencial * són necessàries quan es selecciona l'autenticació del principal de servei. Tot i que CI=true també selecciona l'autenticació del principal de servei per compatibilitat, utilitza PA_CLI_USE_SP_AUTH=true per fer explícit el mode d'autenticació.

Per a les instruccions de configuració, consulteu Publicar aplicacions de codi Power Apps amb un principi de servei.

Opcions de comandament globals

Aquestes variables corresponen a opcions disponibles a través de les comandes CLI de Power Apps.

Variable d'entorn Opció corresponent Descripció
PA_CLI_CLOUD --cloud Selecciona el núvol objectiu. Els valors vàlids són:
- public (per defecte)
- usgov
- usgovhigh
- usgovdod
- china
Els valors no són diferents entre majúscules i majúscules.
PA_CLI_ENVIRONMENT_ID --environment-id Especifica l'ID de l'entorn de Power Platform objectiu.

Inicialització de l'aplicació

Aquestes variables proporcionen opcions a pa app init.

Variable d'entorn Opció corresponent Descripció
PA_CLI_APP_BUILD_PATH --build-path Especifica el directori de sortida de compilació. El valor per defecte és ./dist.
PA_CLI_APP_DESCRIPTION --description Especifica la descripció de l'aplicació.
PA_CLI_APP_DISPLAY_NAME --display-name Especifica el nom de visualització de l'aplicació.
PA_CLI_APP_FILE_ENTRY_POINT --file-entry-point Especifica el punt d'entrada HTML a la sortida de la compilació. El valor per defecte és index.html.
PA_CLI_APP_TYPE --app-type Especifica el tipus d'aplicació. Els valors vàlids són:
- CodeApp (per defecte)
- MobileApp
El valor es guarda power.config.json i s'utilitza com a tipus d'aplicació quan l'aplicació es publica.
PA_CLI_APP_URL --app-url Especifica la URL local de l'aplicació durant pa app init. El valor es guarda com localAppUrl a power.config.json i esdevé l'URL per defecte per a futures pa app run comandes. El valor per defecte és http://localhost:3000.

Executa aplicacions

Aquestes variables proporcionen opcions a pa app run.

Variable d'entorn Opció corresponent Descripció
PA_CLI_LOCAL_APP_URL --local-app-url Sobreescriu el localAppUrl valor de power.config.json per a la comanda actual sense canviar la configuració guardada. Si cap dels dos valors està fixat, el valor per defecte és http://localhost:3000.
PA_CLI_PORT --port Especifica el port per a l'amfitrió local de Power Apps. El valor per defecte és 8080.

Comparteix aplicacions

Aquestes variables proporcionen opcions a pa app share.

Variable d'entorn Opció corresponent Descripció
PA_CLI_SHARE_ACCESS --access Especifica el nivell d'accés. Els valors vàlids són:
- play (per defecte)
- edit
PA_CLI_SHARE_PRINCIPAL --principal Especifica una o més adreces de correu electrònic separades per comes o identificadors d'objectes Microsoft Entra.

Solucions, connectors i fonts de dades

Variable d'entorn Opció corresponent Descripció
PA_CLI_CONNECTION_DISPLAY_NAME --display-name Especifica el nom de pantalla quan es crea una connexió.
PA_CLI_CONNECTION_ID --connection-id Especifica un ID d'instància de connexió de connector.
PA_CLI_CONNECTION_REF --connection-ref Especifica un nom lògic de referència de connexió.
PA_CLI_CONNECTION_SEARCH --search Filtra resultat de pa connection list.
PA_CLI_CONNECTOR --connector Especifica un identificador de connector, com shared_office365usersara .
PA_CLI_CONNECTOR_SEARCH --search Filtra resultat de pa connector list.
PA_CLI_DATASET --dataset Especifica un conjunt de dades, com ara un lloc de SharePoint o una base de dades SQL.
PA_CLI_DATA_SOURCE_NAME --name Especifica la font de dades a refrescar o eliminar.
PA_CLI_ORG_URL --org-url Anul·la la URL de l'organització Dataverse utilitzada per recuperar metadades quan s'afegeix una font de dades.
PA_CLI_PROCEDURE --procedure Especifica un procediment emmagatzemat SQL.
PA_CLI_SOLUTION_ID --solution-id Especifica la solució per a pa app push, pa app add data-source, o pa connection list-references.
PA_CLI_SOLUTION_SEARCH --search Filtra resultat de pa solution list.
PA_CLI_TABLE --table Especifica el nom d'un recurs de taula o connector.

Per a les ordres que accepten cada opció, vegeu la referència de la comanda CLI de Power Apps.

APIs de Dataverse i fluxos de Power Automate

Variable d'entorn Opció corresponent Descripció
PA_CLI_DATAVERSE_API_NAME --api-name Especifica l'acció o funció de Dataverse a afegir amb l'app pa add dataverse-api.
PA_CLI_DATAVERSE_API_SEARCH_TERM --search Filtra accions i funcions de Dataverse pel nom amb pa app find-dataverse-api.
PA_CLI_FLOW_DATA_SOURCE_NAME --flow-name Especifica la font de dades de flux a eliminar de l'aplicació amb pa app remove flow
PA_CLI_FLOW_ID --flow-id Especifica el flux de Power Automate per afegir amb pa app add flow.
PA_CLI_FLOW_SEARCH --search Filtra els fluxos disponibles de Power Automate per nom ambpa app list-flows
PA_CLI_REMOVE_FLOW_ID --flow-id Especifica el flux de Power Automate a eliminar ambpa app remove flow

Telemetria i sortida de consola

Variable d'entorn Opció corresponent Descripció
PA_CLI_CONSOLE_ONLY --console-only Configura el valor a true (minúscula) amb pa telemetry enable o pa telemetry disable per escriure telemetria només a la consola i no enviar-la remotament.
PA_CLI_OUTPUT_TO_CONSOLE --output-to-console Configura el valor a true (minúscula) amb pa telemetry enable o pa telemetry disable per reflectir esdeveniments de telemetria enviats remotament a la consola.
PA_CLI_TELEMETRY Cap Configura un d'aquests valors per desactivar la telemetria del procés actual:
- 0
- false
- no
- off
Els valors són insensibles a majúscules i majúscules i s'ignoren els espais circumdants.

Per a la configuració persistent de telemetria, vegeu Gestionar la configuració de telemetria per a la CLI de Power Apps.

Variables d'entorn estàndard

La CLI també observa aquesta variable d'entorn estàndard:

Variable d'entorn Descripció
NO_COLOR Configura aquesta variable a un valor no buit per desactivar la sortida de color ANSI. També pots utilitzar aquesta --no-color opció.
  • Last updated on