Dataverse CLI reference (predogled)

Opomba

  • To je funkcija predogleda.
  • Poskusne funkcije niso za komercialno uporabo, njihovo delovanje je lahko omejeno. Te funkcije so na voljo še pred uradno izdajo, da lahko stranke predčasno dostopajo do njih in posredujejo povratne informacije.

V tem članku so opisani ukazi, ki so na voljo v funkciji Dataverse CLI. Vsak ukaz podpira možnost --help , ki navaja njeno uporabo, možnosti in primere. Ukazi, ki vrnejo podatke, --json podpirajo možnost za neobdelani izhod JSON, ki je uporaben v skriptih.

S poljubnega ukaza lahko uporabite te globalne možnosti:

Možnost Description
--log-level <level> Nastavite raven pisanja dnevnika: Trace, Debug, Information, Warning, Errorali Critical. Privzeto: Warning.
--log-file Prijavite se v datoteko v začasnem imeniku namesto v konzoli.
--context <value> Kontekst postopka, dopet uporabniku posredniku. Nastavite lahko tudi spremenljivko DATAVERSE_OPERATION_CONTEXT okolja.
Command Description
api describe Opišite API
api invoke Priklic API-ja po imenu
api list Seznam api-jev, ki jih je mogoče odkriti
api request Pošiljanje zahteve HTTP s preverjeno pristnostjo
auth create Ustvarjanje novega profila za preverjanje pristnosti
auth list Seznam vseh profilov za preverjanje pristnosti
auth remove Odstranjevanje profila za preverjanje pristnosti
auth select Izberite aktivni profil za preverjanje pristnosti
auth who Pokaži trenutni profil za preverjanje pristnosti
data associate Povezovanje dveh zapisov prek relacije
data count Štetje zapisov v tabeli
data create Ustvarite nov zapis.
data delete Brisanje zapisa
data describe Opišite shemo entitete
data disassociate Odstranjevanje relacije med dvema zapisoma
data get Pridobivanje enega zapisa z ID-jem ali nadomestnim ključem
data query Izvajanje poizvedbe OData, FetchXML ali SQL
data update Posodobi obstoječi zapis
data upload Prenos datoteke v stolpec datoteke v obstoječem zapisu
data upsert Ustvarjanje ali posodabljanje zapisa z nadomestnim ključem
erp batch cancel Preklic paketne obdelave »Finance in operacije«
erp batch list Seznam paketnih poslov »Finance in operacije«
install Namestitev določene različice ali posodobitev na najnovejšo različico
mcp Zagon strežnika MCP za Dataverse ali ERP
mcp allow Dovoli aplikacijo kot odjemalec MCP
org list Navedi vsa dostopna okolja
org who Pokaži podatke o trenutni organizaciji in uporabniku
skill delete Brisanje znanja iz storitve Dataverse
skill download Prenos znanja iz storitve Dataverse
skill list Navedite aktivna znanja v okolju
skill upload Prenos znanja v Dataverse

Opomba

Številni ukazi podpirajo --target <dataverse\|erp> možnost, ki usmeri operacijo v Dataverse (privzeto) ali v povezano okolje Finance and Operations (ERP). Ukazi, ki se povezujejo z okoljem --environment <url> , podpirajo možnost (-env) za preglasitev URL-ja okolja trenutnega profila.

api describe ukaz

Pokaži metapodatke za en API. Za API-je po meri Dataverse izhod vključuje opis parametra zahteve in opise lastnosti odziva, ko jih metapodatki ponudijo.

Dataverse names are unprefixed by default. V obrazcu lahko uporabite imena, ki so določena za ERP erp:ServiceGroup/Service/Operation.

api describe Parametrov

Parameter Description
--target Razrešite nekvalificirano ime ali dataverseerp.
--service-group Samo ERP. Omejite iskanje operacije na eno skupino storitev.
--service Samo ERP. Omejite iskanje operacije na eno storitev.
--environment Preglasite URL okolja Dataverse.
--json Izhod neobdelane JSON.

