Бележка
Достъпът до тази страница изисква удостоверяване. Можете да опитате да влезете или да промените директориите.
Достъпът до тази страница изисква удостоверяване. Можете да опитате да промените директориите.
Използвайте променливи на средата, за да конфигурирате Power Apps CLI удостоверяване и да предоставите опции за командите в скриптове и канали на CI/CD. Променливите на средата, дефинирани от Power Apps CLI, използват PA_CLI_ префикса.
Забележка
Променливите на средата са наименувани стойности, които операционната система предоставя на приложенията. Power Apps CLI разпознава променливите, описани в тази препратка. За да научите как работят променливите на средата и как да ги управлявате, вижте За променливите на средата.
Тази препратка описва променливите на средата на операционната система, които конфигурират Power Apps CLI. Тези променливи са различни от променливите на средата на решението на Power Platform, които съхраняват стойностите на конфигурацията, използвани от дадено приложение.
За опция за команда CLI разрешава стойност в следния ред:
- Опция за команден ред
- Променлива на среда
- Стойност по подразбиране, ако опцията има такава
- Интерактивна подкана, когато се поддържа
Дадена опция, предоставена в командния ред, има приоритет пред съответната променлива на средата.
Важно
Променливите на средата могат да разкриват тайни за други процеси, регистрационни файлове или хронология на обвивката. Съхранявайте PA_CLI_SP_CLIENT_SECRET в тайния магазин на вашата платформа за CI/CD, маскиране от регистрационни файлове и не отделяйте тайни за управление на източника.
Задаване на променливи на средата
Следващите примери са зададениPA_CLI_ENVIRONMENT_ID, преди да изпълните команда CLI за Power Apps.
$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 на dataverse и потоци на Power Automate
| Променлива на среда | Съответстваща опция | Описание |
|---|---|---|
PA_CLI_DATAVERSE_API_NAME |
--api-name |
Указва действието или функцията Dataverse, която да се добави с pa app, към която да се добави 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 enable или pa telemetry disable да дублирате отдалечено изпратени събития за телеметрия към конзолата. |
PA_CLI_TELEMETRY |
Няма | Задайте една от тези стойности, за да забраните телеметрията за текущия процес: - 0- false- no- offСтойностите са нечувствителни към малки и главни букви, а околните интервали се игнорират. |
За постоянни настройки за телеметрия вижте Управление на настройките за телеметрия за Power Apps CLI.
Стандартни променливи на средата
CLI също така спазва тази стандартна променлива на средата:
| Променлива на среда | Описание |
|---|---|
NO_COLOR |
Задайте на тази променлива непразна стойност, за да забраните ANSI цветовия изход. Можете също да използвате опцията --no-color . |