Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Используйте переменные среды для настройки проверки подлинности Power Apps CLI и предоставления параметров команд в скриптах и конвейерах CI/CD. Переменные среды, определенные Power Apps CLI, используют PA_CLI_ префикс.
Note
Переменные среды — это именованные значения, которые операционная система предоставляет приложениям. Power Apps CLI распознает переменные, описанные в этой ссылке. Чтобы узнать, как работают переменные среды и как управлять ими, см. сведения о переменных среды.
В этом справочнике описываются переменные среды операционной системы, которые настраивают интерфейс командной строки Power Apps. Эти переменные отличаются от переменных среды решения Power Platform, в которых хранятся значения конфигурации, используемые приложением.
Для параметра команды интерфейс командной строки разрешает значение в следующем порядке:
- Параметр командной строки
- Переменная среды
- Значение по умолчанию, если параметр имеет один
- Интерактивный запрос при поддержке
Параметр, предоставленный в командной строке, имеет приоритет над соответствующей переменной среды.
Important
Переменные среды могут предоставлять секреты другим процессам, журналам или журналу оболочки. Храните PA_CLI_SP_CLIENT_SECRET в секретном хранилище платформы CI/CD, маскируйте его из журналов и не фиксируйте секреты в системе управления версиями.
Настройка переменных среды
Следующие примеры задаются PA_CLI_ENVIRONMENT_ID перед выполнением команды Power Apps CLI.
$env:PA_CLI_ENVIRONMENT_ID = "<environment-id>"
pa app list
Переменная среды остается доступной для команд, запущенных из одного сеанса терминала. Используйте стандартную команду оболочки, чтобы удалить ее, когда она больше не нужна.
Authentication
| Переменная среды | Description |
|---|---|
PA_CLI_ACCOUNT |
Указывает учетную запись для pa auth login или pa auth switch. |
PA_CLI_SP_CLIENT_ID |
Указывает идентификатор Microsoft Entra приложения (клиента) для проверки подлинности субъекта-службы. |
PA_CLI_SP_CLIENT_SECRET |
Указывает секрет клиента для проверки подлинности субъекта-службы. |
PA_CLI_SP_TENANT_ID |
Указывает идентификатор каталога Microsoft Entra (клиента) для проверки подлинности субъекта-службы. |
PA_CLI_USE_SP_AUTH |
Задайте для параметра значение true (нижний регистр), чтобы использовать проверку подлинности субъекта-службы. |
При выборе проверки подлинности субъекта-службы требуются три PA_CLI_SP_* переменные учетных данных. Хотя CI=true также выбирается проверка подлинности субъекта-службы для обеспечения совместимости, используйте PA_CLI_USE_SP_AUTH=true для явного режима проверки подлинности.
Инструкции по настройке см. в статье "Публикация приложений кода Power Apps с помощью субъекта-службы".
Глобальные параметры команд
Эти переменные соответствуют параметрам, доступным в Power Apps командах CLI.
| Переменная среды | Соответствующий параметр | Description |
|---|---|---|
PA_CLI_CLOUD |
--cloud |
Выбирает целевое облако. Допустимые значения: - public (по умолчанию)- usgov- usgovhigh- usgovdod- chinaЗначения не учитывает регистр. |
PA_CLI_ENVIRONMENT_ID |
--environment-id |
Указывает целевой идентификатор среды Power Platform. |
Инициализация приложений
Эти переменные предоставляют параметры pa app init.
| Переменная среды | Соответствующий параметр | Description |
|---|---|---|
PA_CLI_APP_BUILD_PATH |
--build-path |
Указывает выходной каталог сборки. Значение по умолчанию — ./dist. |
PA_CLI_APP_DESCRIPTION |
--description |
Указывает описание приложения. |
PA_CLI_APP_DISPLAY_NAME |
--display-name |
Указывает отображаемое имя приложения. |
PA_CLI_APP_FILE_ENTRY_POINT |
--file-entry-point |
Указывает точку входа HTML в выходных данных сборки. Значение по умолчанию — index.html. |
PA_CLI_APP_TYPE |
--app-type |
Указывает тип приложения. Допустимые значения: - CodeApp (по умолчанию)- MobileAppЗначение сохраняется и используется в power.config.json качестве типа приложения при публикации приложения. |
PA_CLI_APP_URL |
--app-url |
Указывает URL-адрес локального приложения во время pa app init. Значение сохраняется как localAppUrl в power.config.json и становится URL-адресом по умолчанию для будущих pa app run команд. Значение по умолчанию — http://localhost:3000. |
Запуск приложений
Эти переменные предоставляют параметры pa app run.
| Переменная среды | Соответствующий параметр | Description |
|---|---|---|
PA_CLI_LOCAL_APP_URL |
--local-app-url |
Переопределяет localAppUrl значение из power.config.json текущей команды без изменения сохраненной конфигурации. Если ни значение не задано, значение по умолчанию равно http://localhost:3000. |
PA_CLI_PORT |
--port |
Указывает порт для локального узла Power Apps. Значение по умолчанию — 8080. |
Общий доступ к приложениям
Эти переменные предоставляют параметры pa app share.
| Переменная среды | Соответствующий параметр | Description |
|---|---|---|
PA_CLI_SHARE_ACCESS |
--access |
Указывает уровень доступа. Допустимые значения: - play (по умолчанию)- edit |
PA_CLI_SHARE_PRINCIPAL |
--principal |
Указывает один или несколько адресов электронной почты, разделенных запятыми, или идентификаторы объектов Microsoft Entra. |
Решения, соединители и источники данных
| Переменная среды | Соответствующий параметр | Description |
|---|---|---|
PA_CLI_CONNECTION_DISPLAY_NAME |
--display-name |
Указывает отображаемое имя при создании подключения. |
PA_CLI_CONNECTION_ID |
--connection-id |
Указывает идентификатор экземпляра подключения соединителя. |
PA_CLI_CONNECTION_REF |
--connection-ref |
Указывает логическое имя ссылки на подключение. |
PA_CLI_CONNECTION_SEARCH |
--search |
Фильтрует результаты из pa connection list. |
PA_CLI_CONNECTOR |
--connector |
Указывает идентификатор соединителя, например shared_office365users. |
PA_CLI_CONNECTOR_SEARCH |
--search |
Фильтрует результаты из pa connector list. |
PA_CLI_DATASET |
--dataset |
Задает набор данных, например сайт SharePoint или базу данных SQL. |
PA_CLI_DATA_SOURCE_NAME |
--name |
Указывает источник данных для обновления или удаления. |
PA_CLI_ORG_URL |
--org-url |
Переопределяет URL-адрес организации Dataverse, используемый для получения метаданных при добавлении источника данных. |
PA_CLI_PROCEDURE |
--procedure |
Указывает хранимую процедуру SQL. |
PA_CLI_SOLUTION_ID |
--solution-id |
Указывает решение для pa app push, pa app add data-sourceили pa connection list-references. |
PA_CLI_SOLUTION_SEARCH |
--search |
Фильтрует результаты из pa solution list. |
PA_CLI_TABLE |
--table |
Указывает имя ресурса таблицы или соединителя. |
Сведения о командах, которые принимают каждый параметр, см. в справочнике по команде cli Power Apps.
API-интерфейсы dataverse и потоки Power Automate
| Переменная среды | Соответствующий параметр | Description |
|---|---|---|
PA_CLI_DATAVERSE_API_NAME |
--api-name |
Указывает действие или функцию Dataverse для добавления с помощью pa app add dataverse-api. |
PA_CLI_DATAVERSE_API_SEARCH_TERM |
--search |
Фильтрует действия и функции Dataverse по имени pa app find-dataverse-api. |
PA_CLI_FLOW_DATA_SOURCE_NAME |
--flow-name |
Указывает источник данных потока для удаления из приложения с помощью pa app remove flow |
PA_CLI_FLOW_ID |
--flow-id |
Указывает поток Power Automate для добавленияpa app add flow. |
PA_CLI_FLOW_SEARCH |
--search |
Фильтрует доступные потоки Power Automate по имениpa app list-flows |
PA_CLI_REMOVE_FLOW_ID |
--flow-id |
Указывает поток Power Automate для удаления с помощьюpa app remove flow |
Выходные данные телеметрии и консоли
| Переменная среды | Соответствующий параметр | Description |
|---|---|---|
PA_CLI_CONSOLE_ONLY |
--console-only |
Задайте для параметра значение true (строчные буквы) или pa telemetry enablepa telemetry disable записать данные телеметрии только в консоль, а не отправлять их удаленно. |
PA_CLI_OUTPUT_TO_CONSOLE |
--output-to-console |
Задайте значение true (строчным регистром) с pa telemetry enable событиями телеметрии удаленно отправляемых данных в консоль или pa telemetry disable зеркальным отображением. |
PA_CLI_TELEMETRY |
None | Задайте одно из этих значений, чтобы отключить телеметрию для текущего процесса: - 0- false- no- offЗначения являются нечувствительными к регистру, а окружающие пространства игнорируются. |
Сведения о постоянных параметрах телеметрии см. в разделе "Управление параметрами телеметрии" для интерфейса командной строки Power Apps.
Стандартные переменные среды
Интерфейс командной строки также наблюдает эту стандартную переменную среды:
| Переменная среды | Description |
|---|---|
NO_COLOR |
Задайте для этой переменной значение nonempty, чтобы отключить выходные данные цвета ANSI. Вы также можете использовать --no-color этот параметр. |