pac solution

أوامر للعمل مع مشاريع حل Dataverse

الاوامر

الأمر	‏‏الوصف
pac solution add-license	إضافة معلومات الترخيص والتخطيط إلى الحل.
pac solution add-reference	إضافة مرجع من المشروع في الدليل الحالي إلى المشروع في "المسار"
pac solution add-solution-component	إضافة مكون حل واحد أو أكثر إلى الحل غير المدار الهدف في Dataverse.
pac solution check	تحميل مشروع حل Dataverse لتشغيله مقابل خدمة Power Apps Checker.
pac solution clone	إنشاء مشروع حل استنادا إلى حل موجود في مؤسستك.
pac solution create-settings	إنشاء ملف إعدادات من مضغوط الحل أو مجلد الحل.
pac solution delete	حذف حل من Dataverse في البيئة الحالية.
pac solution export	تصدير حل من Dataverse.
pac solution import	استيراد الحل إلى Dataverse.
pac solution init	تهيئة دليل مع مشروع حل Dataverse جديد
pac solution list	سرد كافة الحلول من مؤسسة Dataverse الحالية
pac solution online-version	تعيين إصدار للحل الذي تم تحميله في Dataverse.
pac solution pack	مكونات حل الحزمة على نظام الملفات المحلي في solution.zip (SolutionPackager).
pac solution publish	نشر كافة التخصيصات
pac solution sync	مزامنة مشروع حل Dataverse الحالي مع الحالة الحالية للحل في مؤسستك.
pac solution unpack	استخراج مكونات الحل من solution.zip إلى نظام الملفات المحلي (SolutionPackager).
pac solution upgrade	تطبيق solution upgrade
pac solution version	تحديث إصدار أو مراجعة الحل.

pac solution add-license

إضافة معلومات الترخيص والتخطيط إلى الحل.

مثال

يوضح هذا المثال كيفية إضافة معلومات الترخيص إلى حل.

pac solution add-license --planDefinitionFile ../ISV_Plan_Definition.csv --planMappingFile ../ISV_Plan_Mapping.csv

ملف تعريف الخطة

ستجد أدناه مثالا لملف تعريف الخطة:

ServiceID,Display name,More info URL
test_isvconnect1599092224747.d365_isvconnect_prod_licensable.bronzeplan,Fabrikam Bronze Plan,http://www.microsoft.com
test_isvconnect1599092224747.d365_isvconnect_prod_licensable.silverplan,Fabrikam Silver Plan,http://www.microsoft.com
test_isvconnect1599092224747.d365_isvconnect_prod_licensable.goldplan,Fabrikam Gold Plan,http://www.microsoft.com

ملف تعيين الخطة

ستجد أدناه مثالا لملف تعيين الخطة:

Service ID,Component name
test_isvconnect1599092224747.d365_isvconnect_prod_licensable.bronzeplan,crf36_BronzeApp
test_isvconnect1599092224747.d365_isvconnect_prod_licensable.silverplan,crf36_BronzeApp
test_isvconnect1599092224747.d365_isvconnect_prod_licensable.silverplan,crf36_SilverApp
test_isvconnect1599092224747.d365_isvconnect_prod_licensable.goldplan,crf36_BronzeApp
test_isvconnect1599092224747.d365_isvconnect_prod_licensable.goldplan,crf36_SilverApp
test_isvconnect1599092224747.d365_isvconnect_prod_licensable.goldplan,crf36_GoldApp

المعلمات المطلوبة ل solution add-license

--planDefinitionFile -pd

ملف تعريف خطة الترخيص بتنسيق CSV؛ الأعمدة المتوقعة: معرف الخدمة واسم العرض وعنوان URL لمزيد من المعلومات.

--planMappingFile -pm

ملف تعيين خطة الترخيص بتنسيق CSV؛ الأعمدة المتوقعة: معرف الخدمة، اسم المكون

pac solution add-reference

إضافة مرجع من المشروع في الدليل الحالي إلى المشروع في "المسار"

مثال

pac solution add-reference --path c:\Users\Downloads\SampleComponent

المعلمات المطلوبة ل solution add-reference

--path -p

المسار إلى المشروع المشار إليه

pac solution add-solution-component

إضافة مكون حل واحد أو أكثر إلى الحل غير المدار الهدف في Dataverse.

