Power Apps variables de entorno de la CLI

Use variables de entorno para configurar Power Apps autenticación de la CLI y proporcionar opciones de comandos en scripts y canalizaciones de CI/CD. Las variables de entorno definidas por la CLI de Power Apps usan el PA_CLI_ prefijo .

Note

Las variables de entorno se denominan valores que el sistema operativo pone a disposición de las aplicaciones. Power Apps CLI reconoce las variables descritas en esta referencia. Para obtener información sobre cómo funcionan las variables de entorno y cómo administrarlas, consulte Acerca de las variables de entorno.

En esta referencia se describen las variables de entorno del sistema operativo que configuran la CLI de Power Apps. Estas variables son diferentes de las variables de entorno de la solución de Power Platform, que almacenan los valores de configuración usados por una aplicación.

Para una opción de comando, la CLI resuelve un valor en este orden:

Opción de línea de comandos
Variable del entorno
Valor predeterminado, si la opción tiene una
Aviso interactivo, cuando se admite

Una opción proporcionada en la línea de comandos tiene prioridad sobre su variable de entorno correspondiente.

Important

Las variables de entorno pueden exponer secretos a otros procesos, registros o historial de shell. Almacene PA_CLI_SP_CLIENT_SECRET en el almacén de secretos de la plataforma de CI/CD, guárdelo de los registros y no confirme secretos en el control de código fuente.

Establecimiento de variables de entorno

En los ejemplos siguientes se establece PA_CLI_ENVIRONMENT_ID antes de ejecutar un comando de la CLI de Power Apps.

PowerShell
Bash

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

export PA_CLI_ENVIRONMENT_ID="<environment-id>"
pa app list

La variable de entorno sigue estando disponible para los comandos iniciados desde la misma sesión de terminal. Use el comando estándar del shell para quitarlo cuando ya no sea necesario.

Autenticación

Variable del entorno	Description
`PA_CLI_ACCOUNT`	Especifica la cuenta de `pa auth login` o `pa auth switch`.
`PA_CLI_SP_CLIENT_ID`	Especifica el identificador de aplicación (cliente) de Microsoft Entra para la autenticación de la entidad de servicio.
`PA_CLI_SP_CLIENT_SECRET`	Especifica el secreto de cliente para la autenticación de la entidad de servicio.
`PA_CLI_SP_TENANT_ID`	Especifica el identificador de directorio (inquilino) de Microsoft Entra para la autenticación de la entidad de servicio.
`PA_CLI_USE_SP_AUTH`	Establezca el valor `true` en (minúsculas) para usar la autenticación de entidad de servicio.

Las tres PA_CLI_SP_variables de credenciales * son necesarias cuando se selecciona la autenticación de la entidad de servicio. Aunque CI=true también selecciona la autenticación de entidad de servicio para la compatibilidad, use PA_CLI_USE_SP_AUTH=true para que el modo de autenticación sea explícito.

Para obtener instrucciones de configuración, consulte Publicación de aplicaciones de código Power Apps con una entidad de servicio.

Opciones de comando global

Estas variables corresponden a opciones disponibles en Power Apps comandos de la CLI.

Variable del entorno	Opción correspondiente	Description
`PA_CLI_CLOUD`	`--cloud`	Selecciona la nube de destino. Los valores válidos son: - `public` (predeterminado) - `usgov` - `usgovhigh` - `usgovdod` - `china` Los valores no distinguen mayúsculas de minúsculas.
`PA_CLI_ENVIRONMENT_ID`	`--environment-id`	Especifica el identificador de entorno de Power Platform de destino.

Inicialización de la aplicación

Estas variables proporcionan opciones a pa app init.

Variable del entorno	Opción correspondiente	Description
`PA_CLI_APP_BUILD_PATH`	`--build-path`	Especifica el directorio de salida de compilación. El valor predeterminado es `./dist`.
`PA_CLI_APP_DESCRIPTION`	`--description`	Especifica la descripción de la aplicación.
`PA_CLI_APP_DISPLAY_NAME`	`--display-name`	Especifica el nombre para mostrar de la aplicación.
`PA_CLI_APP_FILE_ENTRY_POINT`	`--file-entry-point`	Especifica el punto de entrada HTML en la salida de la compilación. El valor predeterminado es `index.html`.
`PA_CLI_APP_TYPE`	`--app-type`	Especifica el tipo de aplicación. Los valores válidos son: - `CodeApp` (predeterminado) - `MobileApp` El valor se guarda en `power.config.json` y se usa como tipo de aplicación cuando se publica la aplicación.
`PA_CLI_APP_URL`	`--app-url`	Especifica la dirección URL de la aplicación local durante `pa app init`. El valor se guarda como `localAppUrl` en y se convierte en `power.config.json` la dirección URL predeterminada para los comandos futuros `pa app run` . El valor predeterminado es `http://localhost:3000`.

Ejecución de aplicaciones

Estas variables proporcionan opciones a pa app run.

