Variáveis de ambiente da CLI do Power Apps

Use variáveis de ambiente para configurar a autenticação CLI do Power Apps e fornecer opções de comandos em scripts e pipelines CI/CD. As variáveis de ambiente definidas pela CLI Power Apps utilizam o PA_CLI_ prefixo.

Note

As variáveis de ambiente são valores nomeados que o sistema operativo disponibiliza às aplicações. O Power Apps CLI reconhece as variáveis descritas nesta referência. Para aprender como funcionam as variáveis do ambiente e como as gerir, consulte as Variáveis do Ambiente.

Esta referência descreve variáveis do ambiente do sistema operativo que configuram a CLI do Power Apps. Estas variáveis são diferentes das variáveis de ambiente da solução Power Platform, que armazenam valores de configuração usados por uma aplicação.

Para uma opção de comando, a CLI resolve um valor nesta ordem:

  1. Opção de linha de comando
  2. Variável de ambiente
  3. Valor padrão, se a opção tiver um
  4. Prompt interativo, quando suportado

Uma opção fornecida na linha de comandos tem prioridade sobre a sua variável de ambiente correspondente.

Importante

As variáveis de ambiente podem expor segredos a outros processos, registos ou histórico de shell. Armazena PA_CLI_SP_CLIENT_SECRET no armazenamento secreto da tua plataforma CI/CD, mascara isso dos logs e não commetas segredos no controlo de versão.

Definir variáveis de ambiente

Os seguintes exemplos estão definidos PA_CLI_ENVIRONMENT_ID antes de executar um comando CLI do Power Apps.

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

A variável de ambiente mantém-se disponível para comandos iniciados a partir da mesma sessão de terminal. Use o comando padrão da sua carcaça para a remover quando já não for necessária.

Authentication

Variável de ambiente Description
PA_CLI_ACCOUNT Especifica a conta para pa auth login ou pa auth switch.
PA_CLI_SP_CLIENT_ID Especifica o ID da aplicação Microsoft Entra (cliente) para autenticação do principal de serviço.
PA_CLI_SP_CLIENT_SECRET Especifica o segredo do cliente para a autenticação do principal de serviço.
PA_CLI_SP_TENANT_ID Especifica o ID do diretório Microsoft Entra (tenant) para autenticação do principal de serviço.
PA_CLI_USE_SP_AUTH Defina o valor para true (minúscula) para usar autenticação do principal de serviço.

As três PA_CLI_SP_variáveis de credencial * são necessárias quando a autenticação do principal de serviço é selecionada. Embora CI=true também selecione a autenticação do principal de serviço para compatibilidade, use PA_CLI_USE_SP_AUTH=true para tornar explícito o modo de autenticação.

Para instruções de configuração, consulte Publicar aplicações de código Power Apps com um princípio de serviço.

Opções globais de comando

Estas variáveis correspondem a opções disponíveis entre os comandos CLI do Power Apps.

Variável de ambiente Opção correspondente Description
PA_CLI_CLOUD --cloud Seleciona a nuvem alvo. Os valores válidos são:
- public (padrão)
- usgov
- usgovhigh
- usgovdod
- china
Os valores são indiferentes a maiúsculas.
PA_CLI_ENVIRONMENT_ID --environment-id Especifica o ID de ambiente da Power Platform alvo.

Inicialização da aplicação

Estas variáveis fornecem opções para pa app init.

Variável de ambiente Opção correspondente Description
PA_CLI_APP_BUILD_PATH --build-path Especifica o diretório de saída da compilação. A predefinição é ./dist.
PA_CLI_APP_DESCRIPTION --description Especifica a descrição da aplicação.
PA_CLI_APP_DISPLAY_NAME --display-name Especifica o nome de exibição da aplicação.
PA_CLI_APP_FILE_ENTRY_POINT --file-entry-point Especifica o ponto de entrada HTML na saída da compilação. A predefinição é index.html.
PA_CLI_APP_TYPE --app-type Especifica o tipo de aplicação. Os valores válidos são:
- CodeApp (padrão)
- MobileApp
O valor é guardado power.config.json e usado como tipo de aplicação quando a aplicação é publicada.
PA_CLI_APP_URL --app-url Especifica a URL local da aplicação durante pa app inito arquivo . O valor é guardado como localAppUrl em power.config.json e torna-se o URL padrão para comandos futuros pa app run . A predefinição é http://localhost:3000.

Executar aplicações

