Dataverse CLI-referencia (előzetes verzió)

Note

  • Ez egy előnézeti funkció.
  • Az előzetes funkciókat nem célszerű termelési környezetben használni, és előfordulhat, hogy korlátozott funkcionalitással rendelkeznek. Ezek a funkciók a hivatalos kiadás előtt érhetők el, hogy az ügyfelek korán megismerkedhessenek velük, és visszajelzést adhassanak róluk.

Ez a cikk a Dataverse parancssori felületén elérhető parancsokat ismerteti. Minden parancs támogat egy --help olyan beállítást, amely felsorolja a használatát, a beállításait és a példákat. Az adatokat visszaíró parancsok támogatják --json a szkriptekben hasznos nyers JSON-kimenetet.

A következő globális beállítások bármelyik paranccsal használhatók:

Option Description
--log-level <level> A naplózási szint beállítása: Trace, Debug, Information, Warning, Errorvagy Critical. Alapértelmezett: Warning.
--log-file Jelentkezzen be egy fájlba az ideiglenes könyvtárban a konzol helyett.
--context <value> A user-agenthez hozzáfűzött műveleti környezet. A környezeti változót is beállíthatja DATAVERSE_OPERATION_CONTEXT .
Command Description
api describe API leírása
api invoke API meghívása név alapján
api list Felderíthető API-k listázása
api request Hitelesített HTTP-kérés küldése
auth create Új hitelesítési profil létrehozása
auth list Az összes hitelesítési profil listázása
auth remove Hitelesítési profil eltávolítása
auth select Válassza ki az aktív hitelesítési profilt
auth who Az aktuális hitelesítési profil megjelenítése
data associate Két rekord összekapcsolása kapcsolaton keresztül
data count Rekordok megszámlálása egy táblában
data create Új rekord létrehozása
data delete Rekord törlése
data describe Egy entitás sémájának leírása
data disassociate Kapcsolat eltávolítása két rekord között
data get Egyetlen rekord lekérése azonosító vagy másodlagos kulcs alapján
data query OData-, FetchXML- vagy SQL-lekérdezés végrehajtása
data update Egy létező rekord frissítése
data upload Fájl feltöltése meglévő rekord fájloszlopára
data upsert Rekord létrehozása vagy frissítése másodlagos kulccsal
erp batch cancel Pénzügyi és üzemeltetési kötegelt feladat megszakítása
erp batch list Pénzügyi és üzemeltetési kötegelt feladatok listázása
install Adott verzió telepítése vagy frissítés a legújabb verzióra
mcp A Dataverse vagy az ERP MCP-kiszolgálójának elindítása
mcp allow Alkalmazás engedélyezése MCP-ügyfélként
org list Az összes akadálymentes környezet listázása
org who Aktuális szervezeti és felhasználói adatok megjelenítése
skill delete Képesség törlése a Dataverse-ből
skill download Képesség letöltése a Dataverse-ből
skill list Aktív készségek listázása a környezetben
skill upload Képesség feltöltése a Dataverse-be

Note

Számos parancs támogatja --target <dataverse\|erp> azt a lehetőséget, amely a műveletet a Dataverse (alapértelmezett) vagy a csatolt Pénzügyi és üzemeltetési (ERP) környezetbe irányítja. A környezethez csatlakozó parancsok támogatják --environment <url> a (-env) beállítást az aktuális profil környezeti URL-címének felülbírálásához.

api describe parancs

Egyetlen API metaadatainak megjelenítése. A Dataverse egyéni API-k esetében a kimenet a kérelemparaméter és a választulajdonság leírását tartalmazza, amikor a metaadatok biztosítják őket.

Az adatversek neve alapértelmezés szerint elavult. Az űrlapon erp:ServiceGroup/Service/OperationERP-minősítéssel rendelkező neveket is használhat.

api describe Paraméterek

Parameter Description
--target A nem minősített név feloldása a vagy a dataverseerp.
--service-group Csak ERP. A műveletkeresés szűkítése egy szolgáltatáscsoportra.
--service Csak ERP. A műveletkeresés szűkítése egy szolgáltatásra.
--environment Felülbírálja a Dataverse-környezet URL-címét.
--json Kimeneti nyers JSON.

api describe példák

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