Variable del entorno	Opción correspondiente	Description
`PA_CLI_LOCAL_APP_URL`	`--local-app-url`	Invalida el `localAppUrl` valor de `power.config.json` para el comando actual sin cambiar la configuración guardada. Si no se establece ninguno de los valores, el valor predeterminado es `http://localhost:3000`.
`PA_CLI_PORT`	`--port`	Especifica el puerto del host local Power Apps. El valor predeterminado es `8080`.

Estas variables proporcionan opciones a pa app share.

Variable del entorno	Opción correspondiente	Description
`PA_CLI_SHARE_ACCESS`	`--access`	Especifica el nivel de acceso. Los valores válidos son: - `play` (predeterminado) - `edit`
`PA_CLI_SHARE_PRINCIPAL`	`--principal`	Especifica una o varias direcciones de correo electrónico separadas por comas o Microsoft Entra identificadores de objeto.

Soluciones, conectores y orígenes de datos

Variable del entorno	Opción correspondiente	Description
`PA_CLI_CONNECTION_DISPLAY_NAME`	`--display-name`	Especifica el nombre para mostrar al crear una conexión.
`PA_CLI_CONNECTION_ID`	`--connection-id`	Especifica un identificador de instancia de conexión del conector.
`PA_CLI_CONNECTION_REF`	`--connection-ref`	Especifica un nombre lógico de referencia de conexión.
`PA_CLI_CONNECTION_SEARCH`	`--search`	Filtra los resultados de `pa connection list`.
`PA_CLI_CONNECTOR`	`--connector`	Especifica un identificador de conector, como `shared_office365users`.
`PA_CLI_CONNECTOR_SEARCH`	`--search`	Filtra los resultados de `pa connector list`.
`PA_CLI_DATASET`	`--dataset`	Especifica un conjunto de datos, como un sitio de SharePoint o una base de datos SQL.
`PA_CLI_DATA_SOURCE_NAME`	`--name`	Especifica el origen de datos que se va a actualizar o quitar.
`PA_CLI_ORG_URL`	`--org-url`	Invalida la dirección URL de la organización de Dataverse que se usa para recuperar metadatos al agregar un origen de datos.
`PA_CLI_PROCEDURE`	`--procedure`	Especifica un procedimiento almacenado de SQL.
`PA_CLI_SOLUTION_ID`	`--solution-id`	Especifica la solución para `pa app push`, `pa app add data-source`o `pa connection list-references`.
`PA_CLI_SOLUTION_SEARCH`	`--search`	Filtra los resultados de `pa solution list`.
`PA_CLI_TABLE`	`--table`	Especifica un nombre de recurso de tabla o conector.

Para ver los comandos que aceptan cada opción, consulte la referencia de comandos de la CLI de Power Apps.

Api de Dataverse y flujos de Power Automate

Variable del entorno	Opción correspondiente	Description
`PA_CLI_DATAVERSE_API_NAME`	`--api-name`	Especifica la acción o función de Dataverse que se va a agregar con la aplicación pa add dataverse-api.
`PA_CLI_DATAVERSE_API_SEARCH_TERM`	`--search`	Filtra las acciones y funciones de Dataverse por su nombre con `pa app find-dataverse-api`.
`PA_CLI_FLOW_DATA_SOURCE_NAME`	`--flow-name`	Especifica el origen de datos de flujo que se va a quitar de la aplicación con `pa app remove flow`
`PA_CLI_FLOW_ID`	`--flow-id`	Especifica el flujo de Power Automate que se va a agregar con `pa app add flow`.
`PA_CLI_FLOW_SEARCH`	`--search`	Filtra los flujos de Power Automate disponibles por nombre con`pa app list-flows`
`PA_CLI_REMOVE_FLOW_ID`	`--flow-id`	Especifica el flujo de Power Automate que se va a quitar con`pa app remove flow`

Salida de telemetría y consola

Variable del entorno	Opción correspondiente	Description
`PA_CLI_CONSOLE_ONLY`	`--console-only`	Establezca el valor `true` en (minúsculas) con `pa telemetry enable` o `pa telemetry disable` para escribir telemetría solo en la consola y no enviarlo de forma remota.
`PA_CLI_OUTPUT_TO_CONSOLE`	`--output-to-console`	Establezca el valor `true` en (minúsculas) con `pa telemetry enable` o `pa telemetry disable` para reflejar eventos de telemetría enviados de forma remota a la consola.
`PA_CLI_TELEMETRY`	Ninguno	Establezca uno de estos valores para deshabilitar la telemetría para el proceso actual: - `0` - `false` - `no` - `off` Los valores no distinguen mayúsculas de minúsculas y se omiten los espacios circundantes.

Para ver la configuración de telemetría persistente, consulte Administración de la configuración de telemetría para la CLI de Power Apps.

Variables de entorno estándar

La CLI también observa esta variable de entorno estándar:

Variable del entorno	Description
`NO_COLOR`	Establezca esta variable en un valor no vacío para deshabilitar la salida de color ANSI. También puede usar la `--no-color` opción .

Comentarios

¿Le ha resultado útil esta página?

Last updated on 2026-09-01