Dataverse CLI reference (preview)

Märkus.

  • See on eelvaatefunktsioon.
  • Eelvaatefunktsioonid ei ole mõeldud kasutamiseks tootmises ja nende funktsioonid võivad olla piiratud. Need funktsioonid on saadaval enne ametlikku väljastamist, et kliendid saaksid sellele varakult juurdepääsu ja võiksid tagasisidet anda.

Selles artiklis kirjeldatakse dataverse CLI-s saadaolevaid käske. Iga käsk toetab suvandit, mis loetleb --help selle kasutuse, suvandid ja näited. Käsud, mis tagastavad andmed, toetavad --json JSON-väljundi toorsuvandi suvandit, mis on skriptides kasulik.

Järgmisi globaalsuvandeid saab kasutada mis tahes käsuga.

Variant Kirjeldus
--log-level <level> Määrake logimistase: Trace, , InformationDebug, Warning, Errorvõi Critical. Vaikeväärtus: Warning.
--log-file Logige konsooli asemel ajutises kataloogis asuvasse faili.
--context <value> User-Agentile lisatud toimingukontekst. Samuti saate määrata DATAVERSE_OPERATION_CONTEXT keskkonnamuutuja.
Käsk Kirjeldus
api describe API kirjeldamine
api invoke API kutsumine nime järgi
api list Loetle leitavad API-d
api request Autenditud HTTP-päringu saatmine
auth create Uue autentimisprofiili loomine
auth list Loetle kõik autentimisprofiilid
auth remove Autentimisprofiili eemaldamine
auth select Aktiivse autentimisprofiili valimine
auth who Praeguse autentimisprofiili kuvamine
data associate Kahe kirje linkimine seose kaudu
data count Tabeli kirjete loendamine
data create Uue kirje loomine
data delete Kirje kustutamine
data describe Olemi skeemi kirjeldamine
data disassociate Kahe kirje vahelise seose eemaldamine
data get Ühe kirje toomine ID või alternatiivse võtme järgi
data query OData, FetchXML-i või SQL-päringu käivitamine
data update Uuendage olemasolevat kirjet
data upload Faili üleslaadimine olemasoleva kirje failiveergu
data upsert Kirje loomine või värskendamine alternatiivse võtme abil
erp batch cancel Pakett-töö Rahandus ja toimingud tühistamine
erp batch list List Finance and Operations batch jobs
install Kindla versiooni installimine või uusimale versioonile värskendamine
mcp MCP-serveri käivitamine Dataverse'i või ERP jaoks
mcp allow Rakenduse lubamine MCP-kliendina
org list Loetle kõik hõlbustusfunktsioonidega keskkonnad
org who Kuva praegune organisatsiooni- ja kasutajateave
skill delete Oskuse kustutamine dataverse'ist
skill download Oskuse allalaadimine dataverse'ist
skill list Aktiivsete oskuste loetlemine keskkonnas
skill upload Oskuse üleslaadimine dataverse'i

Märkus.

Paljud käsud toetavad --target <dataverse\|erp> võimalust, mis marsruudib toimingu Dataverse'i (vaikesäte) või lingitud finants- ja toimingukeskkonda (ERP). Keskkonnaga ühenduse loovad käsud toetavad --environment <url> (-env) suvandit praeguse profiili keskkonna URL-i alistamiseks.

api describe käsk

Saate kuvada ühe API metaandmed. Dataverse'i kohandatud API-de puhul sisaldab väljund päringuparameetrit ja vastuse atribuudi kirjeldust, kui metaandmed neid pakuvad.

Andmevasted on vaikimisi ette valmistamata. Vormil saate kasutada ERP-tingimustele vastavaid nimesid erp:ServiceGroup/Service/Operation.

api describe parameetrid

Parameeter Kirjeldus
--target Lahendage sobimatu nimi vormingus dataverse või erp.
--service-group Ainult ERP. Kitsendage toiminguotsing ühe teenuserühmaga.
--service Ainult ERP. Kitsendage toiminguotsingut ühe teenusega.
--environment Tühistage Dataverse'i keskkonna URL.
--json Väljundi toores JSON.

