Referència de la CLI de Dataverse (previsualització)

Nota

  • Aquesta és una característica de visualització prèvia.
  • Les característiques de visualització prèvia no estan dissenyades per a un entorn de producció i poden tenir una funcionalitat restringida. Aquestes característiques estan disponibles abans d’un llançament oficial de producte per tal que els clients el puguin utilitzar abans i enviar-nos els seus comentaris.

Aquest article descriu les ordres disponibles a la CLI de Dataverse. Cada comanda admet una --help opció que en detalla l'ús, les opcions i els exemples. Les ordres que retornen dades admeten una --json opció per a la sortida JSON en brut que és útil en scripts.

Les següents opcions globals es poden utilitzar amb qualsevol comanda:

Opció Descripció
--log-level <level> Estableix el nivell de registre: Trace, Debug, Information, Warning, Error, o Critical. Per defecte: Warning.
--log-file Inicia sessió en un fitxer del directori temporal en comptes de la consola.
--context <value> Context d'operació afegit a l'User-Agent. També pots configurar la variable d'entorn DATAVERSE_OPERATION_CONTEXT .
Ordre Descripció
api describe Descriu una API
api invoke Invoca una API pel nom
api list Llista d'APIs descobribles
api request Envia una sol·licitud HTTP autenticada
auth create Crea un nou perfil d'autenticació
auth list Llista tots els perfils d'autenticació
auth remove Elimina un perfil d'autenticació
auth select Selecciona el perfil d'autenticació activa
auth who Mostra el perfil d'autenticació actual
data associate Enllaça dos registres a través d'una relació
data count Registres de comptatge en una taula
data create Crea un registre nou
data delete Suprimir un registre
data describe Descriu l'esquema d'una entitat
data disassociate Eliminar una relació entre dos registres
data get Recuperar un registre únic per ID o clau alternativa
data query Executa una consulta OData, FetchXML o SQL
data update Actualitza un registre existent
data upload Puja un fitxer a una columna de fitxer d'un registre existent
data upsert Crea o actualitza un registre per clau alternativa
erp batch cancel Cancel·la una feina de promoció de Finances i Operacions
erp batch list Llista feines de promoció de Finances i Operacions
install Instal·la una versió específica o actualitza a l'última versió
mcp Inicia el servidor MCP per a Dataverse o ERP
mcp allow Permetre una aplicació com a client MCP
org list Llista tots els entorns accessibles
org who Mostra l'organització actual i la informació de l'usuari
skill delete Elimina una habilitat de Dataverse
skill download Descarrega una habilitat de Dataverse
skill list Llista les habilitats actives en l'entorn
skill upload Puja una habilitat a Dataverse

Nota

Moltes ordres admeten una --target <dataverse\|erp> opció que enruta l'operació a Dataverse (el valor per defecte) o a l'entorn vinculat de Finances i Operacions (ERP). Les ordres que es connecten a un entorn suporten una --environment <url> opció (-env) per sobreescriure l'URL de l'entorn del perfil actual.

api describe manar

Mostra les metadades d'una sola API. Per a les APIs personalitzades de Dataverse, la sortida inclou descripcions de paràmetres de sol·licitud i propietats de resposta quan les metadades les proporcionen.

Els noms del Dataverse no tenen prefix per defecte. Pots utilitzar noms qualificats per a l'ERP en el formulari erp:ServiceGroup/Service/Operation.

api describe Paràmetres

Paràmetre Descripció
--target Resol un nom no qualificat contra dataverse o erp.
--service-group Només ERP. Redueix la cerca d'operacions a un sol grup de serveis.
--service Només ERP. Redueix la cerca d'operacions a un sol servei.
--environment Sobreescriu l'URL de l'entorn Dataverse.
--json Sortiu JSON en brut.

api describe Exemples

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

api invoke manar