مثال

يوضح هذا المثال كيفية إضافة مكون حل إلى حل. في هذه الحالة، نقوم بإضافة جدول جهات الاتصال إلى الحل SampleSolution. الجدول هو نوع المكون 1.

pac solution add-solution-component --solutionUniqueName SampleSolution --component contact --componentType 1

المعلمات المطلوبة ل solution add-solution-component

--component -c

اسم المخطط أو معرف المكون لإضافته إلى الحل الهدف.

--componentType -ct

القيمة التي تمثل مكون الحل الذي تضيفه.

--solutionUniqueName -sn

اسم الحل.

معلمات اختيارية ل solution add-solution-component

--AddRequiredComponents -arc

يشير إلى ما إذا كان يجب أيضا إضافة مكونات الحل الأخرى المطلوبة من قبل مكون الحل الذي تضيفه إلى الحل غير المدار.

لا تتطلب هذه المعلمة أي قيمة. إنه مفتاح

--async -a

استيراد الحل بشكل غير متزامن.

لا تتطلب هذه المعلمة أي قيمة. إنه مفتاح

--environment -env

عنوان URL للبيئة أو معرف البيئة الهدف.

pac solution check

تحميل مشروع حل Dataverse لتشغيله مقابل خدمة Power Apps Checker.

مثال

pac solution check --path c:\Users\Documents\Solution.zip --outputDirectory c:\samplepackage --geo UnitedStates

معلمات اختيارية ل solution check

--clearCache -cc

مسح solution checkذاكرة التخزين المؤقت لإنفاذ er، للمستأجر الخاص بك، لجميع السجلات المتعلقة بالنتائج السابقة للحلول الخاصة بك.

لا تتطلب هذه المعلمة أي قيمة. إنه مفتاح

--customEndpoint -ce

حدد عنوان URL مخصصا كنقطة نهاية Power Apps Checker.

--environment -env

تحديد Dataverse الهدف. قد تكون القيمة GUID أو مطلق https URL. عند عدم التحديد، سيتم استخدام المؤسسة النشطة المحددة لملف تعريف المصادقة الحالي.

--excludedFiles -ef

استبعاد الملفات من التحليل. تمرير كقيم مفصولة بفواصل

--geo -g

المثيل الجغرافي لخدمة Power Apps Checker التي يجب استخدامها.

استخدم إحدى هذه القيم:

• PreviewUnitedStates
• UnitedStates
• Europe
• Asia
• Australia
• Japan
• India
• Canada
• SouthAmerica
• UnitedKingdom
• France
• SouthAfrica
• Germany
• UnitedArabEmirates
• Switzerland
• Norway
• Singapore
• Korea
• Sweden
• USGovernment
• USGovernmentL4
• USGovernmentL5DoD
• China

--outputDirectory -o

دليل الإخراج

--path -p

المسار حيث يوجد ملف حل واحد أو أكثر ليتم التحقق من وجوده. يمكن أن يحتوي المسار على أحرف glob/wildcard.

--ruleLevelOverride -rl

المسار إلى ملف يحتوي على قواعد ومستويات صفيف JSON لتجاوزها. القيم المقبولة لمستوى التجاوز هي: هامة، شديدة الأهمية، متوسطة الأهمية، منخفضة الأهمية، معلوماتية. مثال: [{"Id":"meta-remove-dup-reg","OverrideLevel":"Medium"},{"Id":"il-avoid-specialized-update-ops","OverrideLevel":"Medium"}]

--ruleSet -rs

حدد مجموعة قواعد يتم تنفيذها كجزء من هذا الإصدار. القيم: Guid صالح، "شهادة AppSource"، "مدقق الحلول" (افتراضي).

--saveResults -sav

يستخدم البيئة الحالية لتخزين نتائج تحليل الحل التي يمكن رؤيتها في تطبيق Solution Health Hub. بشكل افتراضي، يتم تعيين هذه الوسيطة إلى false.

لا تتطلب هذه المعلمة أي قيمة. إنه مفتاح

--solutionUrl -u

SAS Uri يشير إلى solution.zip لتحليلها

pac solution clone

إنشاء مشروع حل استنادا إلى حل موجود في مؤسستك.

الأمثلة

