הפניה ל- CLI של Dataverse (תצוגה מקדימה)

הערה

  • ‏‫‏‫זוהי תכונת Preview.‬‬
  • תכונות Preview אינן מיועדות לשימוש בסביבת ייצור, והפונקציונליות שלהן עשויה להיות מוגבלת. תכונות אלו זמינות לפני הפרסום הרשמי כך שלקוחות יוכלו לקבל גישה מוקדמת ולספק משוב.

מאמר זה מתאר את הפקודות הזמינות ב- Dataverse CLI. כל פקודה תומכת באפשרות --help המפרטת את השימוש, האפשרויות והדוגמאות שלה. פקודות שמחזרות נתונים תומכות --json באפשרות עבור פלט JSON גולמי שימושי בקבצי Script.

ניתן להשתמש באפשרויות הכלליות הבאות עם כל פקודה:

אפשרות תיאור
--log-level <level> הגדר את רמת הרישום: Trace, , DebugInformation, Warning, Errorאו Critical. ברירת מחדל: Warning.
--log-file היכנס לקובץ בספריה הזמנית במקום במסוף.
--context <value> הקשר הפעולה מצורף לנציג המשתמש. באפשרותך גם להגדיר את משתנה DATAVERSE_OPERATION_CONTEXT הסביבה.
הפקודה תיאור
api describe תאר API
api invoke הפעלת API לפי שם
api list פרט ממשקי API הניתנים לגילוי
api request שליחת בקשת HTTP מאומתת
auth create יצירת פרופיל אימות חדש
auth list פרט את כל פרופילי האימות
auth remove הסרת פרופיל אימות
auth select בחר את פרופיל האימות הפעיל
auth who הצג את פרופיל האימות הנוכחי
data associate קישור שתי רשומות באמצעות קשר גומלין
data count ספירת רשומות בטבלה
data create צור רשומה חדשה
data delete מחיקת רשומה
data describe תאר סכימת ישות
data disassociate הסרת קשר גומלין בין שתי רשומות
data get אחזור רשומה בודדת לפי מזהה או מפתח חלופי
data query ביצוע שאילתת OData, FetchXML או SQL
data update עדכן רשומה קיימת
data upload העלאת קובץ לעמודת קובץ ברשומה קיימת
data upsert יצירה או עדכון של רשומה באמצעות מפתח חלופי
erp batch cancel ביטול משימת אצווה של כספים ופעולות
erp batch list פרט משימות אצווה של כספים ופעולות
install התקן גירסה ספציפית, או עדכן לגירסה העדכנית ביותר
mcp הפעלת שרת MCP עבור Dataverse או ERP
mcp allow אפשר יישום כלוח MCP
org list פרט את כל הסביבות הנגישים
org who הצגת פרטי הארגון והמשתמש הנוכחיים
skill delete מחיקת מיומנות מ- Dataverse
skill download הורד מיומנות מ- Dataverse
skill list פרט כישורים פעילים בסביבה
skill upload העלאת מיומנות ל- Dataverse

הערה

פקודות רבות תומכות באפשרות --target <dataverse\|erp> המנתבת את הפעולה ל- Dataverse (ברירת המחדל) או לסביבה המקושרת Finance and Operations (ERP). פקודות ההתחברות לסביבה תומכות באפשרות --environment <url> (-env) לעקוף את כתובת ה- URL של הסביבה של הפרופיל הנוכחי.

api describe פקודה

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

שמות Dataverse אינם מוגדרים כברירת מחדל. באפשרותך להשתמש בשמות העומדים בדרישות ERP בטופס erp:ServiceGroup/Service/Operation.

api describe פרמטרים

פרמטר תיאור
--target פתור שם לא מלא מול או dataverseerp.
--service-group ERP בלבד. צמצום בדיקת המידע של הפעולה לקבוצת שירות אחת.
--service ERP בלבד. צמצום בדיקת המידע של הפעולה לשירות אחד.
--environment עקוף את כתובת ה- URL של הסביבה Dataverse.
--json פלט JSON גולמי.

api describe דוגמאות

