pac solution

פקודות לעבודה עם פרוייקטי פתרון Dataverse.

פקודות

הפקודה	Description
pac solution add-license	הוסף פרטי רשיון ותוכנית לפתרון.
pac solution add-reference	הוספת הפניה מהפרוייקט בספריה הנוכחית לפרוייקט ב- 'path'
pac solution add-solution-component	הוסף רכיב פתרון אחד או יותר לפתרון הלא מנוהל המשמש כיעד ב- Dataverse.
pac solution check	העלה פרוייקט פתרון Dataverse כדי לפעול מול Power Apps בודק הנתונים.
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	ארוז רכיבי פתרון ב- filesystem מקומי לתוך solution.zip (SolutionPackager).
pac solution publish	מפרסם את כל ההתאמות האישיות
pac solution sync	סנכרן את פרוייקט הפתרון הנוכחי של Dataverse עם המצב הנוכחי של הפתרון בארגון שלך.
pac solution unpack	חלץ רכיבי פתרון solution.zip אל מערכת קבצים מקומית (SolutionPackager).
pac solution upgrade	להחיל solution upgrade
pac solution version	עדכן גירסת Build או גירסת מהדורה עבור הפתרון.

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

הוספת הפניה מהפרוייקט בספריה הנוכחית לפרוייקט ב- 'path'

לדוגמה

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 בודק הנתונים.

לדוגמה

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

פרמטרים אופציונליים עבור solution check

--clearCache -cc

ניקוי מטמון solution checkהאכיפה עבור הדייר שלך, של כל הרשומות הקשורות לתוצאות קודמות עבור הפתרונות שלך.

לפרמטר זה אין כל ערך. זה מתג.

--customEndpoint -ce

ציין כתובת URL מותאמת אישית בתור Power Apps הקצה של בודק היישומים.

--environment -env

מציין את target Dataverse. הערך עשוי להיות GUID או כתובת URL מוחלטת של https. כאשר לא צוין, המערכת תשמש את הארגון הפעיל שנבחר עבור פרופיל האימות הנוכחי.

--excludedFiles -ef

אל תכלול קבצים בניתוח. העברת כערכים המופרדים באמצעות פסיק

--geo -g

באיזה מופע גיאוגרפי של Power Apps בודק הקבצים שבו יש להשתמש.

השתמש באחד מהערכים הבאים:

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

--outputDirectory -o

ספריית פלט

--path -p

נתיב שבו קיים קובץ פתרון אחד או יותר. הנתיב יכול להכיל תווים כלליים/תווים כלליים.

--ruleLevelOverride -rl

נתיב לקובץ המכיל כללי מערך של JSON ואת הרמות לעקיפה. הערכים המקובלים עבור OverrideLevel הם: קריטי, גבוה, בינוני, נמוך, מידע. דוגמה: [{"Id":"meta-remove-dup-reg","OverrideLevel":"Medium"},{"Id":"il-avoid-specialized-update-ops","OverrideLevel":"Medium"}]

--ruleSet -rs

בחר ערכת כללים שבוצעה כחלק מקובץ Build זה. ערכים: GUID חוקי, "אישור AppSource", "בודק הפתרונות" (ברירת מחדל).

--saveResults -sav

משתמש בסביבה הנוכחית כדי לאחסן תוצאות של ניתוח פתרונות שניתן לראות ביישום מרכז תקינות הפתרון. כברירת מחדל, ארגומנט זה מוגדר ל- False.

לפרמטר זה אין כל ערך. זה מתג.

--solutionUrl -u

Uri של SAS המצביע 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

מציין את target Dataverse. הערך עשוי להיות GUID או כתובת URL מוחלטת של https. כאשר לא צוין, המערכת תשמש את הארגון הפעיל שנבחר עבור פרופיל האימות הנוכחי.

--include -i

אילו הגדרות צריכות להיכלל בפתרון המיוצא.

השתמש באחד או יותר מערכים אלה, המופרדים באמצעות פסיקים:

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

--localize -loc

חילוץ או מיזוג של כל משאבי המחרוזת לקבצי ‎.resx

לפרמטר זה אין כל ערך. זה מתג.

--map -m

הנתיב המלא לקובץ xml של מיפוי ממנו יש לקרוא תיקיות רכיבים ל- Pack.

--max-async-wait-time -wt

זמן המתנה אסינכרוני מרבי בדקות. ערך ברירת המחדל הוא 60 דקות.