توضح الأمثلة التالية استخدام pac solution clone الأمر .

• نسخ أساسي
• النسخ مع تضمين إعدادات الترقيم العام والتعداد التلقائي

نسخ أساسي

ينسخ هذا المثال الحل sampleSolution إلى الدليل الحالي.

pac solution clone --name sampleSolution

النسخ مع تضمين إعدادات الترقيم العام والتعداد التلقائي

ينسخ هذا المثال الحل sampleSolution إلى الدليل الحالي مع تضمين إعدادات الترقيم العام والتعداد التلقائي.

pac solution clone --name sampleSolution --include general,autonumbering

المعلمات المطلوبة ل solution clone

--name -n

اسم الحل الذي سيتم تصديره.

معلمات اختيارية ل solution clone

--async -a

يصدر الحل بشكل غير متزامن.

لا تتطلب هذه المعلمة أي قيمة. إنه مفتاح

--environment -env

تحديد Dataverse الهدف. قد تكون القيمة GUID أو مطلق https URL. عند عدم التحديد، سيتم استخدام المؤسسة النشطة المحددة لملف تعريف المصادقة الحالي.

--include -i

ما هي الإعدادات التي يجب تضمينها في الحل الذي يتم تصديره.

استخدم قيمة واحدة أو أكثر من هذه القيم مفصولة بفواصل:

• autonumbering
• calendar
• customization
• emailtracking
• externalapplications
• general
• isvconfig
• marketing
• outlooksynchronization
• relationshiproles
• sales

--localize -loc

استخراج أو دمج جميع موارد السلسلة في ملفات .resx.

لا تتطلب هذه المعلمة أي قيمة. إنه مفتاح

--map -m

المسار الكامل إلى تعيين ملف xml لقراءة مجلدات المكونات لحزمها.

--max-async-wait-time -wt

الحد الأقصى لوقت الانتظار غير المتزامن بالدقائق. القيمة الافتراضية هي 60 دقيقة.

--outputDirectory -o

دليل الإخراج

--packagetype -p

تحديد نوع الاستخراج للحل. يمكن أن يكون: "غير مدار" أو "مدار" أو "كلاهما". القيمة الافتراضية هي: "كلاهما".

--targetversion -v

مهمل: يتم تجاهل هذه المعلمة.

pac solution create-settings

إنشاء ملف إعدادات من مضغوط الحل أو مجلد الحل.

مثال

pac solution create-settings --solution-zip C:\SampleSolution.zip --settings-file .\SampleDeploymentSettingsDev.json

معلمات اختيارية ل solution create-settings

--settings-file -s

ملف .json مع إعدادات النشر لمراجع الاتصال ومتغيرات البيئة.

--solution-folder -f

المسار إلى مجلد الحل المحلي غير المحزم: إما جذر ملف 'Other/Solution.xml' أو مجلد بملف .cdsproj.

--solution-zip -z

المسار إلى ملف مضغوط للحل.

pac solution delete

حذف حل من Dataverse في البيئة الحالية.

مثال

pac solution delete --solution-name Samplesolution

المعلمات المطلوبة ل solution delete

--solution-name -sn

اسم الحل.

معلمات اختيارية ل solution delete

--environment -env

تحديد Dataverse الهدف. قد تكون القيمة GUID أو مطلق https URL. عند عدم التحديد، سيتم استخدام المؤسسة النشطة المحددة لملف تعريف المصادقة الحالي.

pac solution export

تصدير حل من Dataverse.

مثال

pac solution export --path c:\Users\Documents\Solution.zip --name SampleComponentSolution --managed true --include general

المعلمات المطلوبة ل solution export

--name -n

اسم الحل الذي سيتم تصديره.

معلمات اختيارية ل solution export

--async -a

يصدر الحل بشكل غير متزامن.

لا تتطلب هذه المعلمة أي قيمة. إنه مفتاح

--environment -env

تحديد Dataverse الهدف. قد تكون القيمة GUID أو مطلق https URL. عند عدم التحديد، سيتم استخدام المؤسسة النشطة المحددة لملف تعريف المصادقة الحالي.

--include -i

ما هي الإعدادات التي يجب تضمينها في الحل الذي يتم تصديره.

استخدم قيمة واحدة أو أكثر من هذه القيم مفصولة بفواصل:

