Referència de comandaments CLI de Power Apps

Utilitza aquesta referència de comandes Power Apps CLI per trobar ràpidament ordres per crear, desenvolupar, connectar i publicar aplicacions de codi Power Apps. La CLI utilitza ordres agrupades en el següent format:

pa <command-group> <command>

Aquests són els grups de comandament:

Grup de comandament Descripció
pa app Crea, executa, connecta i publica aplicacions de codi.
pa auth Inicia sessió i gestiona els comptes.
pa connection Crea i gestiona connexions i descobreix els seus recursos.
pa connector Troba connectors disponibles en un entorn Power Platform.
pa solution Troba solucions disponibles en un entorn Power Platform.
pa telemetry Gestiona la configuració de telemetria de la CLI.

Opcions globals

Utilitza --help a qualsevol nivell per mostrar ajuda al terminal:

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

Utilitza --version per mostrar la versió instal·lada de la CLI de Power Apps:

pa --version

Comandes CLI de Power Apps

Aquestes ordres estan disponibles:

Ordre Descripció
pa app add data-source Afegeix un connector o una font de dades tabular a l'aplicació de codi.
pa app add dataverse-api Afegeix una acció o funció de Dataverse a l'aplicació de codi.
pa app add flow Afegeix un flux de Power Automate a l'aplicació de codi.
pa app find-dataverse-api Troba accions i funcions de Dataverse en l'entorn actual.
pa app get-settings Mostra la configuració actual de l'aplicació.
pa app init Inicialitza una aplicació de codi al directori actual.
pa app list Aplicacions de codis de llista en l'entorn actual.
pa app list-environment-variables Llista les variables d'entorn disponibles a l'aplicació de codi.
pa app list-flows Llista els fluxos de Power Automate conscients de la solució en l'entorn actual.
pa app push Publica una nova versió de l'aplicació Code a Power Apps.
pa app refresh data-source Actualitza els fitxers generats per a una font de dades.
pa app remove data-source Elimina una font de dades de l'aplicació de codi.
pa app remove flow Elimina un flux de Power Automate de l'aplicació de codi.
pa app run Inicia l'amfitrió local de Power Apps per a l'aplicació de codi.
pa app set-setting Actualitza la configuració de l'aplicació.
pa app share Comparteix l'aplicació de codi amb usuaris o responsables del servei.
pa auth login Inicia sessió des del navegador del sistema.
pa auth logout Tanca sessió i elimina la informació d'autenticació guardada.
pa auth status Mostra els comptes iniciats i identifica el compte actiu.
pa auth switch Canvia el compte actiu.
pa connection create Crea una connexió per a un connector.
pa connection list Fes una llista de connexions en l'entorn actual.
pa connection list-datasets Llista conjunts de dades disponibles a través d'una connexió.
pa connection list-procedures Llista els procediments emmagatzemats SQL disponibles en un conjunt de dades.
pa connection list-references Llista les referències de connexió en una solució.
pa connection list-tables Taules de llista disponibles en un conjunt de dades.
pa connector list Llista connectors disponibles en l'entorn actual de Power Platform.
pa solution list Fes una llista de solucions en l'entorn actual.
pa telemetry disable Desactiva la recollida de telemetria.
pa telemetry enable Activa la recollida de telemetria.
pa telemetry status Mostra la configuració actual de telemetria.

pa app add data-source

Afegeix un connector o una font de dades tabular a l'aplicació de codi.

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

pa app add data-source Paràmetres

Paràmetre Descripció
--connector L'identificador del connector, com shared_office365usersara , o el nom de visualització del connector, com "Office 365 Users"ara . Si un nom de visualització coincideix amb més d'un connector, la comanda llista els identificadors de connectors corresponents perquè puguis especificar-ne un.
--as Si afegir el connector com a table font o action com a font de dades. Utilitza aquest paràmetre amb connectors que admetin tant taules com accions, com SharePoint i SQL Server. Per a més informació, vegeupa app add data-source observacions.
--connection-id L'ID de connexió a utilitzar per a la font de dades.
--connection-ref El nom lògic d'una referència de connexió, com cr123_sharedsharepointonline_1a2b3ara .
--solution-id La solució que conté la referència de connexió.
--dataset El conjunt de dades per a una font de dades tabular.
--table La taula per afegir. Repeteix aquest paràmetre per afegir diverses taules del mateix connector, connexió i conjunt de dades. El Dataverse nadiu admet una taula per comanda.
--org-url L'URL de l'organització Dataverse s'utilitza per recuperar les metadades natives de les taules Dataverse. En mode interactiu, la línia de comandes mostra aquest valor si no la proporciones com a opció de comandament o variable d'entorn.
--procedure El procediment emmagatzemat SQL per afegir.

