Nota
O acceso a esta páxina require autorización. Pode tentar iniciar sesión ou modificar os directorios.
O acceso a esta páxina require autorización. Pode tentar modificar os directorios.
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--tableou--procedure. - Para engadir as accións do conector, usa
--as action. Non podes usar--as actioncon--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:
- Se non especificas
--connector, o comando pide o ID do conector. - O comando pide o nome lóxico da táboa.
- 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
- Se non especificas
--connector, o comando pide o ID do conector. - 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:
- Para SQL Server, o comando pregunta se estás engadindo un procedemento almacenado. Se o es, pide o nome do procedemento almacenado.
- 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.
- 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:
- Aprende como actualizar unha operación Dataverse
- Resolución de problemas nas operacións de Dataverse
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:
- Aprende que pasa cando engades un fluxo de Power Automate
- Aprende a actualizar un fluxo de Power Automate
- Revisión das limitacións e consideracións para os fluxos de Power Automate
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:
- Revisar os requisitos previos para engadir unha acción ou función de Dataverse
- Revisar os requisitos previos para engadir fluxos de Power Automate
- Aprende a inicializar unha aplicación de código
- Aprende como funciona o inicio de sesión cando inicializas unha aplicación de código
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.
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.
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