Препратка към командата CLI на Power Apps

Използвайте тази Power Apps CLI команда за бързо намиране на команди за създаване, разработване, свързване и публикуване на приложения за Power Apps код. CLI използва групирани команди в следния формат:

pa <command-group> <command>

Това са групите с команди:

Командна група Описание
pa app Създавайте, изпълнявайте, свързвайте и публикувайте приложения с код.
pa auth Влезте и управлявайте акаунтите.
pa connection Създавайте и управлявайте връзки и открийте техните ресурси.
pa connector Намерете конектори, налични в среда на Power Platform.
pa solution Намерете решения, налични в среда на Power Platform.
pa telemetry Управление на настройките за CLI телеметрия.

Глобални опции

Използвайте --help на всяко ниво, за да покажете помощ в терминала:

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

Използвайте--version, за да покажете инсталираната Power Apps CLI версия:

pa --version

Power Apps CLI команди

Тези команди са налични:

Command Описание
pa app add data-source Добавете конектор или табличен източник на данни към приложението за код.
pa app add dataverse-api Добавете действие или функция Dataverse към приложението за код.
pa app add flow Добавете поток на Power Automate към приложението за код.
pa app find-dataverse-api Намиране на действия и функции на Dataverse в текущата среда.
pa app get-settings Показване на текущите настройки на приложението.
pa app init Инициализиране на приложение за код в текущата директория.
pa app list Изброяване на приложения с код в текущата среда.
pa app list-environment-variables List environment variables available to the code app.
pa app list-flows Изброяване на Power Automate потоци с оглед на решението в текущата среда.
pa app push Публикувайте нова версия на приложението за код, за да Power Apps.
pa app refresh data-source Обновяване на генерираните файлове за източник на данни.
pa app remove data-source Премахнете източник на данни от приложението за код.
pa app remove flow Премахнете поток на Power Automate от приложението за код.
pa app run Стартирайте локалния хост на Power Apps за приложението за код.
pa app set-setting "Актуализиране на настройките на приложението".
pa app share Споделете приложението за код с потребители или главен субект на услуга.
pa auth login Влезте в системния браузър.
pa auth logout Излезте и премахнете записаната информация за удостоверяване.
pa auth status Показване на акаунтите, в които сте влезли, и идентифициране на активния акаунт.
pa auth switch Промяна на активния акаунт.
pa connection create Създаване на връзка за конектор.
pa connection list Списък на връзките в текущата среда.
pa connection list-datasets Изброяване на набори от данни, налични чрез връзка.
pa connection list-procedures Изброяване на съхранените SQL процедури в набор от данни.
pa connection list-references Изброяване на препратки към връзки в решение.
pa connection list-tables Списък на таблиците, налични в набор от данни.
pa connector list Списъчни конектори, налични в текущата среда на Power Platform.
pa solution list Изброяване на решения в текущата среда.
pa telemetry disable Забраняване на събирането на телеметрични данни.
pa telemetry enable Разрешаване на събирането на телеметрия.
pa telemetry status Показване на текущите настройки за телеметрия.

pa app add data-source

Добавя конектор или табличен източник на данни към приложението за код.

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

pa app add data-source Параметри

Параметър Описание
--connector Идентификаторът на конектора, като shared_office365usersнапример , или показваното име на конектора, като "Потребители на Office 365"например . Ако показваното име съвпада с повече от един конектор, командата изброява съответстващите идентификатори на конектора, така че да можете да зададете такъв.
--as Дали да добавите конектора като table , или като източник на action данни. Използвайте този параметър с конектори, които поддържат както таблици, така и действия, като например SharePoint и SQL Server. За повече информация вж pa app add data-source . забележките.
--connection-id ИД на връзката, който да се използва за източника на данни.
--connection-ref Логическото име на препратка към връзка, като cr123_sharedsharepointonline_1a2b3например .
--solution-id Решението, съдържащо препратката към връзката.
--dataset Наборът от данни за табличен източник на данни.
--table Таблицата за добавяне. Повторете този параметър, за да добавите няколко таблици от един и същ конектор, връзка и набор от данни. Native Dataverse поддържа по една таблица за команда.
--org-url URL адресът на организацията Dataverse, използван за извличане на основни метаданни за таблица на Dataverse. В интерактивен режим командният прозорец за тази стойност се показва, ако не я предоставяте като опция за команда или променлива на средата.
--procedure Sql съхранена процедура за добавяне.