Aquests paràmetres tenen les corresponents Solucions, connectors i variables ambientals de fonts de dades .

pa app add data-source Observacions

Per afegir diverses taules connectors en una sola comanda, repeteix --table per a cada taula. Les taules han d'utilitzar el mateix connector, connexió i conjunt de dades. La comanda només afegeix identificadors duplicats de taula una vegada. Només pots incloure una taula nativa de Dataverse o un procediment emmagatzemat SQL per ordre.

Si una operació específica de metadades, validació o escriptura d'esquema falla, la comanda encara afegeix les taules vàlides. Informa de l'ordre succeeded i failed el resultat i retorna un codi d'entrada no de zero si alguna taula falla. Revisa els resultats abans de tornar-ho a intentar.

Alguns connectors, com SharePoint i SQL Server, admeten tant taules com accions. Per a aquests connectors, especifica què afegir:

  • Per afegir taules o un procediment emmagatzemat SQL, utilitza --as table, o inclou --table o --procedure.
  • Per afegir les accions del connector, utilitza --as action. No es pot utilitzar --as action amb --dataset, --table, o --procedure.

Si no especifiques què afegir, l'ordre pregunta Afegeix una taula? en un terminal interactiu. En mode no interactiu, la comanda falla fins que especifiquis --as. Els connectors que només admeten accions, com Office 365 Users, no necessiten --as ni suporten --as table. Per afegir accions o funcions de Dataverse, utilitza pa app add dataverse-api en lloc de --as action.

En un terminal interactiu, la línia d'ordres mostra els valors requerits que no proporciones com a opcions de comandament o variables d'entorn. Els prompts depenen del tipus de font de dades.

Per al Dataverse nadiu:

  1. Si no especifiques --connector, l'ordre demana l'ID del connector.
  2. L'ordre demana el nom lògic de la taula.
  3. L'ordre demana l'URL d'organització de Dataverse quan no es proporciona.

Native Dataverse no utilitza cap ID de connexió, referència de connexió ni conjunt de dades.

Per a fonts de dades recolzades per connectors:

Tria el connector i el tipus de font de dades

  1. Si no especifiques --connector, l'ordre demana l'ID del connector.
  2. Si el connector admet tant taules com accions i res més determina què afegir, l'ordre pregunta: Afegeix una taula?

Tria la connexió

La comanda pregunta: Estàs utilitzant una referència de connexió en lloc d'un ID de connexió? Salta aquesta pregunta quan proporciones un ID o referència de connexió.

  • Si selecciones Sí, l'ordre demana el nom lògic de la referència de connexió.
  • Si selecciones No, la comanda llista les teves connexions per al connector. Selecciona (Introdueix manualment...) per introduir un ID de connexió que no estigui a la llista.

Tria les dades

  • Si afegeixes accions, la comanda salta els indicadors de procediment emmagatzemat, conjunt de dades i taula.

  • Si afegeixes taules o un procediment emmagatzemat:

    1. Per a SQL Server, la comanda pregunta si estàs afegint un procediment emmagatzemat. Si ho ets, demana el nom del procediment emmagatzemat.
    2. L'ordre llista els conjunts de dades disponibles a través de la connexió. Selecciona (Introdueix manualment...) per introduir un conjunt de dades que no està a la llista.
    3. A menys que estiguis afegint un procediment emmagatzemat, la comanda obre una llista cercable de taules al conjunt de dades. Pots seleccionar més d'una taula.

Quan utilitzes una referència de connexió, el conjunt de dades i les llistes de taules provenen de la connexió a la qual apunta la referència.

pa app add data-source Exemples

Afegeix una font de dades responent a les preguntes:

pa app add data-source

Afegeix una taula nativa de Dataverse:

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

Afegeix les accions d'un connector que també suporta taules:

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

Afegeix una llista de SharePoint list utilitzant el nom de visualització del connector:

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

Afegeix múltiples taules SQL del mateix conjunt de dades:

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