api describe Primeri

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

api invoke ukaz

Po imenu prikliče odkriti API. Za parametre name=value uporabite sintakso. Če vrednost vsebuje presledke, narekovajte celoten žeton. Nekateri API-ji Dataverse sprejmejo parameter niza, katerega vsebina je sama po sebi JSON. V tem primeru podajte besedilo JSON kot vrednost tako, da uporabite običajna pravila citiranja in beganja lupine.

Odgovori JSON so privzeto upodobljeni v prijazni obliki besedila, ki ohrani imena izhodnih lastnosti. Uporablja --json se za ohranjanje neobdelane koristne vsebine JSON.

api invoke Parametrov

Parameter Description
--target Razrešite nekvalificirano ime ali dataverseerp.
--service-group Samo ERP. Omejite iskanje operacije na eno skupino storitev.
--service Samo ERP. Omejite iskanje operacije na eno storitev.
--param Dodajte imenovani parameter v name=value obrazcu. Ponovljivi.
--bind Pot vezave za vmesnike API Dataverse, vezane na entiteto.
--method, -X Preglasite metodo HTTP, ki je na voljo.
--body Namesto imenovanih parametrov uporabite neobdelano telo JSON.
--body-file Branje neobdelanega telesa JSON iz datoteke.
--header, -H Dodajte glavo HTTP v key:value obrazcu.
--include, -i Vključite stanje odgovora in glave.
--environment Preglasite URL okolja Dataverse.
--json Ustvari neobdelanI JSON namesto prijaznega besedila.

api invoke Primeri

Prikliče funkcijo Dataverse. V tem primeru je prikazana uporaba Dynamics 365 Contact Center CCaaS_GetPresence.

dataverse api invoke CCaaS_GetPresence ApiVersion=1.0

Prikliči dejanje Dataverse AISummarize s presledki v vrednosti parametra:

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

Priklic storitve po meri ERP:

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

api list ukaz

Navedite api-je, ki jih je mogoče odkriti, kot so API-ji Dataverse po meri in končne točke storitve, ki jih je mogoče odkriti z ERP. Rezultati prikazujejo identiteto API, prijazno ime, vrsto in opis, ko so na voljo. Če želite filtrirati rezultate, lahko podate izbirni izraz poizvedbe.

api list Parametrov

Parameter Description
--target Ciljni sistem za iskanje: dataverse (privzeto) ali erp.
--service-group Samo ERP. Filtrirajte v eno skupino storitev.
--service Samo ERP. Filtrirajte v eno storitev.
--limit Največje število API-jev, ki jih želite vrniti. Privzeto: 50.
--page Številka strani na osnovi 1 pri ostranjevanju rezultatov. Privzeto: 1.
--environment Preglasite URL okolja Dataverse.
--json Izhod neobdelane JSON.

api list Primeri

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 ukaz

Pošljite neobdelano zahtevo HTTP s preverjeno pristnostjo v Dataverse ali ERP. Ta ukaz uporabite, ko potrebujete popoln nadzor nad potjo, metodo, glavami in telom.

api request parametrih

Parameter Description
--target Ciljni sistem: dataverse ali erp. Obvezen.
--path Pot zahteve. Obvezen.
--method, -X Metoda HTTP. Privzeto: GETali ko POST je telo dobavljeno.
--body Telo zahteve JSON v vrstici.
--body-file Datoteka, ki vsebuje telo zahteve predmeta JSON.
--header, -H Dodajte glavo HTTP v key:value obrazcu.
--include, -i Vključite stanje odgovora in glave.
--environment Preglasite URL okolja Dataverse.

api request Primeri

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 ukaz

Ustvarite nov profil za preverjanje pristnosti.

auth create Parametrov

S temi parametri določite vedenje ukaza auth create .