api describe Näited

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

api invoke käsk

Avastatud API kutsumine nime järgi. Parameetrite süntaksit saate kasutada name=value . Kui väärtus sisaldab tühikuid, siis hinnake kogu tõend. Mõned andmeversi API-d aktsepteerivad stringiparameetrit, mille sisu on ise JSON. Sel juhul edastage JSON-tekst väärtusena, kasutades oma kesta normaaljaotuse ja eskaleerimisreegleid.

Vaikimisi renderdatakse JSON-vastused sõbralikus tekstivormingus, mis säilitab väljundatribuudinimed. Sobib --json JSON-i toorlasti säilitamiseks.

api invoke parameetrid

Parameeter Kirjeldus
--target Lahendage sobimatu nimi vormingus dataverse või erp.
--service-group Ainult ERP. Kitsendage toiminguotsing ühe teenuserühmaga.
--service Ainult ERP. Kitsendage toiminguotsingut ühe teenusega.
--param Lisage nimega parameeter vormile name=value . Korratav.
--bind Olemiga seotud Dataverse API-de sidumistee.
--method, -X Tuletatud HTTP-meetodi alistamine.
--body Kasutage nimeliste parameetrite asemel JSON-i toorkeha.
--body-file Saate lugeda failist JSON-i toorkeha.
--header, -H Saate vormile lisada HTTP-päise key:value .
--include, -i Lisage vastuse olek ja päised.
--environment Tühistage Dataverse'i keskkonna URL.
--json Väljastage sõbraliku teksti asemel toores JSON.

api invoke Näited

Funktsiooni Dataverse käivitamine. Selles näites kirjeldatakse funktsiooni Dynamics 365 Contact Center CCaaS_GetPresence kasutamist.

dataverse api invoke CCaaS_GetPresence ApiVersion=1.0

Käivitage toiming Dataverse AISummarize koos tühikutega parameetri väärtuses:

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

ERP kohandatud teenuse käivitamine:

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

api list käsk

Loetlege leitavad API-d, näiteks Dataverse'i kohandatud API-d ja ERP kutsutavad teenuse lõpp-punktid. Tulemites kuvatakse API identiteet, sõbralik nimi, liik ja kirjeldus, kui need on saadaval. Tulemite filtreerimiseks saate edastada valikulise päringutermini.

api list Parameetrid

Parameeter Kirjeldus
--target Otsitav sihtsüsteem: dataverse (vaikesäte) või erp.
--service-group Ainult ERP. Saate filtreerida ühte teenuserühma.
--service Ainult ERP. Saate filtreerida ühte teenusesse.
--limit Tagastatavate API-de maksimumarv. Vaikeväärtus: 50.
--page 1-põhine leheküljenumber tulemite sirvimisel. Vaikeväärtus: 1.
--environment Tühistage Dataverse'i keskkonna URL.
--json Väljundi toores JSON.

api list Näited

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 käsk

Autenditud toor-HTTP-päringu saatmine Dataverse'ile või ERP-le. Kasutage seda käsku, kui vajate täielikku kontrolli tee, meetodi, päiste ja kehateksti üle.

api request Parameetrid

Parameeter Kirjeldus
--target Sihtsüsteem: dataverse või erp. Nõutav.
--path Taotluse tee. Nõutav.
--method, -X HTTP-meetod. Vaikesäte: GETvõi POST sisu esitamisel.
--body Tekstisisene JSON-i taotluse keha.
--body-file Fail, mis sisaldab JSON-objekti taotluse keha.
--header, -H Saate vormile lisada HTTP-päise key:value .
--include, -i Lisage vastuse olek ja päised.
--environment Tühistage Dataverse'i keskkonna URL.

api request Näited

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 käsk

Looge uus autentimisprofiil.

auth create Parameetrid

Nende parameetrite abil saate määrata käsu käitumise auth create .

