Microsoft Power Platform CLI के लिए पोर्टलों का समर्थन

नोट

12 अक्टूबर 2022 से प्रभावी, Power Apps पोर्टल Power Pages है। अधिक जानकारी: Microsoft Power Pages अब आम तौर पर उपलब्ध है (ब्लॉग)
हम जल्द ही Power Apps पोर्टल दस्तावेज़ीकरण को Power Pages दस्तावेज़ीकरण के साथ माइग्रेट और विलय करेंगे।

Microsoft Power Platform CLI (कमांड लाइन इंटरफेस) एक सरल, सिंगल-स्टॉप डेवलपर कमांड-लाइन इंटरफेस है जो डेवलपर्स और ऐप निर्माताओं को कोड घटक बनाने का अधिकार देता है.

Microsoft Power Platform CLI टूलिंग एक व्यापक अनुप्रयोग वाली लाइफ-साइकिल मैनेजमेंट (ALM) स्टोरी की ओर पहला कदम है जहां एंटरप्राइज डेवलपर्स और ISV अपने एक्सटेंशन और अनुकूलन को जल्दी और कुशलता से बना सकते हैं, निर्माण कर सकते हैं, डिबग कर सकते हैं और प्रकाशित कर सकते हैं. अधिक जानकारी के लिए, Microsoft Power Platform CLI क्या है? देखें

इस सुविधा के साथ, Microsoft Power Apps पोर्टल कॉन्फ़िगरेशन के CI/CD (सतत एकीकरण/सतत परिनियोजन) को सक्षम करने के लिए Microsoft Power Platform CLI का समर्थन करता है। अब आप पोर्टल कॉन्फ़िगरेशन को स्रोत नियंत्रण में देख सकते हैं और Microsoft Power Platform CLI का उपयोग करके पोर्टल कॉन्फ़िगरेशन को किसी भी परिवेश में ले जा सकते हैं.

नोट

यह सुविधा आम तौर पर Power Platform CLI संस्करण 1.9.8 के साथ उपलब्ध है. नवीनतम संस्करण इंस्टॉल करने के बारे में जानने के लिए, Microsoft Power Platform CLI इंस्टॉल करें देखें.

पोर्टलों के विकास के लिए Microsoft Power Platform CLI का उपयोग क्यों करें?

Microsoft Power Platform CLI के लिए पोर्टल्स सपोर्ट के साथ, अब आप पोर्टल्स कॉन्टेंट में बदलाव करके पोर्टल्स कस्टमाइजेशन के लिए ऑफलाइन जैसी क्षमता का इस्तेमाल कर सकते हैं. और एक बार जब सभी कस्टमाइजेशन या परिवर्तन सहेजे जाते हैं, तो उन्हें पोर्टल पर अपलोड करें. जब आप Microsoft Power Platform CLI का उपयोग करके पोर्टल्स कॉन्टेंट डाउनलोड करते हैं, तो कॉन्टेंट को YAML और HTML प्रारूपों में स्ट्रक्चर किया जाता है जिससे इसे अनुकूलित करना आसान हो जाता है, जिससे विकास-समर्थक अनुभव सक्षम होता है.

यहां उन सुविधाओं और क्षमताओं की एक सूची दी गई है जो Microsoft Power Platform CLI के समर्थन से पोर्टलों को लाभ पहुंचाती हैं:

उपयोग में आसानी

• स्थानीय फ़ाइल प्रणाली से पोर्टल डेटा डाउनलोड/अपलोड करने के लिए समर्थन

• मौजूदा Microsoft Power Platform CLI टूल पर बना हुआ.

अनुप्रयोग जीवनचक्र प्रबंधन (ALM)

• किसी संगठन के भीतर पोर्टल कॉन्फ़िगरेशन में परिवर्तन ट्रैक करें

• संगठनों या टेनेंटों में कॉन्फ़िगरेशन फ़ाइलों को स्थानांतरित करें

विकास-समर्थक और उद्यम समर्थन

• किसी भी सोर्स कंट्रोल टूल के साथ मूल रूप से एकीकृत करने में मदद करता है, जैसे "गिट"

• CI/CD पाइपलाइनों को आसानी से सेटअप करें

Microsoft Power Platform CLI इंस्टॉल करें