Parameter Description
--environment, -env URL okolja Dataverse, v katerem želite preveriti pristnost.
--name, -n Izbirno ime profila. Z imenom izberite profil pozneje.
--cloud, -ci Ciljni oblak: Public, UsGov, UsGovHigh, UsGovDod, ali China.
--deviceCode, -dc Uporabite tok preverjanja pristnosti kode naprave za okolja brez brskalnika.
--username, -un Uporabniško ime za preverjanje pristnosti uporabniškega imena in gesla.
--password, -p Geslo za preverjanje pristnosti uporabniškega imena in gesla.
--applicationId, -id ID programa (odjemalca) za preverjanje pristnosti glavnega imena storitve (SPN).
--clientSecret, -cs Skrivnost odjemalca za glavno preverjanje pristnosti storitve.
--certificateDiskPath, -cdp Pot do datoteke s potrdilom .pfx za preverjanje pristnosti, ki temelji na potrdilu.
--certificatePassword, -cp Geslo za potrdilo.
--tenant, -t ID najemnika. Zahtevano za glavno preverjanje pristnosti storitve.
--managedIdentity, -mi Uporabite Azure identiteto.
--githubFederated, -ghf Uporabite GitHub Actions preverjanje pristnosti.
--azureDevOpsFederated, -adof Uporabite Azure DevOps preverjanje pristnosti.
--clientid, -cid ID odjemalca Microsoft Entra po meri za uporabo namesto privzete aplikacije Dataverse CLI.
--no-default-environment Ne nastavite okolja kot privzetega.
--accept-cleartext-caching Dovolite predpomnilnik žetona navadnega besedila v sistemu Linux.

auth create Primeri

V spodnjih primerih je prikazano, kako uporabite auth create ukaz.

Interaktivno preverjanje pristnosti

S tem ukazom odprete brskalnik ali sistemsko pogovorno okno za dodatne informacije.

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

Poimenovani profil

Ustvarite profil z določenim imenom.

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

Tok kode naprave

Tok kode naprave uporabite za okolja brez brskalnika.

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

Glavno ime storitve s skrivnostjo odjemalca

Glavno ime storitve uporabite, ko potrebujete nespremljano preverjanje pristnosti, na primer v cevovodu CI/CD ali drugem avtomatiziranem skriptu, kjer interaktivni vpis ni mogoč. Navedite ID aplikacije, skrivnost odjemalca in ID najemnika registracije aplikacije, ki ima dostop do okolja.

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

ID odjemalca aplikacije Entra po meri

Namesto privzete uporabite svojo registracijo aplikacije.

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

auth list ukaz

Navedite vse profile za preverjanje pristnosti. Dodaj za --json neobdelani izhod JSON.

auth list Primeri

dataverse auth list
dataverse auth list --json

auth remove ukaz

Odstranite enega ali vse profile za preverjanje pristnosti.

auth remove parametrih

Parameter Description
--index, -i Odstranite profil z določenim indeksom na osnovi 1, kot je prikazano v .auth list
--name, -n Odstranite profil z navedenim imenom.
--all Odstranite vse profile.

auth remove Primeri

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

auth select ukaz

Izberite aktivni profil za preverjanje pristnosti. Zaženite ukaz brez možnosti za seznam vseh profilov.

auth select Parametrov

Parameter Description
--index, -i Izberite profil po kazalu, ki temelji na 1, kot je prikazano v .auth list
--name, -n Izberite profil po imenu.

auth select Primeri

Odprite interaktivni izbirnik. S puščičnimi tipkami ali tipkajte za filtriranje:

dataverse auth select

Izberite profil po indeksu ali imenu:

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

auth who ukaz

Pokaži trenutni aktivni profil preverjanja pristnosti. Dodaj za --json neobdelani izhod JSON.

auth who Primeri

dataverse auth who
dataverse auth who --json

data associate ukaz

Povežite dva zapisa z lastnostjo krmarjenja (relacija). Ta ukaz je podprt le za Dataverse.

data associate parametrih

