Notă
Accesul la această pagină necesită autorizare. Puteți încerca să vă conectați sau să modificați directoarele.
Accesul la această pagină necesită autorizare. Puteți încerca să modificați directoarele.
Utilizați variabilele de mediu pentru a configura autentificarea Power Apps CLI și a furniza opțiuni de comandă în scripturi și canale CI/CD. Variabilele de mediu definite de Power Apps CLI utilizează prefixulPA_CLI_.
Notă
Variabilele de mediu sunt denumite valori pe care sistemul de operare le pune la dispoziție aplicațiilor. Power Apps CLI recunoaște variabilele descrise în această referință. Pentru a afla cum funcționează variabilele de mediu și cum să le gestionați, consultați Despre Variabilele de mediu.
Această referință descrie variabilele de mediu ale sistemului de operare care configurează Power Apps CLI. Aceste variabile sunt diferite de variabilele de mediu pentru soluții Power Platform, care stochează valorile de configurare utilizate de o aplicație.
Pentru o opțiune de comandă, CLI rezolvă o valoare în această ordine:
- Opțiune linie de comandă
- Variabilă de mediu
- Valoare implicită, dacă opțiunea are una
- Solicitare interactivă, când este acceptată
O opțiune furnizată în linia de comandă are prioritate față de variabila de mediu corespunzătoare.
Importantă
Variabilele de mediu pot expune secrete altor procese, jurnale sau istoric shell. Stocați-vă PA_CLI_SP_CLIENT_SECRET în magazinul secret al platformei CI/CD, mascați-l din jurnale și nu comiteți secrete pentru controlul sursei.
Setați variabilele de mediu
Următoarele exemple sunt setate PA_CLI_ENVIRONMENT_ID înainte de a rula o comandă Power Apps CLI.
$env:PA_CLI_ENVIRONMENT_ID = "<environment-id>"
pa app list
Variabila de mediu rămâne disponibilă pentru comenzile pornite din aceeași sesiune terminală. Utilizați comanda standard a shellului pentru a o elimina atunci când nu mai este necesară.
Autentificare
| Variabilă de mediu | Descriere |
|---|---|
PA_CLI_ACCOUNT |
Specifică contul pentru pa auth login sau pa auth switch. |
PA_CLI_SP_CLIENT_ID |
Specifică ID-ul aplicației Microsoft Entra (client) pentru autentificarea principală a serviciului. |
PA_CLI_SP_CLIENT_SECRET |
Specifică secretul clientului pentru autentificarea principală a serviciului. |
PA_CLI_SP_TENANT_ID |
Specifică ID-ul directorului (entității găzduite) Microsoft Entra pentru autentificarea principală a serviciului. |
PA_CLI_USE_SP_AUTH |
Setați valoarea la true (litere mici) pentru a utiliza autentificarea principală a serviciului. |
Cele trei PA_CLI_SP_variabile * acreditări sunt necesare atunci când este selectată autentificarea principală a serviciului. Deși, de CI=true asemenea, selectează autentificarea principală a serviciului pentru compatibilitate, utilizați-o PA_CLI_USE_SP_AUTH=true pentru a face modul de autentificare explicit.
Pentru instrucțiuni de configurare, consultați Publicarea aplicațiilor de cod Power Apps cu o entitate principală de serviciu.
Opțiuni de comandă globale
Aceste variabile corespund opțiunilor disponibile în comenzile CLI Power Apps.
| Variabilă de mediu | Opțiune corespunzătoare | Descriere |
|---|---|---|
PA_CLI_CLOUD |
--cloud |
Selectează mediul cloud țintă. Valorile valide sunt: - public (implicit)- usgov- usgovhigh- usgovdod- chinaValorile sunt sensibile la litere mari și mici. |
PA_CLI_ENVIRONMENT_ID |
--environment-id |
Specifică ID-ul de mediu de platformă Power Platform țintă. |
Inițializare aplicație
Aceste variabile furnizează opțiuni pentru pa app init.
| Variabilă de mediu | Opțiune corespunzătoare | Descriere |
|---|---|---|
PA_CLI_APP_BUILD_PATH |
--build-path |
Specifică directorul de ieșire al compilării. Valoarea implicită este ./dist. |
PA_CLI_APP_DESCRIPTION |
--description |
Specifică descrierea aplicației. |
PA_CLI_APP_DISPLAY_NAME |
--display-name |
Specifică numele afișat al aplicației. |
PA_CLI_APP_FILE_ENTRY_POINT |
--file-entry-point |
Specifică punctul de intrare HTML din rezultatul compilării. Valoarea implicită este index.html. |
PA_CLI_APP_TYPE |
--app-type |
Specifică tipul de aplicație. Valorile valide sunt: - CodeApp (implicit)- MobileAppValoarea este salvată și power.config.json utilizată ca tip de aplicație atunci când aplicația este publicată. |
PA_CLI_APP_URL |
--app-url |
Specifică URL-ul aplicației locale în timpul pa app init. Valoarea este salvată ca localAppUrl și power.config.json devine URL-ul implicit pentru comenzile viitoare pa app run . Valoarea implicită este http://localhost:3000. |
Rulați aplicații
Aceste variabile furnizează opțiuni pentru pa app run.
| Variabilă de mediu | Opțiune corespunzătoare | Descriere |
|---|---|---|
PA_CLI_LOCAL_APP_URL |
--local-app-url |
localAppUrl Înlocuiește valoarea din power.config.json pentru comanda curentă fără a modifica configurația salvată. Dacă niciuna dintre valori nu este setată, valoarea implicită este http://localhost:3000. |
PA_CLI_PORT |
--port |
Specifică portul pentru gazda Power Apps locală. Valoarea implicită este 8080. |
Partajați aplicații
Aceste variabile furnizează opțiuni pentru pa app share.
| Variabilă de mediu | Opțiune corespunzătoare | Descriere |
|---|---|---|
PA_CLI_SHARE_ACCESS |
--access |
Specifică nivelul de acces. Valorile valide sunt: - play (implicit)- edit |
PA_CLI_SHARE_PRINCIPAL |
--principal |
Specifică una sau mai multe adrese de e-mail separate prin virgulă sau ID-uri de obiect Microsoft Entra. |
Soluții, conectori și surse de date
| Variabilă de mediu | Opțiune corespunzătoare | Descriere |
|---|---|---|
PA_CLI_CONNECTION_DISPLAY_NAME |
--display-name |
Specifică numele afișat la crearea unei conexiuni. |
PA_CLI_CONNECTION_ID |
--connection-id |
Specifică un ID de instanță de conexiune de conector. |
PA_CLI_CONNECTION_REF |
--connection-ref |
Specifică un nume logic de referință de conexiune. |
PA_CLI_CONNECTION_SEARCH |
--search |
Filtrează rezultatele din pa connection list. |
PA_CLI_CONNECTOR |
--connector |
Specifică un ID de conector, cum shared_office365usersar fi . |
PA_CLI_CONNECTOR_SEARCH |
--search |
Filtrează rezultatele din pa connector list. |
PA_CLI_DATASET |
--dataset |
Specifică un set de date, cum ar fi un site SharePoint sau o bază de date SQL. |
PA_CLI_DATA_SOURCE_NAME |
--name |
Specifică sursa de date de reîmprospătat sau de eliminat. |
PA_CLI_ORG_URL |
--org-url |
Înlocuiește URL-ul organizației Dataverse utilizat pentru a regăsi metadate atunci când adăugați o sursă de date. |
PA_CLI_PROCEDURE |
--procedure |
Specifică o procedură stocată SQL. |
PA_CLI_SOLUTION_ID |
--solution-id |
Specifică soluția pentru pa app push, pa app add data-sourcesau pa connection list-references. |
PA_CLI_SOLUTION_SEARCH |
--search |
Filtrează rezultatele din pa solution list. |
PA_CLI_TABLE |
--table |
Specifică un nume de resursă de tabel sau de conector. |
Pentru comenzile care acceptă fiecare opțiune, consultați Power Apps referințe de comandă CLI.
API-uri de date și fluxuri de Power Automate
| Variabilă de mediu | Opțiune corespunzătoare | Descriere |
|---|---|---|
PA_CLI_DATAVERSE_API_NAME |
--api-name |
Specifică acțiunea Dataverse sau funcția de adăugat cu pa app add dataverse-api. |
PA_CLI_DATAVERSE_API_SEARCH_TERM |
--search |
Filtrează acțiunile și funcțiile Dataverse după nume cu pa app find-dataverse-api. |
PA_CLI_FLOW_DATA_SOURCE_NAME |
--flow-name |
Specifică sursa de date de flux cu care se va elimina din aplicație pa app remove flow |
PA_CLI_FLOW_ID |
--flow-id |
Specifică fluxul de Power Automate de adăugat cu pa app add flow. |
PA_CLI_FLOW_SEARCH |
--search |
Filtrează fluxurile de Power Automate disponibile după nume cupa app list-flows |
PA_CLI_REMOVE_FLOW_ID |
--flow-id |
Specifică fluxul de Power Automate de eliminat cupa app remove flow |
Telemetrie și ieșire consolă
| Variabilă de mediu | Opțiune corespunzătoare | Descriere |
|---|---|---|
PA_CLI_CONSOLE_ONLY |
--console-only |
Setați valoarea la true (litere mici) cu pa telemetry enable sau pa telemetry disable pentru a scrie telemetrie doar pe consolă și nu pentru a o trimite de la distanță. |
PA_CLI_OUTPUT_TO_CONSOLE |
--output-to-console |
Setați valoarea la true (litere mici) cu pa telemetry enable sau pa telemetry disable pentru a oglindi evenimentele de telemetrie trimise de la distanță pe consolă. |
PA_CLI_TELEMETRY |
Niciunul | Setați una dintre aceste valori pentru a dezactiva telemetria pentru procesul curent: - 0- false- no- offValorile sunt sensibile la litere mari și mici, iar spațiile înconjurătoare sunt ignorate. |
Pentru setările de telemetrie persistente, consultați Gestionarea setărilor de telemetrie pentru Power Apps CLI.
Variabile de mediu standard
CLI observă, de asemenea, această variabilă de mediu standard:
| Variabilă de mediu | Descriere |
|---|---|
NO_COLOR |
Setați această variabilă la o valoare nevidă pentru a dezactiva ieșirea culorii ANSI. De asemenea, puteți utiliza opțiunea --no-color . |