dataverse api describe sample_CustomAPIExample
dataverse api describe msdyn_DoesKBExist
dataverse api describe GetUserSessionInfo --target erp --service-group UserSessionService --service AifUserSessionService

api invoke פקודה

הפעל API שהתגלה לפי שם. השתמש name=value בתחביר עבור פרמטרים. אם ערך מכיל רווחים, צטט את האסימון כולו. ממשקי API מסוימים של Dataverse מקבלים פרמטר מחרוזת שהתוכן שלו הוא עצמו JSON. במקרה זה, להעביר את הטקסט JSON כערך באמצעות כללי הציטוט הרגיל של המעטפת שלך.

כברירת מחדל, תגובות JSON מעובדות בתבנית טקסט ידידותית ששומרת על שמות מאפייני הפלט. השתמש --json כדי לשמר את תוכן המנה הגולמי של JSON.

api invoke פרמטרים

פרמטר תיאור
--target פתור שם לא מלא מול או dataverseerp.
--service-group ERP בלבד. צמצום בדיקת המידע של הפעולה לקבוצת שירות אחת.
--service ERP בלבד. צמצום בדיקת המידע של הפעולה לשירות אחד.
--param הוסף פרמטר בעל שם name=value בטופס. ניתן להפעלה.
--bind נתיב האיגוד עבור ממשקי API של Dataverse המאוגדים בישות.
--method, -X עקוף את פעולת השירות של HTTP נגזרת.
--body השתמש בגוף JSON גולמי במקום בפרמטרים בעלי שם.
--body-file קרא גוף JSON גולמי מקובץ.
--header, -H הוסף כותרת HTTP key:value בטופס.
--include, -i כלול את מצב התגובה ואת הכותרות.
--environment עקוף את כתובת ה- URL של הסביבה Dataverse.
--json פלט JSON גולמי במקום טקסט ידידותי.

api invoke דוגמאות

הפעלת פונקציית Dataverse. דוגמה זו מציגה את השימוש בפונקציה Dynamics 365 Contact Center CCaaS_GetPresence הבאה.

dataverse api invoke CCaaS_GetPresence ApiVersion=1.0

הפעל את הפעולה Dataverse AISummarize עם רווחים בערך פרמטר:

dataverse api invoke AISummarize "Text=The customer reported intermittent login failures..."

הפעל שירות מותאם אישית של ERP:

dataverse api invoke GetUserSessionInfo --target erp --service-group UserSessionService --service AifUserSessionService

api list פקודה

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

api list פרמטרים

פרמטר תיאור
--target מערכת היעד לחיפוש: dataverse (ברירת מחדל) או erp.
--service-group ERP בלבד. סינון לקבוצת שירות יחידה.
--service ERP בלבד. סינון לשירות יחיד.
--limit המספר המרבי של ממשקי API להחזרה. ברירת מחדל: 50.
--page מספר העמוד המבוסס על 1 בעת דפדף בין התוצאות. ברירת מחדל: 1.
--environment עקוף את כתובת ה- URL של הסביבה Dataverse.
--json פלט JSON גולמי.

api list דוגמאות

dataverse api list
dataverse api list invoice --target dataverse
dataverse api list --target erp GetUserSessionInfo
dataverse api list --target erp --service-group UserSessionService --service AifUserSessionService

api request פקודה

שלח בקשת HTTP מאומתת גולמית ל- Dataverse או ל- ERP. השתמש בפקודה זו כאשר אתה זקוק לשליטה מלאה בנתיב, בפעולת השירות, בכותרות ובגוף ההודעה.

api request פרמטרים

פרמטר תיאור
--target מערכת היעד: dataverse או erp. חובה.
--path נתיב הבקשה. חובה.
--method, -X פעולת השירות HTTP. ברירת מחדל: GET, POST או כאשר גוף צוין.
--body גוף בקשה מוטבע של JSON.
--body-file קובץ המכיל גוף בקשה לאובייקט JSON.
--header, -H הוסף כותרת HTTP key:value בטופס.
--include, -i כלול את מצב התגובה ואת הכותרות.
--environment עקוף את כתובת ה- URL של הסביבה Dataverse.

api request דוגמאות