Parameter Description
--table, -t Ime nabora entitet primarnega zapisa. Obvezen.
--id, -i GUID primarnega zapisa. Obvezen.
--relationship, -rel Ime lastnosti krmarjenja. Obvezen.
--related Ime nabora entitet povezane tabele. Obvezen.
--related-id GUID povezanega zapisa. Obvezen.
--environment, -env Preglasite URL okolja.
--json Izhod neobdelane JSON.

data associate Primeri

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

data count ukaz

Preštejte zapise v tabeli, izbirno filtrirane.

data count Parametrov

Parameter Description
--table, -t Ime nabora entitet. Zahtevano, razen če uporabljate --fetchxml.
--filter, -f Izraz OData $filter .
--fetchxml Združevalna poizvedba FetchXML za kompleksna števila.
--target Usmeri v dataverse (privzeto) ali povezano erp okolje.
--cross-company Samo ERP. Štetje v vseh podjetjih. Privzeto: privzeto podjetje uporabnika.
--environment, -env Preglasite URL okolja.
--json Izhod neobdelane JSON.

data count Primeri

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

data create ukaz

Ustvarite nov zapis v tabeli »Dataverse«. Nastavite stolpce za iskanje s sintakso @odata.bind .

data create Parametrov

Parameter Description
--table, -t Ime nabora entitet. Obvezen.
--data, -d Predmet JSON z vrednostmi polja.
--data-file Pot do datoteke JSON s podatki zapisa.
--return, -r Vrni celoten ustvarjeni zapis.
--target Usmeri v dataverse (privzeto) ali povezano erp okolje.
--environment, -env Preglasite URL okolja.
--json Izhod neobdelane JSON.

data create Primeri

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

Namig

Uporabite --data-file za kompleksno funkcijo JSON. Uporablja --return --json se za pridobitev celotnega ustvarjenega zapisa.

data delete ukaz

Izbrišite en zapis s primarnim ključem ali z nadomestnim ključem.

data delete Parametrov

Parameter Description
--table, -t Ime nabora entitet. Obvezen.
--id, -i GUID zapisa.
--key, -k Nadomestni ključ.
--no-confirm Preskočite poziv za potrditev.
--target Usmeri v dataverse (privzeto) ali povezano erp okolje.
--environment, -env Preglasite URL okolja.
--json Izhod neobdelane JSON.

data delete Primeri

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

data describe ukaz

Opišite shemo entitete OData. Za Dataverse ukaz kliče z upravljano EntityDefinitions(LogicalName='<table>')$expand po --include, in drugi klic, ko customapis je --include actions nastavljen. Vgrajena dejanja Dataverse, na Assign primer SetState in niso oštevilčena. Za ERP en klic vrne lastnosti /Metadata/PublicEntities , vezana dejanja in krmarjenje skupaj.

data describe parametrih

Parameter Description
--target Cilj: dataverse (privzeto) ali erp.
--table, -t Obvezen. Za Dataverse logično ime, na primer account. Za ERP ime nabora entitet, na primer BatchJobs.
--include Seznam odsekov, ločenih z vejicami, ki vključuje: entity, relationsproperties, , actionsali all. Vzdevki: attributes=properties, . relationships=relations Privzeto za ERP: all. Privzeto za Dataverse: entity,properties.
--json Izhod neobdelane JSON.

data describe Primeri

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

data disassociate ukaz

Odstranjevanje relacije med dvema zapisoma. Ta ukaz je podprt le za Dataverse.

data disassociate Parametrov

Parameter Description
--table, -t Ime nabora entitet primarnega zapisa. Obvezen.
--id, -i GUID primarnega zapisa. Obvezen.
--relationship, -rel Ime lastnosti krmarjenja. Obvezen.
--related-id GUID povezanega zapisa za relacijo »mnogo proti mnogo«. Če želite počistiti iskanje, izpustite ta parameter.
--environment, -env Preglasite URL okolja.
--json Izhod neobdelane JSON.

data disassociate Primeri

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

data get ukaz

