Referencia do comando CLI de Power Apps

Usa esta referencia de comandos Power Apps CLI para atopar rapidamente comandos para crear, desenvolver, conectar e publicar aplicacións de código Power Apps. A CLI usa comandos agrupados no seguinte formato:

pa <command-group> <command>

Estes son os grupos de comando:

Grupo de mando Descrición
pa app Crear, executar, conectar e publicar aplicacións de código.
pa auth Inicia sesión e xestiona contas.
pa connection Crea e xestiona conexións e descubre os seus recursos.
pa connector Atopa conectores dispoñibles nun entorno Power Platform.
pa solution Atopa solucións dispoñibles nun entorno Power Platform.
pa telemetry Xestiona a configuración da telemetría da CLI.

Opcións globais

Úsase --help en calquera nivel para mostrar axuda no terminal:

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

Úsase --version para mostrar a versión instalada da CLI de Power Apps:

pa --version

Comandos CLI de Power Apps

Estes comandos están dispoñibles:

Comando Descrición
pa app add data-source Engade un conector ou fonte de datos tabular á aplicación de código.
pa app add dataverse-api Engade unha acción ou función de Dataverse á aplicación de código.
pa app add flow Engade un fluxo de Power Automate á aplicación de código.
pa app find-dataverse-api Atopa accións e funcións de Dataverse no entorno actual.
pa app get-settings Mostra a configuración actual da aplicación.
pa app init Inicializa unha aplicación de código no directorio actual.
pa app list Aplicacións de código de lista no entorno actual.
pa app list-environment-variables Lista as variables do entorno dispoñibles na aplicación de código.
pa app list-flows Lista os fluxos de Power Automate conscientes da solución no entorno actual.
pa app push Publica unha nova versión da app Code en Power Apps.
pa app refresh data-source Actualiza os ficheiros xerados para unha fonte de datos.
pa app remove data-source Elimina unha fonte de datos da aplicación de código.
pa app remove flow Elimina un fluxo de Power Automate da aplicación de código.
pa app run Inicia o anfitrión local de Power Apps para a aplicación de código.
pa app set-setting Actualizar a configuración da aplicación.
pa app share Comparte a aplicación de código cos usuarios ou cos responsables do servizo.
pa auth login Inicia sesión a través do navegador do sistema.
pa auth logout Pecha sesión e elimina a información de autenticación gardada.
pa auth status Mostra as contas iniciadas e identifica a conta activa.
pa auth switch Cambia a conta activa.
pa connection create Crea unha conexión para un conector.
pa connection list Lista as conexións no ambiente actual.
pa connection list-datasets Lista os conxuntos de datos dispoñibles a través dunha conexión.
pa connection list-procedures Lista os procedementos almacenados SQL dispoñibles nun conxunto de datos.
pa connection list-references Lista referencias de conexión nunha solución.
pa connection list-tables Táboas de listas dispoñibles nun conxunto de datos.
pa connector list Lista de conectores dispoñibles no entorno actual de Power Platform.
pa solution list Lista as solucións no entorno actual.
pa telemetry disable Desactiva a recollida de telemetría.
pa telemetry enable Activa a recollida de telemetría.
pa telemetry status Mostra os axustes actuais de telemetría.

pa app add data-source

Engade un conector ou fonte de datos tabular á aplicación de código.

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

pa app add data-source Parámetros

Parámetro Descrición
--connector O identificador do conector, como shared_office365users, ou o nome de visualización do conector, como "Office 365 Users". Se un nome de visualización coincide con máis dun conector, o comando lista os identificadores correspondentes para que poidas especificar un.
--as Se engadir o conector como fonte table de datos ou action como fonte. Usa este parámetro con conectores que soportan tanto as táboas como as accións, como SharePoint e SQL Server. Para máis información, véxase pa app add data-source observacións.
--connection-id O ID de conexión para usar na fonte de datos.
--connection-ref O nome lóxico dunha referencia de conexión, como cr123_sharedsharepointonline_1a2b3.
--solution-id A solución que contén a referencia de conexión.
--dataset O conxunto de datos para unha fonte de datos tabular.
--table A mesa para engadir. Repite este parámetro para engadir varias táboas do mesmo conector, conexión e conxunto de datos. Dataverse nativo soporta unha única táboa por comando.
--org-url A URL da organización Dataverse usada para recuperar metadatos nativos das mesas Dataverse. No modo interactivo, a liña de comandos para este valor se non o proporcionas como opción de comandos ou variable de ambiente.
--procedure O procedemento almacenado SQL para engadir.

