referência de comando da CLI Power Apps

Use essa referência de comando da CLI Power Apps para localizar rapidamente comandos para criar, desenvolver, conectar e publicar aplicativos de código Power Apps. A CLI usa comandos agrupados no seguinte formato:

pa <command-group> <command>

Estes são os grupos de comandos:

Grupo de comandos Description
pa app Criar, executar, conectar e publicar aplicativos de código.
pa auth Entre e gerencie contas.
pa connector Encontre conectores disponíveis em um ambiente do Power Platform.
pa connection Crie e gerencie conexões e descubra seus recursos.
pa telemetry Gerenciar as configurações de telemetria da CLI.

Opções globais

Use --help em qualquer nível para exibir a ajuda no terminal:

pa --help
pa app --help
pa app init --help

Use --version para exibir a versão da CLI Power Apps instalada:

pa --version

comandos da CLI Power Apps

Estes comandos estão disponíveis:

Command Description
pa app add data-source Adicione um conector ou uma fonte de dados tabular ao aplicativo de código.
pa app add dataverse-api Adicione uma ação ou função do Dataverse ao aplicativo de código.
pa app add flow Adicione um fluxo de Power Automate ao aplicativo de código.
pa app find-dataverse-api Localize ações e funções do Dataverse no ambiente atual.
pa app init Inicialize um aplicativo de código no diretório atual.
pa app list Listar aplicativos de código no ambiente atual.
pa app list-environment-variables Listar variáveis de ambiente disponíveis para o aplicativo de código.
pa app list-flows Listar fluxos de Power Automate com reconhecimento de solução no ambiente atual.
pa app push Publique uma nova versão do aplicativo de código para Power Apps.
pa app refresh data-source Atualize os arquivos gerados para uma fonte de dados.
pa app remove data-source Remova uma fonte de dados do aplicativo de código.
pa app remove flow Remova um fluxo de Power Automate do aplicativo de código.
pa app run Inicie a Power Apps host local para o aplicativo de código.
pa app share Compartilhe o aplicativo de código com usuários ou entidades de serviço.
pa auth login Entre por meio do navegador do sistema.
pa auth logout Saia e remova as informações de autenticação salvas.
pa auth status Exiba contas assinadas e identifique a conta ativa.
pa auth switch Altere a conta ativa.
pa connection create Crie uma conexão para um conector.
pa connection list Listar conexões no ambiente atual.
pa connection list-datasets Listar conjuntos de dados disponíveis por meio de uma conexão.
pa connection list-procedures Listar procedimentos armazenados do SQL disponíveis em um conjunto de dados.
pa connection list-references Listar referências de conexão em uma solução.
pa connection list-tables Listar tabelas disponíveis em um conjunto de dados.
pa connector list Listar conectores disponíveis no ambiente atual do Power Platform.
pa telemetry disable Desabilite a coleção de telemetria.
pa telemetry enable Habilite a coleção de telemetria.
pa telemetry status Exiba as configurações de telemetria atuais.

pa app add data-source

Adiciona uma fonte de dados de tabela ou conector ao aplicativo de código.

pa app add data-source --connector <connector-id> [options]

Parâmetros pa app add data-source

Parâmetro Description
--connector O identificador do conector, como shared_office365users.
--connection-id A ID de conexão a ser usada para a fonte de dados.
--connection-ref O nome lógico de uma referência de conexão.
--solution-id A solução que contém a referência de conexão.
--dataset O conjunto de dados de uma fonte de dados tabular.
--table A tabela a ser adicionada.
--procedure O procedimento armazenado sql a ser adicionado.

pa app add dataverse-api

Adiciona uma ação ou função do Dataverse ao aplicativo de código.

pa app add dataverse-api --api-name <operation-name>

Parâmetros pa app add dataverse-api

Parâmetro Description
--api-name O nome da ação ou função do Dataverse a ser adicionada.

Saiba mais:

pa app add flow

Adiciona um fluxo de Power Automate ao aplicativo de código.

pa app add flow --flow-id <flow-id>

Parâmetros pa app add flow

Parâmetro Description
--flow-id A ID do fluxo de Power Automate a ser adicionado.

O comando:

  • Baixa a definição de OpenAPI do fluxo.
  • Gera modelos e serviços typeScript fortemente tipado.
  • Adiciona o fluxo e suas referências de conexão a power.config.json.

Se uma definição de fluxo for alterada, execute este comando novamente para regenerar o código da versão mais recente.

Importante

A pessoa que executa pa app add flow deve ter acesso ao fluxo e suas conexões subjacentes. O comando falhará se a pessoa não tiver acesso a uma conexão necessária.

Saiba mais sobre cenários em que você usa este comando:

pa app find-dataverse-api