चरण-दर-चरण निर्देशों के लिए, Microsoft Power Platform CLI स्थापित करें देखें.

समर्थित तालिकाएं

Microsoft Power Platform CLI के लिए पोर्टल्स समर्थन नीचे सूचीबद्ध तालिकाओं तक सीमित है.

adx_ad

adx_adplacement

adx_blog

adx_blogpost

adx_botconsumer

adx_communityforum

adx_communityforumaccesspermission

adx_contentsnippet

adx_entityform

adx_entityformmetadata

adx_entitylist

adx_entitypermission

adx_forumthreadtype

adx_pagetemplate

adx_poll

adx_polloption

adx_pollplacement

adx_portallanguage

adx_publishingstate

adx_redirect

adx_shortcut

adx_sitemarker

adx_sitesetting

adx_tag

adx_urlhistory

adx_webfile

adx_webform

adx_webformmetadata

adx_webformstep

adx_weblink

adx_weblinkset

adx_webpage

adx_webpageaccesscontrolrule

adx_webrole

adx_website

adx_websiteaccess

adx_websitebinding (केवल डाउनलोड)

adx_websitelanguage

adx_webtemplate

टिप्पणी

महत्वपूर्ण

• Microsoft Power Platform CLI का उपयोग करके अनुकूलन के लिए कस्टम तालिका और पोर्टल टेम्पलेट-विशिष्ट तालिका (जैसे ब्लॉग, समुदाय या विचार पोर्टल) का समर्थन नहीं किया जाता है.
• विज्ञापन (adx_ad) रिकॉर्ड में छवि फ़ाइल अटैचमेंट Power Platform सीएलआई का उपयोग करके डाउनलोड नहीं किया जाता है. एक समाधान के रूप में, छवि URL फ़ील्ड का उपयोग करें, या एक वेब फ़ाइल एक छवि फ़ाइल युक्त रिकॉर्ड करने के लिए प्रतिलिपि फ़ील्ड में एक HTML संदर्भ जोड़कर.

पोर्टल के लिए Microsoft Power Platform CLI इंस्टॉल करें और सत्यापित करें

Microsoft Power Platform CLI इंस्टॉल करने के बारे में जानने के लिए, Microsoft Power Platform CLI इंस्टॉल करें पर जाएं.

Microsoft Power Platform CLI इंस्टॉल करने के बाद, एक कमांड-प्रॉम्प्ट खोलें और आउटपुट में "पापोर्टल" - Power Apps पोर्टल्स के लिए कमांड शामिल है या नहीं, इसे सत्यापित करने के लिए pac चलाएं.

पोर्टलों के लिए Microsoft Power Platform CLI कमांड

पोर्टल्स के लिए Microsoft Power Platform CLI कमांड "पापोर्टल" है.

नीचे दिए गए अनुभाग “पपोर्टल” कमांड के विभिन्न गुणों के बारे में अतिरिक्त विवरण प्रदान करते हैं.

पैरामीटर्स

गुण नाम	विवरण	उदाहरण
सूची	वर्तमान Dataverse परिवेश से सभी पोर्टल वेबसाइटों को सूचीबद्ध करें.	pac paportal list
डाउनलोड करें	वर्तमान Dataverse परिवेश से पोर्टल वेबसाइट सामग्री डाउनलोड करें. इसके निम्नलिखित पैरामीटर हैं: - पाथ: पाथ जहां वेबसाइट कॉन्टेंट डाउनलोड की जाएगी (उर्फ: -p) - webSiteId: पोर्टल वेबसाइट ID डाउनलोड करने के लिए (उर्फ: -id) - ओवरराइट: (वैकल्पिक) सही - मौजूदा कॉन्टेंट को ओवरराइट करने के लिए; गलत - विफल करने के लिए यदि फ़ोल्डर में पहले से ही वेबसाइट कॉन्टेंट (उर्फ: -o) है	pac paportal download --path "C:\portals" --webSiteId f88b70cc-580b-4f1a-87c3-41debefeb902
अपलोड करें	वर्तमान Dataverse परिवेश में पोर्टल वेबसाइट कॉन्टेंट अपलोड करें. इसके निम्नलिखित पैरामीटर हैं: - पथ: पाथ जहां वेबसाइट कॉन्टेंट संग्रहीत की जाती है (उर्फ: -p) -deploymentProfile: deployment-profiles/[profile-name].depoyment.yaml फ़ाइल में प्रोफ़ाइल चर के माध्यम से परिभाषित परिवेश विवरण के साथ पोर्टल डेटा अपलोड करें	pac paportal upload --path "C:\portals\starter-portal" --deploymentProfile "profile-name"