Estes parámetros teñen as correspondentes Solucións, conectores e variables ambientais das fontes de datos .

pa app add data-source Observacións

Para engadir varias táboas conectoras nun comando, repite --table para cada táboa. As táboas deben usar o mesmo conector, conexión e conxunto de datos. O comando engade identificadores duplicados da táboa só unha vez. Só podes incluír unha táboa nativa de Dataverse ou un procedemento almacenado SQL por comando.

Se falla unha operación específica de metadatos, validación ou escritura de esquema específica, o comando segue engadindo as táboas válidas. Informa da orde succeeded e failed resulta e devolve un código de saída non nulo se algunha táboa falla. Revisa os resultados antes de tentar de novo.

Algúns conectores, como SharePoint e SQL Server, soportan tanto as táboas como as accións. Para estes conectores, especifica que engadir:

  • Para engadir táboas ou un procedemento almacenado SQL, use --as table, ou inclúa --table ou --procedure.
  • Para engadir as accións do conector, usa --as action. Non podes usar --as action con --dataset, --table, ou --procedure.

Se non especificas que engadir, o comando pregunta Engadir unha táboa? nun terminal interactivo. No modo non interactivo, o comando falla ata que especifiques --as. Os conectores que só soportan accións, como Office 365 Users, non necesitan --as nin soportan --as table. Para engadir accións ou funcións de Dataverse, use pa app add dataverse-api en lugar de --as action.

Nun terminal interactivo, as liñas de comandos mostran valores requiridos que non proporcionas como opcións de comandos ou variables de ambiente. Os prompts dependen do tipo de fonte de datos.

Para Dataverse nativo:

  1. Se non especificas --connector, o comando pide o ID do conector.
  2. O comando pide o nome lóxico da táboa.
  3. O comando pide a URL da organización Dataverse cando non se proporciona.

Native Dataverse non usa un ID de conexión, referencia de conexión nin conxunto de datos.

Para fontes de datos respaldadas por conectores:

Escolla o conector e o tipo de fonte de datos

  1. Se non especificas --connector, o comando pide o ID do conector.
  2. Se o conector soporta tanto as táboas como as accións e nada máis determina que engadir, o comando pregunta: Engade unha táboa?

Escolla a conexión

O comando pregunta : Estás a usar unha referencia de conexión en lugar dun ID de conexión? Salta esta pregunta cando proporcionas un ID ou referencia de conexión.

  • Se seleccionas Si, o comando pide o nome lóxico da referencia da conexión.
  • Se seleccionas Non, o comando lista as túas conexións para o conector. Selecciona (Introduce manualmente...) para introducir un ID de conexión que non estea na lista.

Elixe os datos

  • Se engades accións, o comando omite o procedemento almacenado, o conxunto de datos e as indicacións da táboa.

  • Se engades táboas ou un procedemento almacenado:

    1. Para SQL Server, o comando pregunta se estás engadindo un procedemento almacenado. Se o es, pide o nome do procedemento almacenado.
    2. O comando lista os conxuntos de datos dispoñibles a través da conexión. Seleccione (Introduza manualmente...) para introducir un conxunto de datos que non estea na lista.
    3. A menos que engadas un procedemento almacenado, o comando abre unha lista buscable de táboas no conxunto de datos. Podes seleccionar máis dunha táboa.

Cando usas unha referencia de conexión, o conxunto de datos e as listas de táboas proceden da conexión á que apunta a referencia.

pa app add data-source Exemplos

Engade unha fonte de datos respondendo a preguntas:

pa app add data-source

Engade unha táboa nativa de Dataverse:

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

Engade as accións dun conector que tamén soporta mesas:

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

Engade unha lista de SharePoint list usando o nome de visualización do conector:

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