api invoke parancs

Felderített API meghívása név alapján. Használja name=value a paraméterek szintaxisát. Ha egy érték szóközöket tartalmaz, idézi a teljes jogkivonatot. Egyes Dataverse API-k olyan sztringparamétert fogadnak el, amelynek tartalma maga JSON. Ebben az esetben adja át a JSON-szöveget értékként a rendszerhéj szokásos idéző és menekülő szabályainak használatával.

Alapértelmezés szerint a JSON-válaszok rövid szöveges formátumban jelennek meg, amely megőrzi a kimeneti tulajdonságneveket. A nyers JSON-hasznos adatok megőrzésére szolgál --json .

api invoke Paraméterek

Parameter Description
--target A nem minősített név feloldása a vagy a dataverseerp.
--service-group Csak ERP. A műveletkeresés szűkítése egy szolgáltatáscsoportra.
--service Csak ERP. A műveletkeresés szűkítése egy szolgáltatásra.
--param Adjon hozzá egy elnevezett paramétert űrlapon name=value . Ismételhető.
--bind Az entitáshoz kötött Dataverse API-k kötési elérési útja.
--method, -X Bírálja felül a következő HTTP-metódust.
--body Névvel ellátott paraméterek helyett használjon nyers JSON-törzset.
--body-file Nyers JSON-törzs beolvasása fájlból.
--header, -H HTTP-fejléc hozzáadása űrlapon key:value .
--include, -i Adja meg a válasz állapotát és fejléceit.
--environment Felülbírálja a Dataverse-környezet URL-címét.
--json Egyszerű szöveg helyett nyers JSON-kimenet.

api invoke példák

Dataverse-függvény meghívása. Ez a példa a Dynamics 365 Contact Center CCaaS_GetPresence függvény használatát mutatja be.

dataverse api invoke CCaaS_GetPresence ApiVersion=1.0

A Dataverse AISummarize művelet meghívása paraméterértékben lévő szóközökkel:

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

Egyéni ERP-szolgáltatás meghívása:

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

api list parancs

Listázzon felderíthető API-kat, például a Dataverse egyéni API-kat és az ERP visszavonhatatlan szolgáltatásvégpontokat. Az eredmények az API-identitást, a rövid nevet, a típust és a leírást jelenítik meg, ha elérhetőek. Az eredmények szűréséhez megadhat egy opcionális lekérdezési kifejezést.

api list Paraméterek

Parameter Description
--target A keresés célrendszere: dataverse (alapértelmezett) vagy erp.
--service-group Csak ERP. Szűrés egyetlen szolgáltatáscsoportra.
--service Csak ERP. Szűrés egyetlen szolgáltatásra.
--limit A visszaadandó API-k maximális száma. Alapértelmezett: 50.
--page Az 1-alapú oldalszám az eredmények lapozásakor. Alapértelmezett: 1.
--environment Felülbírálja a Dataverse-környezet URL-címét.
--json Kimeneti nyers JSON.

api list példák

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 parancs

Nyers hitelesített HTTP-kérés küldése a Dataverse-nek vagy az ERP-nek. Ezt a parancsot akkor használja, ha teljes körűen szabályoznia kell az elérési utat, a metódust, az élőfejeket és a törzset.

api request Paraméterek

Parameter Description
--target A célrendszer: dataverse vagy erp. Required.
--path A kérelem elérési útja. Required.
--method, -X Az HTTP módszer. Alapértelmezett: GETvagy POST ha egy törzs van megadva.
--body Beágyazott JSON-kérelem törzse.
--body-file Egy JSON-objektumkérelem törzsét tartalmazó fájl.
--header, -H HTTP-fejléc hozzáadása űrlapon key:value .
--include, -i Adja meg a válasz állapotát és fejléceit.
--environment Felülbírálja a Dataverse-környezet URL-címét.

api request példák

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 parancs

Hozzon létre egy új hitelesítési profilt.

auth create Paraméterek

Ezekkel a paraméterekkel adhatja meg a parancs viselkedését auth create .