Pridobite en zapis z ID-jem (primarni ključ) ali z nadomestnim ključem.

data get parametrih

Parameter Description
--table, -t Ime nabora entitet. Obvezen.
--id, -i GUID zapisa (primarni ključ).
--key, -k Nadomestni ključ, na primer "col='val'".
--select, -s Seznam stolpcev(), ločenih z vejico$select.
--expand, -x Izraz OData $expand za povezane zapise.
--target Usmeri v dataverse (privzeto) ali povezano erp okolje.
--environment, -env Preglasite URL okolja.
--json Izhod neobdelane JSON.

data get Primeri

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 ukaz

Izvedite poizvedbo OData, FetchXML ali SQL v tabeli Dataverse.

data query Parametrov

Parameter Description
--table, -t Ime entitete je nastavljeno na poizvedbo. Zahtevano za poizvedbe OData.
--select, -s Seznam stolpcev(), ločenih z vejico$select.
--filter, -f Izraz OData $filter .
--orderby, -o Izraz OData $orderby .
--top Največje število vrnjenih zapisov (1–5000).
--expand, -x Izraz OData $expand za povezane zapise.
--fetchxml Poizvedba FetchXML v vrstici.
--fetchxml-file Pot do datoteke, ki vsebuje poizvedbo FetchXML.
--sql Poizvedba SQL SELECT (predogled).
--sql-file Pot do datoteke, ki vsebuje poizvedbo SQL.
--all, -a Če želite pridobiti vse zapise, upoštevajte oštevilči strani.
--max-records Največje število zapisov, ki jih želite pridobiti pri uporabi --all. Privzeto: 100000.
--target Usmeri v dataverse (privzeto) ali povezano erp okolje.
--cross-company Samo ERP. Poizvedba v vseh podjetjih. Privzeto: privzeto podjetje uporabnika.
--environment, -env Preglasite URL okolja.
--json Izhod neobdelane JSON.

data query Primeri

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

Več informacij

data update ukaz

Posodobite eno ali več polj v obstoječem zapisu, prepoznanih z ID-jem ali nadomestnim ključem. Nastavite stolpce za iskanje s sintakso @odata.bind .

data update Parametrov

Parameter Description
--table, -t Ime nabora entitet. Obvezen.
--id, -i GUID zapisa.
--key, -k Nadomestni ključ.
--data, -d Predmet JSON s polji, ki jih želite posodobiti.
--data-file Pot do datoteke JSON s podatki o posodobitvi.
--return, -r Vrnitev celotnega posodobljenega zapisa.
--target Usmeri v dataverse (privzeto) ali povezano erp okolje.
--environment, -env Preglasite URL okolja.
--json Izhod neobdelane JSON.

data update Primeri

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

data upload ukaz

Prenesite lokalno datoteko v stolpec »Dataverse« v obstoječem zapisu. Ukaz samodejno izbere eno zahtevo ali delni prenos glede na velikost datoteke, razen če ne določite --mode. V samodejnem načinu se datoteke, ki so pod 128 MB, prenesejo v eno zahtevo, večje datoteke pa uporabljajo prenesene datoteke z razdelkom. Ko izpustite , --mime-typeukaz določi vrsto MIME iz datotene pripone. Neznane pripone so privzeto za application/octet-stream.

data upload Parametrov

Parameter Description
--table, -t Shema tabele ali logično ime, na primer account. Obvezen. Ukaz razreši nabor entitet iz metapodatkov.
--id, -i GUID zapisa. Obvezen.
--column, -c Ime atributa stolpca datoteke. Obvezen.
--file, -f Pot do lokalne datoteke. Obvezen.
--mode, -m Strategija prenosa: auto (privzeto), small, ali chunk.
--mime-type Eksplicitna vrsta MIME. Privzeto: iz datotečna pripona.
--overwrite Prepiši obstoječo datoteko. Ukaz privzeto ne uspe, če stolpec ni prazen.
--environment, -env Preglasite URL okolja.
--json Izhod neobdelane JSON.

