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 connection Crie e gerencie conexões e descubra seus recursos.
pa connector Encontre conectores disponíveis em um ambiente do Power Platform.
pa solution Encontre soluções disponíveis em um ambiente do Power Platform.
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 get-settings Exiba as configurações atuais do aplicativo.
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 set-setting Atualize as configurações do aplicativo.
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 solution list Listar soluções no ambiente atual.
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, ou o nome de exibição do conector, como "Usuários do Office 365". Se um nome de exibição corresponder a mais de um conector, o comando listará os identificadores de conector correspondentes para que você possa especificar um.
--as Se o conector deve ser adicionado como uma table ou uma action fonte de dados. Use esse parâmetro com conectores que dão suporte a tabelas e ações, como SharePoint e SQL Server. Para obter mais informações, consulte pa app add data-source comentários.
--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, como cr123_sharedsharepointonline_1a2b3.
--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. Repita esse parâmetro para adicionar várias tabelas do mesmo conector, conexão e conjunto de dados. O Dataverse nativo dá suporte a uma tabela por comando.
--org-url A URL da organização do Dataverse usada para recuperar metadados de tabela nativos do Dataverse. No modo interativo, o comando solicitará esse valor se você não for fornecido como uma opção de comando ou variável de ambiente.
--procedure O procedimento armazenado sql a ser adicionado.

Esses parâmetros têm soluções, conectores e variáveis ambientais de fontes de dados correspondentes.

pa app add data-source Observações

Para adicionar várias tabelas de conector em um comando, repita --table para cada tabela. As tabelas devem usar o mesmo conector, conexão e conjunto de dados. O comando adiciona identificadores de tabela duplicados apenas uma vez. Você pode incluir apenas uma tabela nativa do Dataverse ou um procedimento armazenado sql por comando.

Se uma operação de gravação, validação ou metadados específicos de tabela falhar, o comando ainda adicionará as tabelas válidas. Ele relatará os resultados e failed os resultados ordenados succeeded e retornará um código de saída diferente de zero se alguma tabela falhar. Examine os resultados antes de tentar novamente.

Alguns conectores, como SharePoint e SQL Server, dão suporte a tabelas e ações. Para esses conectores, especifique o que adicionar:

  • Para adicionar tabelas ou um procedimento armazenado sql, use --as table, ou inclua --table ou --procedure.
  • Para adicionar as ações do conector, use --as action. Você não pode usar --as action com --dataset, --tableou --procedure.

Se você não especificar o que adicionar, o comando perguntará Adicionar uma tabela? em um terminal interativo. No modo não interativo, o comando falha até que você especifique --as. Conectores que dão suporte apenas a ações, como Usuários do Office 365, não precisam --as e não dão suporte--as table. Para adicionar ações ou funções do Dataverse, use pa app add dataverse-api em vez de --as action.

Em um terminal interativo, o comando solicita valores necessários que você não fornece como opções de comando ou variáveis de ambiente. Os prompts dependem do tipo de fonte de dados.

Para o Dataverse nativo:

  1. Se você não especificar --connector, o comando solicitará a ID do conector.
  2. O comando solicita o nome lógico da tabela.
  3. O comando solicita a URL da organização do Dataverse quando ela não é fornecida.

O Dataverse nativo não usa uma ID de conexão, uma referência de conexão ou um conjunto de dados.

Para fontes de dados com suporte de conector:

Escolher o conector e o tipo de fonte de dados

  1. Se você não especificar --connector, o comando solicitará a ID do conector.
  2. Se o conector der suporte a tabelas e ações e nada mais determinar o que adicionar, o comando perguntará Adicionar uma tabela?

Escolher a conexão

O comando pergunta Se você está usando uma referência de conexão em vez de uma ID de conexão? Ele ignora essa pergunta quando você fornece uma ID de conexão ou referência de conexão.

  • Se você selecionar Sim, o comando solicitará o nome lógico da referência de conexão.
  • Se você selecionar Não, o comando listará suas conexões para o conector. Selecione (Insira manualmente...) para inserir uma ID de conexão que não esteja na lista.

Escolher os dados

  • Se você estiver adicionando ações, o comando ignorará o procedimento armazenado, o conjunto de dados e os prompts de tabela.

  • Se você estiver adicionando tabelas ou um procedimento armazenado:

    1. Para SQL Server, o comando pergunta se você está adicionando um procedimento armazenado. Se você estiver, ele solicitará o nome do procedimento armazenado.
    2. O comando lista os conjuntos de dados disponíveis por meio da conexão. Selecione (Insira manualmente...) para inserir um conjunto de dados que não está na lista.
    3. A menos que você esteja adicionando um procedimento armazenado, o comando abrirá uma lista pesquisável de tabelas no conjunto de dados. Você pode selecionar mais de uma tabela.