Engade múltiples táboas SQL do mesmo conxunto de datos:

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

Engade unha táboa a través dunha referencia de conexión, e selecciona o conxunto de datos e a táboa cando apareza o prompt de comandos:

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

Engade unha acción ou función de Dataverse á aplicación de código.

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

pa app add dataverse-api Parámetros

Parámetro Descrición
--api-name O nome da acción ou función de Dataverse para engadir.

PA_CLI_DATAVERSE_API_NAME é a variable de ambiente correspondente para o --api-name parámetro.

Máis información:

pa app add flow

Engade un fluxo de Power Automate á aplicación de código.

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

pa app add flow Parámetros

Parámetro Descrición
--flow-id O ID do fluxo de Power Automate para engadir.

PA_CLI_FLOW_ID é a variable de ambiente correspondente para o --flow-id parámetro.

A orde:

  • Descarga a definición OpenAPI do fluxo.
  • Xera modelos e servizos TypeScript fortemente tipados.
  • Engade o fluxo e as súas referencias de conexión a power.config.json.

Se unha definición de fluxo cambia, executa este comando de novo para rexenerar o código da última versión.

Importante

A persoa que corre pa app add flow debe ter acceso ao fluxo e ás súas conexións subxacentes. O comando falla se a persoa non ten acceso a unha conexión requirida.

Aprende máis sobre escenarios nos que usas este comando:

pa app find-dataverse-api

Atopa accións e funcións de Dataverse no entorno actual.

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

pa app find-dataverse-api Parámetros

Parámetro Descrición
--search O nome da operación a buscar.
--json Devolve os resultados como JSON.

Estes parámetros corresponden ás APIs de Dataverse e ás variables ambientais dos fluxos de Power Automate.

Aprende como atopar operacións dispoñibles en Dataverse.

pa app get-settings

Mostra as configuracións actuais da aplicación de código.

pa app get-settings [--json]

pa app get-settings Parámetros

Parámetro Descrición
--json Devolve a configuración da aplicación como JSON.

Executa este comando desde un proxecto de aplicación de código inicializado que conteña un power.config.json ficheiro.

pa app init

Inicializa unha aplicación de código no directorio actual.

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

pa app init Parámetros

Parámetro Descrición
--display-name O nome de visualización da aplicación de código.
--environment-id O entorno Power Platform para a aplicación de código.
--description A descrición da aplicación de código.
--build-path O directorio que contén os activos compilados da aplicación.
--file-entry-point O punto de entrada HTML na saída da compilación.
--app-type O tipo de aplicación. Os valores válidos son CodeApp e MobileApp.
--app-url A URL da aplicación de código que se executa localmente.
--cloud A instancia da nube de Power Platform.

Estes parámetros teñen as correspondentes variables ambientais de inicialización da aplicación .

Aprende máis sobre escenarios onde podes usar este comando:

pa app list

Lista aplicacións de código no entorno actual.

pa app list

pa app list-environment-variables

Lista as variables do entorno dispoñibles para a aplicación de código.

pa app list-environment-variables

pa app list-flows

Lista os fluxos de Power Automate conscientes da solución no entorno actual.

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 Descrición
--search O filtro flúe polo nome.

PA_CLI_FLOW_SEARCH é a variable de ambiente correspondente para o --search parámetro.

pa app push

Publica unha nova versión da aplicación de código en Power Apps.

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

pa app push Parámetros

Parámetro Descrición
--solution-id O ID da solución á que engadir a aplicación de código.
--non-interactive Publica a aplicación de forma non interactiva. Aprende a publicar aplicacións cun director de servizo.

Úsase PA_CLI_SOLUTION_ID como variable de ambiente co --solution-id parámetro.

Aprende a crear unha aplicación de código usando a CLI de Power Apps.

pa app refresh data-source

Actualiza os ficheiros xerados para unha fonte de datos.

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

pa app refresh data-source Parámetros

Parámetro Descrición
--name O nome da fonte de datos para actualizar.

pa app remove data-source

Elimina unha fonte de datos da aplicación 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 Descrición
--connector O identificador do conector para a fonte de datos.
--name O nome da fonte de datos a eliminar.
--force Elimina a fonte de datos sen necesidade de confirmación.