dataverse api request --target dataverse --path /api/data/v9.2/sample_CustomAPIExample --body "{\"Input\":\"value\"}"
dataverse api request --target erp --path /api/services/UserSessionService/AifUserSessionService/GetUserSessionInfo --body "{}"

auth create פקודה

צור פרופיל אימות חדש.

auth create פרמטרים זמינים

השתמש בפרמטרים אלה כדי לציין את אופן הפעולה של auth create הפקודה.

פרמטר תיאור
--environment, -env כתובת ה- URL עבור סביבת Dataverse שברצונך לאמת מולה.
--name, -n שם אופציונלי עבור הפרופיל. השתמש בשם כדי לבחור את הפרופיל מאוחר יותר.
--cloud, -ci ענן היעד: Public, UsGov, UsGovHigh, UsGovDod, או China.
--deviceCode, -dc השתמש בזרימת אימות קוד המכשיר, עבור בסביבות ללא דפדפן.
--username, -un שם המשתמש עבור אימות שם משתמש וסיסמה.
--password, -p הסיסמה עבור אימות שם משתמש וסיסמה.
--applicationId, -id מזהה היישום (לקוח) עבור אימות מנהל שירות (SPN).
--clientSecret, -cs סוד הלקוח עבור אימות ראשי של שירות.
--certificateDiskPath, -cdp הנתיב לקובץ אישור .pfx עבור אימות מבוסס אישור.
--certificatePassword, -cp הסיסמה עבור האישור.
--tenant, -t מזהה הדייר. נדרש עבור אימות ראשי של שירות.
--managedIdentity, -mi השתמש Azure מנוהלת.
--githubFederated, -ghf השתמש GitHub Actions מאוחד.
--azureDevOpsFederated, -adof השתמש Azure DevOps אימות מאוחד.
--clientid, -cid מזהה לקוח Microsoft Entra יישום מותאם אישית לשימוש במקום יישום ה- CLI Dataverse המוגדר כברירת מחדל.
--no-default-environment אל תגדיר את הסביבה כברירת המחדל.
--accept-cleartext-caching אפשר מטמון אסימון טקסט רגיל ב- Linux.

auth create דוגמאות

הדוגמאות הבאות מדגימות כיצד להשתמש בפקודה auth create .

אימות אינטראקטיבי

פקודה זו פותחת תיבת דו-שיח של דפדפן או מערכת לקבלת מידע נוסף.

dataverse auth create --environment https://myorg.crm.dynamics.com

פרופיל בעל שם

צור פרופיל עם שם ספציפי.

dataverse auth create --environment https://myorg.crm.dynamics.com --name prod

זרימת קוד מכשיר

השתמש בזרימת קוד המכשיר עבור בסביבות ללא דפדפן.

dataverse auth create --environment https://myorg.crm.dynamics.com --deviceCode

מנהל שירות עם סוד לקוח

השתמש במנהל שירות כאשר אתה זקוק לאימות ללא התערבות, כגון בצינור CI/CD או בקובץ Script אוטומטי אחר שבו אין אפשרות לבצע כניסה אינטראקטיבית. ספק את מזהה היישום, סוד הלקוח ומזהה הדייר של רישום יישום בעל גישה לסביבה.

dataverse auth create --applicationId <appId> --clientSecret <secret> --tenant <tenantId>

מזהה לקוח של יישום Entra מותאם אישית

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

dataverse auth create --environment https://myorg.crm.dynamics.com --clientid <your-app-guid>

auth list פקודה

פרט את כל פרופילי האימות. הוסף --json לפלט JSON גולמי.

auth list דוגמאות

dataverse auth list
dataverse auth list --json

auth remove פקודה

הסר פרופיל אימות אחד או את כולם.

auth remove פרמטרים

פרמטר תיאור
--index, -i הסר את הפרופיל עם האינדקס המבוסס על 1 שצוין, כפי שמוצג ב- auth list.
--name, -n הסר את הפרופיל בשם שצוין.
--all הסר את כל הפרופילים.

auth remove דוגמאות

dataverse auth remove --index 1
dataverse auth remove --name prod
dataverse auth remove --all

auth select פקודה

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