--outputDirectory -o

ספריית פלט

--packagetype -p

מציין את סוג החילוץ עבור הפתרון. יכול להיות: 'לא מנוהל', 'מנוהל' או 'שניהם'. ערך ברירת המחדל הוא: 'Both'.

--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

נתיב אל תיקיית הפתרונות המקומית, שפרקה את האריזה: הבסיס של הקובץ 'אחר/Solution.xml' או תיקיה עם קובץ .cdsproj

--solution-zip -z

נתיב לקובץ zip של פתרון.

pac solution delete

מחק פתרון מ- Dataverse בסביבה הנוכחית.

לדוגמה

pac solution delete --solution-name Samplesolution

פרמטרים נדרשים עבור solution delete

--solution-name -sn

שם הפתרון.

פרמטרים אופציונליים עבור solution delete

--environment -env

מציין את target Dataverse. הערך עשוי להיות GUID או כתובת URL מוחלטת של https. כאשר לא צוין, המערכת תשמש את הארגון הפעיל שנבחר עבור פרופיל האימות הנוכחי.

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

מציין את target Dataverse. הערך עשוי להיות GUID או כתובת URL מוחלטת של https. כאשר לא צוין, המערכת תשמש את הארגון הפעיל שנבחר עבור פרופיל האימות הנוכחי.

--include -i

אילו הגדרות צריכות להיכלל בפתרון המיוצא.

השתמש באחד או יותר מערכים אלה, המופרדים באמצעות פסיקים:

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

--managed -m

אם יש לייצא את הפתרון כפתרון מנוהל.

לפרמטר זה אין כל ערך. זה מתג.

--max-async-wait-time -wt

זמן המתנה אסינכרוני מרבי בדקות. ערך ברירת המחדל הוא 60 דקות.

--overwrite -ow

קובץ הפתרון המיוצא יכול להחליף את קובץ ה- zip של הפתרון במערכת הקבצים המקומית.

לפרמטר זה אין כל ערך. זה מתג.

--path -p

נתיב שבו נכתב קובץ ה- zip של הפתרון המיוצא.

--targetversion -v

לא נמצא עוד בשימוש: הפונקציה מתעלמת בפרמטר זה.

pac solution import

יבא את הפתרון ל- Dataverse.

לדוגמה

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

פרמטרים אופציונליים עבור solution import

--activate-plugins -ap

הפעל יישומי Plug-in וזרימות עבודה בפתרון.

לפרמטר זה אין כל ערך. זה מתג.

--async -a

ייבוא הפתרון באופן אסינכרוני.

לפרמטר זה אין כל ערך. זה מתג.

--environment -env

מציין את target Dataverse. הערך עשוי להיות GUID או כתובת URL מוחלטת של https. כאשר לא צוין, המערכת תשמש את הארגון הפעיל שנבחר עבור פרופיל האימות הנוכחי.

--force-overwrite -f

כפיית החלפה של התאמות אישיות לא מנוהלות

לפרמטר זה אין כל ערך. זה מתג.

--import-as-holding -h

יבא את הפתרון כפתרון החזקה.

לפרמטר זה אין כל ערך. זה מתג.

--max-async-wait-time -wt

זמן המתנה אסינכרוני מרבי בדקות. ערך ברירת המחדל הוא 60 דקות.

--path -p

נתיב לקובץ zip של פתרון. אם לא צוין, מניח שהתיקיה הנוכחית היא פרוייקט cdsproj.

--publish-changes -pc

פרסם את השינויים שלך לאחר ייבוא מוצלח.

לפרמטר זה אין כל ערך. זה מתג.

--settings-file

קובץ .json עם הגדרות הפריסה עבור הפניות לחיבורים ומשתנה סביבה.

--skip-dependency-check -s

דלג על בדיקת תלות כנגד יחסי תלות שסומנו כעדכון מוצר

לפרמטר זה אין כל ערך. זה מתג.

--skip-lower-version -slv

solution import דלג אם קיימת גירסה זהה או מתקדמת יותר בסביבה הנוכחית.

לפרמטר זה אין כל ערך. זה מתג.

--stage-and-upgrade -up

יבא ושדרג את הפתרון.

לפרמטר זה אין כל ערך. זה מתג.

הערות

עליך להיות מחובר לסביבה באמצעות פקודתpac האימות לשימוש ב- 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

