справочник по команде cli Power Apps

Используйте эту ссылку Power Apps CLI, чтобы быстро найти команды для создания, разработки, подключения и публикации Power Apps приложений кода. Интерфейс командной строки использует группированные команды в следующем формате:

pa <command-group> <command>

Это группы команд:

Группа команд	Description
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

команды cli Power Apps

Эти команды доступны:

Command	Description
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	Вывод списка переменных среды, доступных приложению кода.
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

Parameter	Description
--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 с помощью отображаемого имени соединителя:

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

Parameter	Description
--api-name	Имя действия или функции Dataverse, добавляемой.

PA_CLI_DATAVERSE_API_NAME — соответствующая переменная среды для --api-name параметра.

Подробнее:

• Узнайте, как обновить операцию Dataverse
• Устранение неполадок операций dataverse

pa app add flow

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

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

параметры pa app add flow

Parameter	Description
--flow-id	Идентификатор добавляемого потока Power Automate.

PA_CLI_FLOW_ID — соответствующая переменная среды для --flow-id параметра.

Команда:

• Загружает определение OpenAPI потока.
• Создает строго типизированные модели и службы TypeScript.
• Добавляет поток и ссылки на power.config.jsonего подключение.

Если определение потока изменяется, выполните эту команду еще раз, чтобы повторно создать код для последней версии.

Important

Пользователь, который работает pa app add flow , должен иметь доступ к потоку и его базовым подключениям. Команда завершается ошибкой, если у пользователя нет доступа к требуемому подключению.

Дополнительные сведения о сценариях, в которых используется эта команда:

• Узнайте, что происходит при добавлении потока Power Automate
• Узнайте, как обновить поток Power Automate
• Ознакомьтесь с ограничениями и рекомендациями по Power Automate потокам

pa app find-dataverse-api

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

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

параметры pa app find-dataverse-api

Parameter	Description
--search	Имя операции для поиска.
--json	Возвращает результаты в формате JSON.

Эти параметры соответствуют API Dataverse и Power Automate потоков переменных среды.

Узнайте, как найти доступные операции Dataverse.

pa app get-settings

Отображает текущие параметры для приложения кода.

pa app get-settings [--json]

параметры pa app get-settings

Parameter	Description
--json	Возвращает параметры приложения в формате JSON.

Выполните эту команду из инициализированного проекта приложения кода, содержащего power.config.json файл.

pa app init

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

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

параметры pa app init

Parameter	Description
--display-name	Отображаемое имя приложения кода.
--environment-id	Среда Power Platform для приложения кода.
--description	Описание приложения кода.
--build-path	Каталог, содержащий скомпилированные ресурсы приложения.
--file-entry-point	Точка входа HTML в выходных данных сборки.
--app-type	Тип приложения. Допустимые значения — CodeApp и MobileApp.
--app-url	URL-адрес локально выполняющегося приложения кода.
--cloud	Экземпляр облака Power Platform.

Эти параметры имеют соответствующие переменные среды инициализации приложений .

Дополнительные сведения о сценариях, где можно использовать следующую команду:

• Проверка предварительных требований для добавления действия или функции Dataverse
• Проверка предварительных требований для добавления потоков Power Automate
• Узнайте, как инициализировать приложение кода
• Узнайте, как работает вход при инициализации приложения кода

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

Parameter	Description
--search	Фильтрация потоков по имени.

PA_CLI_FLOW_SEARCH — соответствующая переменная среды для --search параметра.

pa app push

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

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

параметры pa app push

Parameter	Description
--solution-id	Идентификатор решения для добавления приложения кода в.
--non-interactive	Публикует приложение неинтерактивно. Узнайте, как публиковать приложения с помощью субъекта-службы.

Используйте PA_CLI_SOLUTION_ID в качестве переменной среды с параметром --solution-id .

Узнайте, как создать приложение кода с помощью интерфейса командной строки Power Apps.

pa app refresh data-source

Обновляет созданные файлы для источника данных.

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

параметры pa app refresh data-source

Parameter	Description
--name	Имя источника данных для обновления.

pa app remove data-source

Удаляет источник данных из приложения кода.

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

параметры pa app remove data-source

Parameter	Description
--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

Parameter	Description
--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

Parameter	Description
--port	Порт для локального узла.
--local-app-url	URL-адрес локально выполняющегося приложения кода.

Эти параметры имеют соответствующие переменные среды запуска приложений .

pa app set-setting

Обновляет один или несколько параметров для приложения кода.

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

параметры pa app set-setting

Parameter	Description
--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

Parameter	Description
--principal	Идентификаторы объектов с разделителями-запятыми или Microsoft Entra идентификаторы объектов для пользователей или субъектов-служб, с которыми можно предоставить общий доступ.
--access	Уровень доступа для предоставления: play (по умолчанию) или edit.