auth select פרמטרים

פרמטר תיאור
--index, -i בחר את הפרופיל לפי האינדקס המבוסס על 1 שלו, כפי שמוצג ב- auth list.
--name, -n בחר את הפרופיל לפי שם.

auth select דוגמאות

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

dataverse auth select

בחר פרופיל לפי אינדקס או לפי שם:

dataverse auth select --index 1
dataverse auth select --name prod

auth who פקודה

הצג את פרופיל האימות הפעיל הנוכחי. הוסף --json לפלט JSON גולמי.

auth who דוגמאות

dataverse auth who
dataverse auth who --json

data associate פקודה

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

data associate פרמטרים

פרמטר תיאור
--table, -t שם ערכת הישות של הרשומה הראשית. חובה.
--id, -i ה- GUID של הרשומה הראשית. חובה.
--relationship, -rel שם מאפיין הניווט. חובה.
--related שם ערכת הישות של הטבלה הקשורה. חובה.
--related-id ה- GUID של הרשומה הקשורה. חובה.
--environment, -env עקוף את כתובת ה- URL של הסביבה.
--json פלט JSON גולמי.

data associate דוגמאות

dataverse data associate --table accounts --id <guid> --relationship contact_customer_accounts --related contacts --related-id <related-guid>

data count פקודה

ספירת הרשומות בטבלה, המסוננים באופן אופציונלי.

data count פרמטרים

פרמטר תיאור
--table, -t שם ערכת הישות. נדרש אלא אם אתה משתמש ב- --fetchxml.
--filter, -f ביטוי OData $filter .
--fetchxml שאילתת צבירה FetchXML עבור ספירות מורכבות.
--target נתב אל dataverse (ברירת מחדל) או לסביבה המקושרת erp .
--cross-company ERP בלבד. ספירה בכל החברות. ברירת מחדל: חברת ברירת המחדל של המשתמש.
--environment, -env עקוף את כתובת ה- URL של הסביבה.
--json פלט JSON גולמי.

data count דוגמאות

dataverse data count --table accounts
dataverse data count --target erp --table Currencies --filter "CurrencyCode eq 'AED'"

data create פקודה

צור רשומה חדשה בטבלה Dataverse. הגדר עמודות בדיקת מידע באמצעות @odata.bind תחביר.

data create פרמטרים זמינים

פרמטר תיאור
--table, -t שם ערכת הישות. חובה.
--data, -d אובייקט JSON עם ערכי השדה.
--data-file הנתיב לקובץ JSON עם נתוני הרשומה.
--return, -r החזר את הרשומה המלאה שנוצרה.
--target נתב אל dataverse (ברירת מחדל) או לסביבה המקושרת erp .
--environment, -env עקוף את כתובת ה- URL של הסביבה.
--json פלט JSON גולמי.

data create דוגמאות

dataverse data create --table accounts --data '{"name":"Contoso"}'
dataverse data create --table contacts --data '{"firstname":"Alice","parentcustomerid_account@odata.bind":"accounts(<guid>)"}'

עצה

השתמש עבור --data-file JSON מורכב. השתמש --return --json כדי לקבל את הרשומה המלאה שנוצרה.

data delete פקודה

מחק רשומה בודדת לפי המפתח הראשי שלה או באמצעות מפתח חלופי.

data delete פרמטרים זמינים

פרמטר תיאור
--table, -t שם ערכת הישות. חובה.
--id, -i ה- GUID של הרשומה.
--key, -k מפתח חלופי.
--no-confirm דלג על הבקשה לאישור.
--target נתב אל dataverse (ברירת מחדל) או לסביבה המקושרת erp .
--environment, -env עקוף את כתובת ה- URL של הסביבה.
--json פלט JSON גולמי.

data delete דוגמאות

dataverse data delete --table accounts --id 00000000-0000-0000-0000-000000000001 --no-confirm

data describe פקודה

