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. इंटरएक्टिव प्रॉम्प्ट, जब समर्थित हो

कमांड लाइन पर दिया गया एक विकल्प अपने संबंधित पर्यावरण चर पर वरीयता लेता है।

महत्वपूर्ण

पर्यावरण चर अन्य प्रक्रियाओं, लॉग या शेल इतिहास के रहस्यों को उजागर कर सकते हैं। अपने CI/CD प्लेटफ़ॉर्म के गुप्त स्टोर में स्टोर करें PA_CLI_SP_CLIENT_SECRET , इसे लॉग से छिपाएं, और स्रोत नियंत्रण के लिए रहस्य न रखें।

परिवेश चर सेट करें

निम्न उदाहरण Power Apps CLI कमांड चलाने से पहले सेट किए PA_CLI_ENVIRONMENT_ID गए हैं.

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

पर्यावरण चर एक ही टर्मिनल सत्र से शुरू किए गए आदेशों के लिए उपलब्ध रहता है। इसे हटाने के लिए अपने शेल के मानक कमांड का उपयोग करें जब इसकी आवश्यकता न रह जाए।

प्रमाणीकरण

परिवेश चर विवरण
PA_CLI_ACCOUNT या के pa auth switchलिए pa auth login खाता निर्दिष्ट करता है।
PA_CLI_SP_CLIENT_ID सेवा प्रिंसिपल प्रमाणीकरण के लिए Microsoft Entra अनुप्रयोग (क्लाइंट) ID निर्दिष्ट करता है।
PA_CLI_SP_CLIENT_SECRET सेवा प्रिंसिपल प्रमाणीकरण के लिए क्लाइंट सीक्रेट निर्दिष्ट करता है।
PA_CLI_SP_TENANT_ID सेवा प्रिंसिपल प्रमाणीकरण के लिए Microsoft Entra निर्देशिका (tenant) ID निर्दिष्ट करता है।
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 परिवेश ID निर्दिष्ट करता है.

ऐप आरंभीकरण

ये चर आपूर्ति विकल्प 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। मान को इस तरह सहेजा 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 ऑब्जेक्ट ID निर्दिष्ट करता है।

समाधान, कनेक्टर और डेटा स्रोत

परिवेश चर संबंधित विकल्प विवरण
PA_CLI_AS --as निर्दिष्ट करता है कि क्या pa app add data-source कोई कनेक्टर जोड़ता है जो तालिकाओं और क्रियाओं दोनों को तालिका के रूप में या क्रियाओं के रूप में समर्थन करता है. मान्य मान हैं:
- table
- action
मान केस-असंवेदनशील हैं।
PA_CLI_CONNECTION_DISPLAY_NAME --display-name कनेक्शन बनाते समय प्रदर्शन नाम निर्दिष्ट करता है।
PA_CLI_CONNECTION_ID --connection-id कनेक्टर कनेक्शन इंस्टेंस ID निर्दिष्ट करता है।
PA_CLI_CONNECTION_REF --connection-ref एक कनेक्शन संदर्भ तार्किक नाम निर्दिष्ट करता है।
PA_CLI_CONNECTION_SEARCH --search फ़िल्टर परिणाम .pa connection list
PA_CLI_CONNECTOR --connector कोई कनेक्टर ID, जैसे , shared_office365usersया कनेक्टर प्रदर्शन नाम, जैसे निर्दिष्ट Office 365 Usersकरता है, जैसे .
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 एक तालिका या कनेक्टर संसाधन नाम निर्दिष्ट करता है. एकाधिक कनेक्टर तालिकाएँ जोड़ने के लिए, आदेश-पंक्ति पैरामीटर दोहराएँ --table । विवरण के लिए, टिप्पणियां देखेंpa app add data-source।

प्रत्येक विकल्प को स्वीकार करने वाले आदेशों के लिए, Power Apps CLI आदेश संदर्भ देखें.

Dataverse API और Power Automate प्रवाह

परिवेश चर संबंधित विकल्प विवरण
PA_CLI_DATAVERSE_API_NAME --api-name pa app add dataverse-api के साथ जोड़ने के लिए Dataverse क्रिया या फ़ंक्शन निर्दिष्ट करता है.
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 इसके साथ जोड़ने pa app add flowके लिए Power Automate प्रवाह निर्दिष्ट करता है.
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 मान को (लोअरकेस) pa telemetry enable पर सेट true करें या कंसोल pa telemetry disable पर दूरस्थ रूप से भेजे गए टेलीमेट्री ईवेंट को मिरर करने के लिए।
PA_CLI_TELEMETRY कोई नहीं वर्तमान प्रक्रिया के लिए टेलीमेट्री को अक्षम करने के लिए इन मानों में से एक सेट करें:
- 0
- false
- no
- off
मान केस-असंवेदनशील हैं, और आसपास के स्थानों को नजरअंदाज कर दिया जाता है।

लगातार टेलीमेट्री सेटिंग्स के लिए, Power Apps CLI के लिए टेलीमेट्री सेटिंग्स प्रबंधित करें देखें.

मानक पर्यावरण चर

सीएलआई इस मानक पर्यावरण चर को भी देखता है:

परिवेश चर विवरण
NO_COLOR ANSI रंग आउटपुट को अक्षम करने के लिए इस चर को एक nonempty मान पर सेट करें। आप विकल्प का भी उपयोग कर सकते हैं --no-color ।