Parameter Description
--environment, -env Annak a Dataverse-környezetnek az URL-címe, amellyel hitelesíteni szeretne.
--name, -n A profil nem kötelező neve. A névvel később válassza ki a profilt.
--cloud, -ci A célfelhő: Public, UsGov, UsGovHigh, UsGovDodvagy China.
--deviceCode, -dc Használja az eszközkód hitelesítési folyamatát böngésző nélküli környezetekhez.
--username, -un A felhasználónév és a jelszóhitelesítés felhasználóneve.
--password, -p A felhasználónév és a jelszóhitelesítés jelszava.
--applicationId, -id A szolgáltatásnév (SPN) hitelesítésének alkalmazás-(ügyfél-) azonosítója.
--clientSecret, -cs A szolgáltatásnév-hitelesítés ügyfélkódja.
--certificateDiskPath, -cdp A tanúsítványalapú hitelesítés .pfx tanúsítványfájljának elérési útja.
--certificatePassword, -cp A tanúsítvány jelszava.
--tenant, -t A bérlő azonosítója. A szolgáltatásnév hitelesítéséhez szükséges.
--managedIdentity, -mi Használjon Azure felügyelt identitást.
--githubFederated, -ghf GitHub Actions összevont hitelesítés használata.
--azureDevOpsFederated, -adof Használjon Azure DevOps összevont hitelesítést.
--clientid, -cid Egy egyéni Microsoft Entra alkalmazás ügyfél-azonosítóját, amelyet az alapértelmezett Dataverse CLI-alkalmazás helyett használhat.
--no-default-environment Ne állítsa be a környezetet alapértelmezettként.
--accept-cleartext-caching Egyszerű szöveges tokengyorsítótár engedélyezése Linuxon.

auth create példák

Az alábbi példák bemutatják a auth create parancs használatát.

Interaktív hitelesítés

Ez a parancs megnyitja a böngésző vagy a rendszer párbeszédpanelét további információkért.

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

Elnevezett profil

Hozzon létre egy profilt egy adott névvel.

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

Az eszközkód beolvasási folyamata

Használja az eszközkód-folyamatot böngésző nélküli környezetekhez.

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

Szolgáltatásazonosító ügyféltitokkal

Használjon egyszerű szolgáltatást, ha felügyelet nélküli hitelesítésre van szüksége, például EGY CI-/CD-folyamatban vagy egy másik automatizált szkriptben, ahol az interaktív bejelentkezés nem lehetséges. Adja meg a környezethez hozzáféréssel rendelkező alkalmazásregisztráció alkalmazásazonosítóját, ügyfélkulcsát és bérlőazonosítóját.

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

Egyéni Entra-alkalmazás ügyfélazonosítója

Az alapértelmezett helyett használja a saját alkalmazásregisztrációját.

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

auth list parancs

Az összes hitelesítési profil listázása. Hozzáadás --json nyers JSON-kimenethez.

auth list példák

dataverse auth list
dataverse auth list --json

auth remove parancs

Távolítsa el az egyik vagy az összes hitelesítési profilt.

auth remove Paraméterek

Parameter Description
--index, -i Távolítsa el a profilt a megadott 1-alapú index használatával, ahogyan az a következőben auth listlátható.
--name, -n Távolítsa el a profilt a megadott névvel.
--all Távolítsa el az összes profilt.

auth remove példák

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

auth select parancs

Válassza ki az aktív hitelesítési profilt. Futtassa a parancsot beállítások nélkül az összes profil listázásához.

auth select Paraméterek

Parameter Description
--index, -i Válassza ki a profilt az 1-alapú index alapján, ahogy az a következőben auth listlátható.
--name, -n Válassza ki a profilt név szerint.

auth select példák

Nyisson meg egy interaktív választót. Használja a nyílbillentyűket, vagy írja be a szűrést:

dataverse auth select

Profil kiválasztása index vagy név szerint:

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

auth who parancs

Az aktuális, aktív hitelesítési profil megjelenítése. Hozzáadás --json nyers JSON-kimenethez.

auth who példák

dataverse auth who
dataverse auth who --json

data associate parancs

Két rekord társítása navigációs tulajdonságon (kapcsolaton) keresztül. Ez a parancs csak a Dataverse esetében támogatott.

data associate Paraméterek