Parameeter Kirjeldus
--environment, -env Selle Dataverse'i keskkonna URL, millega soovite autentida.
--name, -n Profiili valikuline nimi. Nime abil saate hiljem profiili valida.
--cloud, -ci Sihtpilv: Public, , UsGovHighUsGov, UsGovDodvõi China.
--deviceCode, -dc Kasutage ilma brauserita keskkondades seadmekoodi autentimisvoogu.
--username, -un Kasutajanimi ja paroolautentimine.
--password, -p Kasutajanime ja parooli autentimise parool.
--applicationId, -id Teenusesubjekti (SPN) autentimise rakenduse (klient) ID.
--clientSecret, -cs Teenusesubjekti autentimise klientrakenduse saladus.
--certificateDiskPath, -cdp Serdipõhise autentimise PFX-serdifaili tee.
--certificatePassword, -cp Serdi parool.
--tenant, -t Rentniku ID. Nõutav teenusesubjekti autentimiseks.
--managedIdentity, -mi Saate kasutada Azure hallatavat identiteeti.
--githubFederated, -ghf Kasutage GitHub Actions liitautentimist.
--azureDevOpsFederated, -adof Kasutage Azure DevOps liitautentimist.
--clientid, -cid Kohandatud Microsoft Entra rakenduse kliendi ID, mida kasutada Dataverse CLI vaikerakenduse asemel.
--no-default-environment Ärge seadke keskkonda vaikekeskkonnaks.
--accept-cleartext-caching Luba Linuxis lihtteksti tõendi vahemälu.

auth create Näited

Järgmised näited näitavad, kuidas käsku kasutada auth create .

Interaktiivne autentimine

See käsk avab lisateabe saamiseks brauseri või süsteemi dialoogi.

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

Nimega profiil

Looge kindla nimega profiil.

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

Seadme koodivoog

Kasutage ilma brauserita keskkondades seadme koodivoogu.

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

Kliendisaladusega teenusesubjekt

Kui vajate järelevalveta autentimist (nt CI/CD konveieris või mõnes muus automaatses skriptis), kus interaktiivne sisselogimine pole võimalik, kasutage teenusesubjekti. Saate sisestada rakenduse registreerimise rakenduse ID, klientrakenduse saladuse ja rentniku ID, millel on juurdepääs keskkonnale.

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

Kohandatud Entra rakenduse kliendi ID

Kasutage vaikerakenduse asemel oma rakenduse registreerimist.

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

auth list käsk

Loetlege kõik autentimisprofiilid. Lisa --json JSON-i toores väljundi jaoks.

auth list Näited

dataverse auth list
dataverse auth list --json

auth remove käsk

Eemaldage üks või kõik autentimisprofiilid.

auth remove Parameetrid

Parameeter Kirjeldus
--index, -i Eemaldage määratud 1-põhise indeksiga profiil, nagu on näidatud jaotises auth list.
--name, -n Eemaldage määratud nimega profiil.
--all Eemaldage kõik profiilid.

auth remove Näited

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

auth select käsk

Valige aktiivne autentimisprofiil. Kõigi profiilide loetlemiseks käivitage käsk ilma valikuteta.

auth select Parameetrid

Parameeter Kirjeldus
--index, -i Valige profiil selle 1-põhise indeksi järgi, nagu on näidatud jaotises auth list.
--name, -n Valige profiil nime järgi.

auth select Näited

Avage interaktiivne valija. Kasutage nooleklahve või tippige filtreerimiseks:

dataverse auth select

Valige profiil registri või nime järgi:

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

auth who käsk

Saate kuvada praeguse aktiivse autentimisprofiili. Lisa --json JSON-i toores väljundi jaoks.

auth who Näited

dataverse auth who
dataverse auth who --json

data associate käsk

Seostage kaks kirjet navigeerimisatribuudi (seose) kaudu. Seda käsku toetatakse ainult dataverse'i korral.

data associate Parameetrid

Parameeter Kirjeldus
--table, -t Esmase kirje olemikomplekti nimi. Nõutav.
--id, -i Esmase kirje GUID. Nõutav.
--relationship, -rel Navigeerimisatribuudi nimi. Nõutav.
--related Seotud tabeli olemikomplekti nimi. Nõutav.
--related-id Seotud kirje GUID. Nõutav.
--environment, -env Alistab keskkonna URL-i.
--json Väljundi toores JSON.