תאר סכימה של ישות OData. עבור Dataverse, הפקודה קוראת עם EntityDefinitions(LogicalName='<table>') מונחה $expand על-ידי --include, ושיחה שניה לערך --include actionscustomapis שבו מוגדרת. פעולות מוכללות של Assign Dataverse, SetState כגון ואינן ספורות. עבור ERP, קריאה יחידה מחזירה /Metadata/PublicEntities מאפיינים, פעולות מאוגדות וניווט יחד.

data describe פרמטרים

פרמטר תיאור
--target היעד: dataverse (ברירת מחדל) או erp.
--table, -t חובה. עבור Dataverse, השם הלוגי, כגון account. עבור ERP, שם ערכת הישות, כגון BatchJobs.
--include רשימה מופרדת באמצעות פסיקים של מקטעים שברצונך לכלול: entity, properties, relations, actions, או all. כינויים: attributes=properties, relationships=relations. ברירת מחדל עבור ERP: all. ברירת מחדל עבור Dataverse: entity,properties.
--json פלט JSON גולמי.

data describe דוגמאות

dataverse data describe --table account
dataverse data describe --target dataverse --table account --include all
dataverse data describe --target erp --table BatchJobs

data disassociate פקודה

הסרת קשר גומלין בין שתי רשומות. פקודה זו נתמכת עבור Dataverse בלבד.

data disassociate פרמטרים

פרמטר תיאור
--table, -t שם ערכת הישות של הרשומה הראשית. חובה.
--id, -i ה- GUID של הרשומה הראשית. חובה.
--relationship, -rel שם מאפיין הניווט. חובה.
--related-id ה- GUID של הרשומה הקשורה, עבור קשר גומלין של רבים לרבים. השמט פרמטר זה כדי לנקות בדיקת מידע.
--environment, -env עקוף את כתובת ה- URL של הסביבה.
--json פלט JSON גולמי.

data disassociate דוגמאות

dataverse data disassociate --table accounts --id <guid> --relationship contact_customer_accounts --related-id <related-guid>

data get פקודה

אחזר רשומה בודדת לפי המזהה שלה (מפתח ראשי) או באמצעות מפתח חלופי.

data get פרמטרים

פרמטר תיאור
--table, -t שם ערכת הישות. חובה.
--id, -i ה- GUID של הרשומה (מפתח ראשי).
--key, -k מפתח חלופי, לדוגמה "col='val'".
--select, -s רשימה מופרדת באמצעות פסיק של עמודות ($select).
--expand, -x ביטוי OData $expand עבור רשומות קשורות.
--target נתב אל dataverse (ברירת מחדל) או לסביבה המקושרת erp .
--environment, -env עקוף את כתובת ה- URL של הסביבה.
--json פלט JSON גולמי.

data get דוגמאות

dataverse data get --table accounts --id 00000000-0000-0000-0000-000000000001
dataverse data get --target erp --table Currencies --key "CurrencyCode='AED'" --select "CurrencyCode,Name"

data query פקודה

ביצוע שאילתת OData, FetchXML או SQL מול טבלה Dataverse.

data query פרמטרים

פרמטר תיאור
--table, -t שם ערכת הישות לשאילתה. נדרש עבור שאילתות OData.
--select, -s רשימה מופרדת באמצעות פסיק של עמודות ($select).
--filter, -f ביטוי OData $filter .
--orderby, -o ביטוי OData $orderby .
--top מספר הרשומות המרבי להחזרה (1-5000).
--expand, -x ביטוי OData $expand עבור רשומות קשורות.
--fetchxml שאילתת FetchXML מוטבעת.
--fetchxml-file הנתיב לקובץ המכיל שאילתת FetchXML.
--sql שאילתת SQL SELECT (תצוגה מקדימה).
--sql-file הנתיב לקובץ המכיל שאילתת SQL.
--all, -a עקוב אחר חלוקה לעמודים כדי לאחזר את כל הרשומות.
--max-records מספר הרשומות המרבי לאחזור בעת שימוש ב- --all. ברירת מחדל: 100000.
--target נתב אל dataverse (ברירת מחדל) או לסביבה המקושרת erp .
--cross-company ERP בלבד. שאילתה בכל החברות. ברירת מחדל: חברת ברירת המחדל של המשתמש.
--environment, -env עקוף את כתובת ה- URL של הסביבה.
--json פלט JSON גולמי.

