Variables do entorno da CLI de Power Apps

Usa variables de entorno para configurar a autenticación CLI de Power Apps e proporcionar opcións de comandos en scripts e pipelines CI/CD. As variables de entorno definidas pola CLI de Power Apps usan o PA_CLI_ prefixo.

Nota

As variables de ambiente son valores nomeados que o sistema operativo pon a disposición das aplicacións. Power Apps CLI recoñece as variables descritas nesta referencia. Para aprender como funcionan as variables do ambiente e como xestionalas, consulta as Variables do Ambiente.

Esta referencia describe as variables do entorno do sistema operativo que configuran a CLI de Power Apps. Estas variables son diferentes das variables do entorno solución de Power Platform, que almacenan valores de configuración usados por unha aplicación.

Para unha opción de comando, a CLI resolve un valor nesta orde:

  1. Opción de liña de comandos
  2. Variable do ambiente
  3. Valor por defecto, se a opción ten un
  4. Prompt interactivo, cando o soporte

Unha opción proporcionada na liña de comandos ten prioridade sobre a súa variable de entorno correspondente.

Importante

As variables do ambiente poden expoñer segredos a outros procesos, rexistros ou historial de shell. Garda PA_CLI_SP_CLIENT_SECRET no almacén secreto da túa plataforma CI/CD, oculta os rexistros e non comprometas segredos no control de versión.

Conxunto de variables de ambiente

Os seguintes exemplos están establecidos PA_CLI_ENVIRONMENT_ID antes de executar un comando CLI de Power Apps.

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

A variable de ambiente permanece dispoñible para comandos iniciados desde a mesma sesión de terminal. Usa o comando estándar da túa carcasa para retirala cando xa non sexa necesaria.

Autenticación

Variable do ambiente Descrición
PA_CLI_ACCOUNT Especifica a conta para pa auth login ou pa auth switch.
PA_CLI_SP_CLIENT_ID Especifica o ID da aplicación Microsoft Entra (cliente) para a autenticación do principal de servizo.
PA_CLI_SP_CLIENT_SECRET Especifica o segredo do cliente para a autenticación do principal de servizo.
PA_CLI_SP_TENANT_ID Especifica o ID do directorio Microsoft Entra (inquilino) para a autenticación do principal do servizo.
PA_CLI_USE_SP_AUTH Configura o valor en true (minúscula) para usar autenticación de principal de servizo.

As tres PA_CLI_SP_variables de credencial * son necesarias cando se selecciona a autenticación do principal de servizo. Aínda que CI=true tamén selecciona a autenticación do principal de servizo para compatibilidade, úsase PA_CLI_USE_SP_AUTH=true para facer explícito o modo de autenticación.

Para instrucións de configuración, consulta Publicar aplicacións de código de Power Apps cun principal de servizo.

Opcións globais de mando

Estas variables corresponden ás opcións dispoñibles entre os comandos CLI de Power Apps.

Variable do ambiente Opción correspondente Descrición
PA_CLI_CLOUD --cloud Selecciona a nube obxectivo. Os valores válidos son:
- public (por defecto)
- usgov
- usgovhigh
- usgovdod
- china
Os valores son insensibles a maiúsculas.
PA_CLI_ENVIRONMENT_ID --environment-id Especifica o ID do entorno da Power Platform obxectivo.

Inicialización da aplicación

Estas variables proporcionan opcións a pa app init.

Variable do ambiente Opción correspondente Descrición
PA_CLI_APP_BUILD_PATH --build-path Especifica o directorio de saída da compilación. O valor por defecto é ./dist.
PA_CLI_APP_DESCRIPTION --description Especifica a descrición da aplicación.
PA_CLI_APP_DISPLAY_NAME --display-name Especifica o nome de visualización da aplicación.
PA_CLI_APP_FILE_ENTRY_POINT --file-entry-point Especifica o punto de entrada HTML na saída da compilación. O valor por defecto é index.html.
PA_CLI_APP_TYPE --app-type Especifica o tipo de aplicación. Os valores válidos son:
- CodeApp (por defecto)
- MobileApp
O valor gárdase power.config.json e úsase como tipo de aplicación cando a aplicación se publica.
PA_CLI_APP_URL --app-url Especifica a URL local da aplicación durante pa app init. O valor gárdase como localAppUrl en power.config.json e convértese na URL predeterminada para comandos futuros pa app run . O valor por defecto é http://localhost:3000.

Executar aplicacións

Estas variables proporcionan opcións a pa app run.

Variable do ambiente Opción correspondente Descrición
PA_CLI_LOCAL_APP_URL --local-app-url Sobrescribe o localAppUrl valor de power.config.json para o comando actual sen cambiar a configuración gardada. Se ningún dos dous valores está establecido, o valor por defecto é http://localhost:3000.
PA_CLI_PORT --port Especifica o porto para o host local de Power Apps. O valor por defecto é 8080.