Quando você usa uma referência de conexão, o conjunto de dados e as listas de tabelas vêm da conexão à qual a referência aponta.

pa app add data-source Exemplos

Adicione uma fonte de dados respondendo aos prompts:

pa app add data-source

Adicione uma tabela nativa do Dataverse:

pa app add data-source --connector dataverse --table account

Adicione as ações de um conector que também dá suporte a tabelas:

pa app add data-source \
  --connector shared_sharepointonline \
  --connection-id <connection-id> \
  --as action

Adicione um SharePoint list usando o nome de exibição do conector:

pa app add data-source \
  --connector "SharePoint" \
  --connection-id <connection-id> \
  --dataset <site-url> \
  --table <list-name>

Adicione várias tabelas SQL do mesmo conjunto de dados:

pa app add data-source \
  --connector shared_sql \
  --connection-id <connection-id> \
  --dataset <server-name,database-name> \
  --table "[dbo].[Customers]" \
  --table "[dbo].[Orders]"

Adicione uma tabela por meio de uma referência de conexão e selecione o conjunto de dados e a tabela quando o comando solicitar:

pa app add data-source \
  --connector shared_sharepointonline \
  --connection-ref <connection-reference-logical-name> \
  --solution-id <solution-id> \
  --as table

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.

PA_CLI_DATAVERSE_API_NAME é a variável de ambiente correspondente para o --api-name parâmetro.

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.

PA_CLI_FLOW_ID é a variável de ambiente correspondente para o --flow-id parâmetro.

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.

Esses parâmetros correspondem às APIs do Dataverse e Power Automate fluem variáveis ambientais.

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

pa app get-settings

Exibe as configurações atuais do aplicativo de código.

pa app get-settings [--json]

Parâmetros pa app get-settings

Parâmetro Description
--json Retorne as configurações do aplicativo como JSON.

Execute este comando de um projeto de aplicativo de código inicializado que contém um power.config.json arquivo.

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.
--description A descrição do aplicativo de código.
--build-path O diretório que contém os ativos do aplicativo compilados.
--file-entry-point O ponto de entrada HTML na saída de build.
--app-type O tipo de aplicativo. Os valores válidos são CodeApp e MobileApp.
--app-url A URL do aplicativo de código em execução local.
--cloud A instância de nuvem do Power Platform.

Esses parâmetros têm variáveis ambientais de inicialização de aplicativo correspondentes.

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_CLI_FLOW_SEARCH é a variável de ambiente correspondente para o --search parâmetro.

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.

Use PA_CLI_SOLUTION_ID como a variável de ambiente com o --solution-id parâmetro.

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.

PA_CLI_FLOW_DATA_SOURCE_NAME e PA_CLI_REMOVE_FLOW_ID são variáveis de ambiente correspondentes a serem usadas com esses parâmetros.

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.

Esses parâmetros têm variáveis ambientais de aplicativos de execução correspondentes.

pa app set-setting

Atualiza uma ou mais configurações para o aplicativo de código.

pa app set-setting --show-header <true|false> [--json]

Parâmetros pa app set-setting

Parâmetro Description
--show-header Mostrar ou ocultar o cabeçalho do aplicativo. Os valores válidos são true e false.
--json Retorne as configurações de aplicativo atualizadas como JSON.

Execute este comando de um projeto de aplicativo de código inicializado que contém um power.config.json arquivo. O comando grava a configuração appSettings em power.config.json. Execute pa app push para publicar a configuração para que o player a aplique em runtime.

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.

Esses parâmetros têm variáveis ambientais de aplicativos de compartilhamento correspondentes.

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_CLI_ACCOUNT é a variável de ambiente correspondente para o --account parâmetro.

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.

PA_CLI_ACCOUNT é a variável de ambiente correspondente para o --account parâmetro.

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.

Esses parâmetros têm soluções, conectores e variáveis ambientais de fontes de dados correspondentes.

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.

Use PA_CLI_SOLUTION_ID com o --solution-id parâmetro.

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_CLI_CONNECTOR_SEARCH é a variável de ambiente correspondente a ser usada com o --search parâmetro.

pa connector list saída

Em um terminal interativo, você vê resultados 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 solution list

Lista soluções no ambiente atual, incluindo o nome amigável, o nome exclusivo e a ID da solução.

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

Parâmetros pa solution list

Parâmetro Description
--search Filtrar soluções por nome amigável ou nome exclusivo. O filtro é uma correspondência de subcadeia de caracteres que não diferencia maiúsculas de minúsculas.
--json Retorne a lista de soluções completa como JSON.

PA_CLI_SOLUTION_SEARCH é a variável de ambiente correspondente para o --search parâmetro.

Em um terminal interativo, você vê resultados 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.

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
  • Última atualização em