• autonumbering
• calendar
• customization
• emailtracking
• externalapplications
• general
• isvconfig
• marketing
• outlooksynchronization
• relationshiproles
• sales

--managed -m

ما إذا كان يجب تصدير الحل كحل مدار.

لا تتطلب هذه المعلمة أي قيمة. إنه مفتاح

--max-async-wait-time -wt

الحد الأقصى لوقت الانتظار غير المتزامن بالدقائق. القيمة الافتراضية هي 60 دقيقة.

--overwrite -ow

يمكن لملف الحل المصدر الكتابة فوق ملف مضغوط الحل على نظام الملفات المحلي.

لا تتطلب هذه المعلمة أي قيمة. إنه مفتاح

--path -p

المسار حيث تتم كتابة ملف مضغوط للحل الذي تم تصديره.

--targetversion -v

مهمل: يتم تجاهل هذه المعلمة.

pac solution import

استيراد الحل إلى Dataverse.

مثال

pac solution import --path c:\Users\Documents\Solution.zip

معلمات اختيارية ل solution import

--activate-plugins -ap

تنشيط المكونات الإضافية وسير العمل على الحل.

لا تتطلب هذه المعلمة أي قيمة. إنه مفتاح

--async -a

استيراد الحل بشكل غير متزامن.

لا تتطلب هذه المعلمة أي قيمة. إنه مفتاح

--environment -env

تحديد Dataverse الهدف. قد تكون القيمة GUID أو مطلق https URL. عند عدم التحديد، سيتم استخدام المؤسسة النشطة المحددة لملف تعريف المصادقة الحالي.

--force-overwrite -f

فرض الكتابة فوق التخصيصات غير المدارة

لا تتطلب هذه المعلمة أي قيمة. إنه مفتاح

--import-as-holding -h

استيراد الحل كحل عقد.

لا تتطلب هذه المعلمة أي قيمة. إنه مفتاح

--max-async-wait-time -wt

الحد الأقصى لوقت الانتظار غير المتزامن بالدقائق. القيمة الافتراضية هي 60 دقيقة.

--path -p

المسار إلى ملف مضغوط للحل. إذا لم يتم تحديده، يفترض أن المجلد الحالي هو مشروع cdsproj.

--publish-changes -pc

نشر التغييرات عند استيراد ناجح.

لا تتطلب هذه المعلمة أي قيمة. إنه مفتاح

--settings-file

ملف .json مع إعدادات النشر لمراجع الاتصال ومتغيرات البيئة.

--skip-dependency-check -s

تخطي التحقق من التبعية مقابل التبعيات التي تم وضع علامة عليها كتحديث المنتج

لا تتطلب هذه المعلمة أي قيمة. إنه مفتاح

--skip-lower-version -slv

تخطي solution import إذا كان نفس الإصدار أو الإصدار الأعلى موجودا في البيئة الحالية.

لا تتطلب هذه المعلمة أي قيمة. إنه مفتاح

--stage-and-upgrade -up

استيراد الحل وترقيته.

لا تتطلب هذه المعلمة أي قيمة. إنه مفتاح

ملاحظات

تكون متصلا ببيئة باستخدام pac الأمر auth لاستخدام pac solution import.

pac solution import

عندما Path لا يتم تحديد المعلمة، فإنها تفترض أن المجلد الحالي هو مشروع cdsproj. إذا تم تعيين الخاصية SolutionPackageType في ملف cdsproj إلى Both، يتم استخدام الحل المدار بشكل افتراضي.

pac solution init

تهيئة دليل مع مشروع حل Dataverse جديد

مثال

pac solution init --publisher-name developer --publisher-prefix dev

المعلمات المطلوبة ل solution init

--publisher-name -pn

اسم Dataverse solution publisher

ملاحظة: يسمح فقط بالأحرف الموجودة ضمن النطاقات [A - Z]، أو [a - z]، أو [0 - 9]، أو _ . قد يكون الحرف الأول فقط في النطاقات [A - Z]، أو [a - z]، أو _.

--publisher-prefix -pp

قيمة بادئة التخصيص ل Dataverse solution publisher

ملاحظة: يجب أن تتكون البادئة من حرفين إلى 8 أحرف، ويمكن أن تتكون فقط من أبجدية رقمية، ويجب أن تبدأ بحرف، ولا يمكن أن تبدأ ب 'mscrm'.