परिनियोजन प्रोफ़ाइल का उपयोग करें

deploymentProfile स्विच आपको YAML प्रारूप में परिवेश के लिए चर के एक सेट को परिभाषित करने की अनुमति देता है. उदाहरण के लिए, आपके पास अलग-अलग परिनियोजन प्रोफ़ाइल (जैसे डेवलपमेंट, परीक्षण, उत्पाद) हो सकते हैं जिनकी प्रोफ़ाइल में अलग-अलग स्कीमा विवरण परिभाषित होते हैं.

यदि आप परीक्षण प्रोफ़ाइल बना रहे हैं, तो आप "test.deployment.yml" (अर्थात, <profileTag>.deployment.yml) नाम से परिनियोजन-प्रोफ़ाइल के अंतर्गत फ़ाइल बना सकते हैं. और आप इस प्रोफ़ाइल का उपयोग करने के लिए टैग (<profileTag>) के साथ कमांड चला सकते हैं:

pac paportal upload --path "C:\portals\starter-portal" --deploymentProfile test

इस फ़ाइल में, आपके पास तालिका ID के साथ तालिका (निकाय) का नाम, विशेषताओं की सूची और वे मान हो सकते हैं जिन्हें आप deploymentProfile पैरामीटर का उपयोग करके पोर्टल कॉन्फ़िगरेशन अपलोड करते समय ओवरराइड करना चाहते हैं.

इसके अतिरिक्त, आप ऑपरेटिंग सिस्टम के परिवेश चरों तक पहुँचने के लिए OS चर का उपयोग कर सकते हैं.

यहां इस "test.deployment.yml" प्रोफ़ाइल YAML फ़ाइल का एक उदाहरण दिया गया है जिसमें अद्वितीय स्कीमा विवरण हैं:

adx_sitesetting:
    - adx_sitesettingid: 4ad86900-b5d7-43ac-1234-482529724970
      adx_value: ${OS.FacebookAppId} 
      adx_name: Authentication/OpenAuth/Facebook/AppId
    - adx_sitesettingid: 5ad86900-b5d7-43ac-8359-482529724979
      adx_value: contoso_sample
      adx_name: Authentication/OpenAuth/Facebook/Secret
adx_contentsnippet:
    - adx_contentsnippetid: b0a1bc03-0df1-4688-86e8-c67b34476510
      adx_name: PowerBI/contoso/sales
      adx_value:  https://powerbi.com/group/contoso/sales

नोट

पोर्टल्स के अलावा CLI में इस्तेमाल होने वाले सभी कमांड्स के बारे में जानने के लिए Microsoft Power Platform CLI में आम कमांड्स.

मैनिफेस्ट फाइलें

जब आप पीएसी पोर्टल डाउनलोड CLI कमांड का उपयोग करके वेबसाइट की सामग्री डाउनलोड करते हैं, तो साइट की सामग्री डाउनलोड करने के साथ-साथ यह दो मेनिफेस्ट फ़ाइलें भी जनरेट करेगा;

• पर्यावरण मेनिफेस्ट फ़ाइल (org-url-manifest.yml)
• ट्रैकिंग मेनिफेस्ट फ़ाइल हटाएं (manifest.yml)

पर्यावरण मेनिफेस्ट फ़ाइल (org-url-manifest.yml)

हर बार जब पीएसी पोर्टल डाउनलोड कमांड चलाया जाता है तो एनवायरनमेंट मैनिफ़ेस्ट फ़ाइल जनरेट होती है.

प्रत्येक डाउनलोड के बाद, पीएसी सीएलआई उपकरण मौजूदा पर्यावरण मेनिफेस्ट फ़ाइल को पढ़ता है और पर्यावरण में हटाई गई प्रविष्टियों को अद्यतन करता है, या पर्यावरण मेनिफेस्ट फ़ाइल मौजूद नहीं होने पर बनाता है।