Afegeix una taula a través d'una referència de connexió, i selecciona el conjunt de dades i la taula quan s'activi la línia de comandes:

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

Afegeix una acció o funció de Dataverse a l'aplicació de codi.

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

pa app add dataverse-api Paràmetres

Paràmetre Descripció
--api-name El nom de l'acció o funció Dataverse per afegir.

PA_CLI_DATAVERSE_API_NAME és la variable d'entorn corresponent per al --api-name paràmetre.

Més informació:

pa app add flow

Afegeix un flux de Power Automate a l'aplicació de codi.

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

pa app add flow Paràmetres

Paràmetre Descripció
--flow-id L'ID del flux de Power Automate per afegir.

PA_CLI_FLOW_ID és la variable d'entorn corresponent per al --flow-id paràmetre.

L'ordre:

  • Descarrega la definició d'OpenAPI del flux.
  • Genera models i serveis TypeScript fortament tipus.
  • Afegeix el flux i les seves referències de connexió a power.config.json.

Si una definició de flux canvia, executa aquesta ordre de nou per regenerar el codi de la darrera versió.

Important

La persona que corre pa app add flow ha de tenir accés al flux i a les seves connexions subjacents. L'ordre falla si la persona no té accés a la connexió necessària.

Aprèn més sobre els escenaris on utilitzes aquesta ordre:

pa app find-dataverse-api

Troba accions i funcions de Dataverse en l'entorn actual.

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

pa app find-dataverse-api Paràmetres

Paràmetre Descripció
--search El nom de l'operació a buscar.
--json Retorna els resultats com a JSON.

Aquests paràmetres corresponen a les API de Dataverse i a les variables ambientals dels fluxos de Power Automate.

Aprèn a trobar operacions disponibles a Dataverse.

pa app get-settings

Mostra la configuració actual de l'aplicació de codi.

pa app get-settings [--json]

pa app get-settings Paràmetres

Paràmetre Descripció
--json Retorna la configuració de l'aplicació com a JSON.

Executa aquesta ordre des d'un projecte d'aplicació de codi inicialitzat que contingui un power.config.json fitxer.

pa app init

Inicialitza una aplicació de codi al directori actual.

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

pa app init Paràmetres

Paràmetre Descripció
--display-name El nom de visualització de l'aplicació de codi.
--environment-id L'entorn Power Platform per a l'aplicació de codi.
--description La descripció de l'aplicació de codi.
--build-path El directori que conté els recursos compilats de l'aplicació.
--file-entry-point El punt d'entrada d'HTML a la sortida de la compilació.
--app-type El tipus d'aplicació. Els valors vàlids són CodeApp i MobileApp.
--app-url L'URL de l'aplicació de codi que s'executa localment.
--cloud La instància al núvol de Power Platform.

Aquests paràmetres tenen les variables ambientals corresponents d'inicialització de l'aplicació .

Aprèn més sobre escenaris on pots utilitzar aquesta ordre:

pa app list

Llista aplicacions de codi en l'entorn actual.

pa app list

pa app list-environment-variables

Llista les variables d'entorn disponibles per a l'aplicació de codi.

pa app list-environment-variables

pa app list-flows

Llista els fluxos de Power Automate conscients de la solució en l'entorn actual.

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

Exemple: 

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àmetres

Paràmetre Descripció
--search El filtre flueix pel nom.

PA_CLI_FLOW_SEARCH és la variable d'entorn corresponent per al --search paràmetre.

pa app push

Publica una nova versió de l'aplicació de codi a Power Apps.

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

pa app push Paràmetres

Paràmetre Descripció
--solution-id L'ID de la solució per afegir l'aplicació de codi.
--non-interactive Publica l'aplicació de manera no interactiva. Aprèn a publicar aplicacions amb un responsable de servei.

Utilitza'l PA_CLI_SOLUTION_ID com a variable d'entorn amb el --solution-id paràmetre.

Aprèn a crear una aplicació de codi utilitzant la CLI de Power Apps.

pa app refresh data-source

Actualitza els fitxers generats per a una font de dades.

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

pa app refresh data-source Paràmetres

Paràmetre Descripció
--name El nom de la font de dades per actualitzar.

pa app remove data-source

Elimina una font de dades de l'aplicació de codi.

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

pa app remove data-source Paràmetres

Paràmetre Descripció
--connector L'identificador del connector per a la font de dades.
--name El nom de la font de dades a eliminar.
--force Elimina la font de dades sense demanar confirmació.