data associate Näited

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

data count käsk

Tabeli kirjete loendamine (soovi korral filtreeritud).

data count Parameetrid

Parameeter Kirjeldus
--table, -t Olemikomplekti nimi. Nõutav, v.a juhul, kui kasutate .--fetchxml
--filter, -f OData $filter avaldis.
--fetchxml FetchXML-i koondpäring kompleksarvude jaoks.
--target Marsruutimine dataverse (vaikesäte) või lingitud erp keskkond.
--cross-company Ainult ERP. Loenda kõigi ettevõtete lõikes. Vaikeväärtus: kasutaja vaikeettevõte.
--environment, -env Alistab keskkonna URL-i.
--json Väljundi toores JSON.

data count Näited

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

data create käsk

Looge andmetabelis uus kirje. Otsinguveergude seadmine süntaksi abil @odata.bind .

data create Parameetrid

Parameeter Kirjeldus
--table, -t Olemikomplekti nimi. Nõutav.
--data, -d JSON-objekt väljaväärtustega.
--data-file Kirjeandmetega JSON-faili tee.
--return, -r Tagastab täieliku loodud kirje.
--target Marsruutimine dataverse (vaikesäte) või lingitud erp keskkond.
--environment, -env Alistab keskkonna URL-i.
--json Väljundi toores JSON.

data create Näited

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

Näpunäide.

Sobib --data-file keeruka JSON-i jaoks. Selle abil --return --json saate hankida täieliku loodud kirje.

data delete käsk

Kustutage üks kirje primaarvõtme või alternatiivse võtme järgi.

data delete Parameetrid

Parameeter Kirjeldus
--table, -t Olemikomplekti nimi. Nõutav.
--id, -i Kirje GUID.
--key, -k Alternatiivne võti.
--no-confirm Jätke kinnitusviip vahele.
--target Marsruutimine dataverse (vaikesäte) või lingitud erp keskkond.
--environment, -env Alistab keskkonna URL-i.
--json Väljundi toores JSON.

data delete Näited

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

data describe käsk

Saate kirjeldada OData olemi skeemi. Dataverse'i korral kutsub käsk kõnesid EntityDefinitions(LogicalName='<table>')$expand , mille --includeautor on , ja teine kõne, kui customapis--include actions see on määratud. Sisseehitatud andmesammastoimingud (nt Assign ja SetState neid pole nummerdatud). ERP puhul tagastab üks kutse /Metadata/PublicEntities atribuute, seotud toiminguid ja navigeerimisi koos.

data describe Parameetrid