Parameter Description
--table, -t Az elsődleges rekord entitáskészletének neve. Required.
--id, -i Az elsődleges rekord GUID azonosítója. Required.
--relationship, -rel A navigációs tulajdonság neve. Required.
--related A kapcsolódó tábla entitáskészletének neve. Required.
--related-id A kapcsolódó rekord GUID azonosítója. Required.
--environment, -env Bírálja felül a környezeti URL-címet.
--json Kimeneti nyers JSON.

data associate példák

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

data count parancs

Tábla rekordjainak megszámlálása, igény szerint szűrve.

data count Paraméterek

Parameter Description
--table, -t Az entitáskészlet neve. Kötelező, hacsak nem használja --fetchxml.
--filter, -f OData-kifejezés $filter .
--fetchxml FetchXML-összesítő lekérdezés összetett számokhoz.
--target Útvonal az dataverse (alapértelmezett) vagy a csatolt környezetbe erp .
--cross-company Csak ERP. Minden vállalatra kiterjedő szám. Alapértelmezett: a felhasználó alapértelmezett vállalata.
--environment, -env Bírálja felül a környezeti URL-címet.
--json Kimeneti nyers JSON.

data count példák

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

data create parancs

Hozzon létre egy új rekordot egy Dataverse-táblában. Keresési oszlopok beállítása szintaxis használatával @odata.bind .

data create Paraméterek

Parameter Description
--table, -t Az entitáskészlet neve. Required.
--data, -d JSON-objektum a mezőértékekkel.
--data-file Egy JSON-fájl elérési útja a rekordadatokkal.
--return, -r Adja vissza a teljes létrehozott rekordot.
--target Útvonal az dataverse (alapértelmezett) vagy a csatolt környezetbe erp .
--environment, -env Bírálja felül a környezeti URL-címet.
--json Kimeneti nyers JSON.

data create példák

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

Tip

Összetett JSON-hoz használható --data-file . A teljes létrehozott rekord lekérésére használható --return --json .

data delete parancs

Egyetlen rekord törlése az elsődleges kulccsal vagy egy másik kulccsal.

data delete Paraméterek

Parameter Description
--table, -t Az entitáskészlet neve. Required.
--id, -i A rekord GUID azonosítója.
--key, -k Egy másik kulcs.
--no-confirm Hagyja ki a megerősítési kérést.
--target Útvonal az dataverse (alapértelmezett) vagy a csatolt környezetbe erp .
--environment, -env Bírálja felül a környezeti URL-címet.
--json Kimeneti nyers JSON.

data delete példák

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

data describe parancs

OData-entitás sémájának leírása. A Dataverse esetében a parancs a vezérléssel--include, EntityDefinitions(LogicalName='<table>') valamint egy második hívással $expand hívja meg, customapis hogy mikor --include actions van beállítva. Beépített Dataverse-műveletek, például AssignSetState a felsorolásuk nem. Az ERP esetében egyetlen hívás, amely /Metadata/PublicEntities a tulajdonságokat, a kötött műveleteket és a navigációkat együttesen adja vissza.

data describe Paraméterek

Parameter Description
--target A cél: dataverse (alapértelmezett) vagy erp.
--table, -t Required. Dataverse esetén a logikai név, például account. Az ERP esetében az entitáskészlet neve, például BatchJobs.
--include A következő szakaszok vesszővel tagolt listája: entity, properties, relations, actionsvagy all. Aliasok: attributes=properties, relationships=relations. Az ERP alapértelmezett beállítása: all. A Dataverse alapértelmezett értéke: entity,properties.
--json Kimeneti nyers JSON.

data describe példák

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

data disassociate parancs

Két rekord közötti kapcsolat eltávolítása. Ez a parancs csak a Dataverse esetében támogatott.

data disassociate Paraméterek

Parameter Description
--table, -t Az elsődleges rekord entitáskészletének neve. Required.
--id, -i Az elsődleges rekord GUID azonosítója. Required.
--relationship, -rel A navigációs tulajdonság neve. Required.
--related-id A kapcsolódó rekord GUID azonosítója egy több-a-többhöz kapcsolathoz. Kihagyja ezt a paramétert a keresés törléséhez.
--environment, -env Bírálja felül a környezeti URL-címet.
--json Kimeneti nyers JSON.

data disassociate példák

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

data get parancs

Egyetlen rekord lekérése az azonosító (elsődleges kulcs) vagy egy másik kulcs alapján.