Localiza ações e funções do Dataverse no ambiente atual.

pa app find-dataverse-api --search <operation-name> [--json]

Parâmetros pa app find-dataverse-api

Parâmetro Description
--search O nome da operação a ser pesquisado.
--json Retorne os resultados como JSON.

Saiba como localizar as operações disponíveis do Dataverse

pa app init

Inicializa um aplicativo de código no diretório atual.

pa app init [--display-name <name>] [--environment-id <environment-id>]

Parâmetros pa app init

Parâmetro Description
--display-name O nome de exibição do aplicativo de código.
--environment-id O ambiente do Power Platform para o aplicativo de código.
--build-path O diretório que contém os ativos do aplicativo compilados.
--cloud A instância de nuvem do Power Platform.

Saiba mais sobre cenários em que você pode usar este comando:

pa app list

Lista aplicativos de código no ambiente atual.

pa app list

pa app list-environment-variables

Lista variáveis de ambiente disponíveis para o aplicativo de código.

pa app list-environment-variables

pa app list-flows

Lista fluxos de Power Automate com reconhecimento de solução no ambiente atual.

pa app list-flows [--search <term>]

Example:

pa app list-flows

Name                    Status   Modified On   Flow ID
──────────────────────────────────────────────────────────────────────────────
Approval Workflow       Started  2026-01-15    a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1
Send Notification       Started  2026-02-01    b1b1b1b1-cccc-dddd-eeee-f2f2f2f2f2f2

Total flows: 2

Parâmetros pa app list-flows

Parâmetro Description
--search Filtrar fluxos por nome.

pa app push

Publica uma nova versão do aplicativo de código para Power Apps.

pa app push [--solution-id <solution-id>]

Parâmetros pa app push

Parâmetro Description
--solution-id A ID da solução à qual adicionar o aplicativo de código.
--non-interactive Publica o aplicativo de forma não interativa. Saiba como publicar aplicativos com uma entidade de serviço.

Saiba como criar um aplicativo de código usando a CLI do Power Apps.

pa app refresh data-source

Atualiza os arquivos gerados para uma fonte de dados.

pa app refresh data-source --name <data-source-name>

Parâmetros pa app refresh data-source

Parâmetro Description
--name O nome da fonte de dados a ser atualizada.

pa app remove data-source

Remove uma fonte de dados do aplicativo de código.

pa app remove data-source --connector <connector-id> --name <data-source-name> [--force]

Parâmetros pa app remove data-source

Parâmetro Description
--connector O identificador do conector para a fonte de dados.
--name O nome da fonte de dados a ser removida.
--force Remova a fonte de dados sem solicitar confirmação.

pa app remove flow

Remove um fluxo de Power Automate do aplicativo de código.

pa app remove flow [--flow-name <name> | --flow-id <flow-id>] [--force]

Parâmetros pa app remove flow

Parâmetro Description
--flow-name O nome do fluxo de Power Automate a ser removido.
--flow-id A ID do fluxo de Power Automate a ser removido.
--force Remova o fluxo sem solicitar confirmação.

Saiba como remover um fluxo

pa app run

Inicia o Power Apps host local para o aplicativo de código.

pa app run [--port <port>] [--local-app-url <url>]

Parâmetros pa app run

Parâmetro Description
--port A porta do host local.
--local-app-url A URL do aplicativo de código em execução local.

pa app share

Compartilha o aplicativo de código com usuários ou entidades de serviço.

pa app share --principal <principal> [--access play|edit]

Parâmetros pa app share

Parâmetro Description
--principal Endereços de email separados por vírgulas ou Microsoft Entra IDs de objeto para os usuários ou entidades de serviço para compartilhar.
--access O nível de acesso a ser concedido: play (padrão) ou edit.

pa app share Observações

O aplicativo de código já deve ser publicado e ter uma ID do aplicativo de um comando bem-sucedido pa app push . Conceda edit acesso quando uma entidade de serviço precisar ser executada pa app push.

Ao compartilhar com uma entidade de serviço, use a ID do objeto aplicativo empresarial, não a ID do objeto Registro de Aplicativo.

pa auth login

Entra por meio do navegador do sistema.

pa auth login

Para pré-preencher a conta na página de entrada, use:

pa auth login --account user@contoso.com

Parâmetros pa auth login

Parâmetro Description
--account A conta a ser preenchida previamente na página de entrada.

pa auth logout

Sai e remove as informações de autenticação salvas.

pa auth logout

Note

Esse comando o desconscreve de todas as contas. Não é possível desconectar você de apenas uma conta. Para alterar qual conta está ativa, use pa auth switch em vez disso.

Saiba como sair

pa auth status

Exibe contas assinadas e identifica a conta ativa.

