Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Use variáveis de ambiente para configurar Power Apps autenticação da CLI e fornecer opções de comando em scripts e pipelines de CI/CD. As variáveis de ambiente definidas pela CLI Power Apps usam o PA_CLI_ prefixo.
Note
Variáveis de ambiente são valores nomeados que o sistema operacional disponibiliza para aplicativos. Power Apps CLI reconhece as variáveis descritas nesta referência. Para saber como as variáveis de ambiente funcionam e como gerenciá-las, consulte sobre variáveis de ambiente.
Essa referência descreve variáveis de ambiente do sistema operacional que configuram a CLI Power Apps. Essas variáveis são diferentes das variáveis de ambiente de solução do Power Platform, que armazenam valores de configuração usados por um aplicativo.
Para uma opção de comando, a CLI resolve um valor nesta ordem:
- Opção de linha de comando
- Variável de ambiente
- Valor padrão, se a opção tiver um
- Prompt interativo, quando com suporte
Uma opção fornecida na linha de comando tem precedência sobre sua variável de ambiente correspondente.
Importante
As variáveis de ambiente podem expor segredos a outros processos, logs ou histórico de shells. Armazene PA_CLI_SP_CLIENT_SECRET no repositório secreto da plataforma CI/CD, mascara-o de logs e não confirme segredos no controle do código-fonte.
Definir variáveis de ambiente
Os exemplos a seguir são definidos PA_CLI_ENVIRONMENT_ID antes de executar um comando Power Apps CLI.
$env:PA_CLI_ENVIRONMENT_ID = "<environment-id>"
pa app list
A variável de ambiente permanece disponível para comandos iniciados na mesma sessão de terminal. Use o comando padrão do shell para removê-lo quando ele não for mais necessário.
Autenticação
| 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 a ID do aplicativo Microsoft Entra (cliente) para autenticação da entidade de serviço. |
PA_CLI_SP_CLIENT_SECRET |
Especifica o segredo do cliente para autenticação da entidade de serviço. |
PA_CLI_SP_TENANT_ID |
Especifica a ID do diretório Microsoft Entra (locatário) para autenticação da entidade de serviço. |
PA_CLI_USE_SP_AUTH |
Defina o valor como true (em letras minúsculas) para usar a autenticação da entidade de serviço. |
As três PA_CLI_SP_* variáveis de credencial são necessárias quando a autenticação da entidade de serviço é selecionada. Embora CI=true também selecione a autenticação da entidade de serviço para compatibilidade, use PA_CLI_USE_SP_AUTH=true para tornar o modo de autenticação explícito.
Para obter instruções de configuração, consulte Publicar Power Apps aplicativos de código com uma entidade de serviço.
Opções de comando global
Essas variáveis correspondem às opções disponíveis nos comandos da CLI Power Apps.
| Variável de ambiente | Opção correspondente | Description |
|---|---|---|
PA_CLI_CLOUD |
--cloud |
Seleciona a nuvem de destino. Os valores válidos são: - public (padrão)- usgov- usgovhigh- usgovdod- chinaOs valores não diferenciam maiúsculas de minúsculas. |
PA_CLI_ENVIRONMENT_ID |
--environment-id |
Especifica a ID do ambiente do Power Platform de destino. |
Inicialização do aplicativo
Essas 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 de build. O padrão é ./dist. |
PA_CLI_APP_DESCRIPTION |
--description |
Especifica a descrição do aplicativo. |
PA_CLI_APP_DISPLAY_NAME |
--display-name |
Especifica o nome de exibição do aplicativo. |
PA_CLI_APP_FILE_ENTRY_POINT |
--file-entry-point |
Especifica o ponto de entrada HTML na saída do build. O padrão é index.html. |
PA_CLI_APP_TYPE |
--app-type |
Especifica o tipo de aplicativo. Os valores válidos são: - CodeApp (padrão)- MobileAppO valor é salvo power.config.json e usado como o tipo de aplicativo quando o aplicativo é publicado. |
PA_CLI_APP_URL |
--app-url |
Especifica a URL do aplicativo local durante pa app init. O valor é salvo como localAppUrl dentro power.config.json e se torna a URL padrão para comandos futuros pa app run . O padrão é http://localhost:3000. |
Executar aplicativos
Essas 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 |
Substitui o localAppUrl valor do power.config.json comando atual sem alterar a configuração salva. Se nenhum dos valores for definido, o padrão será http://localhost:3000. |
PA_CLI_PORT |
--port |
Especifica a porta do host local Power Apps. O padrão é 8080. |
Compartilhar aplicativos
Essas 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 Microsoft Entra IDs de objeto. |
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 conexão. |
PA_CLI_CONNECTION_ID |
--connection-id |
Especifica uma ID da instância de conexão do conector. |
PA_CLI_CONNECTION_REF |
--connection-ref |
Especifica um nome lógico de referência de conexão. |
PA_CLI_CONNECTION_SEARCH |
--search |
Filtra os resultados de pa connection list. |
PA_CLI_CONNECTOR |
--connector |
Especifica uma ID do conector, como shared_office365users. |
PA_CLI_CONNECTOR_SEARCH |
--search |
Filtra os resultados de pa connector list. |
PA_CLI_DATASET |
--dataset |
Especifica um conjunto de dados, como um site SharePoint ou um banco de dados SQL. |
PA_CLI_DATA_SOURCE_NAME |
--name |
Especifica a fonte de dados a ser atualizada ou removida. |
PA_CLI_ORG_URL |
--org-url |
Substitui a URL da organização do Dataverse usada para recuperar metadados ao adicionar uma fonte de dados. |
PA_CLI_PROCEDURE |
--procedure |
Especifica um procedimento armazenado do SQL. |
PA_CLI_SOLUTION_ID |
--solution-id |
Especifica a solução para pa app push, pa app add data-sourceou pa connection list-references. |
PA_CLI_SOLUTION_SEARCH |
--search |
Filtra os resultados de pa solution list. |
PA_CLI_TABLE |
--table |
Especifica um nome de recurso de tabela ou conector. |
Para obter os comandos que aceitam cada opção, consulte a referência de comando da CLI Power Apps.
APIs do Dataverse e fluxos de 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 ser adicionada com o aplicativo pa adicionar dataverse-api. |
PA_CLI_DATAVERSE_API_SEARCH_TERM |
--search |
Filtra ações e funções do Dataverse por nome com pa app find-dataverse-api. |
PA_CLI_FLOW_DATA_SOURCE_NAME |
--flow-name |
Especifica a fonte de dados de fluxo a ser removida do aplicativo com pa app remove flow |
PA_CLI_FLOW_ID |
--flow-id |
Especifica o fluxo de Power Automate a ser adicionado com pa app add flow. |
PA_CLI_FLOW_SEARCH |
--search |
Filtra os fluxos de Power Automate disponíveis por nome compa app list-flows |
PA_CLI_REMOVE_FLOW_ID |
--flow-id |
Especifica o fluxo de Power Automate a ser removido compa app remove flow |
Telemetria e saída do console
| Variável de ambiente | Opção correspondente | Description |
|---|---|---|
PA_CLI_CONSOLE_ONLY |
--console-only |
Defina o valor como true (em letras minúsculas) com pa telemetry enable ou pa telemetry disable para gravar telemetria somente no console e não enviá-lo remotamente. |
PA_CLI_OUTPUT_TO_CONSOLE |
--output-to-console |
Defina o valor como true (em letras minúsculas) com pa telemetry enable ou pa telemetry disable para espelhar eventos de telemetria enviados remotamente para o console. |
PA_CLI_TELEMETRY |
None | Defina um desses valores para desabilitar a telemetria para o processo atual: - 0- false- no- offOs valores não diferenciam maiúsculas de minúsculas e espaços ao redor são ignorados. |
Para obter configurações de telemetria persistentes, consulte Gerenciar configurações de telemetria para a CLI Power Apps.
Variáveis de ambiente padrão
A CLI também observa essa variável de ambiente padrão:
| Variável de ambiente | Description |
|---|---|
NO_COLOR |
Defina essa variável como um valor não inteiro para desabilitar a saída de cor ANSI. Você também pode usar a opção --no-color . |