Invoca una API descoberta pel seu nom. Utilitza name=value la sintaxi per als paràmetres. Si un valor conté espais, cita el token sencer. Algunes APIs de Dataverse accepten un paràmetre de cadena el contingut del qual és JSON. En aquest cas, passa el text JSON com a valor utilitzant les regles normals de citació i escapament de la teva shell.

Per defecte, les respostes JSON es representen en un format de text amigable que manté els noms de les propietats de sortida. Utilitza --json per preservar la càrrega útil JSON en brut.

api invoke Paràmetres

Paràmetre Descripció
--target Resol un nom no qualificat contra dataverse o erp.
--service-group Només ERP. Redueix la cerca d'operacions a un sol grup de serveis.
--service Només ERP. Redueix la cerca d'operacions a un sol servei.
--param Afegeix un paràmetre amb nom en name=value el formulari. Repetible.
--bind El camí d'enllaç per a APIs Dataverse vinculades a entitats.
--method, -X Sobreescriu el mètode HTTP inferit.
--body Utilitza un cos JSON en brut en lloc de paràmetres anomenats.
--body-file Llegeix un cos JSON en brut d'un fitxer.
--header, -H Afegeix una capçalera HTTP en key:value formulari.
--include, -i Inclou l'estat de la resposta i les capçaleres.
--environment Sobreescriu l'URL de l'entorn Dataverse.
--json Treu JSON en brut en lloc de text amistós.

api invoke Exemples

Invoca una funció de Dataverse. Aquest exemple mostra l'ús de la funció Dynamics 365 Contact Center CCaaS_GetPresence.

dataverse api invoke CCaaS_GetPresence ApiVersion=1.0

Invoca l'acció Dataverse AISummarize amb espais en un valor de paràmetre:

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

Invoca un servei personalitzat ERP:

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

api list manar

Llista APIs descobribles, com ara APIs personalitzades de Dataverse i punts finals de servei invocables ERP. Els resultats mostren la identitat de l'API, nom amistós, tipus i descripció quan estan disponibles. Pots passar un terme de consulta opcional per filtrar els resultats.

api list Paràmetres

Paràmetre Descripció
--target El sistema objectiu per cercar: dataverse (per defecte) o erp.
--service-group Només ERP. Filtra a un únic grup de servei.
--service Només ERP. Filtra a un sol servei.
--limit El nombre màxim d'APIs per retornar. Per defecte: 50.
--page El número de pàgina basat en 1 quan passes els resultats. Per defecte: 1.
--environment Sobreescriu l'URL de l'entorn Dataverse.
--json Sortiu JSON en brut.

api list Exemples

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 manar

Envia una petició HTTP autenticada en brut a Dataverse o ERP. Utilitza aquesta ordre quan necessitis control total sobre el camí, el mètode, les capçaleres i el cos.

api request Paràmetres

Paràmetre Descripció
--target El sistema objectiu: dataverse o erp. Obligatòries.
--path El camí de la sol·licitud. Obligatòries.
--method, -X El mètode HTTP. Valor per defecte: GET, o POST quan s'hi subministra un cos.
--body Un cos de sol·licitud JSON en línia.
--body-file Un fitxer que conté el cos d'una sol·licitud d'objecte JSON.
--header, -H Afegeix una capçalera HTTP en key:value formulari.
--include, -i Inclou l'estat de la resposta i les capçaleres.
--environment Sobreescriu l'URL de l'entorn Dataverse.

api request Exemples

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 manar

Crea un nou perfil d'autenticació.

auth create Paràmetres

Utilitza aquests paràmetres per especificar el comportament de l'ordre auth create .