Эти параметры имеют соответствующие переменные среды приложений Share .

pa app share Замечания

Приложение кода должно быть опубликовано и иметь идентификатор приложения из успешной pa app push команды. Предоставьте edit доступ при необходимости запуска pa app pushсубъекта-службы.

При совместном использовании с субъектом-службой используйте идентификатор объекта Enterprise Application, а не идентификатор объекта регистрации приложений.

pa auth login

Войдите через системный браузер.

pa auth login

Чтобы предварительно заполнить учетную запись на странице входа, используйте следующую команду:

pa auth login --account user@contoso.com

параметры pa auth login

Parameter	Description
--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

Parameter	Description
--json	Возвращает состояние проверки подлинности в формате JSON.

Узнайте, как проверить, какая учетная запись активна

pa auth switch

Изменяет активную учетную запись.

pa auth switch --account user@contoso.com

параметры pa auth switch

Parameter	Description
--account	Учетная запись, активная.

PA_CLI_ACCOUNT — соответствующая переменная среды для --account параметра.

Дополнительные сведения об использовании этой команды см. в следующих случаях:

• Узнайте, как проверить, какая учетная запись активна
• Узнайте, как переключить активную учетную запись
• Узнайте, как выйти

pa connection create

Создает подключение для соединителя.

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

параметры pa connection create

Parameter	Alias	Обязательный	Description
--connector	-	Да	Идентификатор соединителя, например shared_office365 или shared_teams.
--display-name	-n	Нет	Отображаемое имя подключения. Если имя не указано, интерфейс командной строки использует имя по умолчанию.
--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

pa connection list

Выводит список подключений в текущей среде.

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

параметры pa connection list

Parameter	Description
--search	Фильтрация подключений по имени.
--json	Возвращает результаты в формате JSON.

Эти параметры имеют соответствующие переменные среды решений, соединителей и источников данных .

pa connection list-datasets

Выводит список наборов данных, доступных через подключение.

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

параметры pa connection list-datasets

Parameter	Description
--connector	Идентификатор соединителя.
--connection-id	Идентификатор подключения, используемый при перечислении наборов данных.

pa connection list-procedures

Перечисляет хранимые процедуры SQL, доступные в наборе данных.

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

параметры pa connection list-procedures

Parameter	Description
--connection-id	Идентификатор подключения, используемый при перечислении хранимых процедур.
--dataset	Набор данных, содержащий хранимые процедуры.

pa connection list-references

Перечисляет ссылки на подключения в решении.

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

параметры pa connection list-references

Parameter	Description
--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

Parameter	Description
--connector	Идентификатор соединителя.
--connection-id	Идентификатор подключения, используемый при перечислении таблиц.
--dataset	Набор данных, содержащий таблицы.

pa connector list

Перечисляет соединители, доступные в текущей среде Power Platform.

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

параметры pa connector list

Parameter	Description
--search	Фильтрация соединителей по имени или отображаемой имени.
--json	Возвращает полный список соединителей в формате JSON.

PA_CLI_CONNECTOR_SEARCH — соответствующая переменная среды, используемая с параметром --search .

pa connector list Выход

В интерактивном терминале отображаются результаты на страницах 20 строк. Нажмите клавишу ВВОД , чтобы отобразить следующую страницу. Нажмите клавишу ESC или Q , чтобы выйти. При перенаправлении выходных данных или включении --jsonкоманда возвращает полный список.

По умолчанию команда возвращает таблицу со следующими столбцами:

Column	Description
Отображаемое имя	Отображаемое имя соединителя, например Office 365 Outlook.
Connector	Идентификатор соединителя, например shared_office365. Используйте это значение с параметром --connectorpa connection create.

При использовании параметра выходные --json данные JSON включают следующие поля:

Поле	Description
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

Parameter	Description
--search	Фильтрация решений по понятному имени или уникальному имени. Фильтр — это совпадение подстроки без учета регистра.
--json	Возвращает полный список решений в формате JSON.

PA_CLI_SOLUTION_SEARCH — соответствующая переменная среды для --search параметра.

В интерактивном терминале отображаются результаты на страницах 20 строк. Нажмите клавишу ВВОД , чтобы отобразить следующую страницу. Нажмите клавишу ESC или Q , чтобы выйти. При перенаправлении выходных данных или включении --jsonкоманда возвращает полный список.

pa telemetry disable

Отключает коллекцию данных телеметрии.

pa telemetry disable

pa telemetry enable

Включает сбор данных телеметрии.

pa telemetry enable

pa telemetry status

Отображает текущие параметры телеметрии.

pa telemetry status

Связанные сведения

• переменные среды Power Apps CLI
• Краткое руководство. Создание приложения кода с помощью интерфейса командной строки Power Apps
• Вход и управление учетными записями с помощью интерфейса командной строки Power Apps
• Добавление источников данных в приложение кода