data query דוגמאות

dataverse data query --table accounts --select "name,revenue" --filter "revenue gt 1000000"
dataverse data query --fetchxml "<fetch><entity name='account'><attribute name='name'/></entity></fetch>"
dataverse data query --sql "SELECT name, revenue FROM account WHERE revenue > 1000000"
dataverse data query --target erp --table Currencies --select "CurrencyCode,Name" --top 10

למד עוד

data update פקודה

עדכן שדה אחד או יותר ברשומה קיימת, המזוהה על-ידי המזהה שלה או על-ידי מפתח חלופי. הגדר עמודות בדיקת מידע באמצעות @odata.bind תחביר.

data update פרמטרים

פרמטר תיאור
--table, -t שם ערכת הישות. חובה.
--id, -i ה- GUID של הרשומה.
--key, -k מפתח חלופי.
--data, -d אובייקט JSON עם השדות לעדכון.
--data-file הנתיב לקובץ JSON עם נתוני העדכון.
--return, -r החזר את הרשומה המעודכנת המלאה.
--target נתב אל dataverse (ברירת מחדל) או לסביבה המקושרת erp .
--environment, -env עקוף את כתובת ה- URL של הסביבה.
--json פלט JSON גולמי.

data update דוגמאות

dataverse data update --table accounts --id 00000000-0000-0000-0000-000000000001 --data '{"name":"Contoso (updated)"}'

data upload פקודה

העלה קובץ מקומי לעמודת קובץ Dataverse ברשומה קיימת. הפקודה בוחרת באופן אוטומטי בקשה יחידה או העלאה בנתח בהתבסס על גודל הקובץ, אלא אם תציין --mode. במצב אוטומטי, קבצים שגודלם עולה על 128 MB מועלים בבקשה אחת, וקבצים גדולים יותר משתמשים בהעלאה נתחית. בעת השמטת --mime-type, הפקודה מסיקה את סוג MIME מסיומת הקובץ. הרחבות לא ידועות המוגדרות כברירת מחדל ל- application/octet-stream.

data upload פרמטרים זמינים

פרמטר תיאור
--table, -t סכימת הטבלה או השם הלוגי, כגון account. חובה. הפקודה פותרת את ערכת הישות ממטה-נתונים.
--id, -i ה- GUID של הרשומה. חובה.
--column, -c שם התכונה 'עמודת קובץ'. חובה.
--file, -f הנתיב לקובץ המקומי. חובה.
--mode, -m אסטרטגיית ההעלאה: auto (ברירת מחדל), smallאו chunk.
--mime-type סוג MIME מפורש. ברירת מחדל: נגזרת מסיומת הקובץ.
--overwrite החלף קובץ קיים. כברירת מחדל, הפקודה נכשלת אם העמודה אינה ריקה.
--environment, -env עקוף את כתובת ה- URL של הסביבה.
--json פלט JSON גולמי.

data upload דוגמאות

dataverse data upload --table account --id <guid> --column new_document --file report.pdf
dataverse data upload -t account -i <guid> -c new_document -f photo.jpg --overwrite
dataverse data upload -t account -i <guid> -c new_document -f big.bin --mode chunk

data upsert פקודה

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

data upsert פרמטרים

פרמטר תיאור
--table, -t שם ערכת הישות. חובה.
--key, -k מפתח חלופי. חובה.
--data, -d אובייקט JSON עם ערכי השדה.
--data-file הנתיב לקובץ JSON.
--update-only כשל אם הרשומה אינה קיימת (If-Match: *).
--create-only כשל אם הרשומה כבר קיימת (If-None-Match: *).
--return, -r החזר את הרשומה המלאה לאחר הפעולה.
--target נתב אל dataverse (ברירת מחדל) או לסביבה המקושרת erp .
--environment, -env עקוף את כתובת ה- URL של הסביבה.
--json פלט JSON גולמי.

data upsert דוגמאות

dataverse data upsert --table accounts --key "accountnumber='ACC-100'" --data '{"name":"Contoso"}'

erp batch cancel פקודה

בטל משימת אצווה של Finance ו- Operations על-ידי .RecId השתמש erp batch list כדי למצוא את RecId.