Тези параметри имат съответните променливи на околната среда решения, конектори и източници на данни .

pa app add data-source Забележки

За да добавите няколко таблици конектор в една команда, повторете --table за всяка таблица. Таблиците трябва да използват един и същ конектор, връзка и набор от данни. Командата добавя дублирани идентификатори на таблица само веднъж. Можете да включите само една основна таблица Dataverse или SQL съхранена процедура за всяка команда.

Ако специфична за таблицата метаданни, проверка или операция за запис на схема е неуспешна, командата все още добавя валидните таблици. Тя съобщава подредени succeeded и failed резултати и връща ненулев код за изход, ако някоя таблица е неуспешна. Прегледайте резултатите, преди да опитате отново.

Някои конектори, като например SharePoint и SQL Server, поддържат както таблици, така и действия. За тези конектори задайте какво да се добави:

  • За да добавите таблици или съхранена SQL процедура, използвайте --as tableили включете --table или --procedure.
  • За да добавите действията на конектора, използвайте --as action. Не можете да използвате --as action с --dataset, --tableили --procedure.

Ако не укажете какво да се добави, командата пита Добавяне на таблица? в интерактивен терминал. В не-интерактивен режим командата е неуспешна, докато не зададете --as. Конектори, които поддържат само действия, като например Потребители на Office 365, не се нуждаят --as и не поддържат --as table. За да добавите действия или функции на Dataverse, използвайте pa app add dataverse-api вместо --as action.

В интерактивен терминал командният прозорец за задължителните стойности, които не предоставяте като опции за команди или променливи на средата. Подканите зависят от типа на източника на данни.

За основен Dataverse:

  1. Ако не зададете --connector, командата пита за ИД на конектора.
  2. Командата пита за логическото име на таблицата.
  3. Командата пита за URL адреса на организацията Dataverse, когато не е предоставен.

Native Dataverse не използва ИД на връзка, препратка към връзка или набор от данни.

За източници на данни, архивирани от конектори:

Избор на конектора и типа на източника на данни

  1. Ако не зададете --connector, командата пита за ИД на конектора.
  2. Ако конекторът поддържа както таблици, така и действия, и нищо друго не определя какво да се добави, командата пита Добавяне на таблица?

Изберете връзката

Командата пита Използвате ли препратка към връзка вместо ИД на връзка? Той пропуска този въпрос, когато предоставите ИД на връзка или препратка към връзка.

  • Ако изберете Да, командата пита за логическото име на препратката към връзката.
  • Ако изберете Не, командата изброява вашите връзки за конектора. Изберете (Въведете ръчно...), за да въведете ИД на връзка, който не е в списъка.

Изберете данните

  • Ако добавяте действия, командата пропуска съхранената процедура, набора от данни и подканите за таблица.

  • Ако добавяте таблици или съхранена процедура:

    1. За SQL Server командата ви пита дали добавяте съхранена процедура. Ако е така, той ви пита за името на съхранената процедура.
    2. Командата изброява наборите от данни, налични през връзката. Изберете (Въведете ръчно...), за да въведете набор от данни, който не е в списъка.
    3. Освен ако не добавяте съхранена процедура, командата отваря списък с таблици, в който може да се търси, в набора от данни. Можете да изберете повече от една таблица.

Когато използвате препратка към връзка, наборът от данни и списъците с таблици идват от връзката, към която сочи препратката.

pa app add data-source Примери

Добавете източник на данни, като отговорите на подканите:

pa app add data-source

Добавяне на основна таблица dataverse:

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

Добавете действията на конектор, който също поддържа таблици:

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