Estas variáveis fornecem opções para pa app run.

Variável de ambiente Opção correspondente Description
PA_CLI_LOCAL_APP_URL --local-app-url Sobrepõe o localAppUrl valor de power.config.json para o comando atual sem alterar a configuração guardada. Se nenhum dos valores for definido, o padrão é http://localhost:3000.
PA_CLI_PORT --port Especifica a porta para o host local do Power Apps. A predefinição é 8080.

Partilhar aplicações

Estas variáveis fornecem opções para pa app share.

Variável de ambiente Opção correspondente Description
PA_CLI_SHARE_ACCESS --access Especifica o nível de acesso. Os valores válidos são:
- play (padrão)
- edit
PA_CLI_SHARE_PRINCIPAL --principal Especifica um ou mais endereços de email separados por vírgulas ou IDs de objeto Microsoft Entra.

Soluções, conectores e fontes de dados

Variável de ambiente Opção correspondente Description
PA_CLI_CONNECTION_DISPLAY_NAME --display-name Especifica o nome de exibição ao criar uma ligação.
PA_CLI_CONNECTION_ID --connection-id Especifica um ID de instância de ligação ao conector.
PA_CLI_CONNECTION_REF --connection-ref Especifica um nome lógico de referência de ligação.
PA_CLI_CONNECTION_SEARCH --search Filtra resultados de pa connection list.
PA_CLI_CONNECTOR --connector Especifica um ID de conector, como shared_office365users.
PA_CLI_CONNECTOR_SEARCH --search Filtra resultados de pa connector list.
PA_CLI_DATASET --dataset Especifica um conjunto de dados, como um site SharePoint ou uma base de dados SQL.
PA_CLI_DATA_SOURCE_NAME --name Especifica a fonte de dados a atualizar ou remover.
PA_CLI_ORG_URL --org-url Sobrepõe a URL da organização Dataverse usada para recuperar metadados ao adicionar uma fonte de dados.
PA_CLI_PROCEDURE --procedure Especifica um procedimento armazenado SQL.
PA_CLI_SOLUTION_ID --solution-id Especifica a solução para pa app push, pa app add data-source, ou pa connection list-references.
PA_CLI_SOLUTION_SEARCH --search Filtra resultados de pa solution list.
PA_CLI_TABLE --table Especifica o nome de um recurso de tabela ou conector.

Para os comandos que aceitam cada opção, consulte a referência de comandos CLI do Power Apps.

APIs do Dataverse e fluxos do Power Automate

Variável de ambiente Opção correspondente Description
PA_CLI_DATAVERSE_API_NAME --api-name Especifica a ação ou função do Dataverse a adicionar com a app pa add dataverse-api.
PA_CLI_DATAVERSE_API_SEARCH_TERM --search Filtra ações e funções do Dataverse pelo nome com pa app find-dataverse-api.
PA_CLI_FLOW_DATA_SOURCE_NAME --flow-name Especifica a fonte de dados de fluxo a remover da aplicação com pa app remove flow
PA_CLI_FLOW_ID --flow-id Especifica o fluxo do Power Automate a adicionar com pa app add flow.
PA_CLI_FLOW_SEARCH --search Filtra os fluxos disponíveis do Power Automate por nome compa app list-flows
PA_CLI_REMOVE_FLOW_ID --flow-id Especifica o fluxo do Power Automate a remover compa app remove flow

Telemetria e saída para consola

Variável de ambiente Opção correspondente Description
PA_CLI_CONSOLE_ONLY --console-only Defina o valor para true (minúsculo) com pa telemetry enable ou pa telemetry disable para escrever telemetria apenas na consola e não enviá-la remotamente.
PA_CLI_OUTPUT_TO_CONSOLE --output-to-console Defina o valor para true (minúscula) com pa telemetry enable ou pa telemetry disable para espelhar eventos de telemetria enviados remotamente para a consola.
PA_CLI_TELEMETRY None Defina um destes valores para desativar a telemetria do processo atual:
- 0
- false
- no
- off
Os valores são indiferentes a maiúsculas minúsculas e os espaços circundantes são ignorados.

Para definições persistentes de telemetria, consulte Gerir definições de telemetria para a CLI do Power Apps.

Variáveis de ambiente padrão

A CLI também observa esta variável padrão de ambiente:

Variável de ambiente Description
NO_COLOR Defina esta variável para um valor não vazio para desativar a saída de cor ANSI. Também podes usar essa --no-color opção.
  • Last updated on