referência de comando da CLI Power Apps

Estes são os comandos para as versões mais recentes:

A CLI do Power Apps fornece 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.

Para exibir a ajuda no terminal, use --help em qualquer nível:

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

Comandos

Estes são os comandos 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.

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 Description
--connector O identificador do conector, como shared_office365.
--display-name O nome de exibição da conexão.
--json Retorne o resultado como JSON.

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.

Saiba como criar uma conexão

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