Paràmetre Descripció
--environment, -env L'URL de l'entorn Dataverse amb què vols autenticar-te.
--name, -n Un nom opcional per al perfil. Fes servir el nom per seleccionar el perfil més endavant.
--cloud, -ci El núvol objectiu: Public, UsGov, UsGovHigh, UsGovDod, o China.
--deviceCode, -dc Utilitza el flux d'autenticació per codi de dispositiu, per a entorns sense navegador.
--username, -un El nom d'usuari per a l'autenticació del nom d'usuari i la contrasenya.
--password, -p La contrasenya per al nom d'usuari i l'autenticació de contrasenya.
--applicationId, -id L'ID de l'aplicació (client) per a l'autenticació del principal de servei (SPN).
--clientSecret, -cs El secret del client per a l'autenticació principal del servei.
--certificateDiskPath, -cdp El camí cap a un fitxer de certificat .pfx per a l'autenticació basada en certificats.
--certificatePassword, -cp La contrasenya del certificat.
--tenant, -t L'ID del llogater. És necessari per a l'autenticació del principal de servei.
--managedIdentity, -mi Utilitza una identitat gestionada d'Azure.
--githubFederated, -ghf Utilitza l'autenticació federada de GitHub Actions.
--azureDevOpsFederated, -adof Utilitza l'autenticació federada d'Azure DevOps.
--clientid, -cid Un ID de client d'aplicació Microsoft Entra personalitzat per utilitzar en lloc de l'aplicació CLI per defecte de Dataverse.
--no-default-environment No posis l'entorn com a predeterminat.
--accept-cleartext-caching Permet una memòria cau de token en text pla a Linux.

auth create Exemples

Els exemples següents mostren com utilitzar l'ordre auth create .

Autenticació interactiva

Aquesta ordre obre un navegador o un diàleg de diàleg del sistema per a informació addicional.

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

Perfil amb nom

Crea un perfil amb un nom específic.

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

Flux de codi del dispositiu

Utilitza el flux de codi del dispositiu per a entorns sense navegador.

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

Principal de servei amb secret del client

Utilitza un principi de servei quan necessitis autenticació sense vigilància, com en una pipeline CI/CD o en un altre script automatitzat on no és possible iniciar sessió de manera interactiva. Proporciona l'ID de l'aplicació, el secret del client i l'ID de l'inquilino d'un registre d'aplicació que tingui accés a l'entorn.

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

ID de client de l'aplicació Entra personalitzat

Fes servir el registre de la teva pròpia aplicació en lloc del per defecte.

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

auth list manar

Llista tots els perfils d'autenticació. Suma --json per a la sortida JSON en brut.

auth list Exemples

dataverse auth list
dataverse auth list --json

auth remove manar

Elimina un o tots els perfils d'autenticació.

auth remove Paràmetres

Paràmetre Descripció
--index, -i Elimineu el perfil amb l'índex basat en 1 especificat, tal com es mostra a auth list.
--name, -n Elimina el perfil amb el nom especificat.
--all Elimina tots els perfils.

auth remove Exemples

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

auth select manar

Selecciona el perfil d'autenticació activa. Executa l'ordre sense opcions per llistar tots els perfils.

auth select Paràmetres

Paràmetre Descripció
--index, -i Selecciona el perfil pel seu índex basat en 1, tal com es mostra a auth list.
--name, -n Selecciona el perfil pel nom.

auth select Exemples

Obre un selector interactiu. Utilitza les tecles de fletxes, o escriu per filtrar:

dataverse auth select

Selecciona un perfil per índex o per nom:

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

auth who manar

Mostra el perfil d'autenticació actiu actual. Suma --json per a la sortida JSON en brut.

auth who Exemples

dataverse auth who
dataverse auth who --json

data associate manar

Associa dos registres a través d'una propietat de navegació (relació). Aquesta comanda només és compatible amb Dataverse.

data associate Paràmetres

Paràmetre Descripció
--table, -t El nom establert de l'entitat del registre primari. Obligatòries.
--id, -i El GUID del registre principal. Obligatòries.
--relationship, -rel El nom de la propietat de navegació. Obligatòries.
--related El nom del conjunt d'entitats de la taula relacionada. Obligatòries.
--related-id El GUID del registre relacionat. Obligatòries.
--environment, -env Sobreescriu l'URL de l'entorn.
--json Sortiu JSON en brut.

data associate Exemples

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

data count manar

Compta els registres en una taula, opcionalment filtrada.

data count Paràmetres

Paràmetre Descripció
--table, -t El nom del conjunt d'entitats. És obligatori tret que utilitzis --fetchxml.
--filter, -f Una expressió OData $filter .
--fetchxml Una consulta agregada FetchXML per a recomptes complexos.
--target Ruta cap a dataverse (per defecte) o l'entorn enllaçat erp .
--cross-company Només ERP. Compta entre totes les empreses. Per defecte: l'empresa per defecte de l'usuari.
--environment, -env Sobreescriu l'URL de l'entorn.
--json Sortiu JSON en brut.

data count Exemples

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

data create manar

Crea un nou registre en una taula Dataverse. Configura les columnes de cerca utilitzant @odata.bind la sintaxi.

data create Paràmetres

Paràmetre Descripció
--table, -t El nom del conjunt d'entitats. Obligatòries.
--data, -d Un objecte JSON amb els valors del camp.
--data-file El camí cap a un fitxer JSON amb les dades del registre.
--return, -r Retorna el registre complet creat.
--target Ruta cap a dataverse (per defecte) o l'entorn enllaçat erp .
--environment, -env Sobreescriu l'URL de l'entorn.
--json Sortiu JSON en brut.

data create Exemples

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

Propina

Utilitza --data-file per a JSON complex. Utilitza-ho --return --json per obtenir el registre complet creat.

data delete manar

Elimina un registre únic per la seva clau principal o per una clau alternativa.

data delete Paràmetres

Paràmetre Descripció
--table, -t El nom del conjunt d'entitats. Obligatòries.
--id, -i El rècord GUID.
--key, -k Una tonalitat alternativa.
--no-confirm Salta el missatge de confirmació.
--target Ruta cap a dataverse (per defecte) o l'entorn enllaçat erp .
--environment, -env Sobreescriu l'URL de l'entorn.
--json Sortiu JSON en brut.

data delete Exemples

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

data describe manar

Descriu l'esquema d'una entitat OData. Per a Dataverse, la comanda crida EntityDefinitions(LogicalName='<table>') amb $expand impulsat per --include, més una segona crida a customapis quan --include actions està establert. Les accions integrades de Dataverse com Assign i SetState no s'enumeren. Per a l'ERP, una sola crida retorna /Metadata/PublicEntities propietats, accions lligades i navegacions juntes.

data describe Paràmetres

Paràmetre Descripció
--target L'objectiu: dataverse (per defecte) o erp.
--table, -t Obligatòries. Per al Dataverse, el nom lògic, com accountara . Per a ERP, el nom del conjunt d'entitats, com BatchJobsara .
--include Una llista separada per coma de seccions que inclou: entity, properties, relations, actions, o all. Àlies: attributes=properties, . relationships=relations Per defecte per a ERP: all. Per defecte per a Dataverse: entity,properties.
--json Sortiu JSON en brut.

data describe Exemples

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

data disassociate manar

Elimina una relació entre dos registres. Aquesta comanda només és compatible amb Dataverse.

data disassociate Paràmetres

Paràmetre Descripció
--table, -t El nom establert de l'entitat del registre primari. Obligatòries.
--id, -i El GUID del registre principal. Obligatòries.
--relationship, -rel El nom de la propietat de navegació. Obligatòries.
--related-id El GUID del registre relacionat, per a una relació de molts a molts. Omet aquest paràmetre per esborrar una consulta.
--environment, -env Sobreescriu l'URL de l'entorn.
--json Sortiu JSON en brut.

data disassociate Exemples

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

data get manar

Recupera un registre únic pel seu ID (clau primària) o per una clau alternativa.

data get Paràmetres

Paràmetre Descripció
--table, -t El nom del conjunt d'entitats. Obligatòries.
--id, -i El registre GUID (clau primària).
--key, -k Una tonalitat alternativa, per exemple "col='val'".
--select, -s Una llista de columnes separada per coma ($select).
--expand, -x Una expressió OData $expand per a registres relacionats.
--target Ruta cap a dataverse (per defecte) o l'entorn enllaçat erp .
--environment, -env Sobreescriu l'URL de l'entorn.
--json Sortiu JSON en brut.

data get Exemples

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 manar

Executa una consulta OData, FetchXML o SQL sobre una taula Dataverse.

data query Paràmetres

Paràmetre Descripció
--table, -t L'entitat estableix el nom per consultar. És necessari per a consultes d'OData.
--select, -s Una llista de columnes separada per coma ($select).
--filter, -f Una expressió OData $filter .
--orderby, -o Una expressió OData $orderby .
--top El nombre màxim de registres a retornar (1-5000).
--expand, -x Una expressió OData $expand per a registres relacionats.
--fetchxml Una consulta FetchXML en línia.
--fetchxml-file El camí cap a un fitxer que conté una consulta FetchXML.
--sql Una consulta SQL SELECT (previsualització).
--sql-file El camí cap a un fitxer que conté una consulta SQL.
--all, -a Segueix la paginació per recuperar tots els registres.
--max-records El nombre màxim de registres a recuperar quan s'utilitza --all. Per defecte: 100000.
--target Ruta cap a dataverse (per defecte) o l'entorn enllaçat erp .
--cross-company Només ERP. Fes consultes a totes les empreses. Per defecte: l'empresa per defecte de l'usuari.
--environment, -env Sobreescriu l'URL de l'entorn.
--json Sortiu JSON en brut.

data query Exemples

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

Més informació

data update manar

Actualitza un o més camps d'un registre existent, identificats pel seu ID o per una clau alternativa. Configura les columnes de cerca utilitzant @odata.bind la sintaxi.

data update Paràmetres

Paràmetre Descripció
--table, -t El nom del conjunt d'entitats. Obligatòries.
--id, -i El rècord GUID.
--key, -k Una tonalitat alternativa.
--data, -d Un objecte JSON amb els camps per actualitzar.
--data-file El camí cap a un fitxer JSON amb les dades d'actualització.
--return, -r Retorna el registre complet actualitzat.
--target Ruta cap a dataverse (per defecte) o l'entorn enllaçat erp .
--environment, -env Sobreescriu l'URL de l'entorn.
--json Sortiu JSON en brut.

data update Exemples

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

data upload manar

Puja un fitxer local a una columna de fitxer Dataverse en un registre existent. L'ordre selecciona automàticament una sol·licitud única o una pujada en fragments segons la mida del fitxer, tret que especifiquis --mode. En mode automàtic, els fitxers de menys de 128 MB es pugen en una sola petició, i els fitxers més grans utilitzen una pujada fragmentada. Quan omets --mime-type, la comanda dedueix el tipus MIME de l'extensió del fitxer. Les extensions desconegudes per defecte són application/octet-stream.

data upload Paràmetres

Paràmetre Descripció
--table, -t L'esquema de taula o nom lògic, com accountara . Obligatòries. L'ordre resol el conjunt d'entitats a partir de les metadades.
--id, -i El rècord GUID. Obligatòries.
--column, -c El nom de l'atribut de la columna del fitxer. Obligatòries.
--file, -f El camí cap al fitxer local. Obligatòries.
--mode, -m L'estratègia de pujada: auto (per defecte), small, o chunk.
--mime-type Un tipus MIME explícit. Per defecte: deduït de l'extensió del fitxer.
--overwrite Sobreescriu un fitxer existent. Per defecte, la comanda falla si la columna no està buida.
--environment, -env Sobreescriu l'URL de l'entorn.
--json Sortiu JSON en brut.

data upload Exemples

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 manar

Crea un registre si no existeix, o actualitza'l si existeix. El registre s'identifica per una tonalitat alternativa. Aprèn a utilitzar una clau alternativa per referenciar un registre

data upsert Paràmetres

Paràmetre Descripció
--table, -t El nom del conjunt d'entitats. Obligatòries.
--key, -k Una tonalitat alternativa. Obligatòries.
--data, -d Un objecte JSON amb els valors del camp.
--data-file El camí cap a un fitxer JSON.
--update-only Suspès si el registre no existeix (If-Match: *).
--create-only Suspès si el registre ja existeix (If-None-Match: *).
--return, -r Retorna el registre complet després de l'operació.
--target Ruta cap a dataverse (per defecte) o l'entorn enllaçat erp .
--environment, -env Sobreescriu l'URL de l'entorn.
--json Sortiu JSON en brut.

data upsert Exemples

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

erp batch cancel manar

Cancel·la una feina de lots de Finances i Operacions per la seva RecId. Utilitza erp batch list per trobar el RecId.

erp batch cancel Exemples

dataverse erp batch cancel <recid>

erp batch list manar

Fes una llista de feines per lots a la instància de Finances i Operacions vinculada al teu entorn Dataverse. L'ordre requereix un perfil d'autenticació connectat a un entorn Dataverse que tingui una instància de Finances i Operacions enllaçada. L'URL de Finances i Operacions es deriva automàticament de la connexió actual de Dataverse.

erp batch list Paràmetres

Paràmetre Descripció
--company Filtra per entitat legal (dataAreaId), com ara USMF.
--status Filtra per estat: Waiting, Executing, Finished, Error, o Cancelled.
--top El nombre màxim de resultats a retornar. Per defecte: 20.
--caption Filtra per subtítol (coincidència de subcadenes insensibles a majúscules i maiúscules).
--json Sortiu JSON en brut.

erp batch list Exemples

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

install manar

Instal·la una versió específica de la CLI de Dataverse, o actualitza a l'última versió. L'ordre detecta si has instal·lat la CLI globalment o si l'estàs utilitzant npx i s'instal·la en conseqüència.

install Exemples

Instal·la l'última versió:

dataverse install latest

Instal·la una versió específica:

dataverse install 1.0.0

mcp manar

Inicia un servidor Model Context Protocol (MCP) que es connecta al teu entorn, perquè assistents d'IA com Claude Desktop puguin interactuar amb les teves dades. L'objectiu es detecta automàticament a partir de la URL: una URL de Dataverse inicia el servidor MCP de Dataverse, i una URL de Finances i Operacions, com https://myorg.operations.dynamics.com, inicia el servidor ERP MCP.

mcp Sintaxi

dataverse mcp <orgUrl> [options]

L'argument <orgUrl> és, per exemple https://myorg.crm.dynamics.com, la URL de la teva organització.

mcp Paràmetres

Paràmetre Descripció
--validate Valida els punts finals MCP i la configuració d'autenticació sense iniciar el servidor.
--log-level Estableix el nivell de registre: Trace, Debug, Information, Warning, Error, o Critical. Per defecte: Warning.
--log-file Inicia sessió en un fitxer al directori temporal.
--preview Utilitza l'endpoint de previsualització MCP (api/mcp_preview en lloc de api/mcp). No està suportat per a ERP.

mcp Exemples

Valida la configuració (un primer pas recomanat):

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

Inicia el servidor utilitzant el transport stdio:

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

Utilitza l'endpoint de previsualització o activa el registre de fitxers de depuració:

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

mcp allow manar

Assegureu-vos que una aplicació Microsoft Entra estigui a la llista de clients permesos de Dataverse MCP per a l'entorn del perfil actual. Aquesta ordre és una alternativa al pas manual d'administració descrit als requisits previs. L'usuari autenticat ha de tenir permisos d'administrador de Dataverse a l'entorn destinat.