Добавете SharePoint list с помощта на показваното име на конектора:

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

Добавяне на няколко SQL таблици от един и същ набор от данни:

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

Добавете таблица чрез препратка към връзка и изберете набора от данни и таблицата, когато командният прозорец:

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

Добавя действие или функция Dataverse към приложението за код.

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

pa app add dataverse-api Параметри

Параметър Описание
--api-name Името на действието или функцията Dataverse за добавяне.

PA_CLI_DATAVERSE_API_NAME е съответната променлива на средата за параметъра --api-name .

Научете повече:

pa app add flow

Добавя поток на Power Automate към приложението за код.

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

pa app add flow Параметри

Параметър Описание
--flow-id ИД на Power Automate поток за добавяне.

PA_CLI_FLOW_ID е съответната променлива на средата за параметъра --flow-id .

Командата:

  • Изтегля дефиницията OpenAPI на потока.
  • Генерира силно въведени typeScript модели и услуги.
  • Добавя потока и препратките към неговата връзка към power.config.json.

Ако дефиницията на поток се промени, изпълнете тази команда отново, за да генерирате отново код за най-новата версия.

Важно

Човекът, който се изпълнява pa app add flow , трябва да има достъп до потока и базовите му връзки. Командата е неуспешна, ако лицето няма достъп до задължителна връзка.

Научете повече за сценариите, при които използвате тази команда:

pa app find-dataverse-api

Намира действията и функциите на Dataverse в текущата среда.

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

pa app find-dataverse-api Параметри

Параметър Описание
--search Името на операцията, която трябва да бъде търсена.
--json Върнете резултатите като JSON.

Тези параметри съответстват на API на dataverse и Power Automate потоци променливи на околната среда.

Научете как да намерите наличните операции на Dataverse.

pa app get-settings

Показва текущите настройки за приложението за код.

pa app get-settings [--json]

pa app get-settings Параметри

Параметър Описание
--json Върнете настройките на приложението като JSON.

Изпълнете тази команда от проект на инициализирано приложение за power.config.json код, който съдържа файл.

pa app init

Инициализира приложение за код в текущата директория.

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

pa app init Параметри

Параметър Описание
--display-name Показваното име на приложението за код.
--environment-id Средата на Power Platform за приложението за код.
--description Описанието на приложението за код.
--build-path Указателят, който съдържа компилираните активи на приложението.
--file-entry-point Входната точка на HTML в резултата от компилацията.
--app-type Типът на приложението. Валидните стойности са CodeApp и MobileApp.
--app-url URL адресът на локално изпълняваното приложение за код.
--cloud Екземплярът в облака на Power Platform.

Тези параметри имат съответните променливи на околната среда за инициализация на приложението .

Научете повече за сценариите, при които можете да използвате тази команда:

pa app list

Показва кодиране на приложения в текущата среда.

pa app list

pa app list-environment-variables

Изброява променливите на средата, налични за приложението за код.

pa app list-environment-variables

pa app list-flows

Изброява Power Automate потоци с оглед на решението в текущата среда.

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

Пример:

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 Параметри

Параметър Описание
--search Филтриране на потоци по име.

PA_CLI_FLOW_SEARCH е съответната променлива на средата за параметъра --search .

pa app push

Публикува нова версия на приложението за код, за да Power Apps.

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

pa app push Параметри

Параметър Описание
--solution-id ИД на решението за добавяне на приложението за код.
--non-interactive Публикува приложението не интерактивно. Научете как да публикувате приложения с главен субект на услуга.

Използвайте PA_CLI_SOLUTION_ID като променлива на средата с параметъра --solution-id .

Научете как да създадете приложение за код с помощта на Power Apps CLI.

pa app refresh data-source

Обновява генерираните файлове за източник на данни.

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

pa app refresh data-source Параметри

Параметър Описание
--name Името на източника на данни за обновяване.

pa app remove data-source

Премахва източник на данни от приложението за код.

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

pa app remove data-source Параметри