معلمات اختيارية ل solution init

--outputDirectory -o

دليل الإخراج

pac solution list

سرد كافة الحلول من مؤسسة Dataverse الحالية

مثال

pac solution list

معلمات اختيارية ل solution list

--environment -env

تحديد Dataverse الهدف. قد تكون القيمة GUID أو مطلق https URL. عند عدم التحديد، سيتم استخدام المؤسسة النشطة المحددة لملف تعريف المصادقة الحالي.

--includeSystemSolutions

تضمين حلول النظام مثل تلك التي نشرتها Microsoft

لا تتطلب هذه المعلمة أي قيمة. إنه مفتاح

--json

إرجاع إخراج الأمر كسلسلة بتنسيق JSON.

pac solution online-version

تعيين إصدار للحل الذي تم تحميله في Dataverse.

مثال

pac solution online-version --solution-name Samplesolution --solution-version 1.0.0.2

المعلمات المطلوبة ل solution online-version

--solution-name -sn

اسم الحل.

--solution-version -sv

solution version حدد الرقم.

معلمات اختيارية ل solution online-version

--environment -env

تحديد Dataverse الهدف. قد تكون القيمة GUID أو مطلق https URL. عند عدم التحديد، سيتم استخدام المؤسسة النشطة المحددة لملف تعريف المصادقة الحالي.

pac solution pack

مكونات حل الحزمة على نظام الملفات المحلي في solution.zip (SolutionPackager).

مثال

pac solution pack --zipfile C:\SampleSolution.zip --folder .\SampleSolutionUnpacked\.

المعلمات المطلوبة ل solution pack

--zipfile -z

المسار الكامل إلى ملف ZIP للحل

معلمات اختيارية ل solution pack

--allowDelete -ad

إملاء ما إذا كانت عمليات الحذف قد تحدث. القيمة الافتراضية هي "false".

لا تتطلب هذه المعلمة أي قيمة. إنه مفتاح

--allowWrite -aw

إملاء ما إذا كانت عمليات الكتابة قد تحدث. القيمة الافتراضية هي "false".

لا تتطلب هذه المعلمة أي قيمة. إنه مفتاح

--clobber -c

تمكين إمكانية حذف الملفات التي تم وضع علامة للقراءة فقط عليها أو الكتابة فوقها. القيمة الافتراضية هي "false".

لا تتطلب هذه المعلمة أي قيمة. إنه مفتاح

--disablePluginRemap -dpm

إعادة تعيين اسم نوع المكون الإضافي المؤهل بالكامل معطل. القيمة الافتراضية هي "false".

لا تتطلب هذه المعلمة أي قيمة. إنه مفتاح

--errorlevel -e

الحد الأدنى لمستوى التسجيل لإخراج السجل [مطول|معلومات|تحذير|خطأ|إيقاف التشغيل]. القيمة الافتراضية هي "معلومات".

--folder -f

المسار إلى المجلد الجذر على نظام الملفات المحلي. عند فك الحزم أو الاستخراج، تتم كتابة هذا إلى. عند تعبئة هذا تتم القراءة منه.

--localize -loc

استخراج أو دمج جميع موارد السلسلة في ملفات .resx.

لا تتطلب هذه المعلمة أي قيمة. إنه مفتاح

--log -l

المسار إلى ملف السجل.

--map -m

المسار الكامل إلى تعيين ملف xml لقراءة مجلدات المكونات لحزمها.

--packagetype -p

عند فك الحزم أو الاستخراج، استخدم لتحديد عملية مدارة مزدوجة وغير مدارة. عند التعبئة، استخدم لتحديد Managed أو Unmanaged من فك حزمة سابقة "كلاهما". يمكن أن يكون: "غير مدار" أو "مدار" أو "كلاهما". القيمة الافتراضية هي "غير مدار".

--singleComponent -sc

تنفيذ الإجراء فقط على نوع مكون واحد [WebResource|المكون الإضافي|سير العمل|بلا]. القيمة الافتراضية هي "بلا".

--sourceLoc -src