Para exibir o status de autenticação como JSON, use:

pa auth status --json

Parâmetros pa auth status

Parâmetro Description
--json Retorne o status de autenticação como JSON.

Saiba como verificar qual conta está ativa

pa auth switch

Altera a conta ativa.

pa auth switch --account user@contoso.com

Parâmetros pa auth switch

Parâmetro Description
--account A conta a ser ativa.

Saiba mais sobre quando você pode usar este comando:

pa connection create

Cria uma conexão para um conector.

pa connection create --connector <connector-id> [--display-name <name>] [--json]

Parâmetros pa connection create

Parâmetro Alias Obrigatório Description
--connector - Sim O identificador do conector, como shared_office365 ou shared_teams.
--display-name -n No O nome de exibição da conexão. Se você não fornecer um nome, a CLI usará um nome padrão.
--json - No Retorna o resultado como JSON.

pa connection create Exemplos

Criar uma conexão Office 365 Outlook:

pa connection create --connector shared_office365

Crie uma conexão Microsoft Teams com um nome de exibição personalizado:

pa connection create --connector shared_teams --display-name "My Teams"

Crie uma conexão e retorne o resultado como JSON:

pa connection create --connector shared_office365 --json

pa connection create saída

Quando o comando for bem-sucedido, ele retornará a ID da conexão. Use a ID de conexão ao adicionar o conector como uma fonte de dados ao aplicativo de código.

Saiba como criar uma conexão com a CLI do Power Apps

pa connection list

Lista conexões no ambiente atual.

pa connection list [--search <term>] [--json]

Parâmetros pa connection list

Parâmetro Description
--search Filtrar conexões por nome.
--json Retorne os resultados como JSON.

pa connection list-datasets

Lista os conjuntos de dados disponíveis por meio de uma conexão.

pa connection list-datasets --connector <connector-id> [--connection-id <connection-id>]

Parâmetros pa connection list-datasets

Parâmetro Description
--connector O identificador do conector.
--connection-id A ID de conexão a ser usada ao listar conjuntos de dados.

pa connection list-procedures

Lista os procedimentos armazenados do SQL disponíveis em um conjunto de dados.

pa connection list-procedures --connection-id <connection-id> --dataset <dataset>

Parâmetros pa connection list-procedures

Parâmetro Description
--connection-id A ID de conexão a ser usada ao listar procedimentos armazenados.
--dataset O conjunto de dados que contém os procedimentos armazenados.

pa connection list-references

Lista referências de conexão em uma solução.

pa connection list-references --solution-id <solution-id>

Parâmetros pa connection list-references

Parâmetro Description
--solution-id A ID da solução que contém as referências de conexão.

pa connection list-tables

Lista tabelas disponíveis em um conjunto de dados.

pa connection list-tables --connector <connector-id> [--connection-id <connection-id>] [--dataset <dataset>]

Parâmetros pa connection list-tables

Parâmetro Description
--connector O identificador do conector.
--connection-id A ID de conexão a ser usada ao listar tabelas.
--dataset O conjunto de dados que contém as tabelas.

pa connector list

Lista os conectores disponíveis no ambiente atual do Power Platform.

pa connector list [--search <term>] [--json]

Parâmetros pa connector list

Parâmetro Description
--search Filtrar conectores por nome ou nome de exibição.
--json Retorne a lista completa de conectores como JSON.

pa connector list saída

Em um terminal interativo, os resultados aparecem em páginas de 20 linhas. Pressione Enter para mostrar a próxima página. Pressione Esc ou Q para sair. Quando você redireciona a saída ou a inclusão --json, o comando retorna a lista completa.

Por padrão, o comando retorna uma tabela com as seguintes colunas:

Coluna Description
Nome de exibição O nome de exibição do conector, como Office 365 Outlook.
Conector O identificador do conector, como shared_office365. Use esse valor com a opção --connector de pa connection create.

Quando você usa o --json parâmetro, a saída JSON inclui os seguintes campos:

Campo Description
id A ID do conector.
name O identificador do conector, como shared_office365.
displayName O nome de exibição do conector.
description A descrição do conector.
isTabular Indica se o conector dá suporte a operações de dados tabulares.

pa connector list Exemplos

Listar todos os conectores disponíveis:

pa connector list

Pesquise conectores:

pa connector list --search teams

Retorne a lista de conectores como JSON:

pa connector list --json

Saiba como listar conectores disponíveis

pa telemetry disable

Desabilita a coleção de telemetria.

pa telemetry disable

pa telemetry enable

Habilita a coleção de telemetria.

pa telemetry enable

pa telemetry status

Exibe as configurações de telemetria atuais.

pa telemetry status
  • Last updated on