Параметър Описание
--connector Идентификаторът на конектора за източника на данни.
--name Името на източника на данни за премахване.
--force Премахнете източника на данни без подкана за потвърждение.

pa app remove flow

Премахва поток на Power Automate от приложението за код.

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

pa app remove flow Параметри

Параметър Описание
--flow-name Името на Power Automate поток за премахване.
--flow-id ИД на потока на Power Automate за премахване.
--force Премахнете потока без подкана за потвърждение.

PA_CLI_FLOW_DATA_SOURCE_NAME и PA_CLI_REMOVE_FLOW_ID са съответстващи променливи на средата, които да се използват с тези параметри.

Научете как да премахнете поток.

pa app run

Стартира локалния хост на Power Apps за приложението за код.

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

pa app run Параметри

Параметър Описание
--port Портът за локалния хост.
--local-app-url URL адресът на локално изпълняваното приложение за код.

Тези параметри съответстват на променливите на околната среда за изпълнение на приложенията .

pa app set-setting

Актуализира една или повече настройки за приложението за код.

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

pa app set-setting Параметри

Параметър Описание
--show-header Показване или скриване на заглавката на приложението. Валидните стойности са true и false.
--json Върнете актуализираните настройки на приложението като JSON.

Изпълнете тази команда от проект на инициализирано приложение за power.config.json код, който съдържа файл. Командата записва настройката appSettings в power.config.json. Изпълнете pa app push , за да публикувате настройката, така че плейърът да я приложи по време на изпълнение.

pa app share

Споделя приложението за код с потребители или субект на услуга.

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

pa app share Параметри

Параметър Описание
--principal Имейл адреси, разделени със запетая, или Microsoft Entra идентификатори на обекти, с които потребителите или субектът на услугата да споделят.
--access Нивото на достъп за предоставяне: play (по подразбиране) или edit.

Тези параметри имат съответстващи променливи на околната среда за споделяне на приложения .

pa app share Забележки

Приложението за код трябва вече да е публикувано и да има ИД на приложение от успешна pa app push команда. Даване на edit достъп, когато главен субект на услуга трябва да изпълни pa app push.

Когато споделяте с главен субект на услуга, използвайте ИД на обект на корпоративното приложение, а не ИД на обект за регистриране на приложение.

pa auth login

Влиза през системния браузър.

pa auth login

За да запълните предварително акаунта на страницата за влизане, използвайте:

pa auth login --account user@contoso.com

pa auth login Параметри

Параметър Описание
--account Акаунтът за предварително запълване на страницата за влизане.

PA_CLI_ACCOUNT е съответната променлива на средата за параметъра --account .

pa auth logout

Излизане и премахване на записана информация за удостоверяване.

pa auth logout

Бележка

Тази команда ще ви извади от всички акаунти. Не може да излезете само от един акаунт. За да промените кой акаунт е активен, използвайте pa auth switch вместо това.

Научете как да излезете

pa auth status

Показва влезлите акаунти и идентифицира активния акаунт.

За да покажете състоянието на удостоверяването като JSON, използвайте:

pa auth status --json

pa auth status Параметри

Параметър Описание
--json Връщане на състоянието на удостоверяване като JSON.

Научете как да проверите кой акаунт е активен

pa auth switch

Променя активния акаунт.

pa auth switch --account user@contoso.com

pa auth switch Параметри

Параметър Описание
--account Акаунтът, който искате да активирате.

PA_CLI_ACCOUNT е съответната променлива на средата за параметъра --account .

Научете повече за това кога можете да използвате тази команда:

pa connection create

Създава връзка за конектор.

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

pa connection create Параметри

Параметър Alias Задължителни Описание
--connector - Да Идентификаторът на конектора, като shared_office365 например или shared_teams.
--display-name -n Не Показваното име за връзката. Ако не предоставите име, CLI използва име по подразбиране.
--json - Не Връща резултата като JSON.

pa connection create Примери

Създаване на Office 365 Outlook връзка:

pa connection create --connector shared_office365

Създайте Microsoft Teams връзка с показвано име по избор:

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