הערה: אורך הקידומת חייב להיות 2 עד 8 תווים, יכול להכיל אלפאנומריים בלבד, להתחיל באות ולא ניתן להתחיל ב- 'mscrm'.

פרמטרים אופציונליים עבור solution init

--outputDirectory -o

ספריית פלט

pac solution list

פרט את כל הפתרונות מהארגון Dataverse הנוכחי

לדוגמה

pac solution list

פרמטרים אופציונליים עבור solution list

--environment -env

מציין את target Dataverse. הערך עשוי להיות GUID או כתובת URL מוחלטת של https. כאשר לא צוין, המערכת תשמש את הארגון הפעיל שנבחר עבור פרופיל האימות הנוכחי.

--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 online-version

--environment -env

מציין את target Dataverse. הערך עשוי להיות GUID או כתובת URL מוחלטת של https. כאשר לא צוין, המערכת תשמש את הארגון הפעיל שנבחר עבור פרופיל האימות הנוכחי.

--solution-version -sv

ציין את solution version המספר. אם הוא מושמט, המקוון הנוכחי solution version מוחזר.

pac solution pack

ארוז רכיבי פתרון ב- filesystem מקומי לתוך 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

רמת רישום מינימלית עבור פלט יומן רישום [מילולי|מידע|אזהרה|שגיאה|לא פעיל]. ערך ברירת המחדל הוא 'Info'.

--folder -f

הנתיב אל תיקיית הבסיס ב- filesystem המקומי. בעת אריזה או חילוץ, פעולה זו נכתבת אל. כאשר אריזת פריט זה נקראה מ- .

--localize -loc

חילוץ או מיזוג של כל משאבי המחרוזת לקבצי ‎.resx

לפרמטר זה אין כל ערך. זה מתג.

--log -l

הנתיב לקובץ יומן הרישום.

--map -m

הנתיב המלא לקובץ xml של מיפוי ממנו יש לקרוא תיקיות רכיבים ל- Pack.

--packagetype -p

בעת אריזה או חילוץ, השתמש כדי לציין פעולה מנוהלת כפולה ופעולה לא מנוהלת. בעת אריזה, השתמש כדי לציין מנוהל או לא מנוהל מפרק קודם את האריזה 'שניהם'. יכול להיות: 'לא מנוהל', 'מנוהל' או 'שניהם'. ערך ברירת המחדל הוא 'לא מנוהל'.

--singleComponent -sc

בצע פעולה רק בסוג רכיב יחיד [WebResource|תוסף|זרימת עבודה|ללא]. ערך ברירת המחדל הוא 'ללא'.

--sourceLoc -src

יצירת קובץ משאב של תבנית. בתוקף רק בעת חילוץ. ערכים אפשריים הם 'אוטומטי', או קוד שפה של השפה שברצונך לייצא. באפשרותך להשתמש במזהה קוד שפה (LCID) או בארגון הבינלאומי עבור תבניות קוד שפה של תקנים (ISO). כאשר קיים, פעולה זו מחלץ את משאבי המחרוזת מההמקומית הנתונה כ- .resx ניטראלי. אם צוין 'אוטומטי' או רק הצורה הארוך או הקצרה של הבורר, ייעשה שימוש באזור הבסיס עבור הפתרון.

--useLcid -lcid

השתמש בערכי מזהה קוד שפה (LCID) (1033) במקום בערכי ארגון בינלאומי עבור קודי תקנים (ISO) (en-US) עבור קבצי שפה.

לפרמטר זה אין כל ערך. זה מתג.

--useUnmanagedFileForMissingManaged -same

השתמש באותו קובץ מקור XML בעת אריזה עבור מנוהל ורק קובץ XML לא מנוהל נמצא; חל על קבצי AppModuleSiteMap, AppModuleMap, FormXml.

לפרמטר זה אין כל ערך. זה מתג.

solution pack הערות

pac solution pack תומך בשתי פריסות של תיקיית מקור בעת קריאת קבצי רכיבים: תבנית ה- XML (דור קודם) ותבנית בקרת המקור YAML.

חשוב

תמיכה בתבנית בקרת מקור של YAML דורשת Microsoft. PowerApps.CLI גירסה 2.4.1 ואילך. הורד מ- NuGet או עדכן ב- pac install latest.

התבנית מזוהה באופן אוטומטי בהתבסס על תוכן התיקיה:

• אם התיקיה מכילה solutions/ ספריית משנה עם קבצים *solution.yml בתבנית YAML→ בתבנית YAML .
• אם לא solutions/ נמצאה ספריית משנה → בתבנית XML (דור קודם), פעולה זו מחייבת שימוש ב- Other\Solution.xml וב- Other\Customizations.xml.

דוגמה לתבנית YAML:

pac solution pack --zipfile C:\output\MySolution.zip --folder C:\repos\myrepo

עבודה עם מאגר מרובה פתרונות:

כאשר התיקיה מכילה יותר מפתרון אחד תחת solutions/*/solution.yml, השתמש SolutionPackager.exe ישירות עם /SolutionName:

SolutionPackager.exe /action:Pack /zipfile:SolutionA.zip /folder:C:\repos\myrepo /SolutionName:SolutionA

הערה

תבנית בקרת המקור YAML היא התבנית שנכתבה על-ידי שילוב Dataverse Git מקורי כאשר אתה מבצע פתרונות מ- Power Apps. אם אתה אורז באופן ידני תיקיה מתוך מאגר משולב של Git, pac solution pack--folder השתמש עם ההצבעות על בסיס המאגר.

לקבלת מידע נוסף אודות מבנה התיקיות YAML והרכיבים הנתמכים, ראה הכלי SolutionPackager — תבניות קובץ של בקרת מקור.

pac solution publish

מפרסם את כל ההתאמות האישיות

לדוגמה

pac solution publish

פרמטרים אופציונליים עבור solution publish

--async -a

מפרסם את כל ההתאמות האישיות באופן אסינכרוני

לפרמטר זה אין כל ערך. זה מתג.

--environment -env

מציין את target Dataverse. הערך עשוי להיות GUID או כתובת URL מוחלטת של https. כאשר לא צוין, המערכת תשמש את הארגון הפעיל שנבחר עבור פרופיל האימות הנוכחי.

--max-async-wait-time -wt

זמן המתנה אסינכרוני מרבי בדקות. ערך ברירת המחדל הוא 60 דקות.

pac solution sync

סנכרן את פרוייקט הפתרון הנוכחי של Dataverse עם המצב הנוכחי של הפתרון בארגון שלך.

דוגמאות

הדוגמאות הבאות מציגות את השימוש בפקודה pac solution sync .

סינכרון בסיסי

דוגמה זו מסנכרנת את הפתרון עם הספריה הנוכחית.

pac solution sync

פרמטרים אופציונליים עבור solution sync

--async -a

ייצוא הפתרון באופן אסינכרוני.

לפרמטר זה אין כל ערך. זה מתג.

--environment -env

מציין את target Dataverse. הערך עשוי להיות GUID או כתובת URL מוחלטת של https. כאשר לא צוין, המערכת תשמש את הארגון הפעיל שנבחר עבור פרופיל האימות הנוכחי.

--include -i

אילו הגדרות צריכות להיכלל בפתרון המיוצא.

השתמש באחד או יותר מערכים אלה, המופרדים באמצעות פסיקים:

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

--localize -loc

חילוץ או מיזוג של כל משאבי המחרוזת לקבצי ‎.resx

לפרמטר זה אין כל ערך. זה מתג.

--map -m

הנתיב המלא לקובץ xml של מיפוי ממנו יש לקרוא תיקיות רכיבים ל- Pack.

--max-async-wait-time -wt

זמן המתנה אסינכרוני מרבי בדקות. ערך ברירת המחדל הוא 60 דקות.

--packagetype -p

בעת אריזה או חילוץ, השתמש כדי לציין פעולה מנוהלת כפולה ופעולה לא מנוהלת. בעת אריזה, השתמש כדי לציין מנוהל או לא מנוהל מפרק קודם את האריזה 'שניהם'. יכול להיות: 'לא מנוהל', 'מנוהל' או 'שניהם'. ערך ברירת המחדל הוא: 'Both'.

--solution-folder -f

נתיב אל תיקיית הפתרונות המקומית, שפרקה את האריזה: הבסיס של הקובץ 'אחר/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

רמת רישום מינימלית עבור פלט יומן רישום [מילולי|מידע|אזהרה|שגיאה|לא פעיל]. ערך ברירת המחדל הוא 'Info'.

--folder -f

הנתיב אל תיקיית הבסיס ב- filesystem המקומי. בעת אריזה או חילוץ, פעולה זו נכתבת אל. כאשר אריזת פריט זה נקראה מ- .

--localize -loc

חילוץ או מיזוג של כל משאבי המחרוזת לקבצי ‎.resx

לפרמטר זה אין כל ערך. זה מתג.

--log -l

הנתיב לקובץ יומן הרישום.

--map -m

הנתיב המלא לקובץ xml של מיפוי ממנו יש לקרוא תיקיות רכיבים ל- Pack.

--packagetype -p

בעת אריזה או חילוץ, השתמש כדי לציין פעולה מנוהלת כפולה ופעולה לא מנוהלת. בעת אריזה, השתמש כדי לציין מנוהל או לא מנוהל מפרק קודם את האריזה 'שניהם'. יכול להיות: 'לא מנוהל', 'מנוהל' או 'שניהם'. ערך ברירת המחדל הוא 'לא מנוהל'.

--singleComponent -sc

בצע פעולה רק בסוג רכיב יחיד [WebResource|תוסף|זרימת עבודה|ללא]. ערך ברירת המחדל הוא 'ללא'.

--sourceLoc -src

יצירת קובץ משאב של תבנית. בתוקף רק בעת חילוץ. ערכים אפשריים הם 'אוטומטי', או קוד שפה של השפה שברצונך לייצא. באפשרותך להשתמש במזהה קוד שפה (LCID) או בארגון הבינלאומי עבור תבניות קוד שפה של תקנים (ISO). כאשר קיים, פעולה זו מחלץ את משאבי המחרוזת מההמקומית הנתונה כ- .resx ניטראלי. אם צוין 'אוטומטי' או רק הצורה הארוך או הקצרה של הבורר, ייעשה שימוש באזור הבסיס עבור הפתרון.

--useLcid -lcid

השתמש בערכי מזהה קוד שפה (LCID) (1033) במקום בערכי ארגון בינלאומי עבור קודי תקנים (ISO) (en-US) עבור קבצי שפה.

לפרמטר זה אין כל ערך. זה מתג.

--useUnmanagedFileForMissingManaged -same

השתמש באותו קובץ מקור XML בעת אריזה עבור מנוהל ורק קובץ XML לא מנוהל נמצא; חל על קבצי AppModuleSiteMap, AppModuleMap, FormXml.

לפרמטר זה אין כל ערך. זה מתג.

solution unpack הערות

כברירת מחדל, pac solution unpack חילוץ רכיבי פתרון מקובץ .zip לתבנית XML, תוך יצירת Other\Solution.xml הירארכיה.

חשוב

תמיכה בתבנית בקרת מקור של YAML דורשת Microsoft. PowerApps.CLI גירסה 2.4.1 ואילך. הורד מ- NuGet או עדכן ב- pac install latest.

בעת עבודה עם פתרונות המנוהלות באמצעות שילוב Dataverse Gitpac solution cloneמקורי או שחולצו באמצעות , התיקיה המתוצאת משתמשת בתבנית בקרת המקור YAML במקום זאת:

<folder>/
├── solutions/
│   └── <SolutionUniqueName>/
│       ├── solution.yml
│       ├── solutioncomponents.yml
│       ├── rootcomponents.yml
│       └── missingdependencies.yml
├── publishers/
│   └── <PublisherUniqueName>/
│       └── publisher.yml
└── [component folders — entities/, workflows/, canvasapps/, ...]

כדי לארוז מחדש תיקיה בפריסת YAML זו, השתמש ב- pac solution pack --folder <rootFolder>. הנוכחות של ספריית solutions/ המשנה מקליטה באופן אוטומטי את תבנית YAML.

חשוב

אם אתה מציין rootcomponents.yml רכיב בתיקיה אך לא כולל את קבצי המקור שלו (לדוגמה, .msappcanvasapps/<name>/קובץ יישום בד ציור תחת ), פעולת הערכה עדיין מצליחה, אך מושמטת רכיב זה מהפלט .zip. כדי להבטיח שכל קבצי הרכיבים קיימים, יצא מחדש ופרק את הפתרון המלא מ- Dataverse.

לקבלת מידע נוסף אודות מבנה התיקיות של YAML והתמיכה ברכיבים, ראה הכלי SolutionPackager — תבניות קובץ של בקרת מקור.

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

מציין את target Dataverse. הערך עשוי להיות GUID או כתובת URL מוחלטת של https. כאשר לא צוין, המערכת תשמש את הארגון הפעיל שנבחר עבור פרופיל האימות הנוכחי.

--max-async-wait-time -wt

זמן המתנה אסינכרוני מרבי בדקות. ערך ברירת המחדל הוא 60 דקות.

pac solution version

עדכן גירסת Build או גירסת מהדורה עבור הפתרון.

לדוגמה

pac solution version --patchversion 2

pac solution version --strategy gittags

פרמטרים אופציונליים עבור solution version

--buildversion -bv

גירסת Build עבור הפתרון.

הערה: הערך חייב להיות מספר שלם עם ערך מינימלי של 0.

--filename -fn

שם קובץ CSV של מעקב לשימוש בעת שימוש ב- filetracking כאסטרטגיה. ערך ברירת המחדל הוא 'ControlsStateVersionInfo.csv'.

--patchversion -pv

לא נמצא עוד בשימוש: הפונקציה מתעלמת בפרמטר זה.

--revisionversion -rv

גירסת מהדורה עבור הפתרון.

הערה: הערך חייב להיות מספר שלם עם ערך מינימלי של 0.

--solutionPath -sp

נתיב אל ספריית הפתרונות של Dataverse Solution.xml קובץ.

--strategy -s

עדכון גירסת Build עבור 'Solution.xml' באמצעות האסטרטגיה שצוינה. אם אתה משתמש בתגיות, הגדר אסימון גישה אישית במשתנה הסביבה הבא "PacCli.PAT"

השתמש באחד מהערכים הבאים:

• None
• GitTags
• FileTracking
• Solution

הבדלים בין ייצוא pac solution clone לייצוא

קיימים מצבים שבהם אינך בטוח מתי להשתמש או לפקודה pac solution clonepac solution export . באפשרותך להשתמש באחת מהפקודות בתרחישים הבאים:

• השתמש pac solution clone באפשרות זו כאשר עליך להוסיף רכיבים חדשים לפתרון.
• השתמש pac solution export כאשר ברצונך לשנות את התוכן הקיים בקובץ פתרון אך לא להוסיף רכיבים חדשים לפתרון.

pac solution clone

הפתרון המיוצא נראה כמו Visual Studio כאשר אתה מייצא את הפתרון באמצעות הפקודה pac solution clone. במקום קובץ .csproj (Visual Studio), תראה קובץ cdsproj. הקובץ cdsproj מכיל את כל פרטי הרכיבים הדרושים לבניית הפרוייקט. פלט גירסת ה- Build הוא קובץ zip של פתרון, שניתן לייבא לסביבות שונות.

המפתח אינו צריך לפרק את האריזה של הפתרון המשוכפל מכיוון שהוא מעובד בתבנית לא ארוזה בתוך התיקיה src (מקור).

כעת, אם ברצונך לשייך תוסף חדש שנוצר לפתרון זה, solution unpackל- ed, pac solution add-reference.cdsproj באפשרותך להשתמש בפקודה כדי לעדכן את הקובץ כדי להוסיף את התוסף החדש. לאחר מכן, תוכל לבנות את הפרוייקט באמצעות או dotnet buildmsbuild.

מומלץ לבצע שחזור גירסת Build לפני בניית הפרוייקט. שחזור גירסת Build (גירסת Build של dotnet עושה תחילה שחזור באופן אוטומטי) תשחזר את .NET הדרושות כדי ליצור פתרון ארוז.

pac solution export

כאשר אתה מייצא את הפתרון pac solution export באמצעות רצונך לייצא את הפתרון באמצעות הפורטל של היוצר, והפלט המתוצא הוא קובץ zip של פתרון.

בעת פירוק אריזת קובץ ה- zip של הפתרון (לא מומלץ לפתוח את ה- zip באמצעות כלים רגילים ולהשתמש בפקודה המתאימה מ- CLI). מבנה הספריה המתוצא דומה למבנה ב- pac solution clone. ההבדל היחיד הוא שלא ניתן להוסיף הפניות לפתרון זה שפרק את האריזה, מכיוון שהוא אינו כולל את .cdsproj קובץ הפרוייקט.

באפשרותך לשנות את קבוצת solution packהקבצים הרלוונטית שברצונך לעדכן ולאחר מכן להמשיך ב- , אשר יוצר שוב את קובץ ה- zip של הפתרון כדי להקל על ייבוא הפתרון לתוך סביבת היעד. התוצאה מהפעולה היא קובץ zip של פתרון עם תוכן מעודכן ו חותמת זמן מעודכנת.

למידע נוסף

Microsoft Power Platform פקודות CLI
Microsoft Power Platform מבט כולל על CLI