erp batch cancel דוגמאות

dataverse erp batch cancel <recid>

erp batch list פקודה

פרט משימות אצווה במופע Finance ו- Operations המקושר לסביבת Dataverse שלך. הפקודה דורשת פרופיל אימות המחובר לסביבה Dataverse הכוללת מופע מקושר של Finance ו- Operations. כתובת ה- URL של Finance ו- Operations נגזרת באופן אוטומטי מהחיבור Dataverse הנוכחי.

erp batch list פרמטרים

פרמטר תיאור
--company סנן לפי ישות משפטית (dataAreaId), כגון USMF.
--status סנן לפי מצב: Waiting, Executing, Finished, Errorאו Cancelled.
--top מספר התוצאות המרבי להחזרה. ברירת מחדל: 20.
--caption סנן לפי כיתוב (התאמה של מחרוזת משנה לא תלויית רישיות).
--json פלט JSON גולמי.

erp batch list דוגמאות

dataverse erp batch list
dataverse erp batch list --status Waiting
dataverse erp batch list --status Executing --top 20

install פקודה

התקן גירסה ספציפית של ה- CLI של Dataverse, או עדכן לגירסה העדכנית ביותר. הפקודה מזהה אם התקנת את שורת הפקודה באופן כללי או אם אתה משתמש בה npx והתקנת אותה בהתאם.

install דוגמאות

התקן את הגירסה העדכנית ביותר:

dataverse install latest

התקן גירסה ספציפית:

dataverse install 1.0.0

mcp פקודה

הפעלת שרת פרוטוקול הקשר של מודל (MCP) אשר מתחבר לסביבה שלך, כך שמסייעי בינה מלאכותית כגון טבלת ה- Context Protocol (MCP) יוכלו לקיים אינטראקציה עם הנתונים שלך. היעד מזוהה באופן אוטומטי מכתובת ה- URL: כתובת URL Dataverse מפעילה את שרת ה- MCP Dataverse, וכתובת URL של Finance ו- Operations, https://myorg.operations.dynamics.comכגון , מפעילה את שרת ה- MCP של ERP.

mcp תחביר

dataverse mcp <orgUrl> [options]

הארגומנט <orgUrl> הוא כתובת ה- URL של הארגון שלך, לדוגמה https://myorg.crm.dynamics.com.

mcp פרמטרים

פרמטר תיאור
--validate אמת את נקודות הקצה של MCP ואת הגדרת האימות מבלי להפעיל את השרת.
--log-level הגדר את רמת הרישום: Trace, , DebugInformation, Warning, Errorאו Critical. ברירת מחדל: Warning.
--log-file היכנס לקובץ בספריה הזמנית.
--preview השתמש בנקודות הקצה של MCP של התצוגה המקדימה (api/mcp_preview במקום api/mcp). לא נתמך עבור ERP.

mcp דוגמאות

אמת את ההגדרה (שלב ראשון מומלץ):

dataverse mcp https://myorg.crm.dynamics.com --validate

הפעל את השרת באמצעות התעבורה stdio:

dataverse mcp https://myorg.crm.dynamics.com

השתמש בנקודות הקצה של התצוגה המקדימה, או הפוך רישום קבצי איתור באגים לזמין:

dataverse mcp https://myorg.crm.dynamics.com --preview
dataverse mcp https://myorg.crm.dynamics.com --log-level Debug --log-file

mcp allow פקודה

ודא כי יישום Microsoft Entra נמצא ברשימת הלקוחות המותרים Dataverse MCP עבור סביבת הפרופיל הנוכחית. פקודה זו היא חלופה לשלב הניהול הידן המתואר בדרישות המוקדמות. למשתמש שאומתו חייבות להיות הרשאות מנהל מערכת Dataverse בסביבת היעד.

mcp allow תחביר

dataverse mcp allow <appId> [options]

הארגומנט <appId> הוא מזהה היישום (לקוח) המאפשר, כ- GUID.

mcp allow פרמטרים

פרמטר תיאור
--erp אפשר ליישום במופע המקושר Finance and Operations במקום Dataverse.