pa app remove flow

Elimina un fluxo de Power Automate da aplicación de código.

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

pa app remove flow Parámetros

Parámetro Descrición
--flow-name O nome do fluxo de Power Automate para eliminar.
--flow-id O ID do fluxo de Power Automate para eliminar.
--force Elimina o fluxo sen necesidade de confirmación.

PA_CLI_FLOW_DATA_SOURCE_NAME e PA_CLI_REMOVE_FLOW_ID son variables de ambiente correspondentes para usar con estes parámetros.

Aprende a eliminar un fluxo.

pa app run

Inicia o host local de Power Apps para a aplicación de código.

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

pa app run Parámetros

Parámetro Descrición
--port O porto para o anfitrión local.
--local-app-url A URL da aplicación de código que se executa localmente.

Estes parámetros teñen variables ambientais correspondentes para executar aplicacións .

pa app set-setting

Actualiza unha ou máis configuracións da aplicación de código.

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

pa app set-setting Parámetros

Parámetro Descrición
--show-header Mostra ou oculta a cabeceira da aplicación. Os valores válidos son true e false.
--json Devolve a configuración actualizada da aplicación como JSON.

Executa este comando desde un proxecto de aplicación de código inicializado que conteña un power.config.json ficheiro. O comando escribe a configuración en appSettingspower.config.json. Corre pa app push para publicar a configuración para que o xogador a aplique en tempo de execución.

pa app share

Comparte a aplicación de código cos usuarios ou cos responsables do servizo.

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

pa app share Parámetros

Parámetro Descrición
--principal Enderezos de correo electrónico separados por comas ou IDs de obxectos Microsoft Entra para que os usuarios ou os responsables do servizo poidan compartir.
--access O nivel de acceso para conceder: play (por defecto) ou edit.

Estes parámetros teñen as correspondentes variables ambientais de Compartir aplicacións .

pa app share Observacións

A aplicación de código debe estar xa publicada e ter un ID de aplicación dun comando exitoso pa app push . Conceder edit acceso cando un principal de servizo necesite executar pa app push.

Ao compartir cun principal de servizo, usa o ID do obxecto da aplicación empresarial, non o ID do obxecto de rexistro da aplicación.

pa auth login

Inicia sesión a través do navegador do sistema.

pa auth login

Para preencher a conta na páxina de inicio de sesión, usa:

pa auth login --account user@contoso.com

pa auth login Parámetros

Parámetro Descrición
--account A conta debe preencher na páxina de inicio de sesión.

PA_CLI_ACCOUNT é a variable de ambiente correspondente para o --account parámetro.

pa auth logout

Pecha sesión e elimina a información de autenticación gardada.

pa auth logout

Nota

Este comando desconecta de todas as contas. Non pode desconectarte só dunha conta. Para cambiar que conta está activa, usa pa auth switch en vez diso.

Aprende a pechar sesión

pa auth status

Mostra as contas iniciadas e identifica a conta activa.

Para mostrar o estado de autenticación como JSON, usa:

pa auth status --json

pa auth status Parámetros

Parámetro Descrición
--json Devolve o estado de autenticación como JSON.

Aprende a comprobar que conta está activa

pa auth switch

Cambia a conta activa.

pa auth switch --account user@contoso.com

pa auth switch Parámetros

Parámetro Descrición
--account A conta para facer activa.

PA_CLI_ACCOUNT é a variable de ambiente correspondente para o --account parámetro.

Aprende máis sobre cando podes usar este comando:

pa connection create

Crea unha conexión para un conector.

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

pa connection create Parámetros

Parámetro Alias Necesario Descrición
--connector - Si O identificador do conector, como shared_office365 ou shared_teams.
--display-name -n Non O nome de visualización da conexión. Se non proporcionas un nome, a CLI usa un nome por defecto.
--json - Non Devolve o resultado como JSON.

pa connection create Exemplos

Crea unha conexión Office 365 Outlook:

pa connection create --connector shared_office365

Crea unha conexión con Microsoft Teams cun nome de visualización personalizado:

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