data get Paraméterek

Parameter Description
--table, -t Az entitáskészlet neve. Required.
--id, -i A rekord GUID azonosítója (elsődleges kulcs).
--key, -k Egy másik kulcs, például "col='val'".
--select, -s Oszlopok vesszővel tagolt listája ($select).
--expand, -x OData-kifejezés $expand a kapcsolódó rekordokhoz.
--target Útvonal az dataverse (alapértelmezett) vagy a csatolt környezetbe erp .
--environment, -env Bírálja felül a környezeti URL-címet.
--json Kimeneti nyers JSON.

data get példák

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 parancs

OData-, FetchXML- vagy SQL-lekérdezés végrehajtása Dataverse-táblán.

data query Paraméterek

Parameter Description
--table, -t Az entitás a lekérdezés nevét állítja be. OData-lekérdezésekhez szükséges.
--select, -s Oszlopok vesszővel tagolt listája ($select).
--filter, -f OData-kifejezés $filter .
--orderby, -o OData-kifejezés $orderby .
--top A visszaadandó rekordok maximális száma (1-5000).
--expand, -x OData-kifejezés $expand a kapcsolódó rekordokhoz.
--fetchxml Beágyazott FetchXML-lekérdezés.
--fetchxml-file Egy FetchXML-lekérdezést tartalmazó fájl elérési útja.
--sql SQL-lekérdezés SELECT (előzetes verzió).
--sql-file Sql-lekérdezést tartalmazó fájl elérési útja.
--all, -a Az összes rekord lekéréséhez kövesse a lapozást.
--max-records A beolvasandó rekordok maximális száma a használat --allsorán. Alapértelmezett: 100000.
--target Útvonal az dataverse (alapértelmezett) vagy a csatolt környezetbe erp .
--cross-company Csak ERP. Lekérdezés az összes vállalatnál. Alapértelmezett: a felhasználó alapértelmezett vállalata.
--environment, -env Bírálja felül a környezeti URL-címet.
--json Kimeneti nyers JSON.

data query példák

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

Learn more

data update parancs

Frissítsen egy vagy több mezőt egy meglévő rekordon, amelyet az azonosítója vagy egy másik kulcs azonosít. Keresési oszlopok beállítása szintaxis használatával @odata.bind .

data update Paraméterek

Parameter Description
--table, -t Az entitáskészlet neve. Required.
--id, -i A rekord GUID azonosítója.
--key, -k Egy másik kulcs.
--data, -d JSON-objektum a frissíteni kívánt mezőkkel.
--data-file Egy JSON-fájl elérési útja a frissítési adatokkal.
--return, -r Adja vissza a teljes frissített rekordot.
--target Útvonal az dataverse (alapértelmezett) vagy a csatolt környezetbe erp .
--environment, -env Bírálja felül a környezeti URL-címet.
--json Kimeneti nyers JSON.

data update példák

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

data upload parancs

Töltsön fel egy helyi fájlt egy meglévő rekord Dataverse-fájloszlopába. A parancs automatikusan kiválaszt egy egyetlen kérést vagy egy darabolt feltöltést a fájlméret alapján, hacsak nem adja meg --mode. Automatikus módban a 128 MB-nál kisebb fájlok egyetlen kérelemben lesznek feltöltve, a nagyobb fájlok pedig darabolt feltöltést használnak. Ha kihagyja --mime-type, a parancs a MIME típusát a fájlkiterjesztésből következteti. Az ismeretlen bővítmények alapértelmezés szerint a .application/octet-stream

data upload Paraméterek

Parameter Description
--table, -t A táblaséma vagy logikai név, például account. Required. A parancs metaadatokból oldja fel az entitáskészletet.
--id, -i A rekord GUID azonosítója. Required.
--column, -c A fájloszlop attribútumának neve. Required.
--file, -f A helyi fájl elérési útja. Required.
--mode, -m A feltöltési stratégia: auto (alapértelmezett) smallvagy chunk.
--mime-type Explicit MIME-típus. Alapértelmezett: a fájlkiterjesztésből következtetett.
--overwrite Meglévő fájl felülírása. Alapértelmezés szerint a parancs meghiúsul, ha az oszlop nem üres.
--environment, -env Bírálja felül a környezeti URL-címet.
--json Kimeneti nyers JSON.

