Power Pages के लिए Microsoft Power Platform CLI समर्थन

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

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

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

नोट

• यह सुविधा आम तौर पर Power Platform CLI संस्करण 1.9.8 के साथ उपलब्ध है. नवीनतम संस्करण स्थापित करने के बारे में जानने के लिए, CLI स्थापित करें पर Microsoft Power Platform जाएँ.
• सीएलआई संस्करण 1.27 से Power Platform शुरू होकर, pac paportal कमांड को बदल दिया जाता है। pac powerpages paportal काम करना जारी रखता है, लेकिन हम आगे बढ़ने का उपयोग करने powerpages की सलाह देते हैं। यह लेख जल्द ही इसके बजाय उपयोग powerpages करने के लिए अपडेट किया जाएगा। paportal

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

Microsoft Power Platform CLI के साथ, अब आप वेबसाइट कॉन्टेंट में बदलाव करके वेबसाइट अनुकूलन के लिए ऑफ़लाइन जैसी क्षमता का इस्तेमाल कर सकते हैं. और एक बार जब सभी अनुकूलन या परिवर्तन सहेज लिए जाए, तो आप वेबसाइट कॉन्फ़िगरेशन को वापस Microsoft Dataverse पर अपलोड कर सकते हैं. जब आप 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 पोर्टल समर्थन निम्न तालिकाओं तक सीमित है।

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

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

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

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

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

इस फ़ाइल में, आपके पास तालिका 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 में आम कमांड्स.

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

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

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

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

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

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

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

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

नोट

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

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

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

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

नोट

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

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

आप VS Code एक्सटेंशन Power Platform VS Code एक्सटेंशन का भी उपयोग कर सकते हैं ताकि IntelliSense से बिल्ट-इन लिक्विड लैंग्वेज का लाभ मिल सके, कोड पूर्णता में सहायता, इशारा करना और VS Code एकीकृत टर्मिनल का उपयोग करके Microsoft Power Platform CLI के साथ इंटरैक्ट किया जा सके. अधिक जानकारी: Visual Studio Code एक्सटेंशन (पूर्वावलोकन) का उपयोग करें

अधिक ध्यान देने योग्य बातें

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

अगले कदम

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

भी देखें

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