Power Apps CLI environment variables

Power Apps CLI аутентификациясын баптау және скрипттер мен CI/CD құбырларында командалық опцияларды ұсыну үшін қоршаған орта айнымалыларын қолданыңыз. Power Apps CLI анықтаған орта айнымалылары префиксті PA_CLI_ пайдаланады.

Ескертпе

Қоршаған орта айнымалылары — операциялық жүйе қосымшаларға қолжетімді ететін атаулы мәндер. Power Apps CLI осы анықтамада сипатталған айнымалыларды таниды. Қоршаған орта айнымалыларының қалай жұмыс істейтінін және оларды қалай басқару керектігін білу үшін Environment Variables бөлімін қараңыз.

Бұл анықтама Power Apps CLI-ді баптайтын операциялық жүйе ортасының айнымалыларын сипаттайды. Бұл айнымалылар Power Platform шешім ортасының айнымалыларынан өзгеше, олар қосымша қолданатын конфигурация мәндерін сақтайды.

Командалық опция үшін CLI келесі ретпен мәнді анықтайды:

Командалық жол опциясы
Орта айнымалысы
Әдепкі мән, егер опцияда ол болса
Қолдау тапқан кезде интерактивті тапсырма

Командалық жолда берілген опция оған сәйкес қоршаған орта айнымалысына қарағанда басымдыққа ие болады.

Маңызды

Қоршаған орта айнымалылары құпияларды басқа процестерге, журналдарға немесе shell тарихына ашуы мүмкін. CI PA_CLI_SP_CLIENT_SECRET /CD платформаңыздың құпия қоймасында сақтаңыз, журналдардан жасырыңыз және құпияларды бастапқы кодты бақылауға жүктемеңіз.

Орта айнымалыларын жиынтыу

Төмендегі мысалдар Power Apps CLI командасын іске қосар алдында қойылғанPA_CLI_ENVIRONMENT_ID.

PowerShell
Баш

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

export 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 директориясының (tenant) идентификаторын анықтайды.
`PA_CLI_USE_SP_AUTH`	Қызмет принципінің аутентификациясын пайдалану үшін (кіші әріп) мәнін `true` орнатыңыз.

Үш PA_CLI_SP_* тіркеу айнымалысы қызмет негізгі аутентификациясы таңдалғанда қажет. CI=true Сонымен қатар үйлесімділік үшін қызмет негізгі аутентификациясын таңдағанымен, аутентификация режимін анық көрсету үшін қолданыладыPA_CLI_USE_SP_AUTH=true.

Орнату нұсқаулары үшін Publish Power Apps code apps with service principal бөлімін қараңыз.

Жаһандық командалық опциялар

Бұл айнымалылар 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`	Build output каталогын анықтайды. Әдепкі — `./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` Мән сақталады және `localAppUrlpower.config.json` болашақ `pa app run` командалар үшін әдепкі URL болады. Әдепкі — `http://localhost:3000`.

Қосымшаларды іске қосу

Бұл айнымалылар опцияларды ұсынады pa app run.

Орта айнымалысы	Сәйкес опция	Сипаттама
`PA_CLI_LOCAL_APP_URL`	`--local-app-url`	Сақталған конфигурацияны өзгертпей-ақ ағымдағы команданың мәнін `power.config.json` ауыстырады`localAppUrl`. Егер екі мән де орнатылмаса, әдепкі — `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`	Деректер көзін қосқанда метадеректерді алу үшін қолданылатын Dataverse ұйымының URL мекенжайын өзгертеді.
`PA_CLI_PROCEDURE`	`--procedure`	SQL сақталған процедураны анықтайды.
`PA_CLI_SOLUTION_ID`	`--solution-id`	, , немесе `pa connection list-references`. үшін `pa app pushpa app add data-source`шешімді анықтайды.
`PA_CLI_SOLUTION_SEARCH`	`--search`	Фильтрлер .`pa solution list`
`PA_CLI_TABLE`	`--table`	Кесте немесе коннектор ресурсының атауын көрсетеді.

Әр опцияны қабылдайтын командалар үшін Power Apps CLI командасының сілтемесін қараңыз.

Dataverse API және Power Automate ағындары

Орта айнымалысы	Сәйкес опция	Сипаттама
`PA_CLI_DATAVERSE_API_NAME`	`--api-name`	pa қосымшасы арқылы қосу үшін Dataverse әрекетін немесе функциясын анықтайды, 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 enablepa 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` опцияны да пайдалана аласыз.

Кері байланыс

Бет пайдалы болды ма?

Last updated on 2026-09-01