pa app remove flow

Elimina un flux de Power Automate de l'aplicació de codi.

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

pa app remove flow Paràmetres

Paràmetre Descripció
--flow-name El nom del flux de Power Automate a eliminar.
--flow-id L'ID del flux de Power Automate a eliminar.
--force Elimina el flux sense que et demanin confirmació.

PA_CLI_FLOW_DATA_SOURCE_NAME i PA_CLI_REMOVE_FLOW_ID són variables d'entorn corresponents per utilitzar amb aquests paràmetres.

Aprèn a eliminar un flux.

pa app run

Inicia l'amfitrió local de Power Apps per a l'aplicació de codi.

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

pa app run Paràmetres

Paràmetre Descripció
--port El port per a l'amfitrió local.
--local-app-url L'URL de l'aplicació de codi que s'executa localment.

Aquests paràmetres tenen les variables ambientals corresponents d'executar aplicacions .

pa app set-setting

Actualitza una o més configuracions de l'aplicació de codi.

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

pa app set-setting Paràmetres

Paràmetre Descripció
--show-header Mostra o amaga la capçalera de l'aplicació. Els valors vàlids són true i false.
--json Retorna la configuració actualitzada de l'aplicació com a JSON.

Executa aquesta ordre des d'un projecte d'aplicació de codi inicialitzat que contingui un power.config.json fitxer. La comanda escriu la configuració a appSettings en power.config.json. Corre pa app push per publicar l'opció perquè el jugador l'apliqui en temps d'execució.

pa app share

Comparteix l'aplicació de codi amb usuaris o responsables del servei.

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

pa app share Paràmetres

Paràmetre Descripció
--principal Adreces de correu electrònic separades per comes o IDs d'objectes Microsoft Entra perquè els usuaris o els responsables del servei comparteixin.
--access El nivell d'accés per concedir: play (per defecte) o edit.

Aquests paràmetres tenen les corresponents variables ambientals de les aplicacions Share .

pa app share Observacions

L'aplicació de codi ja ha d'estar publicada i tenir un ID d'aplicació d'una comanda exitosa pa app push . Concedeix edit accés quan un principal de servei necessiti executar pa app push.

Quan comparteixis amb un principal de servei, utilitza l'ID d'objecte d'aplicació empresarial, no l'ID d'objecte de registre d'aplicacions.

pa auth login

Inicia sessió des del navegador del sistema.

pa auth login

Per preompler-te el compte a la pàgina d'inici de sessió, utilitza:

pa auth login --account user@contoso.com

pa auth login Paràmetres

Paràmetre Descripció
--account El compte s'ha de preomplir a la pàgina d'inici de sessió.

PA_CLI_ACCOUNT és la variable d'entorn corresponent per al --account paràmetre.

pa auth logout

Tanca sessió i elimina la informació d'autenticació guardada.

pa auth logout

Nota

Aquesta ordre et desconnecta de tots els comptes. No et pot desconnectar només d'un compte. Per canviar quin compte està actiu, utilitza pa auth switch en comptes d'això.

Aprèn a desconnectar

pa auth status

Mostra els comptes iniciats i identifica el compte actiu.

Per mostrar l'estat d'autenticació com a JSON, utilitza:

pa auth status --json

pa auth status Paràmetres

Paràmetre Descripció
--json Retorna l'estat d'autenticació com a JSON.

Aprèn a comprovar quin compte està actiu

pa auth switch

Canvia el compte actiu.

pa auth switch --account user@contoso.com

pa auth switch Paràmetres

Paràmetre Descripció
--account El compte a fer actiu.

PA_CLI_ACCOUNT és la variable d'entorn corresponent per al --account paràmetre.

Aprèn més sobre quan pots utilitzar aquesta ordre:

pa connection create

Crea una connexió per a un connector.

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

pa connection create Paràmetres

Paràmetre Àlies Necessari Descripció
--connector - Sí L'identificador del connector, com shared_office365 ara o shared_teams.
--display-name -n No El nom de visualització de la connexió. Si no proporciones un nom, la CLI utilitza un nom per defecte.
--json - No Retorna el resultat com a JSON.

pa connection create Exemples

Crea una connexió Office 365 Outlook:

pa connection create --connector shared_office365

Crea una connexió a Microsoft Teams amb un nom de visualització personalitzat:

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