Crea unha conexión e devolve o resultado en JSON:

pa connection create --connector shared_office365 --json

pa connection create Saída

Cando o comando ten éxito, devolve o ID da conexión. Usa o ID de conexión cando engadas o conector como fonte de datos á aplicación de código.

Aprende a crear unha conexión desde a CLI de Power Apps

pa connection list

Lista conexións no entorno actual.

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

pa connection list Parámetros

Parámetro Descrición
--search Filtra as conexións polo nome.
--json Devolve os resultados como JSON.

Estes parámetros teñen as correspondentes Solucións, conectores e variables ambientais das fontes de datos .

pa connection list-datasets

Lista conxuntos de datos dispoñibles a través dunha conexión.

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

pa connection list-datasets Parámetros

Parámetro Descrición
--connector O identificador do conector.
--connection-id O ID de conexión para usar ao listar conxuntos de datos.

pa connection list-procedures

Lista os procedementos almacenados SQL dispoñibles nun conxunto de datos.

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

pa connection list-procedures Parámetros

Parámetro Descrición
--connection-id O ID de conexión para usar ao listar procedementos almacenados.
--dataset O conxunto de datos que contén os procedementos almacenados.

pa connection list-references

Lista referencias de conexión nunha solución.

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

pa connection list-references Parámetros

Parámetro Descrición
--solution-id O ID da solución que contén as referencias de conexión.

Úsao PA_CLI_SOLUTION_ID co --solution-id parámetro.

pa connection list-tables

Listas táboas dispoñibles nun conxunto de datos.

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

pa connection list-tables Parámetros

Parámetro Descrición
--connector O identificador do conector.
--connection-id O ID de conexión para usar ao listar táboas.
--dataset O conxunto de datos que contén as táboas.

pa connector list

Lista dos conectores dispoñibles no entorno actual de Power Platform.

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

pa connector list Parámetros

Parámetro Descrición
--search Conectores de filtro por nome ou nome de visualización.
--json Devolve a lista completa de conectores como JSON.

PA_CLI_CONNECTOR_SEARCH é a variable de ambiente correspondente a usar co --search parámetro.

pa connector list Saída

Nun terminal interactivo, ves resultados en páxinas de 20 filas. Preme Enter para mostrar a seguinte páxina. PremeEsc ou Q para saír. Cando redirixes a saída ou inclúes --json, o comando devolve a lista completa.

Por defecto, o comando devolve unha táboa coas seguintes columnas:

Columna Descrición
Nome para mostrar O nome de visualización do conector, como Office 365 Outlook.
Conector O identificador do conector, como shared_office365. Usa este valor coa --connector opción de pa connection create.

Cando usas o --json parámetro, a saída JSON inclúe os seguintes campos:

Campo Descrición
id O ID do conector.
name O identificador do conector, como shared_office365.
displayName O nome de visualización do conector.
description A descrición do conector.
isTabular Indica se o conector soporta operacións de datos tabulares.

pa connector list Exemplos

Lista de todos os conectores dispoñibles:

pa connector list

Busca conectores:

pa connector list --search teams

Devolve a lista de conectores como JSON:

pa connector list --json

Aprende a listar os conectores dispoñibles

pa solution list

Lista solucións no entorno actual, incluíndo o seu nome amigable, nome único e ID da solución.

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

pa solution list Parámetros

Parámetro Descrición
--search Filtra as solucións por nome amigable ou nome único. O filtro é unha coincidencia de subcadea insensible a maiúsculas minúsculas.
--json Devolve a lista completa de solucións como JSON.

PA_CLI_SOLUTION_SEARCH é a variable de ambiente correspondente para o --search parámetro.

Nun terminal interactivo, ves resultados en páxinas de 20 filas. Preme Enter para mostrar a seguinte páxina. PremeEsc ou Q para saír. Cando redirixes a saída ou inclúes --json, o comando devolve a lista completa.

pa telemetry disable

Desactiva a recollida de telemetría.

pa telemetry disable

pa telemetry enable

Permite a recollida de telemetría.

pa telemetry enable

pa telemetry status

Mostra as configuracións actuais de telemetría.

pa telemetry status