data upload Primeri

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 ukaz

Ustvarite zapis, če ne obstaja, ali ga posodobite, če obstaja. Zapis je prepoznan z nadomestnim ključem. Naučite se uporabiti nadomestni ključ za sklicevanje na zapis

data upsert Parametrov

Parameter Description
--table, -t Ime nabora entitet. Obvezen.
--key, -k Nadomestni ključ. Obvezen.
--data, -d Predmet JSON z vrednostmi polja.
--data-file Pot do datoteke JSON.
--update-only Ne uspe, če zapis ne obstaja (If-Match: *).
--create-only Ne uspe, če zapis že obstaja (If-None-Match: *).
--return, -r Po operaciji vrni celoten zapis.
--target Usmeri v dataverse (privzeto) ali povezano erp okolje.
--environment, -env Preglasite URL okolja.
--json Izhod neobdelane JSON.

data upsert Primeri

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

erp batch cancel ukaz

Prekličite paketno obdelavo Finance in operacije po svoji RecId. Uporabite erp batch list , če želite poiskati RecId.

erp batch cancel Primeri

dataverse erp batch cancel <recid>

erp batch list ukaz

Navedite paketne posle v primerku Finance in Operations, ki je povezan z vašim okoljem Dataverse. Ukaz zahteva profil za preverjanje pristnosti, povezan z okoljem Dataverse, ki ima povezan primerek Finance in Operations. URL finance in operacije je samodejno izpeljan iz trenutne podatkovne povezave.

erp batch list Parametrov

Parameter Description
--company Filtrirajte po pravni entiteti (dataAreaId), na primer USMF.
--status Filtrirajte po stanju: Waiting, Executing, Finished, Error, ali Cancelled.
--top Največje število vrnjenih rezultatov. Privzeto: 20.
--caption Filtriraj po napisu (ujemanje podniza, ki ne razlikuje med malimi in velikimi črkami).
--json Izhod neobdelane JSON.

erp batch list Primeri

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

install ukaz

Namestite določeno različico strežnika Dataverse CLI ali posodobite na najnovejšo različico. Ukaz zazna, ali ste cli namestili globalno ali pa uporabljate npx in ustrezno namesti.

install Primeri

Namestite najnovejšo različico:

dataverse install latest

Namestite določeno različico:

dataverse install 1.0.0

mcp ukaz

Zažene strežnik MCP (Model Context Protocol), ki se poveže z vašim okoljem, tako da lahko pomočniki za AI, kot je Namizje Claude, komunicirajo z vašimi podatki. Cilj je samodejno zaznan iz URL-ja: Url Dataverse zažene strežnik Dataverse MCP, URL finance in operacije pa https://myorg.operations.dynamics.comzažene strežnik ERP MCP.

mcp Sintaksa

dataverse mcp <orgUrl> [options]

Argument <orgUrl> je URL vaše organizacije, na primer https://myorg.crm.dynamics.com.

mcp Parametrov

Parameter Description
--validate Preverite veljavnost končnih točk MCP in nastavitev preverjanja pristnosti, ne da bi zagnali strežnik.
--log-level Nastavite raven pisanja dnevnika: Trace, Debug, Information, Warning, Errorali Critical. Privzeto: Warning.
--log-file Prijavite se v datoteko v začasnem imeniku.
--preview Uporabite končno točko MCP predogleda (api/mcp_preview namesto api/mcp). Ni podprto za ERP.

mcp Primeri

Preverite veljavnost nastavitve (priporočeni prvi korak):

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

Zaženite strežnik z uporabo stdio prevoz:

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

Uporabite končno točko predogleda ali omogočite zapisovanje v dnevnik datotek za iskanje napak:

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

mcp allow ukaz

Prepričajte se, Microsoft Entra program na seznamu dovoljenih odjemalcev Dataverse MCP za okolje trenutnega profila. Ta ukaz je alternativa koraku ročnega skrbnika, ki je opisan v zahtevah. Uporabnik s preverjeno pristnostjo mora imeti skrbniška dovoljenja za Dataverse v ciljnem okolju.

