Referência de comandos CLI do Power Apps

Use esta referência de comandos Power Apps CLI para encontrar rapidamente comandos para criar, desenvolver, ligar e publicar aplicações de código Power Apps. A CLI utiliza comandos agrupados no seguinte formato:

pa <command-group> <command>

Estes são os grupos de comando:

Grupo de comando Description
pa app Criar, executar, ligar e publicar aplicações de código.
pa auth Inicia sessão e gere contas.
pa connection Crie e gere ligações e descubra os seus recursos.
pa connector Encontre conectores disponíveis num ambiente Power Platform.
pa solution Encontre soluções disponíveis num ambiente Power Platform.
pa telemetry Gerir as definições de telemetria da CLI.

Opções globais

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

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

Use --version para mostrar a versão instalada do Power Apps CLI:

pa --version

Comandos CLI do Power Apps

Estes comandos estão disponíveis:

Command Description
pa app add data-source Adicione um conector ou fonte de dados tabulares à aplicação de código.
pa app add dataverse-api Adicione uma ação ou função Dataverse à aplicação de código.
pa app add flow Adicione um fluxo do Power Automate à aplicação de código.
pa app find-dataverse-api Encontre ações e funções do Dataverse no ambiente atual.
pa app get-settings Mostrar as definições atuais da aplicação.
pa app init Inicialize uma aplicação de código no diretório atual.
pa app list Aplicações de código de lista no ambiente atual.
pa app list-environment-variables Liste as variáveis de ambiente disponíveis para a aplicação de código.
pa app list-flows Liste os fluxos do Power Automate conscientes da solução no ambiente atual.
pa app push Publique uma nova versão da aplicação Code no Power Apps.
pa app refresh data-source Atualize os ficheiros gerados para uma fonte de dados.
pa app remove data-source Remova uma fonte de dados da aplicação de código.
pa app remove flow Remover um fluxo do Power Automate da aplicação de código.
pa app run Inicia o anfitrião local do Power Apps para a aplicação de código.
pa app set-setting Atualizar as definições da aplicação.
pa app share Partilhe a aplicação de código com os utilizadores ou com os responsáveis do serviço.
pa auth login Iniciar sessão através do navegador do sistema.
pa auth logout Faça logout e remova as informações de autenticação guardadas.
pa auth status Mostre as contas iniciadas e identifique a conta ativa.
pa auth switch Muda a conta ativa.
pa connection create Crie uma ligação para um conector.
pa connection list Liste as ligações no ambiente atual.
pa connection list-datasets Liste conjuntos de dados disponíveis através de uma ligação.
pa connection list-procedures Liste os procedimentos armazenados SQL disponíveis num conjunto de dados.
pa connection list-references Liste referências de ligação numa solução.
pa connection list-tables Tabelas de listas disponíveis num conjunto de dados.
pa connector list Liste conectores disponíveis no ambiente atual da Power Platform.
pa solution list Liste as soluções no ambiente atual.
pa telemetry disable Desativar a recolha de telemetria.
pa telemetry enable Ativar a recolha de telemetria.
pa telemetry status Mostrar as definições atuais de telemetria.

pa app add data-source

Adiciona um conector ou fonte de dados tabulares à aplicação de código.

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

pa app add data-source Parâmetros

Parâmetro Description
--connector O identificador do conector, como shared_office365users, ou o nome de exibição do conector, como "Utilizadores do Office 365". Se um nome de exibição corresponder a mais do que um conector, o comando lista os identificadores correspondentes para que possa especificar um.
--as Se deve adicionar o conector como uma table fonte de dados ou action como uma fonte de dados. Use este parâmetro com conectores que suportem tanto tabelas como ações, como SharePoint e SQL Server. Para mais informações, consulte pa app add data-source as observações.
--connection-id O ID de ligação a usar 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 ligação.
--dataset O conjunto de dados para uma fonte de dados tabular.
--table A tabela para acrescentar. Repita este parâmetro para adicionar múltiplas tabelas do mesmo conector, ligação e conjunto de dados. O Dataverse nativo suporta uma tabela por comando.
--org-url A URL da organização Dataverse é usada para recuperar metadados nativos das tabelas Dataverse. No modo interativo, o prompt de comandos para este valor se não o fornecer como opção de comando ou variável de ambiente.
--procedure O procedimento SQL armazenado para adicionar.

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

pa app add data-source Observações

