змінні середовища Power Apps CLI

Використовуйте змінні середовища, щоб настроїти автентифікацію Power Apps CLI та надати параметри команд у сценаріях і каналах CI/CD. Змінні середовища, визначені Power Apps CLI, використовують PA_CLI_ префікс.

Примітка.

Змінні середовища – це іменовані значення, які операційна система робить доступними для програм. Power Apps CLI розпізнає змінні, описані в цьому посиланні. Щоб дізнатися, як працюють змінні середовища та як ними керувати, див. статтю Про змінні середовища.

У цьому посиланні описано змінні середовища операційної системи, які настроюють Power Apps CLI. Ці змінні відрізняються від змінних середовища рішення Power Platform, у яких зберігаються значення конфігурації, які використовуються програмою.

Для параметра команди CLI усуває значення в такому порядку:

  1. Параметр командного рядка
  2. Змінна середовища
  3. Стандартне значення, якщо параметр має одне
  4. Інтерактивний запит, коли підтримується

Параметр, указаний у командному рядку, має пріоритет над відповідною змінною середовища.

Важливий

Змінні середовища можуть надавати секрети іншим процесам, журналам або журналу оболонки. Зберігайте PA_CLI_SP_CLIENT_SECRET в таємному магазині платформи CI/CD, маскуйте його з журналів і не давайте секрети для керування джерелом.

Встановлення змінних середовища

Наведені нижче приклади наведено PA_CLI_ENVIRONMENT_ID перед виконанням команди Power Apps CLI.

$env:PA_CLI_ENVIRONMENT_ID = "<environment-id>"
pa app list

Змінна середовища залишається доступною для команд, запущених із того самого сеансу терміналу. Використовуйте стандартну команду оболонки, щоб видалити її, коли вона більше не потрібна.

Автентифікація

Змінна середовища Опис
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.

Змінна середовища Відповідний параметр Опис
PA_CLI_CLOUD --cloud Вибирає цільову хмару. Допустимими значеннями є:
- public (за замовчуванням)
- usgov
- usgovhigh
- usgovdod
- china
Значення нечутливі до регістра.
PA_CLI_ENVIRONMENT_ID --environment-id Указує ідентифікатор середовища цільової платформи Power Platform.

Ініціалізація програми

Ці змінні постачають параметри для pa app init.

Змінна середовища Відповідний параметр Опис
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.

Змінна середовища Відповідний параметр Опис
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.

Змінна середовища Відповідний параметр Опис
PA_CLI_SHARE_ACCESS --access Указує рівень доступу. Допустимими значеннями є:
- play (за замовчуванням)
- edit
PA_CLI_SHARE_PRINCIPAL --principal Указує одну або кілька адрес електронної пошти, розділених комами, або ідентифікатори Microsoft Entra об'єктів.

Рішення, з'єднувачі та джерела даних

Змінна середовища Відповідний параметр Опис
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 Указує ім'я ресурсу таблиці або з'єднувача.

Команди, які приймають кожен параметр, див. в Power Apps посилання на команду CLI.

API та потоки Power Automate dataverse

Змінна середовища Відповідний параметр Опис
PA_CLI_DATAVERSE_API_NAME --api-name Указує дію або функцію Dataverse для додавання за допомогою програми pa 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

Телеметрія та вивід консолі

Змінна середовища Відповідний параметр Опис
PA_CLI_CONSOLE_ONLY --console-only Установіть значення true (у нижньому регістрі) за допомогою pa telemetry enable телеметрії або pa telemetry disable для записування лише консолі та не надсилайте його віддалено.
PA_CLI_OUTPUT_TO_CONSOLE --output-to-console Установіть значення true (у нижньому регістрі) або pa telemetry enablepa telemetry disable віддзеркалення подій телеметрії, надісланих віддалено, на консоль.
PA_CLI_TELEMETRY Ніхто Установіть одне з цих значень, щоб вимкнути телеметрію для поточного процесу:
- 0
- false
- no
- off
Значення нечутливі до регістру, а навколишні пробіли ігноруються.

Відомості про постійні настройки телеметрії див. в статті Керування параметрами телеметрії для Power Apps CLI.

Стандартні змінні середовища

CLI також дотримується цієї стандартної змінної середовища:

Змінна середовища Опис
NO_COLOR Установіть для цієї змінної значення nonempty, щоб вимкнути виведення кольорів ANSI. Також можна скористатися параметром --no-color .
  • Last updated on