إنشاء ملف مورد قالب. صالح فقط عند الاستخراج. القيم المحتملة هي "تلقائي"، أو رمز اللغة للغة التي ترغب في تصديرها. يمكنك استخدام معرف رمز اللغة (LCID) أو تنسيقات التعليمات البرمجية للغة المنظمة الدولية للتوحيد القياسي (ISO). عند وجوده، يستخرج هذا موارد السلسلة من اللغة المحددة ك resx.محايد. إذا تم تحديد "auto" أو الشكل الطويل أو القصير فقط من مفتاح التبديل، يتم استخدام اللغة الأساسية للحل.

--useLcid -lcid

استخدم قيم معرف رمز اللغة (LCID) (1033) بدلا من رموز المنظمة الدولية للتوحيد القياسي (ISO) (en-US) لملفات اللغة.

لا تتطلب هذه المعلمة أي قيمة. إنه مفتاح

--useUnmanagedFileForMissingManaged -same

استخدم نفس ملف مصدر XML عند العثور على حزمة لملف XML المدار وغير المدار فقط؛ ينطبق على AppModuleSiteMap وAppModuleMap وملفات FormXml.

لا تتطلب هذه المعلمة أي قيمة. إنه مفتاح

pac solution publish

نشر كافة التخصيصات

مثال

pac solution publish

معلمات اختيارية ل solution publish

--async -a

نشر كافة التخصيصات بشكل غير متزامن

لا تتطلب هذه المعلمة أي قيمة. إنه مفتاح

--environment -env

تحديد Dataverse الهدف. قد تكون القيمة GUID أو مطلق https URL. عند عدم التحديد، سيتم استخدام المؤسسة النشطة المحددة لملف تعريف المصادقة الحالي.

--max-async-wait-time -wt

الحد الأقصى لوقت الانتظار غير المتزامن بالدقائق. القيمة الافتراضية هي 60 دقيقة.

pac solution sync

مزامنة مشروع حل Dataverse الحالي مع الحالة الحالية للحل في مؤسستك.

الأمثلة

توضح الأمثلة التالية استخدام pac solution sync الأمر .

المزامنة الأساسية

يقوم هذا المثال بمزامنة الحل إلى الدليل الحالي.

pac solution sync

معلمات اختيارية ل solution sync

--async -a

يصدر الحل بشكل غير متزامن.

لا تتطلب هذه المعلمة أي قيمة. إنه مفتاح

--environment -env

تحديد Dataverse الهدف. قد تكون القيمة GUID أو مطلق https URL. عند عدم التحديد، سيتم استخدام المؤسسة النشطة المحددة لملف تعريف المصادقة الحالي.

--include -i

ما هي الإعدادات التي يجب تضمينها في الحل الذي يتم تصديره.

استخدم قيمة واحدة أو أكثر من هذه القيم مفصولة بفواصل:

• autonumbering
• calendar
• customization
• emailtracking
• externalapplications
• general
• isvconfig
• marketing
• outlooksynchronization
• relationshiproles
• sales

--localize -loc

استخراج أو دمج جميع موارد السلسلة في ملفات .resx.

لا تتطلب هذه المعلمة أي قيمة. إنه مفتاح

--map -m

المسار الكامل إلى تعيين ملف xml لقراءة مجلدات المكونات لحزمها.

--max-async-wait-time -wt

الحد الأقصى لوقت الانتظار غير المتزامن بالدقائق. القيمة الافتراضية هي 60 دقيقة.

--packagetype -p

عند فك الحزم أو الاستخراج، استخدم لتحديد عملية مدارة مزدوجة وغير مدارة. عند التعبئة، استخدم لتحديد Managed أو Unmanaged من فك حزمة سابقة "كلاهما". يمكن أن يكون: "غير مدار" أو "مدار" أو "كلاهما". القيمة الافتراضية هي: "كلاهما".

--solution-folder -f

المسار إلى مجلد الحل المحلي غير المحزم: إما جذر ملف 'Other/Solution.xml' أو مجلد بملف .cdsproj.

pac solution unpack

استخراج مكونات الحل من solution.zip إلى نظام الملفات المحلي (SolutionPackager).

مثال

pac solution unpack --zipfile C:\SampleSolution.zip --folder .\SampleSolutionUnpacked\.

المعلمات المطلوبة ل solution unpack

--zipfile -z

المسار الكامل إلى ملف ZIP للحل

معلمات اختيارية ل solution unpack