Para adicionar múltiplas tabelas de ligação num só comando, repita --table para cada tabela. As tabelas devem usar o mesmo conector, ligação e conjunto de dados. O comando adiciona identificadores duplicados de tabela apenas uma vez. Pode incluir apenas uma tabela nativa do Dataverse ou um procedimento armazenado SQL por comando.

Se falhar uma operação específica de metadados, validação ou escrita de esquema específica, o comando ainda adiciona as tabelas válidas. Reporta a ordem succeeded e failed o resultado e devolve um código de saída diferente de zero se alguma tabela falhar. Revê os resultados antes de tentar novamente.

Alguns conectores, como SharePoint e SQL Server, suportam tanto tabelas como ações. Para estes 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. Não podes usar --as action com --dataset, --table, ou --procedure.

Se não especificar o que adicionar, o comando pergunta Adicionar uma tabela? num terminal interativo. No modo não interativo, o comando falha até que especifique --as. Conectores que suportam apenas ações, como o Utilizadores do Office 365, não precisam --as nem suportam --as table. Para adicionar ações ou funções do Dataverse, use pa app add dataverse-api em vez de --as action.

Num terminal interativo, os prompts de comandos indicam valores necessários que não forneces como opções de comando ou variáveis de ambiente. Os prompts dependem do tipo de fonte de dados.

Para Dataverse nativo:

  1. Se não especificar --connector, o comando pede o ID do conector.
  2. O comando pede o nome lógico da tabela.
  3. O comando pede a URL da organização Dataverse quando esta não é fornecida.

O Dataverse nativo não utiliza um ID de ligação, referência de ligação ou conjunto de dados.

Para fontes de dados suportadas por conectores:

Escolha o conector e o tipo de fonte de dados

  1. Se não especificar --connector, o comando pede o ID do conector.
  2. Se o conector suporta tanto tabelas como ações e nada mais determina o que adicionar, o comando pergunta Adicionar uma tabela?

Escolha a ligação

O comando pergunta : Estás a usar uma referência de ligação em vez de um ID de ligação? Ignora esta pergunta quando forneces um ID ou referência de ligação.

  • Se selecionares Sim, o comando pede o nome lógico da referência da ligação.
  • Se selecionares Não, o comando lista as tuas ligações para o conector. Selecione (Enter manualmente...) para inserir um ID de ligação que não esteja na lista.

Escolha os dados

  • Se estiveres a adicionar ações, o comando salta os prompts de procedimento armazenado, conjunto de dados e tabelas.

  • Se está a adicionar tabelas ou um procedimento armazenado:

    1. Para o SQL Server, o comando pergunta se está a adicionar um procedimento armazenado. Se estiveres, pede o nome do procedimento armazenado.
    2. O comando lista os conjuntos de dados disponíveis através da ligação. Selecione (Introduzir manualmente...) para inserir um conjunto de dados que não esteja na lista.
    3. A menos que esteja a adicionar um procedimento armazenado, o comando abre uma lista pesquisável de tabelas no conjunto de dados. Pode selecionar mais do que uma tabela.

Quando usas uma referência de ligação, o conjunto de dados e as listas de tabelas vêm da ligação para a qual a referência aponta.

pa app add data-source exemplos

Adicione uma fonte de dados respondendo a 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 suporta tabelas:

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

Adicione uma lista 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 através de uma referência de ligação e selecione o conjunto de dados e a tabela quando o prompt de comandos aparecer:

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 à aplicação de código.

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

pa app add dataverse-api Parâmetros

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

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 Power Automate à aplicação de código.

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

pa app add flow Parâmetros

Parâmetro Description
--flow-id O ID do fluxo do Power Automate para adicionar.

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

O comando:

  • Descarrega a definição OpenAPI do fluxo.
  • Gera modelos e serviços TypeScript fortemente tipados.
  • Adiciona o fluxo e as suas referências de ligação a power.config.json.

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

Importante

A pessoa que corre pa app add flow deve ter acesso ao fluxo e às suas ligações subjacentes. O comando falha se a pessoa não tiver acesso a uma ligação necessária.

Saiba mais sobre cenários em que utiliza este comando:

pa app find-dataverse-api

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

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

pa app find-dataverse-api Parâmetros

Parâmetro Description
--search O nome da operação a procurar.
--json Devolva os resultados em JSON.

Estes parâmetros correspondem às APIs do Dataverse e às variáveis ambientais dos fluxos do Power Automate.

Saiba como encontrar operações disponíveis no Dataverse.

pa app get-settings

Mostra as definições atuais da aplicação de código.

pa app get-settings [--json]