Compartir aplicacións

Estas variables proporcionan opcións a pa app share.

Variable do ambiente Opción correspondente Descrición
PA_CLI_SHARE_ACCESS --access Especifica o nivel de acceso. Os valores válidos son:
- play (por defecto)
- edit
PA_CLI_SHARE_PRINCIPAL --principal Especifica un ou máis enderezos de correo separados por comas ou IDs de obxecto Microsoft Entra.

Solucións, conectores e fontes de datos

Variable do ambiente Opción correspondente Descrición
PA_CLI_AS --as Especifica se pa app add data-source engade un conector que soporte tanto as táboas como as accións como unha táboa ou como accións. Os valores válidos son:
- table
- action
Os valores son insensibles a maiúsculas.
PA_CLI_CONNECTION_DISPLAY_NAME --display-name Especifica o nome de visualización ao crear unha conexión.
PA_CLI_CONNECTION_ID --connection-id Especifica un ID de instancia de conexión de conector.
PA_CLI_CONNECTION_REF --connection-ref Especifica un nome lóxico de referencia de conexión.
PA_CLI_CONNECTION_SEARCH --search Filtra os resultados de pa connection list.
PA_CLI_CONNECTOR --connector Especifica un ID de conector, como shared_office365users, ou un nome de visualización do conector, como Office 365 Users.
PA_CLI_CONNECTOR_SEARCH --search Filtra os resultados de pa connector list.
PA_CLI_DATASET --dataset Especifica un conxunto de datos, como un sitio de SharePoint ou unha base de datos SQL.
PA_CLI_DATA_SOURCE_NAME --name Especifica a fonte de datos a actualizar ou eliminar.
PA_CLI_ORG_URL --org-url Anula a URL da organización Dataverse usada para recuperar metadatos ao engadir unha fonte de datos.
PA_CLI_PROCEDURE --procedure Especifica un procedemento almacenado SQL.
PA_CLI_SOLUTION_ID --solution-id Especifica a solución para pa app push, pa app add data-source, ou pa connection list-references.
PA_CLI_SOLUTION_SEARCH --search Filtra os resultados de pa solution list.
PA_CLI_TABLE --table Especifica o nome dunha táboa ou recurso conector. Para engadir múltiples táboas de conectores, repite o --table parámetro da liña de comandos. Para máis detalles, véxanse pa app add data-source as observacións.

Para os comandos que aceptan cada opción, consulta a referencia de comandos CLI de Power Apps.

APIs de Dataverse e fluxos de Power Automate

Variable do ambiente Opción correspondente Descrición
PA_CLI_DATAVERSE_API_NAME --api-name Especifica a acción ou función de Dataverse para engadir coa app pa engadir dataverse-api.
PA_CLI_DATAVERSE_API_SEARCH_TERM --search Filtra accións e funcións de Dataverse polo nome con pa app find-dataverse-api.
PA_CLI_FLOW_DATA_SOURCE_NAME --flow-name Especifica a fonte de datos do fluxo a eliminar da aplicación con pa app remove flow
PA_CLI_FLOW_ID --flow-id Especifica o fluxo de Power Automate para engadir con pa app add flow.
PA_CLI_FLOW_SEARCH --search Filtra os fluxos dispoñibles de Power Automate por nome conpa app list-flows
PA_CLI_REMOVE_FLOW_ID --flow-id Especifica o fluxo de Power Automate a eliminar conpa app remove flow

Telemetría e saída de consola

Variable do ambiente Opción correspondente Descrición
PA_CLI_CONSOLE_ONLY --console-only Establece o valor en true minúsculas con pa telemetry enable ou pa telemetry disable para escribir telemetría só na consola e non enviala remotamente.
PA_CLI_OUTPUT_TO_CONSOLE --output-to-console Establece o valor en true (minúscula) con pa telemetry enable ou pa telemetry disable para reflectir eventos de telemetría enviados remotamente á consola.
PA_CLI_TELEMETRY Ningún Establece un destes valores para desactivar a telemetría do proceso actual:
- 0
- false
- no
- off
Os valores non distinguen maiúsculas e minúsculas, e ignóranse os espazos circundantes.

Para a configuración de telemetría persistente, consulta Xestionar a configuración de telemetría para a CLI de Power Apps.

Variables ambientais estándar

A CLI tamén observa esta variable estándar de ambiente:

Variable do ambiente Descrición
NO_COLOR Establece esta variable nun valor non baleiro para desactivar a saída de cor ANSI. Tamén podes usar esa --no-color opción.
  • Última actualización o