data upload példák

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 parancs

Hozzon létre egy rekordot, ha nem létezik, vagy frissítse, ha igen. A rekordot egy másik kulcs azonosítja. Megtudhatja, hogyan használhat másik kulcsot egy rekordra való hivatkozáshoz

data upsert Paraméterek

Parameter Description
--table, -t Az entitáskészlet neve. Required.
--key, -k Egy másik kulcs. Required.
--data, -d JSON-objektum a mezőértékekkel.
--data-file Egy JSON-fájl elérési útja.
--update-only Sikertelen, ha a rekord nem létezik (If-Match: *).
--create-only Sikertelen, ha a rekord már létezik (If-None-Match: *).
--return, -r A művelet után adja vissza a teljes rekordot.
--target Útvonal az dataverse (alapértelmezett) vagy a csatolt környezetbe erp .
--environment, -env Bírálja felül a környezeti URL-címet.
--json Kimeneti nyers JSON.

data upsert példák

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

erp batch cancel parancs

Pénzügyi és üzemeltetési kötegelt feladat megszakítása a sajátjával RecId. RecIdA .erp batch list

erp batch cancel példák

dataverse erp batch cancel <recid>

erp batch list parancs

Listázza a Dataverse-környezethez társított Finance and Operations-példány kötegelt feladatait. A parancshoz olyan hitelesítési profilra van szükség, amely összekapcsolt Pénzügyi és üzemeltetési példánnyal rendelkező Dataverse-környezethez csatlakozik. A Pénzügyi és üzemeltetési URL-cím automatikusan származik az aktuális Dataverse-kapcsolatból.

erp batch list Paraméterek

Parameter Description
--company Szűrés jogi személy (dataAreaId), például USMF.
--status Szűrés állapot szerint: Waiting, Executing, Finished, Errorvagy Cancelled.
--top A visszaadandó eredmények maximális száma. Alapértelmezett: 20.
--caption Szűrés felirat alapján (kis- és nagybetűk nem érzéketlen részszűrési egyezése).
--json Kimeneti nyers JSON.

erp batch list példák

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

install parancs

Telepítse a Dataverse CLI egy adott verzióját, vagy frissítsen a legújabb verzióra. A parancs észleli, hogy globálisan telepítette-e a parancssori felületet, vagy ennek megfelelően használja npx és telepíti.

install példák

Telepítse a legújabb verziót:

dataverse install latest

Telepítsen egy adott verziót:

dataverse install 1.0.0

mcp parancs

Elindít egy modellkörnyezeti protokoll (MCP) kiszolgálót, amely csatlakozik a környezethez, hogy az olyan AI-asszisztensek, mint a Claude Desktop, képesek legyenek az adatok kezelésére. A cél automatikusan észlelhető az URL-címből: a Dataverse URL-cím elindítja a Dataverse MCP-kiszolgálót, és egy pénzügyi és üzemeltetési URL-cím, például https://myorg.operations.dynamics.comelindítja az ERP MCP-kiszolgálót.

mcp szintaxis

dataverse mcp <orgUrl> [options]

Az <orgUrl> argumentum például https://myorg.crm.dynamics.coma szervezet URL-címe.

mcp Paraméterek

Parameter Description
--validate Ellenőrizze az MCP-végpontokat és a hitelesítési beállításokat a kiszolgáló indítása nélkül.
--log-level A naplózási szint beállítása: Trace, Debug, Information, Warning, Errorvagy Critical. Alapértelmezett: Warning.
--log-file Jelentkezzen be egy fájlba az ideiglenes könyvtárban.
--preview Használja az előzetes verziójú MCP-végpontot (api/mcp_previewhelyett).api/mcp Az ERP nem támogatott.

mcp példák

A beállítás ellenőrzése (ajánlott első lépés):

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

Indítsa el a kiszolgálót a stdio transport használatával:

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

Használja az előnézeti végpontot, vagy engedélyezze a hibakeresési fájlnaplózást:

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

mcp allow parancs