Crea una connexió i retorna el resultat com a JSON:

pa connection create --connector shared_office365 --json

pa connection create Sortida

Quan l'ordre té èxit, retorna l'ID de connexió. Utilitza l'ID de connexió quan afegeixis el connector com a font de dades a l'aplicació de codi.

Aprèn a crear una connexió des de la CLI de Power Apps

pa connection list

Llista connexions en l'entorn actual.

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

pa connection list Paràmetres

Paràmetre Descripció
--search Filtra les connexions pel nom.
--json Retorna els resultats com a JSON.

Aquests paràmetres tenen les corresponents Solucions, connectors i variables ambientals de fonts de dades .

pa connection list-datasets

Llista conjunts de dades disponibles a través d'una connexió.

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

pa connection list-datasets Paràmetres

Paràmetre Descripció
--connector L'identificador del connector.
--connection-id L'ID de connexió que s'ha d'utilitzar quan es llisten conjunts de dades.

pa connection list-procedures

Llista els procediments emmagatzemats SQL disponibles en un conjunt de dades.

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

pa connection list-procedures Paràmetres

Paràmetre Descripció
--connection-id L'ID de connexió que s'ha d'utilitzar quan es llisten els procediments emmagatzemats.
--dataset El conjunt de dades que conté els procediments emmagatzemats.

pa connection list-references

Llista referències de connexió en una solució.

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

pa connection list-references Paràmetres

Paràmetre Descripció
--solution-id L'ID de la solució que conté les referències de connexió.

Utilitza PA_CLI_SOLUTION_ID amb el --solution-id paràmetre.

pa connection list-tables

Llistes de taules disponibles en un conjunt de dades.

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

pa connection list-tables Paràmetres

Paràmetre Descripció
--connector L'identificador del connector.
--connection-id L'ID de connexió que s'ha d'utilitzar quan llistis taules.
--dataset El conjunt de dades que conté les taules.

pa connector list

Llista els connectors disponibles en l'entorn actual de Power Platform.

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

pa connector list Paràmetres

Paràmetre Descripció
--search Filtra connectors per nom o nom de visualització.
--json Retorna la llista completa de connectors com a JSON.

PA_CLI_CONNECTOR_SEARCH és la variable d'entorn corresponent a utilitzar amb el --search paràmetre.

pa connector list Sortida

En un terminal interactiu, veus els resultats en pàgines de 20 files. Prem Enter per mostrar la pàgina següent. Prem Esc o Q per sortir. Quan redirigeixes la sortida o inclou --json, la comanda retorna la llista completa.

Per defecte, l'ordre retorna una taula amb les següents columnes:

Columna Descripció
Nom de visualització El nom visual del connector, com ara Office 365 Outlook.
Connector L'identificador del connector, com shared_office365ara . Utilitza aquest valor amb l'opció --connector de pa connection create.

Quan utilitzes el --json paràmetre, la sortida JSON inclou els següents camps:

Camp Descripció
id L'ID del connector.
name L'identificador del connector, com shared_office365ara .
displayName El nom de visualització del connector.
description La descripció del connector.
isTabular Indica si el connector admet operacions de dades tabulares.

pa connector list Exemples

Llista tots els connectors disponibles:

pa connector list

Cerca connectors:

pa connector list --search teams

Retorna la llista de connectors com a JSON:

pa connector list --json

Aprèn a llistar connectors disponibles

pa solution list

Llista les solucions de l'entorn actual, incloent-hi el seu nom amistós, nom únic i ID de la solució.

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

pa solution list Paràmetres

Paràmetre Descripció
--search Filtra les solucions per nom amic o nom únic. El filtre és una coincidència de subcadena insensible a majúscules i maiúscules.
--json Retorna la llista completa de solucions com a JSON.

PA_CLI_SOLUTION_SEARCH és la variable d'entorn corresponent per al --search paràmetre.

En un terminal interactiu, veus els resultats en pàgines de 20 files. Prem Enter per mostrar la pàgina següent. Prem Esc o Q per sortir. Quan redirigeixes la sortida o inclou --json, la comanda retorna la llista completa.

pa telemetry disable

Desactiva la recollida de telemetria.

pa telemetry disable

pa telemetry enable

Activa la recollida de telemetria.

pa telemetry enable

pa telemetry status

Mostra la configuració actual de telemetria.

pa telemetry status
  • Darrera actualització el