mcp allow דוגמאות

dataverse mcp allow 0c412cc3-0dd6-449b-987f-05b053db9457
dataverse mcp allow 0c412cc3-0dd6-449b-987f-05b053db9457 --erp

הערה

Finance ו- Operations ממטמון את רשימת המותרות ב- AOS, כך שהמזהה החדש המותר של היישום יכול להימשך עד כחמש דקות כדי להיכנס לתוקף.

org list פקודה

פרט את כל הסביבות שבאפשרותך לגשת אליו.

org list פרמטרים זמינים

פרמטר תיאור
--filter סנן את רשימת הסביבות לפי מונח חיפוש.
--json פלט JSON גולמי.

org list דוגמאות

dataverse org list
dataverse org list --filter contoso
dataverse org list --json

org who פקודה

הצג מידע אודות הארגון והמשתמש הנוכחיים, באמצעות פרופיל האימות הפעיל. הפקודה env היא כינוי עבור org.

org who פרמטרים זמינים

פרמטר תיאור
--environment, -env עקוף את כתובת ה- URL של הסביבה.
--json פלט JSON גולמי.

org who דוגמאות

dataverse org who
dataverse org who --environment https://myorg.crm.dynamics.com
dataverse org who --json

skill פקודות

נהל מיומנויות Dataverse – ערכות הוראות לשימוש חוזר ( SKILL.md קובץ וקבצי המשאבים שלו) שבהן משתמשות סוכני בינה מלאכותית – המאוחסנים בסביבה המחוברת. הפקודות ברמה העליונה skill מספקות פעולות יצירה, קריאה, עדכון ומחיקה מול הסביבה. באופן מקומי, מיומנויות מאוחסנות תחת .claude/skills/<name>/.

הערה

פקודות עריכה והערכה של כישורים, כגון make, update, get, ו- eval, נפרדות מפקודות אלה. לקבלת מידע נוסף, הפעל את dataverse workspace skill --help.

skill delete פקודה

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

dataverse skill delete new_lead-qualification

skill download פקודה

הורד כישורים אחד או יותר מהסביבה הפעילה Dataverse לדיסק. הפקודה מורידה את הקובץ SKILL.md ואת כל קבצי המשאבים, תוך שמירה על מבנה מדריך הכתובות. השתמש כדי skill list למצוא שמות ייחודיים לכישורים.

פרמטר תיאור
--all הורד את כל הכישורים הפעילים מהסביבה. לא ניתן לשלב עם שם ייחודי של מיומנות.
--output, -o ספריית הבסיס לפלט. ברירת מחדל: .claude/skills/. עם --all, כל מיומנות נכתבת אל <path>/<name>/.
--json הפק פלט של תוכן הכישורים כ- JSON מבלי לכתוב קבצים. באפשרותך לציין נתיב קובץ לכתיבה. 
dataverse skill download new_lead-qualification
dataverse skill download --all --output ./skills

skill list פקודה

פרט את כל הכישורים הפעילים בסביבה המחוברת Dataverse.

פרמטר תיאור
--resources, -r פרט גם את קבצי המשאבים עבור כל מיומנות.
--json פלט כ- JSON. באפשרותך לציין נתיב קובץ לכתיבה. 
dataverse skill list
dataverse skill list --resources

skill upload פקודה

העלה כישורים אחד או יותר מהדיסק לסביבה הפעילה Dataverse. הפקודה תומכת בספריות, .zip, קבצי .skillוקבצי .md

באפשרותך להעביר מיומנות <name>, הנפתרת ל- .claude/skills/<name>/, או מפורשת <path> למדריך כתובות או לקובץ.

פרמטר תיאור
--all העלה את כל הכישורים תחת .claude/skills/. לא ניתן לשלב עם שם מיומנות או נתיב.
--json הפק פלט של התוצאה כ- JSON. באפשרותך לציין נתיב קובץ לכתיבה. 
dataverse skill upload lead-qualification
dataverse skill upload ./my-skill.zip
dataverse skill upload --all

למידע נוסף‬

עבודה עם נתונים באמצעות ה- CLI Dataverse

  • Last updated on