जब आप पोर्टल वेबसाइट की सामग्री अपलोड करने के लिए पीएसी पोर्टल अपलोड कमांड चलाते हैं. यह पर्यावरण मेनिफेस्ट फ़ाइल को पढ़ता है और पिछले डाउनलोड के बाद किए गए परिवर्तनों की पहचान करता है और केवल अद्यतन सामग्री को अपलोड करता है. यह अपलोड प्रक्रिया को अनुकूलित करने में मदद करता है क्योंकि हर अपलोड कमांड पर सभी सामग्री को अपलोड करने के बजाय केवल अपडेट की गई वेबसाइट सामग्री ही अपलोड होती है.

आकस्मिक परिवर्तनों से बचने के लिए, परिवेश मेनिफ़ेस्ट फ़ाइल केवल तभी पढ़ी जाएगी जब वह समान परिवेश से कनेक्ट होती है (पर्यावरण URL फ़ाइल नाम से मेल खाता है).

ट्रैकिंग मेनिफेस्ट फ़ाइल हटाएं (manifest.yml)

इस फ़ाइल का उपयोग परिवेश से हटाए गए रिकॉर्ड को ट्रैक करने के लिए किया जाता है.

जब वेबसाइट की सामग्री को पीएसी पोर्टल डाउनलोड कमांड से डाउनलोड किया जाता है, तो यह पर्यावरण मेनिफेस्ट फ़ाइल (org-url-manifest.yml) से हटाए गए रिकॉर्ड को manifest.yml फ़ाइल में जोड़ देगा. इसलिए, जब आप पीएसी पोर्टल अपलोड कमांड का उपयोग करके वेबसाइट की सामग्री अपलोड करते हैं, तो यह फाइलों को वातावरण से (यहां तक कि एक अलग वातावरण में) हटा देगा. यह फ़ाइल हटाई नहीं जाती है, और इसका उपयोग इस बात पर ध्यान दिए बिना किया जाता है कि आप किस परिवेश से जुड़े हुए हैं।

नोट

एक वातावरण में साइट सामग्री रिकॉर्ड को हटाने के लिए और PAC CLI का उपयोग करके उसी सामग्री रिकॉर्ड को दूसरे वातावरण में भी हटाने के लिए, आपको वेबसाइट रिकॉर्ड सामग्री को हटाने से पहले और बाद में पीएसी पोर्टल डाउनलोड कमांड चलाने की आवश्यकता होगी. जब पीएसी पोर्टल अपलोड कमांड चलाया जाता है, तो मेनिफ़ेस्ट.आईएमएल इन परिवर्तनों को ट्रैक करेगा और लक्ष्य वातावरण में संबंधित रिकॉर्ड को हटा देगा.

Visual Studio Code एक्सटेंशन का प्रयोग करें

You can also use VS Code extension Power Platform VS Code Extension to benefit built-in Liquid language from IntelliSense, code completion assistance, hinting, and interact with the Microsoft Power Platform CLI using the VS Code Integrated Terminal. अधिक जानकारी: Visual Studio Code एक्सटेंशन (पूर्वावलोकन) का उपयोग करें

अतिरिक्त विचार

• यदि आपका फ़ाइल पाथ अधिकतम पाथ लंबाई सीमा से अधिक है, तो किसी त्रुटि की सूचना दी जाती है. अधिक जानकारी: Windows में अधिकतम पाथ लंबाई की सीमा
• डुप्लीकेट वेब पेज नाम जैसे डुप्लीकेट रिकॉर्ड के लिए, Microsoft Power Platform CLI दो अलग-अलग फ़ोल्डर बनाता है—एक वेब पेज के नाम के साथ, और दूसरा उसी नाम के आगे एक हैश कोड के साथ. उदाहरण के लिए, "मेरा पेज" और "मेरा पेज-हैश-कोड".

अगले कदम

ट्यूटोरियल: पोर्टल के साथ Microsoft Power Platform CLI का उपयोग करें

इसे भी देखें

• Microsoft Power Platform CLI
• Visual Studio Code एक्सटेंशन (पूर्वावलोकन) का उपयोग करें