Създаване на връзка и връщане на резултата като JSON:

pa connection create --connector shared_office365 --json

pa connection create изход

Когато командата е успешна, връща ИД на връзката. Използвайте ИД на връзката, когато добавяте конектора като източник на данни към приложението за код.

Научете как да създадете връзка от Power Apps CLI

pa connection list

Изброява връзките в текущата среда.

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

pa connection list Параметри

Параметър Описание
--search Филтриране на връзки по име.
--json Върнете резултатите като JSON.

Тези параметри имат съответните променливи на околната среда решения, конектори и източници на данни .

pa connection list-datasets

Изброява набори от данни, налични чрез връзка.

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

pa connection list-datasets Параметри

Параметър Описание
--connector Идентификаторът на конектора.
--connection-id ИД на връзката, който да се използва при изброяване на набори от данни.

pa connection list-procedures

Изброява съхранените SQL процедури, налични в набор от данни.

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

pa connection list-procedures Параметри

Параметър Описание
--connection-id ИД на връзката, който да се използва при изброяване на съхранени процедури.
--dataset Наборът от данни, съдържащ съхранените процедури.

pa connection list-references

Изброява препратките към връзки в решение.

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

pa connection list-references Параметри

Параметър Описание
--solution-id ИД на решението, съдържащо препратките към връзка.

Използвайте PA_CLI_SOLUTION_ID с параметъра --solution-id .

pa connection list-tables

Изброява таблиците, налични в набор от данни.

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

pa connection list-tables Параметри

Параметър Описание
--connector Идентификаторът на конектора.
--connection-id ИД на връзката, който да се използва при изброяване на таблици.
--dataset Наборът от данни, съдържащ таблиците.

pa connector list

Изброява конекторите, налични в текущата среда на Power Platform.

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

pa connector list Параметри

Параметър Описание
--search Филтриране на конектори по име или показвано име.
--json Върнете пълния списък с конектори като JSON.

PA_CLI_CONNECTOR_SEARCH е съответната променлива на средата, която се използва с параметъра --search .

pa connector list изход

В интерактивен терминал виждате резултати в страници с 20 реда. Натиснете Enter , за да покажете следващата страница. Натиснете Esc или Q , за да излезете. Когато пренасочите изхода или включите --json, командата връща пълния списък.

По подразбиране командата връща таблица със следните колони:

Колона Описание
Показвано име Показваното име на конектора, като например Office 365 Outlook.
Конектор Идентификаторът на конектора, като shared_office365например . Използвайте тази стойност с опцията --connectorpa connection create.

Когато използвате параметъра --json , изходът JSON включва следните полета:

Поле Описание
id ИД на конектора.
name Идентификаторът на конектора, като shared_office365например .
displayName Показваното име на конектора.
description Описание на конектора.
isTabular Показва дали конекторът поддържа операции с таблични данни.

pa connector list Примери

Избройте всички налични конектори:

pa connector list

Търсене на конектори:

pa connector list --search teams

Връщане на списъка на конекторите като JSON:

pa connector list --json

Научете как да изброите наличните конектори

pa solution list

Изброява решенията в текущата среда, включително истинското им име, уникалното име и ИД на решението.

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

pa solution list Параметри

Параметър Описание
--search Филтрирайте решенията по истинско име или уникално име. Филтърът е съвпадение на подниз без разлика между главни и малки букви.
--json Върнете пълния списък с решения като JSON.

PA_CLI_SOLUTION_SEARCH е съответната променлива на средата за параметъра --search .

В интерактивен терминал виждате резултати в страници с 20 реда. Натиснете Enter , за да покажете следващата страница. Натиснете Esc или Q , за да излезете. Когато пренасочите изхода или включите --json, командата връща пълния списък.

pa telemetry disable

Забранява събирането на телеметрия.

pa telemetry disable

pa telemetry enable

Разрешава събиране на телеметрия.

pa telemetry enable

pa telemetry status

Показва текущите настройки за телеметрия.

pa telemetry status
  • Последна актуализация: