Referință CLI dataverse (previzualizare)

Notă

  • Aceasta este o caracteristică de previzualizare.
  • Caracteristicile în regim de previzualizare nu sunt destinate utilizării în producție și pot avea funcționalitate restricționată. Aceste caracteristici sunt disponibile înainte de lansarea oficială, astfel încât clienții să poată obține acces din timp și să poată oferi feedback.

Acest articol descrie comenzile disponibile în CLI Dataverse. Fiecare comandă acceptă o --help opțiune care listează utilizarea, opțiunile și exemplele sale. Comenzile care returnează date acceptă o --json opțiune pentru ieșirea JSON brută, utilă în scripturi.

Următoarele opțiuni globale pot fi utilizate cu orice comandă:

Opțiune Descriere
--log-level <level> Setați nivelul înregistrării în jurnal: Trace, Debug, Information, Warning, Error, sau Critical. Valoare implicită: Warning.
--log-file Conectați-vă la un fișier din directorul temporar în loc de consolă.
--context <value> Contextul operațiunii adăugat la Agentul utilizator. De asemenea, puteți seta variabila de DATAVERSE_OPERATION_CONTEXT mediu.
Command Descriere
api describe Descrieți un API
api invoke Invocarea unui API după nume
api list Listable API-uri descoperite
api request Trimiterea unei solicitări HTTP autentificate
auth create Crearea unui nou profil de autentificare
auth list Se listează toate profilurile de autentificare
auth remove Eliminarea unui profil de autentificare
auth select Selectați profilul de autentificare activ
auth who Afișare profil de autentificare curent
data associate Legarea a două înregistrări printr-o relație
data count Numărarea înregistrărilor dintr-un tabel
data create Creați o înregistrare nouă
data delete Ștergerea unei înregistrări
data describe Descrieți schema unei entități
data disassociate Eliminarea unei relații între două înregistrări
data get Regăsiți o singură înregistrare după ID sau cheie alternativă
data query Executarea unei interogări OData, FetchXML sau SQL
data update Actualizați o înregistrare existentă
data upload Încărcarea unui fișier într-o coloană de fișier dintr-o înregistrare existentă
data upsert Crearea sau actualizarea unei înregistrări după cheia alternativă
erp batch cancel Anularea unei operațiuni pe loturi Finanțe și operațiuni
erp batch list List finance and Operations batch jobs
install Instalați o anumită versiune sau actualizați la cea mai recentă versiune
mcp Pornirea serverului MCP pentru Dataverse sau ERP
mcp allow Permiteți unei aplicații ca client MCP
org list Listați toate mediile accesibile
org who Afișați informațiile curente despre organizație și utilizator
skill delete Ștergerea unei abilități din Dataverse
skill download Descărcați o abilitate de la Dataverse
skill list Listarea abilităților active în mediu
skill upload Încărcarea unei abilități în Dataverse

Notă

Multe comenzi acceptă o --target <dataverse\|erp> opțiune care direcționează operațiunea către Dataverse (setarea implicită) sau către mediul Financiar și Operațiuni (ERP) legat. Comenzile care se conectează la un mediu acceptă o --environment <url> opțiune (-env) de a înlocui URL-ul de mediu al profilului curent.

api describe comanda

Afișați metadatele pentru un singur API. Pentru API-urile particularizate Dataverse, rezultatul include descrierile parametrilor solicitării și ale proprietăților de răspuns atunci când metadatele le furnizează.

Numele de date nu sunt prefixate în mod implicit. Puteți utiliza nume calificate pentru ERP în formular erp:ServiceGroup/Service/Operation.

api describe Parametrii

Parametru Descriere
--target Rezolvați un nume necalificat împotriva dataverse sau erp.
--service-group Numai ERP. Restrângeți căutarea operațiunii la un singur grup de servicii.
--service Numai ERP. Restrângeți căutarea operațiunii la un singur serviciu.
--environment Înlocuiți URL-ul de mediu Dataverse.
--json Ieșire JSON brut.

api describe Exemple

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

api invoke comanda

Invocați un API descoperit după nume. Utilizați name=value sintaxa pentru parametri. Dacă o valoare conține spații, citați întregul simbol. Unele API-uri Dataverse acceptă un parametru șir al cărui conținut sunt ei înșiși JSON. În acest caz, treceți textul JSON ca valoare utilizând citate și reguli normale de salvare ale shellului.

În mod implicit, răspunsurile JSON sunt redate într-un format de text prietenos, care păstrează numele proprietăților de ieșire. Se utilizează --json pentru a păstra sarcina JSON brută.

api invoke Parametrii

Parametru Descriere
--target Rezolvați un nume necalificat împotriva dataverse sau erp.
--service-group Numai ERP. Restrângeți căutarea operațiunii la un singur grup de servicii.
--service Numai ERP. Restrângeți căutarea operațiunii la un singur serviciu.
--param Adăugați un parametru denumit în name=value formular. Repetabile.
--bind Calea de legare pentru API-urile Dataverse legate de entitate.
--method, -X Înlocuiți metoda HTTP dedusă.
--body Utilizați un corp JSON brut în locul parametrilor numiți.
--body-file Citiți un corp JSON brut dintr-un fișier.
--header, -H Adăugați un antet HTTP în key:value formular.
--include, -i Includeți starea răspunsului și anteturile.
--environment Înlocuiți URL-ul de mediu Dataverse.
--json Ieșire JSON brut în loc de text prietenos.

api invoke Exemple

Invocați o funcție Dataverse. Acest exemplu arată utilizarea funcției Dynamics 365 Contact Center CCaaS_GetPresence.

dataverse api invoke CCaaS_GetPresence ApiVersion=1.0

Apelați acțiunea Dataverse AISummarize cu spații într-o valoare de parametru:

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

Apelați un serviciu particularizat ERP:

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

api list comanda

Enumerați API-urile descoperite, cum ar fi API-urile particularizate Dataverse și punctele finale de serviciu invocabile ERP. Rezultatele afișează identitatea API, numele prietenos, tipul și descrierea atunci când sunt disponibile. Puteți transmite un termen opțional de interogare pentru a filtra rezultatele.

api list Parametrii

Parametru Descriere
--target Sistemul țintă de căutat: dataverse (implicit) sau erp.
--service-group Numai ERP. Filtrați la un singur grup de servicii.
--service Numai ERP. Filtrați la un singur serviciu.
--limit Numărul maxim de API-uri de returnat. Valoare implicită: 50.
--page Numărul de pagină bazat pe 1 atunci când parcurgeți rezultatele. Valoare implicită: 1.
--environment Înlocuiți URL-ul de mediu Dataverse.
--json Ieșire JSON brut.

api list Exemple

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 comanda

Trimiteți o solicitare HTTP autentificată brută la Dataverse sau ERP. Utilizați această comandă atunci când aveți nevoie de control total asupra căii, metodei, anteturilor și corpului.

api request Parametrii

Parametru Descriere
--target Sistemul țintă: dataverse sau erp. Obligatoriu.
--path Calea solicitării. Obligatoriu.
--method, -X Metoda HTTP. Implicit: GETsau POST atunci când este furnizat un corp.
--body Un corp de solicitare JSON în linie.
--body-file Un fișier care conține un corp de solicitare de obiect JSON.
--header, -H Adăugați un antet HTTP în key:value formular.
--include, -i Includeți starea răspunsului și anteturile.
--environment Înlocuiți URL-ul de mediu Dataverse.

api request Exemple

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 comanda

Creați un nou profil de autentificare.

auth create Parametrii

Utilizați acești parametri pentru a specifica comportamentul comenzii auth create .

Parametru Descriere
--environment, -env URL-ul pentru mediul Dataverse cu care doriți să vă autentificați.
--name, -n Un nume opțional pentru profil. Utilizați numele pentru a selecta profilul mai târziu.
--cloud, -ci Norul țintă: Public, UsGov, UsGovHigh, , UsGovDod, sau China.
--deviceCode, -dc Utilizați fluxul de autentificare a codului dispozitivului, pentru mediile fără un browser.
--username, -un Numele de utilizator pentru numele de utilizator și autentificarea prin parolă.
--password, -p Parola pentru numele de utilizator și autentificarea prin parolă.
--applicationId, -id ID-ul aplicației (client) pentru autentificarea principală de serviciu (SPN).
--clientSecret, -cs Secretul clientului pentru autentificarea principală a serviciului.
--certificateDiskPath, -cdp Calea către un fișier certificat .pfx pentru autentificarea bazată pe certificat.
--certificatePassword, -cp Parola pentru certificat.
--tenant, -t ID-ul entității găzduite. Obligatoriu pentru autentificarea principală a serviciului.
--managedIdentity, -mi Utilizați o identitate gestionată Azure.
--githubFederated, -ghf Utilizați GitHub Actions autentificare federativă.
--azureDevOpsFederated, -adof Utilizați Azure DevOps autentificare federativă.
--clientid, -cid Un ID client de aplicație particularizat Microsoft Entra de utilizat în locul aplicației Dataverse CLI implicite.
--no-default-environment Nu setați mediul ca implicit.
--accept-cleartext-caching Permiteți un cache de token simplu pe Linux.

auth create Exemple

Următoarele exemple demonstrează cum să utilizați auth create comanda.

Autentificare interactivă

Această comandă deschide un browser sau o casetă de dialog de sistem pentru informații suplimentare.

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

Profil denumit

Creați un profil cu un nume specific.

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

Flux de cod de dispozitiv

Utilizați fluxul de cod al dispozitivului pentru medii fără un browser.

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

Principal de serviciu cu secretul clientului

Utilizați un cont principal de serviciu atunci când aveți nevoie de autentificare nesupravegheată, cum ar fi un canal CI/CD sau un alt script automat în care conectarea interactivă nu este posibilă. Furnizați ID-ul aplicației, secretul clientului și ID-ul entității găzduite al unei înregistrări de aplicație care are acces la mediu.

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

ID client aplicație Entra particularizat

Utilizați înregistrarea propriei aplicații în locul setării implicite.

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

auth list comanda

Listați toate profilurile de autentificare. Se adaugă --json pentru ieșireA JSON brută.

auth list Exemple

dataverse auth list
dataverse auth list --json

auth remove comanda

Eliminați unul sau toate profilurile de autentificare.

auth remove Parametrii

Parametru Descriere
--index, -i Eliminați profilul cu indexul bazat pe 1 specificat, așa cum se arată în auth list.
--name, -n Eliminați profilul cu numele specificat.
--all Eliminați toate profilurile.

auth remove Exemple

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

auth select comanda

Selectați profilul de autentificare activ. Rulați comanda fără opțiuni pentru a lista toate profilurile.

auth select Parametrii

Parametru Descriere
--index, -i Selectați profilul după indexul său bazat pe 1, așa cum se arată în auth list.
--name, -n Selectați profilul după nume.

auth select Exemple

Deschideți un selector interactiv. Utilizați tastele săgeată sau tastați pentru a filtra:

dataverse auth select

Selectați un profil după index sau după nume:

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

auth who comanda

Afișați profilul curent de autentificare activ. Se adaugă --json pentru ieșireA JSON brută.

auth who Exemple

dataverse auth who
dataverse auth who --json

data associate comanda

Asociați două înregistrări printr-o proprietate de navigare (relație). Această comandă este acceptată doar pentru Dataverse.

data associate Parametrii

Parametru Descriere
--table, -t Numele setului de entități al înregistrării primare. Obligatoriu.
--id, -i GUID-ul înregistrării primare. Obligatoriu.
--relationship, -rel Numele proprietății de navigare. Obligatoriu.
--related Numele setului de entități al tabelului asociat. Obligatoriu.
--related-id GUID-ul înregistrării asociate. Obligatoriu.
--environment, -env Înlocuiți URL-ul de mediu.
--json Ieșire JSON brut.

data associate Exemple

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

data count comanda

Contorizați înregistrările dintr-un tabel, filtrate opțional.

data count Parametrii

Parametru Descriere
--table, -t Numele setului de entități. Obligatoriu, cu excepția cazului în care utilizați --fetchxml.
--filter, -f O expresie OData $filter .
--fetchxml O interogare agregată PreluareXML pentru contorizarea complexă.
--target Rută la dataverse (implicit) sau la mediul legat erp .
--cross-company Numai ERP. Contați în toate firmele. Implicit: firma implicită a utilizatorului.
--environment, -env Înlocuiți URL-ul de mediu.
--json Ieșire JSON brut.

data count Exemple

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

data create comanda

Creați o înregistrare nouă într-un tabel Dataverse. Setați coloanele de căutare utilizând @odata.bind sintaxa.

data create Parametrii

Parametru Descriere
--table, -t Numele setului de entități. Obligatoriu.
--data, -d Un obiect JSON cu valorile câmpului.
--data-file Calea către un fișier JSON cu datele înregistrării.
--return, -r Returnați înregistrarea completă creată.
--target Rută la dataverse (implicit) sau la mediul legat erp .
--environment, -env Înlocuiți URL-ul de mediu.
--json Ieșire JSON brut.

data create Exemple

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

Sfat

Se utilizează --data-file pentru JSON complex. Se utilizează --return --json pentru a obține înregistrarea creată completă.

data delete comanda

Ștergeți o singură înregistrare după cheia primară sau după o cheie alternativă.

data delete Parametrii

Parametru Descriere
--table, -t Numele setului de entități. Obligatoriu.
--id, -i GUID-ul înregistrării.
--key, -k O cheie alternativă.
--no-confirm Omiteți solicitarea de confirmare.
--target Rută la dataverse (implicit) sau la mediul legat erp .
--environment, -env Înlocuiți URL-ul de mediu.
--json Ieșire JSON brut.

data delete Exemple

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

data describe comanda

Descrieți schema unei entități OData. Pentru Dataverse, comenzile EntityDefinitions(LogicalName='<table>') cu $expand ajutorul --include, plus un al doilea apel către customapis când --include actions este setat. Acțiuni Predefinite Dataverse, cum Assign ar fi și SetState nu sunt enumerate. Pentru ERP, un singur apel pentru a /Metadata/PublicEntities returna proprietăți, acțiuni legate și navigații împreună.

data describe Parametrii

Parametru Descriere
--target Ținta: dataverse (implicit) sau erp.
--table, -t Obligatoriu. Pentru Dataverse, numele logic, cum accountar fi . Pentru ERP, numele setului de entități, cum BatchJobsar fi .
--include O listă de secțiuni separate prin virgulă pentru a include: entity, properties, relations, , actionssau all. Aliasuri: attributes=properties, relationships=relations. Implicit pentru ERP: all. Implicit pentru Dataverse: entity,properties.
--json Ieșire JSON brut.

data describe Exemple

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

data disassociate comanda

Eliminați o relație între două înregistrări. Această comandă este acceptată doar pentru Dataverse.

data disassociate Parametrii

Parametru Descriere
--table, -t Numele setului de entități al înregistrării primare. Obligatoriu.
--id, -i GUID-ul înregistrării primare. Obligatoriu.
--relationship, -rel Numele proprietății de navigare. Obligatoriu.
--related-id GUID-ul înregistrării asociate, pentru o relație mai-mulți-la-mai-mulți. Omiteți acest parametru pentru a goli o căutare.
--environment, -env Înlocuiți URL-ul de mediu.
--json Ieșire JSON brut.

data disassociate Exemple

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

data get comanda

Regăsiți o singură înregistrare după ID-ul său (cheia primară) sau după o cheie alternativă.

data get Parametrii

Parametru Descriere
--table, -t Numele setului de entități. Obligatoriu.
--id, -i GUID-ul de înregistrare (cheia primară).
--key, -k O cheie alternativă, de exemplu "col='val'".
--select, -s O listă de coloane separate prin virgulă ($select).
--expand, -x O expresie OData $expand pentru înregistrările asociate.
--target Rută la dataverse (implicit) sau la mediul legat erp .
--environment, -env Înlocuiți URL-ul de mediu.
--json Ieșire JSON brut.

data get Exemple

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 comanda

Executați o interogare OData, FetchXML sau SQL în raport cu un tabel Dataverse.

data query parametri

Parametru Descriere
--table, -t Numele setului de entități de interogat. Obligatoriu pentru interogări OData.
--select, -s O listă de coloane separate prin virgulă ($select).
--filter, -f O expresie OData $filter .
--orderby, -o O expresie OData $orderby .
--top Numărul maxim de înregistrări de returnat (1-5000).
--expand, -x O expresie OData $expand pentru înregistrările asociate.
--fetchxml O interogare FetchXML în linie.
--fetchxml-file Calea către un fișier care conține o interogare FetchXML.
--sql O interogare SQL SELECT (previzualizare).
--sql-file Calea către un fișier care conține o interogare SQL.
--all, -a Urmăriți paginarea pentru a regăsi toate înregistrările.
--max-records Numărul maxim de înregistrări de regăsit atunci când se utilizează --all. Valoare implicită: 100000.
--target Rută la dataverse (implicit) sau la mediul legat erp .
--cross-company Numai ERP. Se interogă toate firmele. Implicit: firma implicită a utilizatorului.
--environment, -env Înlocuiți URL-ul de mediu.
--json Ieșire JSON brut.

data query Exemple

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

Află mai multe

data update comanda

Actualizați unul sau mai multe câmpuri dintr-o înregistrare existentă, identificate prin ID-ul său sau printr-o cheie alternativă. Setați coloanele de căutare utilizând @odata.bind sintaxa.

data update Parametrii

Parametru Descriere
--table, -t Numele setului de entități. Obligatoriu.
--id, -i GUID-ul înregistrării.
--key, -k O cheie alternativă.
--data, -d Un obiect JSON cu câmpurile de actualizat.
--data-file Calea către un fișier JSON cu datele de actualizare.
--return, -r Returnează înregistrarea actualizată completă.
--target Rută la dataverse (implicit) sau la mediul legat erp .
--environment, -env Înlocuiți URL-ul de mediu.
--json Ieșire JSON brut.

data update Exemple

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

data upload comanda

Încărcați un fișier local într-o coloană de fișier Dataverse dintr-o înregistrare existentă. Comanda selectează automat o singură solicitare sau încărcare bloc pe baza dimensiunii fișierului, cu excepția cazului în care specificați --mode. În modul automat, fișierele sub 128 MB sunt încărcate într-o singură solicitare și fișierele mai mari utilizează o încărcare bloc. Atunci când omiteți --mime-type, comanda deduce tipul MIME din extensia de fișier. Extensii necunoscute implicite la application/octet-stream.

data upload Parametrii

Parametru Descriere
--table, -t Schema tabelului sau numele logic, cum accountar fi . Obligatoriu. Comanda rezolvă setul de entități din metadate.
--id, -i GUID-ul înregistrării. Obligatoriu.
--column, -c Numele atributului coloanei fișierului. Obligatoriu.
--file, -f Calea către fișierul local. Obligatoriu.
--mode, -m Strategia de încărcare: auto (implicit), smallsau chunk.
--mime-type Un tip MIME explicit. Implicit: dedus din extensia de fișier.
--overwrite Suprascrieți un fișier existent. În mod implicit, comanda nu reușește dacă coloana nu este goală.
--environment, -env Înlocuiți URL-ul de mediu.
--json Ieșire JSON brut.

data upload Exemple

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 comanda

Creați o înregistrare dacă nu există sau actualizați-o dacă nu există. Înregistrarea este identificată printr-o cheie alternativă. Aflați cum să utilizați o cheie alternativă pentru a face referire la o înregistrare

data upsert parametri

Parametru Descriere
--table, -t Numele setului de entități. Obligatoriu.
--key, -k O cheie alternativă. Obligatoriu.
--data, -d Un obiect JSON cu valorile câmpului.
--data-file Calea către un fișier JSON.
--update-only Eroare dacă înregistrarea nu există (If-Match: *).
--create-only Eroare dacă înregistrarea există deja (If-None-Match: *).
--return, -r Returnează înregistrarea completă după operațiune.
--target Rută la dataverse (implicit) sau la mediul legat erp .
--environment, -env Înlocuiți URL-ul de mediu.
--json Ieșire JSON brut.

data upsert Exemple

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

erp batch cancel comanda

Anulați o lucrare pe loturi Finanțe și operațiuni după .RecId Utilizați erp batch list pentru a găsi RecId.

erp batch cancel Exemple

dataverse erp batch cancel <recid>

erp batch list comanda

Listați lucrările pe loturi în instanța Finanțe și operațiuni care este legată la mediul Dataverse. Comanda necesită un profil de autentificare conectat la un mediu Dataverse care are o instanță Finanțe și operațiuni legate. ADRESA URL Finanțe și operațiuni este derivată automat din conexiunea Dataverse curentă.

erp batch list Parametrii

Parametru Descriere
--company Filtrați după entitatea juridică (dataAreaId), cum USMFar fi .
--status Filtrare după stare: Waiting, Executing, Finished, Errorsau Cancelled.
--top Numărul maxim de rezultate de returnat. Valoare implicită: 20.
--caption Filtrați după legendă (potrivire subșir fără litere mari și mici).
--json Ieșire JSON brut.

erp batch list Exemple

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

install comanda

Instalați o anumită versiune a dataverse CLI sau actualizați la cea mai recentă versiune. Comanda detectează dacă ați instalat global CLI sau utilizați npx și se instalează în mod corespunzător.

install Exemple

Instalați cea mai recentă versiune:

dataverse install latest

Instalați o anumită versiune:

dataverse install 1.0.0

mcp comanda

Pornește un server Protocol contextual model (MCP) care se conectează la mediul dvs., astfel încât asistenții AI, cum ar fi Claude Desktop, să poată interacționa cu datele dvs. Ținta este detectată automat din URL: un URL Dataverse pornește serverul Dataverse MCP și un URL Financiar și Operațiuni, cum https://myorg.operations.dynamics.comar fi , pornește serverul ERP MCP.

mcp Sintaxa

dataverse mcp <orgUrl> [options]

Argumentul <orgUrl> este adresa URL a organizației dvs., de exemplu https://myorg.crm.dynamics.com.

mcp parametri

Parametru Descriere
--validate Validați punctele finale MCP și configurarea autentificării fără a porni serverul.
--log-level Setați nivelul înregistrării în jurnal: Trace, Debug, Information, Warning, Error, sau Critical. Valoare implicită: Warning.
--log-file Conectați-vă la un fișier din directorul temporar.
--preview Utilizați punctul final MCP de previzualizare (api/mcp_preview în loc de api/mcp). Nu este acceptat pentru ERP.

mcp Exemple

Validați configurarea (primul pas recomandat):

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

Începeți serverul utilizând transportul stdio:

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

Utilizați punctul final de previzualizare sau activați înregistrarea în jurnal a fișierelor de depanare:

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

mcp allow comanda

Asigurați-vă că o aplicație Microsoft Entra se află în lista de clienți permiți Dataverse MCP pentru mediul profilului curent. Această comandă este o alternativă la pasul de administrare manual descris în cerințele preliminare. Utilizatorul autentificat trebuie să aibă permisiuni de administrator Dataverse în mediul țintă.

mcp allow Sintaxa

dataverse mcp allow <appId> [options]

Argumentul <appId> este ID-ul aplicației (client) pentru a permite, ca GUID.

mcp allow Parametrii

Parametru Descriere
--erp Permiteți aplicația în instanța Finanțe și operațiuni legate în loc de Dataverse.

mcp allow Exemple

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

Notă

Finanțe și operațiuni memorează în cache lista de permisiuni din AOS, astfel încât un ID de aplicație nou permis poate dura până la aproximativ cinci minute pentru a avea efect.

org list comanda

Listați toate mediile pe care le puteți accesa.

org list Parametrii

Parametru Descriere
--filter Filtrați lista de medii după un termen de căutare.
--json Ieșire JSON brut.

org list Exemple

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

org who comanda

Afișați informații despre organizația curentă și despre utilizator, utilizând profilul de autentificare activ. Comanda env este un alias pentru org.

org who Parametrii

Parametru Descriere
--environment, -env Înlocuiți URL-ul de mediu.
--json Ieșire JSON brut.

org who Exemple

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

skill Comenzi

Gestionați abilitățile Dataverse - seturi de instrucțiuni reutilizabile (un SKILL.md fișier și fișierele sale de resurse) pe care le utilizează agenții AI - care sunt stocate în mediul conectat. Comenzile de nivel skill superior oferă operațiuni de creare, citire, actualizare și ștergere în mediul înconjurător. Local, abilitățile sunt stocate sub .claude/skills/<name>/.

Notă

Crearea competențelor și comenzile de evaluare, cum makear fi , update, get, și eval, sunt separate de aceste comenzi. Pentru mai multe informații, rulați dataverse workspace skill --help.

skill delete comanda

Ștergeți o abilitate și toate resursele sale din mediul Dataverse activ. Utilizați skill list pentru a găsi nume unice de competențe.

dataverse skill delete new_lead-qualification

skill download comanda

Descărcați una sau mai multe abilități din mediul Dataverse activ pe disc. Comanda descarcă SKILL.md fișierul și toate fișierele de resurse, păstrând structura directorului. Utilizați skill list pentru a găsi nume unice de competențe.

Parametru Descriere
--all Descărcați toate abilitățile active din mediu. Nu se poate combina cu un nume unic de competență.
--output, -o Directorul de bază pentru ieșire. Valoare implicită: .claude/skills/. Cu --all, fiecare abilitate este scris în <path>/<name>/.
--json Afișați conținutul abilității ca JSON fără a scrie fișiere. Opțional, specificați o cale de fișier în care să scrieți. 
dataverse skill download new_lead-qualification
dataverse skill download --all --output ./skills

skill list comanda

Enumerați toate abilitățile active din mediul Dataverse conectat.

Parametru Descriere
--resources, -r De asemenea, listați fișierele de resurse pentru fiecare competență.
--json Ieșire ca JSON. Opțional, specificați o cale de fișier în care să scrieți. 
dataverse skill list
dataverse skill list --resources

skill upload comanda

Încărcați una sau mai multe abilități de pe disc în mediul Dataverse activ. Comanda acceptă directoare, fișiere.zip , fișiere .skill și fișiere .md .

Puteți să transmiteți o abilitate <name>, care se rezolvă la .claude/skills/<name>/sau un fișier explicit <path> la un director sau fișier.

Parametru Descriere
--all Încărcați toate abilitățile sub .claude/skills/. Nu se poate combina cu un nume sau o cale de competență.
--json Se afișează rezultatul ca JSON. Opțional, specificați o cale de fișier în care să scrieți. 
dataverse skill upload lead-qualification
dataverse skill upload ./my-skill.zip
dataverse skill upload --all

Consultați și

Lucrul cu datele utilizând Dataverse CLI

  • Last updated on