pa app get-settings Parâmetros

Parâmetro Description
--json Devolve as definições da aplicação como JSON.

Execute este comando a partir de um projeto de aplicação de código inicializado que contenha um power.config.json ficheiro.

pa app init

Inicializa uma aplicação de código no diretório atual.

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

pa app init Parâmetros

Parâmetro Description
--display-name O nome de exibição da aplicação de código.
--environment-id O ambiente Power Platform para a aplicação de código.
--description A descrição da aplicação de código.
--build-path O diretório que contém os ativos compilados da app.
--file-entry-point O ponto de entrada HTML na saída da compilação.
--app-type O tipo de aplicação. Os valores válidos são CodeApp e MobileApp.
--app-url O URL da aplicação de código a correr localmente.
--cloud A instância cloud da Power Platform.

Estes parâmetros têm variáveis ambientais de inicialização da aplicação correspondentes.

Saiba mais sobre cenários onde pode usar este comando:

pa app list

Lista aplicações de código no ambiente atual.

pa app list

pa app list-environment-variables

Lista variáveis de ambiente disponíveis para a aplicação de código.

pa app list-environment-variables

pa app list-flows

Lista fluxos do Power Automate conscientes da solução no ambiente atual.

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

Exemplo: 

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

pa app list-flows Parâmetros

Parâmetro Description
--search O filtro flui pelo nome.

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

pa app push

Publica uma nova versão da aplicação de código para o Power Apps.

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

pa app push Parâmetros

Parâmetro Description
--solution-id O ID da solução para adicionar a aplicação de código.
--non-interactive Publica a aplicação de forma não interativa. Aprenda a publicar aplicações com um princípio de serviço.

Usa PA_CLI_SOLUTION_ID como variável ambiente com o --solution-id parâmetro.

Aprenda a criar uma aplicação de código usando a CLI do Power Apps.

pa app refresh data-source

Atualiza os ficheiros gerados para uma fonte de dados.

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

pa app refresh data-source Parâmetros

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

pa app remove data-source

Remove uma fonte de dados da aplicação de código.

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

pa app remove data-source Parâmetros

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

pa app remove flow

Remove um fluxo do Power Automate da aplicação de código.

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

pa app remove flow Parâmetros

Parâmetro Description
--flow-name O nome do fluxo do Power Automate para remover.
--flow-id O ID do fluxo do Power Automate a remover.
--force Remova o fluxo sem necessidade de confirmação.

PA_CLI_FLOW_DATA_SOURCE_NAME e PA_CLI_REMOVE_FLOW_ID são variáveis de ambiente correspondentes a usar com estes parâmetros.

Aprenda a remover um fluxo.

pa app run

Inicia o host local do Power Apps para a aplicação de código.

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

pa app run Parâmetros

Parâmetro Description
--port O port para o anfitrião local.
--local-app-url O URL da aplicação de código a correr localmente.

Estes parâmetros têm variáveis ambientais correspondentes de Executar aplicações .

pa app set-setting

Atualiza uma ou mais definições da aplicação de código.

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

pa app set-setting Parâmetros

Parâmetro Description
--show-header Mostrar ou esconder o cabeçalho da aplicação. Os valores válidos são true e false.
--json Devolve as definições atualizadas da app em JSON.

Execute este comando a partir de um projeto de aplicação de código inicializado que contenha um power.config.json ficheiro. O comando escreve a definição em appSettings .power.config.json Corre pa app push para publicar a definição para que o jogador a aplique em tempo de execução.

pa app share

Partilha a aplicação de código com os utilizadores ou com os responsáveis do serviço.

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

pa app share Parâmetros

Parâmetro Description
--principal Endereços de email separados por vírgulas ou IDs de objeto Microsoft Entra para os utilizadores ou os principais do serviço partilharem.
--access O nível de acesso a conceder: play (padrão) ou edit.

Estes parâmetros têm variáveis ambientais correspondentes às aplicações de partilha .

pa app share Observações

A aplicação de código deve já estar publicada e ter um ID de aplicação de um comando bem-sucedido pa app push . Conceda edit acesso quando um principal de serviço precisa de funcionar pa app push.

Ao partilhar com um principal de serviço, use o ID do objeto da Aplicação Empresarial, e não o ID do objeto de Registo da Aplicação.

pa auth login

Inicia sessão através do navegador do sistema.

pa auth login

Para pré-preencher a conta na página de inicio, utilize:

pa auth login --account user@contoso.com

pa auth login Parâmetros