mcp allow Sintaxi

dataverse mcp allow <appId> [options]

L'argument <appId> és que l'ID de l'aplicació (client) ha de permetre, com a GUID.

mcp allow Paràmetres

Paràmetre Descripció
--erp Permet l'aplicació a la instància enllaçada de Finances i Operacions en lloc de Dataverse.

mcp allow Exemples

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

Nota

Finances i Operacions emmagatzema la llista de permisos a l'AOS, així que un nou ID d'aplicació permès pot trigar fins a uns cinc minuts a fer efecte.

org list manar

Fes una llista de tots els entorns als quals puguis accedir.

org list Paràmetres

Paràmetre Descripció
--filter Filtra la llista d'entorns per un terme de cerca.
--json Sortiu JSON en brut.

org list Exemples

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

org who manar

Mostra informació sobre l'organització i l'usuari actuals, utilitzant el perfil d'autenticació activa. L'ordre env és un àlies per a org.

org who Paràmetres

Paràmetre Descripció
--environment, -env Sobreescriu l'URL de l'entorn.
--json Sortiu JSON en brut.

org who Exemples

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

skill ordres

Gestiona les habilitats de Dataverse—conjunts d'instruccions reutilitzables (un SKILL.md fitxer i els seus fitxers de recursos) que utilitzen els agents d'IA—que s'emmagatzemen a l'entorn connectat. Les ordres de primer nivell skill proporcionen operacions de creació, lectura, actualització i eliminació contra l'entorn. Localment, les habilitats s'emmagatzemen sota .claude/skills/<name>/.

Nota

Les ordres d'autorització i avaluació d'habilitats, com make, update, get, i eval, són separades d'aquestes ordres. Per a més informació, executa dataverse workspace skill --help.

skill delete manar

Elimina una habilitat i tots els seus recursos de l'entorn actiu de Dataverse. Utilitza'l skill list per trobar noms únics d'habilitats.

dataverse skill delete new_lead-qualification

skill download manar

Descarrega una o més habilitats de l'entorn actiu Dataverse al disc. L'ordre descarrega el SKILL.md fitxer i tots els fitxers de recursos, preservant l'estructura de directoris. Utilitza'l skill list per trobar noms únics d'habilitats.

Paràmetre Descripció
--all Descarrega totes les habilitats actives de l'entorn. No es pot combinar amb un nom únic d'habilitat.
--output, -o El directori base per a la sortida. Per defecte: .claude/skills/. Amb --all, cada habilitat s'escriu a <path>/<name>/.
--json Treu el contingut de l'habilitat en JSON sense escriure fitxers. Opcionalment, especifica un camí de fitxer on escriure. 
dataverse skill download new_lead-qualification
dataverse skill download --all --output ./skills

skill list manar

Llista totes les habilitats actives en l'entorn connectat Dataverse.

Paràmetre Descripció
--resources, -r També llista els fitxers de recursos de cada habilitat.
--json Sortida en JSON. Opcionalment, especifica un camí de fitxer on escriure. 
dataverse skill list
dataverse skill list --resources

skill upload manar

Puja una o més habilitats del disc a l'entorn actiu Dataverse. La comanda suporta directoris, fitxers.zip , fitxers .skill i fitxers .md .

Pots passar una habilitat <name>, que es resol a .claude/skills/<name>/, o una explícita <path> a un directori o fitxer.

Paràmetre Descripció
--all Puja totes les habilitats sota .claude/skills/. No es pot combinar amb un nom d'habilitat o un camí.
--json Treu el resultat en format JSON. Opcionalment, especifica un camí de fitxer on escriure. 
dataverse skill upload lead-qualification
dataverse skill upload ./my-skill.zip
dataverse skill upload --all

Vegeu també

Treballar amb dades utilitzant la CLI Dataverse

  • Last updated on