Parameeter Kirjeldus
--target Sihtmärk: dataverse (vaikeväärtus) või erp.
--table, -t Nõutav. Andmevärskendus – loogikanimi( nt account. ERP puhul olemikomplekti nimi( nt BatchJobs.
--include Komaeraldusega jaotiste loend, mis hõlmab: entity, properties, relations, actionsvõi all. Pseudonüümid: attributes=properties, . relationships=relations ERP vaikeväärtus: all. Dataverse'i vaikeväärtus: entity,properties.
--json Väljundi toores JSON.

data describe Näited

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

data disassociate käsk

Kahe kirje vahelise seose eemaldamine Seda käsku toetatakse ainult dataverse'i korral.

data disassociate parameetrid

Parameeter Kirjeldus
--table, -t Esmase kirje olemikomplekti nimi. Nõutav.
--id, -i Esmase kirje GUID. Nõutav.
--relationship, -rel Navigeerimisatribuudi nimi. Nõutav.
--related-id Seotud kirje GUID mitu-mitmele seose jaoks. Otsingu kustutamiseks jäetakse see parameeter välja.
--environment, -env Alistab keskkonna URL-i.
--json Väljundi toores JSON.

data disassociate Näited

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

data get käsk

Saate tuua ühe kirje ID (primaarvõtme) või alternatiivse võtme järgi.

data get Parameetrid

Parameeter Kirjeldus
--table, -t Olemikomplekti nimi. Nõutav.
--id, -i Kirje GUID (primaarvõti).
--key, -k Alternatiivne võti, näiteks "col='val'".
--select, -s Komaeraldusega veergude loend ($select).
--expand, -x OData $expand avaldis seotud kirjete jaoks.
--target Marsruutimine dataverse (vaikesäte) või lingitud erp keskkond.
--environment, -env Alistab keskkonna URL-i.
--json Väljundi toores JSON.

data get Näited

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 käsk

OData, FetchXML-i või SQL-päringu käivitamine dataverse-tabeli suhtes.

data query Parameetrid

Parameeter Kirjeldus
--table, -t Päringusse kaasatud olemikomplekti nimi. Nõutav OData päringute jaoks.
--select, -s Komaeraldusega veergude loend ($select).
--filter, -f OData $filter avaldis.
--orderby, -o OData $orderby avaldis.
--top Tagastatavate kirjete maksimumarv (1–5000).
--expand, -x OData $expand avaldis seotud kirjete jaoks.
--fetchxml Päring Tekstisisene FetchXML.
--fetchxml-file FetchXML-päringut sisaldava faili tee.
--sql SQL-päring SELECT (eelvaade).
--sql-file SQL-päringut sisaldava faili tee.
--all, -a Kõigi kirjete toomiseks järgige paginatsiooni.
--max-records Suurim lubatud arv kirjeid, mida rakenduse kasutamisel --alltuua. Vaikeväärtus: 100000.
--target Marsruutimine dataverse (vaikesäte) või lingitud erp keskkond.
--cross-company Ainult ERP. Päring kõigis ettevõtetes. Vaikeväärtus: kasutaja vaikeettevõte.
--environment, -env Alistab keskkonna URL-i.
--json Väljundi toores JSON.

data query Näited

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

Lisateave

data update käsk

Värskendage olemasoleva kirje ühte või mitut välja, mille ID või alternatiivvõti on tuvastatud. Otsinguveergude seadmine süntaksi abil @odata.bind .

data update Parameetrid

Parameeter Kirjeldus
--table, -t Olemikomplekti nimi. Nõutav.
--id, -i Kirje GUID.
--key, -k Alternatiivne võti.
--data, -d Värskendatava väljaga JSON-objekt.
--data-file JSON-faili tee koos värskendusandmetega.
--return, -r Tagastab täieliku värskendatud kirje.
--target Marsruutimine dataverse (vaikesäte) või lingitud erp keskkond.
--environment, -env Alistab keskkonna URL-i.
--json Väljundi toores JSON.

data update Näited

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

data upload käsk

Laadige kohalik fail üles olemasoleva kirje veergu Dataverse. Käsk valib failimahu põhjal automaatselt ühe- või mitmekordse üleslaadimise( v.a juhul, kui määrate ).--mode Automaatrežiimis laaditakse alla 128 MB failid üles ühe taotlusena ja suuremad failid kasutavad üleslaadimist. Kui te seda ei märgi --mime-type, tuletab käsk MIME-tüübi faililaiendist. Tundmatute laiendite vaikeväärtus on application/octet-stream.

data upload Parameetrid

Parameeter Kirjeldus
--table, -t Tabeliskeem või loogikanimi,nt account. Nõutav. Käsk lahendab olemikomplekti metaandmetest.
--id, -i Kirje GUID. Nõutav.
--column, -c Failiveeru atribuudi nimi. Nõutav.
--file, -f Kohaliku faili tee. Nõutav.
--mode, -m Üleslaadimise strateegia: auto (vaikesäte) smallvõi chunk.
--mime-type Otsene MIME-tüüp. Vaikesäte: tuletatud faililaiendist.
--overwrite Kirjuta olemasolev fail üle. Vaikimisi käsk nurjub, kui veerg pole tühi.
--environment, -env Alistab keskkonna URL-i.
--json Väljundi toores JSON.

data upload Näited

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 käsk

Looge kirje, kui seda pole olemas, või värskendage seda, kui seda pole. Kirjet tuvastab alternatiivne võti. Teave kirjele viitamise alternatiivse võtme kasutamise kohta

data upsert Parameetrid

Parameeter Kirjeldus
--table, -t Olemikomplekti nimi. Nõutav.
--key, -k Alternatiivne võti. Nõutav.
--data, -d JSON-objekt väljaväärtustega.
--data-file JSON-faili tee.
--update-only Nurjumine, kui kirjet pole olemas (If-Match: *).
--create-only Nurjumine, kui kirje on juba olemas (If-None-Match: *).
--return, -r Tagastab pärast toimingut kogu kirje.
--target Marsruutimine dataverse (vaikesäte) või lingitud erp keskkond.
--environment, -env Alistab keskkonna URL-i.
--json Väljundi toores JSON.

data upsert Näited

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

erp batch cancel käsk

Saate tühistada pakett-töö Rahandus ja Toimingud selle RecIdpoolt. Kasutage i erp batch list leidmiseks RecId.

erp batch cancel Näited

dataverse erp batch cancel <recid>

erp batch list käsk

Loetlege pakett-tööd finants- ja toimingueksemplaris, mis on lingitud teie Dataverse'i keskkonnaga. Käsk nõuab autentimisprofiili, mis on ühendatud Dataverse'i keskkonnaga, millel on lingitud finants- ja toimingueksemplar. Finants- ja toimingu-URL tuletatakse automaatselt praegusest andmeühendusest.

erp batch list parameetrid

Parameeter Kirjeldus
--company Filtreeri juriidilise isiku (dataAreaId), nt USMF.
--status Filtreeri oleku järgi: Waiting, , FinishedExecuting, Errorvõi Cancelled.
--top Tagastatavate tulemite maksimumarv. Vaikeväärtus: 20.
--caption Pealdise alusel filtreerimine (tõstutundetu substringi vaste).
--json Väljundi toores JSON.

erp batch list Näited

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

install käsk

Installige Dataverse CLI konkreetne versioon või võtke kasutusele uusim versioon. Käsk tuvastab, kas olete CLI globaalselt installinud või kasutate npx ja installib vastavalt.

install Näited

Installige uusim versioon:

dataverse install latest

Installige kindel versioon:

dataverse install 1.0.0

mcp käsk

Käivitab mudeli kontekstiprotokolli (MCP) serveri, mis loob ühenduse teie keskkonnaga, et tehisintellekti assistendid (nt Claude Desktop) saaksid teie andmeid kasutada. Sihtmärk tuvastatakse AUTOMAATSELT URL-ist: Dataverse URL käivitab Dataverse MCP-serveri ja rahanduse ja toimingute URL-i (nt https://myorg.operations.dynamics.com) käivitab ERP MCP-serveri.

mcp Süntaks

dataverse mcp <orgUrl> [options]

Argument <orgUrl> on teie ettevõtte URL, näiteks https://myorg.crm.dynamics.com.

mcp Parameetrid

Parameeter Kirjeldus
--validate Valideerige MCP lõpp-punktid ja autentimishäälestus serverit käivitamata.
--log-level Määrake logimistase: Trace, , InformationDebug, Warning, Errorvõi Critical. Vaikeväärtus: Warning.
--log-file Logige ajutises kataloogis asuvasse faili.
--preview Kasutage eelvaate MCP lõpp-punkti (api/mcp_preview mitte api/mcp). ERP ei toetata.

mcp Näited

Kontrollige häälestust (soovitatav esimene toiming):

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

Käivitage server stdio transpordi abil.

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

Kasutage eelvaate lõpp-punkti või lubage failide silumine.

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

mcp allow käsk

Veenduge, et Microsoft Entra rakendus oleks praeguse profiili keskkonna jaoks Dataverse MCP lubatud klientide loendis. See käsk on alternatiiv eeltingimustes kirjeldatud käsitsi administraatoritoimingule. Autenditud kasutajal peavad olema sihtkeskkonnas Dataverse'i administraatoriõigused.

mcp allow Süntaks

dataverse mcp allow <appId> [options]

Argument <appId> on rakenduse (klient) ID, mida saab GUID-na lubada.

mcp allow Parameetrid

Parameeter Kirjeldus
--erp Lubage rakendus andmevärskenduse asemel lingitud eksemplaris Rahandus ja Toimingud.

mcp allow Näited

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

Märkus.

Rahandus ja toimingud salvestavad AOS-is lubatud loendi vahemällu, nii et äsja lubatud rakenduse ID jõustumiseks võib kuluda kuni viis minutit.

org list käsk

Loetlege kõik keskkonnad, millele pääsete juurde.

org list Parameetrid

Parameeter Kirjeldus
--filter Saate keskkondade loendit filtreerida otsingutermini järgi.
--json Väljundi toores JSON.

org list Näited

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

org who käsk

Aktiivse autentimisprofiili abil saate kuvada teavet praeguse organisatsiooni ja kasutaja kohta. Käsk env on pseudonüüm.org

org who Parameetrid

Parameeter Kirjeldus
--environment, -env Alistab keskkonna URL-i.
--json Väljundi toores JSON.

org who Näited

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

skill Käsud

Saate hallata ühendatud keskkonnas talletatavaid andmevärskendusoskusi (korduvkasutatavaid juhiste kogumeid ( SKILL.md faili ja selle ressursifaile), mida TEI agendid kasutavad. Ülataseme skill käsud pakuvad keskkonnas loomis-, lugemis-, värskendamis- ja kustutamistoiminguid. Kohalikult salvestatakse oskused jaotises .claude/skills/<name>/.

Märkus.

Oskuse loomise ja hindamise käsud (nt make, update, getja eval) on nendest käskudest eraldi. Lisateabe saamiseks käivitage dataverse workspace skill --help.

skill delete käsk

Saate oskuse ja kõik selle ressursid aktiivsest Dataverse'i keskkonnast kustutada. Sobib skill list oskuse kordumatute nimede otsimiseks.

dataverse skill delete new_lead-qualification

skill download käsk

Laadige aktiivsest Dataverse'i keskkonnast kettale alla üks või mitu oskust. Käsk laadib alla faili ja kõik ressursifailid SKILL.md , säilitades kataloogi struktuuri. Sobib skill list oskuse kordumatute nimede otsimiseks.

Parameeter Kirjeldus
--all Laadige keskkonnast alla kõik aktiivsed oskused. Oskuse kordumatut nime ei saa kombineerida.
--output, -o Väljundi põhikataloog. Vaikeväärtus: .claude/skills/. With --all, iga oskus on kirjutatud <path>/<name>/.
--json Väljastage oskuste sisu JSON-ina ilma faile kirjutamata. Soovi korral saate määrata failitee, kuhu kirjutada. 
dataverse skill download new_lead-qualification
dataverse skill download --all --output ./skills

skill list käsk

Saate loetleda kõik aktiivsed oskused ühendatud Dataverse'i keskkonnas.

Parameeter Kirjeldus
--resources, -r Samuti loetlege iga oskuse ressursifailid.
--json Väljund JSON-ina. Soovi korral saate määrata failitee, kuhu kirjutada. 
dataverse skill list
dataverse skill list --resources

skill upload käsk

Saate ühe või mitu oskust kettalt aktiivsesse Dataverse'i keskkonda üles laadida. Käsk toetab katalooge, .zip faile, .skilli faile ja MD-faile .

Saate edastada oskuse <name>, mis laheneb .claude/skills/<name>/kaustale või <path> failile.

Parameeter Kirjeldus
--all Laadige kõik oskused üles jaotises .claude/skills/. Oskuse nime või teed ei saa kombineerida.
--json Väljastab tulemi JSON-ina. Soovi korral saate määrata failitee, kuhu kirjutada. 
dataverse skill upload lead-qualification
dataverse skill upload ./my-skill.zip
dataverse skill upload --all

Lisateave

Dataverse CLI abil andmetega töötamine

  • Last updated on