mcp allow Sintaksa

dataverse mcp allow <appId> [options]

Argument <appId> je ID aplikacije (odjemalca), ki ga želite dovoliti, kot GUID.

mcp allow parametrih

Parameter Description
--erp Dovolite aplikacijo v povezanem primerku Finance in Operations namesto Dataverse.

mcp allow Primeri

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

Opomba

Finance in Operations predpomni seznam dovoljenih v AOS, tako da lahko novo dovoljeni ID aplikacije traja do pet minut, da se uveljavi.

org list ukaz

Navedite vsa okolja, do katere lahko dostopate.

org list Parametrov

Parameter Description
--filter Filtrirajte seznam okolij z iskanim izrazom.
--json Izhod neobdelane JSON.

org list Primeri

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

org who ukaz

Z aktivnim profilom za preverjanje pristnosti prikažite informacije o trenutni organizaciji in uporabniku. Ukaz env je vzdevek za org.

org who Parametrov

Parameter Description
--environment, -env Preglasite URL okolja.
--json Izhod neobdelane JSON.

org who Primeri

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

skill Ukazi

Upravljajte znanje storitve Dataverse – nabore navodil za vnovično uporabo ( SKILL.md datoteko in njene datoteke sredstev), ki jih uporabljajo posredniki za UI – ki so shranjeni v povezanem okolju. Ukazi najvišje ravni skill omogočajo postopke ustvarjanja, branja, posodabljanja in brisanja v okolju. Lokalno so znanja shranjena v razdelku .claude/skills/<name>/.

Opomba

Ukazi za ustvarjanje in vrednotenje znanja, kot makeso , update, getin eval, so ločeni od teh ukazov. Če želite več informacij, zaženite dataverse workspace skill --help.

skill delete ukaz

Izbrišite znanje in vse njene vire iz aktivnega okolja Dataverse. Uporabite, skill list če želite poiskati enolična imena znanj.

dataverse skill delete new_lead-qualification

skill download ukaz

Prenesite eno ali več znanj iz aktivnega okolja Dataverse na disk. Ukaz prenese datoteko in SKILL.md vse datoteke sredstev, pri tem pa ohrani strukturo imenika. Uporabite, skill list če želite poiskati enolična imena znanj.

Parameter Description
--all Prenesite vsa aktivna znanja iz okolja. Ni mogoče združiti z enoličnim imenom znanja.
--output, -o Osnovni imenik za izhod. Privzeto: .claude/skills/. Z --all, je vsako znanje napisano na <path>/<name>/.
--json Vsebino znanja prikažite kot JSON brez pisanja datotek. Po želji lahko določite pot datoteke za pisanje. 
dataverse skill download new_lead-qualification
dataverse skill download --all --output ./skills

skill list ukaz

Navedite vsa aktivna znanja v povezanem okolju Dataverse.

Parameter Description
--resources, -r Navedite tudi datoteke sredstev za vsako znanje.
--json Izhod kot JSON. Po želji lahko določite pot datoteke za pisanje. 
dataverse skill list
dataverse skill list --resources

skill upload ukaz

Prenesite eno ali več znanj z diska v aktivno okolje Dataverse. Ukaz podpira imenike ,.zip datoteke, datoteke .skill in datoteke .md .

V imeniku ali datoteki <name>lahko prenesete .claude/skills/<name>/znanje, ki se razreši v , <path> ali eksplicitno.

Parameter Description
--all Naložite vsa znanja v razdelku .claude/skills/. Ni mogoče združiti z imenom ali potjo znanja.
--json Izhod rezultata kot JSON. Po želji lahko določite pot datoteke za pisanje. 
dataverse skill upload lead-qualification
dataverse skill upload ./my-skill.zip
dataverse skill upload --all

Glejte tudi

Delo s podatki s funkcijo Dataverse CLI

  • Last updated on