Győződjön meg arról, hogy egy Microsoft Entra alkalmazás szerepel a Dataverse MCP által engedélyezett ügyfelek listájában az aktuális profil környezetéhez. Ez a parancs az előfeltételekben leírt manuális rendszergazdai lépés alternatíva. A hitelesített felhasználónak Dataverse-rendszergazdai engedélyekkel kell rendelkeznie a célkörnyezetben.

mcp allow szintaxis

dataverse mcp allow <appId> [options]

Az <appId> argumentum az engedélyezendő alkalmazás (ügyfél) azonosítója GUID-ként.

mcp allow Paraméterek

Parameter Description
--erp Engedélyezze az alkalmazást a csatolt Pénzügyi és üzemeltetési példányon a Dataverse helyett.

mcp allow példák

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

Note

A Finance and Operations gyorsítótárazza az engedélyezési listát az AOS-ben, így az újonnan engedélyezett alkalmazásazonosító érvénybe lépése akár öt percet is igénybe vehet.

org list parancs

Listázhatja az összes elérhető környezetet.

org list Paraméterek

Parameter Description
--filter A környezetek listájának szűrése keresési kifejezés alapján.
--json Kimeneti nyers JSON.

org list példák

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

org who parancs

Az aktuális szervezet és felhasználó adatainak megjelenítése az aktív hitelesítési profil használatával. A env parancs a következő aliasa: org.

org who Paraméterek

Parameter Description
--environment, -env Bírálja felül a környezeti URL-címet.
--json Kimeneti nyers JSON.

org who példák

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

skill parancsok

Kezelheti az AI-ügynökök által használt újrafelhasználható utasításkészleteket (egy SKILL.md fájlt és annak erőforrásfájljait), amelyeket a csatlakoztatott környezetben tárolnak. A legfelső szintű skill parancsok létrehozási, olvasási, frissítési és törlési műveleteket biztosítanak a környezettel szemben. A készségek helyileg a következő helyen vannak tárolva .claude/skills/<name>/: .

Note

A képesség-létrehozási és -kiértékelési parancsok, például makea , update, getés eval, külön vannak ezektől a parancsoktól. További információ: dataverse workspace skill --help.

skill delete parancs

Egy képesség és az összes erőforrás törlése az aktív Dataverse-környezetből. A képesség egyedi neveinek megkeresésére használható skill list .

dataverse skill delete new_lead-qualification

skill download parancs

Töltsön le egy vagy több szakértelmet az aktív Dataverse-környezetből a lemezre. A parancs letölti a fájlt és az SKILL.md összes erőforrásfájlt, megőrizve a címtárstruktúrát. A képesség egyedi neveinek megkeresésére használható skill list .

Parameter Description
--all Töltse le az összes aktív készséget a környezetből. Nem kombinálható egyedi képességnévvel.
--output, -o A kimenet alapkönyvtára. Alapértelmezett: .claude/skills/. Ezzel a lehetőséggel --allminden készséget a rendszer megír <path>/<name>/.
--json A képességtartalmat JSON-ként adja ki fájlok írása nélkül. Megadhat egy fájl elérési útját, amelybe írni szeretne. 
dataverse skill download new_lead-qualification
dataverse skill download --all --output ./skills

skill list parancs

A csatlakoztatott Dataverse-környezetben található összes aktív készség listázása.

Parameter Description
--resources, -r Az egyes képességek erőforrásfájljait is listázni kell.
--json Kimenet JSON-ként. Megadhat egy fájl elérési útját, amelybe írni szeretne. 
dataverse skill list
dataverse skill list --resources

skill upload parancs

Töltsön fel egy vagy több szakértelmet a lemezről az aktív Dataverse-környezetbe. A parancs támogatja a könyvtárakat, .zip fájlokat, .skill fájlokat és .md fájlokat.

Átadhat egy képességet <name>, amely feloldja .claude/skills/<name>/azt, vagy explicit <path> módon egy könyvtárba vagy fájlba.

Parameter Description
--all Töltse fel az összes készséget a () területen .claude/skills/. Nem kombinálható a szakértelem nevével vagy elérési útjával.
--json Adja ki az eredményt JSON-ként. Megadhat egy fájl elérési útját, amelybe írni szeretne. 
dataverse skill upload lead-qualification
dataverse skill upload ./my-skill.zip
dataverse skill upload --all

Lásd még

Adatok használata a Dataverse parancssori felületével

  • Last updated on