Parâmetro Description
--account A conta deve pré-preencher na página de inicio.

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

pa auth logout

Desliga-se e remove as informações de autenticação guardadas.

pa auth logout

Note

Este comando desliga-o de todas as contas. Não te pode desligar apenas de uma conta. Para mudar qual conta está ativa, use pa auth switch em vez disso.

Aprende como desligar

pa auth status

Mostra as contas iniciadas e identifica a conta ativa.

Para mostrar o estado de autenticação como JSON, utilize:

pa auth status --json

pa auth status Parâmetros

Parâmetro Description
--json Devolva o estado de autenticação como JSON.

Aprenda a verificar qual conta está ativa

pa auth switch

Altera a conta ativa.

pa auth switch --account user@contoso.com

pa auth switch Parâmetros

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

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

Saiba mais sobre quando pode usar este comando:

pa connection create

Cria uma ligação para um conector.

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

pa connection create Parâmetros

Parâmetro Alias Obrigatório Description
--connector - Yes O identificador do conector, como shared_office365 ou shared_teams.
--display-name -n No O nome de exibição da ligação. Se não fornecer um nome, a CLI usa um nome padrão.
--json - No Devolve o resultado como JSON.

pa connection create exemplos

Crie uma ligação Office 365 Outlook:

pa connection create --connector shared_office365

Crie uma ligação ao Microsoft Teams com um nome de visualização personalizado:

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

Crie uma ligação e devolve o resultado em JSON:

pa connection create --connector shared_office365 --json

pa connection create saída

Quando o comando tem sucesso, devolve o ID da ligação. Usa o ID de ligação quando adicionares o conector como fonte de dados à aplicação de código.

Aprenda a criar uma ligação a partir da CLI do Power Apps

pa connection list

Lista ligações no ambiente atual.

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

pa connection list Parâmetros

Parâmetro Description
--search Filtra as ligações pelo nome.
--json Devolva os resultados em JSON.

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

pa connection list-datasets

Lista conjuntos de dados disponíveis através de uma ligação.

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

pa connection list-datasets Parâmetros

Parâmetro Description
--connector O identificador do conector.
--connection-id O ID de ligação a usar ao listar conjuntos de dados.

pa connection list-procedures

Lista os procedimentos armazenados SQL disponíveis num conjunto de dados.

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

pa connection list-procedures Parâmetros

Parâmetro Description
--connection-id O ID de ligação a usar ao listar procedimentos armazenados.
--dataset O conjunto de dados que contém os procedimentos armazenados.

pa connection list-references

Lista referências de ligação numa solução.

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

pa connection list-references Parâmetros

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

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

pa connection list-tables

Listas tabelas disponíveis num conjunto de dados.

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

pa connection list-tables Parâmetros

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

pa connector list

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

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

pa connector list Parâmetros

Parâmetro Description
--search Filtra os conectores por nome ou nome de exibição.
--json Devolva a lista completa de conectores em JSON.

PA_CLI_CONNECTOR_SEARCH é a variável de ambiente correspondente a usar com o --search parâmetro.

pa connector list saída

Num terminal interativo, vê-se os resultados em páginas de 20 linhas. Carrega em Enter para mostrar a página seguinte. Pressiona Esc ou Q para sair. Quando redireciona a saída ou inclui --json, o comando devolve a lista completa.

Por defeito, o comando devolve uma tabela com as seguintes colunas:

Column 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 este valor com a --connector opção de pa connection create.

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

Campo Description
id O 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 suporta operações de dados tabulares.

pa connector list exemplos

Liste todos os conectores disponíveis:

pa connector list

Procure por conectores:

pa connector list --search teams

Devolve a lista de conectores como JSON:

pa connector list --json

Aprenda a listar os conectores disponíveis

pa solution list

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

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

pa solution list Parâmetros

Parâmetro Description
--search Filtra as soluções por nome amigo ou nome único. O filtro é uma correspondência de substrings insensível a maiúsculas minúsculas.
--json Devolve a lista completa de soluções em JSON.

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

Num terminal interativo, vê-se os resultados em páginas de 20 linhas. Carrega em Enter para mostrar a página seguinte. Pressiona Esc ou Q para sair. Quando redireciona a saída ou inclui --json, o comando devolve a lista completa.

pa telemetry disable

Desativa a recolha de telemetria.

pa telemetry disable

pa telemetry enable

Permite a recolha de telemetria.

pa telemetry enable

pa telemetry status

Mostra as definições atuais de telemetria.

pa telemetry status
  • Last updated on