--allowDelete -ad

إملاء ما إذا كانت عمليات الحذف قد تحدث. القيمة الافتراضية هي "false".

لا تتطلب هذه المعلمة أي قيمة. إنه مفتاح

--allowWrite -aw

إملاء ما إذا كانت عمليات الكتابة قد تحدث. القيمة الافتراضية هي "false".

لا تتطلب هذه المعلمة أي قيمة. إنه مفتاح

--clobber -c

تمكين إمكانية حذف الملفات التي تم وضع علامة للقراءة فقط عليها أو الكتابة فوقها. القيمة الافتراضية هي "false".

لا تتطلب هذه المعلمة أي قيمة. إنه مفتاح

--disablePluginRemap -dpm

إعادة تعيين اسم نوع المكون الإضافي المؤهل بالكامل معطل. القيمة الافتراضية هي "false".

لا تتطلب هذه المعلمة أي قيمة. إنه مفتاح

--errorlevel -e

الحد الأدنى لمستوى التسجيل لإخراج السجل [مطول|معلومات|تحذير|خطأ|إيقاف التشغيل]. القيمة الافتراضية هي "معلومات".

--folder -f

المسار إلى المجلد الجذر على نظام الملفات المحلي. عند فك الحزم أو الاستخراج، تتم كتابة هذا إلى. عند تعبئة هذا تتم القراءة منه.

--localize -loc

استخراج أو دمج جميع موارد السلسلة في ملفات .resx.

لا تتطلب هذه المعلمة أي قيمة. إنه مفتاح

--log -l

المسار إلى ملف السجل.

--map -m

المسار الكامل إلى تعيين ملف xml لقراءة مجلدات المكونات لحزمها.

--packagetype -p

عند فك الحزم أو الاستخراج، استخدم لتحديد عملية مدارة مزدوجة وغير مدارة. عند التعبئة، استخدم لتحديد Managed أو Unmanaged من فك حزمة سابقة "كلاهما". يمكن أن يكون: "غير مدار" أو "مدار" أو "كلاهما". القيمة الافتراضية هي "غير مدار".

--singleComponent -sc

تنفيذ الإجراء فقط على نوع مكون واحد [WebResource|المكون الإضافي|سير العمل|بلا]. القيمة الافتراضية هي "بلا".

--sourceLoc -src

إنشاء ملف مورد قالب. صالح فقط عند الاستخراج. القيم المحتملة هي "تلقائي"، أو رمز اللغة للغة التي ترغب في تصديرها. يمكنك استخدام معرف رمز اللغة (LCID) أو تنسيقات التعليمات البرمجية للغة المنظمة الدولية للتوحيد القياسي (ISO). عند وجوده، يستخرج هذا موارد السلسلة من اللغة المحددة ك resx.محايد. إذا تم تحديد "auto" أو الشكل الطويل أو القصير فقط من مفتاح التبديل، يتم استخدام اللغة الأساسية للحل.

--useLcid -lcid

استخدم قيم معرف رمز اللغة (LCID) (1033) بدلا من رموز المنظمة الدولية للتوحيد القياسي (ISO) (en-US) لملفات اللغة.

لا تتطلب هذه المعلمة أي قيمة. إنه مفتاح

--useUnmanagedFileForMissingManaged -same

استخدم نفس ملف مصدر XML عند العثور على حزمة لملف XML المدار وغير المدار فقط؛ ينطبق على AppModuleSiteMap وAppModuleMap وملفات FormXml.

لا تتطلب هذه المعلمة أي قيمة. إنه مفتاح

pac solution upgrade

تطبيق solution upgrade

مثال

pac solution upgrade --solution-name SampleSolution --async --max-async-wait-time 60

المعلمات المطلوبة ل solution upgrade

--solution-name -sn

اسم الحل.

معلمات اختيارية ل solution upgrade

--async -a

ترقيات الحل بشكل غير متزامن

لا تتطلب هذه المعلمة أي قيمة. إنه مفتاح

--environment -env

تحديد Dataverse الهدف. قد تكون القيمة GUID أو مطلق https URL. عند عدم التحديد، سيتم استخدام المؤسسة النشطة المحددة لملف تعريف المصادقة الحالي.

--max-async-wait-time -wt

الحد الأقصى لوقت الانتظار غير المتزامن بالدقائق. القيمة الافتراضية هي 60 دقيقة.

pac solution version

تحديث إصدار أو مراجعة الحل.

مثال

pac solution version --patchversion 2

pac solution version --strategy gittags

معلمات اختيارية ل solution version

--buildversion -bv

إنشاء إصدار للحل.

ملاحظة: يجب أن تكون القيمة عددا صحيحا بقيمة 0 كحد أدنى.

--filename -fn

اسم ملف Tracker CSV لاستخدامه عند استخدام filetracking كإستراتيجية. القيمة الافتراضية هي 'ControlsStateVersionInfo.csv'.

--patchversion -pv

مهمل: يتم تجاهل هذه المعلمة.

--revisionversion -rv

إصدار المراجعة للحل.

ملاحظة: يجب أن تكون القيمة عددا صحيحا بقيمة 0 كحد أدنى.

--solutionPath -sp

المسار إلى دليل حل Dataverse أو ملف Solution.xml.

--strategy -s

تحديث إصدار النسخة لملف 'Solution.xml' باستخدام استراتيجية محددة. إذا كنت تستخدم gittags، فقم بتعيين الرمز المميز للوصول الشخصي في متغير البيئة التالي "PacCli.PAT"

استخدم إحدى هذه القيم:

• None
• GitTags
• FileTracking
• Solution

الاختلافات بين pac solution clone التصدير

هناك حالات لا تكون فيها متأكدا من وقت الاستخدام pac solution clone أو pac solution export الأمر. يمكنك استخدام أحد الأوامر في السيناريوهات التالية:

• استخدم pac solution clone عندما تحتاج إلى إضافة مكونات جديدة إلى الحل.
• استخدم pac solution export عندما تريد تعديل المحتوى الموجود في ملف حل ولكن دون إضافة أي مكونات جديدة إلى الحل.

pac solution clone

يبدو الحل المصدر مثل مشروع Visual Studio عند تصدير الحل باستخدام pac solution clone الأمر . بدلا من .csproj (كما في Visual Studio)، سترى ملفا cdsproj . يحتوي cdsproj الملف على جميع معلومات المكونات المطلوبة لإنشاء المشروع. إخراج البناء هو ملف مضغوط للحل، والذي يمكنك استيراده إلى بيئات مختلفة.

لا يتعين على المطور فك حزمة الحل المستنسخ لأنه يتم عرضه بتنسيق غير معبأة داخل المجلد src (المصدر).

الآن، إذا كنت ترغب في إقران مكون إضافي تم إنشاؤه حديثا بهذا الحل، مع solution unpacked، يمكنك استخدام pac solution add-reference الأمر لتحديث .cdsproj الملف لإضافة المكون الإضافي الجديد. بعد ذلك، يمكنك إنشاء المشروع باستخدام إما dotnet build أو msbuild.

يوصى بإجراء استعادة بناء أولا قبل إنشاء المشروع. استعادة البنية (تقوم بنية dotnet بالاستعادة تلقائيا أولا) ستستعيد مكتبات .NET المطلوبة لإنشاء حل معبأة.

pac solution export

عند تصدير الحل باستخدام pac solution export تشعر وكأنك تقوم بتصدير الحل باستخدام مدخل صانع، والإخراج الناتج هو ملف مضغوط للحل.

عند فك حزمة الملف المضغوط للحل (لا نوصي بفتح الرمز البريدي باستخدام أدوات قياسية واستخدام الأمر المناسب من CLI). بنية الدليل الناتجة مشابهة للبنية في pac solution clone. الفرق الوحيد هو أنه لا يمكنك إضافة مراجع إلى هذا الحل غير المحزم، لأنه لا يحتوي على .cdsproj ملف المشروع.

يمكنك تعديل مجموعة الملفات ذات الصلة التي تريد تحديثها ثم المتابعة مع solution pack، الذي ينشئ الملف المضغوط للحل مرة أخرى لتسهيل استيراد الحل إلى البيئة المستهدفة. النتيجة من الإجراء هي ملف مضغوط للحل مع محتويات محدثة وطوابع زمنية محدثة.

(راجع أيضًا )

مجموعات أوامر Microsoft Power Platform CLI
نظرة عامة على Microsoft Power Platform CLI