Informazioni di riferimento dell'interfaccia della riga di comando di Dataverse (anteprima)

Note

  • Questa è una funzionalità di anteprima.
  • Le funzionalità di anteprima non sono destinate ad essere utilizzate per la produzione e sono soggette a restrizioni. Queste funzionalità sono disponibili prima di una versione ufficiale in modo che i clienti possano ottenere l'accesso anticipato e fornire commenti e suggerimenti.

Questo articolo descrive i comandi disponibili nell'interfaccia della riga di comando di Dataverse. Ogni comando supporta un'opzione --help che elenca l'utilizzo, le opzioni e gli esempi. I comandi che restituiscono dati supportano un'opzione --json per l'output JSON non elaborato utile negli script.

Con qualsiasi comando è possibile usare le opzioni globali seguenti:

Option Description
--log-level <level> Impostare il livello di registrazione: Trace, Debug, WarningInformation, , Erroro Critical. Impostazione predefinita: Warning.
--log-file Accedere a un file nella directory temporanea anziché nella console.
--context <value> Contesto dell'operazione aggiunto all'agente utente. È anche possibile impostare la DATAVERSE_OPERATION_CONTEXT variabile di ambiente.
Command Description
api describe Descrivere un'API
api invoke Richiamare un'API per nome
api list Elencare le API individuabili
api request Inviare una richiesta HTTP autenticata
auth create Creare un nuovo profilo di autenticazione
auth list Elencare tutti i profili di autenticazione
auth remove Rimuovere un profilo di autenticazione
auth select Selezionare il profilo di autenticazione attivo
auth who Visualizzare il profilo di autenticazione corrente
data associate Collegare due record tramite una relazione
data count Conteggio dei record in una tabella
data create Creazione di un nuovo record
data delete Eliminare un record
data describe Descrivere lo schema di un'entità
data disassociate Rimuovere una relazione tra due record
data get Recuperare un singolo record in base all'ID o alla chiave alternativa
data query Eseguire una query OData, FetchXML o SQL
data update Aggiorna un record esistente
data upload Caricare un file in una colonna di file in un record esistente
data upsert Creare o aggiornare un record in base a una chiave alternativa
erp batch cancel Annullare un processo batch Finance and Operations
erp batch list Elencare i processi batch finance and operations
install Installare una versione specifica o eseguire l'aggiornamento alla versione più recente
mcp Avviare il server MCP per Dataverse o ERP
mcp allow Consentire un'app come client MCP
org list Elencare tutti gli ambienti accessibili
org who Mostra le informazioni correnti sull'organizzazione e sull'utente
skill delete Eliminare una competenza da Dataverse
skill download Scaricare una competenza da Dataverse
skill list Elencare le competenze attive nell'ambiente
skill upload Caricare una competenza in Dataverse

Note

Molti comandi supportano un'opzione --target <dataverse\|erp> che indirizza l'operazione a Dataverse (impostazione predefinita) o all'ambiente FINANCE and Operations (ERP) collegato. I comandi che si connettono a un ambiente supportano un'opzione --environment <url> (-env) per eseguire l'override dell'URL dell'ambiente del profilo corrente.

api describe comando

Visualizzare i metadati per una singola API. Per le API personalizzate di Dataverse, l'output include descrizioni dei parametri di richiesta e delle proprietà di risposta quando i metadati li forniscono.

Per impostazione predefinita, i nomi del dataverse non sono preceduti da prefissi. È possibile usare nomi qualificati ERP nel formato erp:ServiceGroup/Service/Operation.

api describe Parametri

Parameter Description
--target Risolvere un nome non qualificato in dataverse o erp.
--service-group Solo ERP. Restringere la ricerca dell'operazione a un gruppo di servizi.
--service Solo ERP. Restringere la ricerca dell'operazione a un servizio.
--environment Eseguire l'override dell'URL dell'ambiente Dataverse.
--json Output JSON non elaborato.

api describe esempi

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

api invoke comando

Richiamare un'API individuata per nome. Usare name=value la sintassi per i parametri. Se un valore contiene spazi, racchiudere tra virgolette l'intero token. Alcune API di Dataverse accettano un parametro stringa il cui contenuto è json. In tal caso, passare il testo JSON come valore usando le normali regole di virgolette ed escape della shell.

Per impostazione predefinita, il rendering delle risposte JSON viene eseguito in un formato di testo descrittivo che mantiene i nomi delle proprietà di output. Usare --json per mantenere il payload JSON non elaborato.

api invoke Parametri

Parameter Description
--target Risolvere un nome non qualificato in dataverse o erp.
--service-group Solo ERP. Restringere la ricerca dell'operazione a un gruppo di servizi.
--service Solo ERP. Restringere la ricerca dell'operazione a un servizio.
--param Aggiungere un parametro denominato nel name=value modulo. Ripetibile.
--bind Percorso di associazione per le API Dataverse associate a entità.
--method, -X Eseguire l'override del metodo HTTP dedotto.
--body Usare un corpo JSON non elaborato anziché parametri denominati.
--body-file Leggere un corpo JSON non elaborato da un file.
--header, -H Aggiungere un'intestazione HTTP nel key:value modulo.
--include, -i Includere lo stato e le intestazioni della risposta.
--environment Eseguire l'override dell'URL dell'ambiente Dataverse.
--json Output JSON non elaborato anziché testo descrittivo.

api invoke esempi

Richiamare una funzione Dataverse. In questo esempio viene illustrato l'uso della funzione CCaaS_GetPresence Dynamics 365 Commerce.

dataverse api invoke CCaaS_GetPresence ApiVersion=1.0

Richiamare l'azione AISummarize dataverse con spazi in un valore di parametro:

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

Richiamare un servizio personalizzato ERP:

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

api list comando

Elencare le API individuabili, ad esempio LE API personalizzate di Dataverse e gli endpoint di servizio invocabili ERP. I risultati mostrano l'identità dell'API, il nome descrittivo, il tipo e la descrizione, se disponibili. È possibile passare un termine di query facoltativo per filtrare i risultati.

api list Parametri

Parameter Description
--target Sistema di destinazione in cui eseguire la ricerca: dataverse (impostazione predefinita) o erp.
--service-group Solo ERP. Filtrare in base a un singolo gruppo di servizi.
--service Solo ERP. Filtrare in base a un singolo servizio.
--limit Numero massimo di API da restituire. Impostazione predefinita: 50.
--page Numero di pagina in base 1 durante il paging dei risultati. Impostazione predefinita: 1.
--environment Eseguire l'override dell'URL dell'ambiente Dataverse.
--json Output JSON non elaborato.

api list esempi

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 comando

Inviare una richiesta HTTP non elaborata autenticata a Dataverse o ERP. Usare questo comando quando è necessario il controllo completo sul percorso, il metodo, le intestazioni e il corpo.

api request Parametri

Parameter Description
--target Sistema di destinazione: dataverse o erp. Required.
--path Percorso della richiesta. Required.
--method, -X Metodo HTTP. Impostazione predefinita: GETo POST quando viene fornito un corpo.
--body Corpo della richiesta JSON inline.
--body-file File che contiene un corpo della richiesta di oggetto JSON.
--header, -H Aggiungere un'intestazione HTTP nel key:value modulo.
--include, -i Includere lo stato e le intestazioni della risposta.
--environment Eseguire l'override dell'URL dell'ambiente Dataverse.

api request esempi

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 comando

Creare un nuovo profilo di autenticazione.

auth create Parametri

Usare questi parametri per specificare il comportamento del auth create comando.

Parameter Description
--environment, -env URL dell'ambiente Dataverse con cui si vuole eseguire l'autenticazione.
--name, -n Nome facoltativo per il profilo. Usare il nome per selezionare il profilo in un secondo momento.
--cloud, -ci Cloud di destinazione: Public, UsGov, UsGovHighUsGovDod, o China.
--deviceCode, -dc Usare il flusso di autenticazione del codice del dispositivo per gli ambienti senza un browser.
--username, -un Nome utente per l'autenticazione con nome utente e password.
--password, -p Password per l'autenticazione del nome utente e della password.
--applicationId, -id ID applicazione (client) per l'autenticazione dell'entità servizio (SPN).
--clientSecret, -cs Segreto client per l'autenticazione dell'entità servizio.
--certificateDiskPath, -cdp Percorso di un file di certificato pfx per l'autenticazione basata su certificato.
--certificatePassword, -cp Password per il certificato.
--tenant, -t ID tenant. Obbligatorio per l'autenticazione dell'entità servizio.
--managedIdentity, -mi Usare un'identità gestita Azure.
--githubFederated, -ghf Usare GitHub Actions'autenticazione federata.
--azureDevOpsFederated, -adof Usare Azure DevOps'autenticazione federata.
--clientid, -cid ID client dell'app Microsoft Entra personalizzato da usare anziché l'app dell'interfaccia della riga di comando dataverse predefinita.
--no-default-environment Non impostare l'ambiente come predefinito.
--accept-cleartext-caching Consentire una cache dei token in testo non crittografato in Linux.

auth create esempi

Gli esempi seguenti illustrano come usare il auth create comando .

Autenticazione interattiva

Questo comando apre una finestra di dialogo del browser o del sistema per ulteriori informazioni.

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

Profilo denominato

Creare un profilo con un nome specifico.

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

Flusso del codice del dispositivo

Usare il flusso del codice del dispositivo per gli ambienti senza un browser.

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

Principale del servizio con segreto del client

Usare un'entità servizio quando è necessaria l'autenticazione automatica, ad esempio in una pipeline CI/CD o in un altro script automatizzato in cui l'accesso interattivo non è possibile. Specificare l'ID applicazione, il segreto client e l'ID tenant di una registrazione dell'app che ha accesso all'ambiente.

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

ID client dell'app Entra personalizzato

Usare la registrazione dell'app personalizzata invece dell'impostazione predefinita.

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

auth list comando

Elencare tutti i profili di autenticazione. Aggiungere --json per l'output JSON non elaborato.

auth list esempi

dataverse auth list
dataverse auth list --json

auth remove comando

Rimuovere uno o tutti i profili di autenticazione.

auth remove Parametri

Parameter Description
--index, -i Rimuovere il profilo con l'indice in base 1 specificato, come illustrato in auth list.
--name, -n Rimuovere il profilo con il nome specificato.
--all Rimuovere tutti i profili.

auth remove esempi

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

auth select comando

Selezionare il profilo di autenticazione attivo. Eseguire il comando senza opzioni per elencare tutti i profili.

auth select Parametri

Parameter Description
--index, -i Selezionare il profilo in base all'indice in base 1, come illustrato in auth list.
--name, -n Selezionare il profilo in base al nome.

auth select esempi

Aprire una selezione interattiva. Usare i tasti di direzione o digitare per filtrare:

dataverse auth select

Selezionare un profilo per indice o per nome:

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

auth who comando

Mostra il profilo di autenticazione attivo corrente. Aggiungere --json per l'output JSON non elaborato.

auth who esempi

dataverse auth who
dataverse auth who --json

data associate comando

Associare due record tramite una proprietà di navigazione (relazione). Questo comando è supportato solo per Dataverse.

data associate Parametri

Parameter Description
--table, -t Nome del set di entità del record primario. Required.
--id, -i GUID del record primario. Required.
--relationship, -rel Nome della proprietà di navigazione. Required.
--related Nome del set di entità della tabella correlata. Required.
--related-id GUID del record correlato. Required.
--environment, -env Eseguire l'override dell'URL dell'ambiente.
--json Output JSON non elaborato.

data associate esempi

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

data count comando

Contare i record in una tabella, facoltativamente filtrati.

data count Parametri

Parameter Description
--table, -t Nome del set di entità. Obbligatorio a meno che non si usi --fetchxml.
--filter, -f Espressione OData $filter .
--fetchxml Query di aggregazione FetchXML per conteggi complessi.
--target Indirizzare a dataverse (impostazione predefinita) o all'ambiente collegato erp .
--cross-company Solo ERP. Conteggio in tutte le aziende. Impostazione predefinita: società predefinita dell'utente.
--environment, -env Eseguire l'override dell'URL dell'ambiente.
--json Output JSON non elaborato.

data count esempi

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

data create comando

Creare un nuovo record in una tabella Dataverse. Impostare le colonne di ricerca usando la @odata.bind sintassi .

data create Parametri

Parameter Description
--table, -t Nome del set di entità. Required.
--data, -d Oggetto JSON con i valori di campo.
--data-file Percorso di un file JSON con i dati del record.
--return, -r Restituisce il record creato completo.
--target Indirizzare a dataverse (impostazione predefinita) o all'ambiente collegato erp .
--environment, -env Eseguire l'override dell'URL dell'ambiente.
--json Output JSON non elaborato.

data create esempi

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

Tip

Usare --data-file per JSON complesso. Usare --return --json per ottenere il record creato completo.

data delete comando

Eliminare un singolo record in base alla chiave primaria o a una chiave alternativa.

data delete Parametri

Parameter Description
--table, -t Nome del set di entità. Required.
--id, -i GUID del record.
--key, -k Chiave alternativa.
--no-confirm Ignorare la richiesta di conferma.
--target Indirizzare a dataverse (impostazione predefinita) o all'ambiente collegato erp .
--environment, -env Eseguire l'override dell'URL dell'ambiente.
--json Output JSON non elaborato.

data delete esempi

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

data describe comando

Descrivere lo schema di un'entità OData. Per Dataverse, il comando chiama EntityDefinitions(LogicalName='<table>') con basato su --include$expand , più una seconda chiamata a customapis quando --include actions è impostata. Le azioni predefinite di Dataverse, Assign ad esempio e SetState non sono enumerate. Per ERP, una singola chiamata a /Metadata/PublicEntities restituisce proprietà, azioni associate e spostamenti insieme.

data describe Parametri

Parameter Description
--target Destinazione: dataverse (impostazione predefinita) o erp.
--table, -t Required. Per Dataverse, il nome logico, ad esempio account. Per ERP, il nome del set di entità, ad esempio BatchJobs.
--include Elenco delimitato da virgole di sezioni da includere: entity, properties, actionsrelations, o all. Alias: attributes=properties, . relationships=relations Valore predefinito per ERP: all. Valore predefinito per Dataverse: entity,properties.
--json Output JSON non elaborato.

data describe esempi

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

data disassociate comando

Rimuovere una relazione tra due record. Questo comando è supportato solo per Dataverse.

data disassociate Parametri

Parameter Description
--table, -t Nome del set di entità del record primario. Required.
--id, -i GUID del record primario. Required.
--relationship, -rel Nome della proprietà di navigazione. Required.
--related-id GUID del record correlato, per una relazione molti-a-molti. Omettere questo parametro per cancellare una ricerca.
--environment, -env Eseguire l'override dell'URL dell'ambiente.
--json Output JSON non elaborato.

data disassociate esempi

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

data get comando

Recuperare un singolo record in base al relativo ID (chiave primaria) o a una chiave alternativa.

data get Parametri

Parameter Description
--table, -t Nome del set di entità. Required.
--id, -i GUID del record (chiave primaria).
--key, -k Chiave alternativa, ad esempio "col='val'".
--select, -s Elenco delimitato da virgole di colonne ($select).
--expand, -x Espressione OData $expand per i record correlati.
--target Indirizzare a dataverse (impostazione predefinita) o all'ambiente collegato erp .
--environment, -env Eseguire l'override dell'URL dell'ambiente.
--json Output JSON non elaborato.

data get esempi

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 comando

Eseguire una query OData, FetchXML o SQL su una tabella Dataverse.

data query Parametri

Parameter Description
--table, -t Nome del set di entità su cui eseguire una query. Obbligatorio per le query OData.
--select, -s Elenco delimitato da virgole di colonne ($select).
--filter, -f Espressione OData $filter .
--orderby, -o Espressione OData $orderby .
--top Numero massimo di record da restituire (1-5000).
--expand, -x Espressione OData $expand per i record correlati.
--fetchxml Query FetchXML inline.
--fetchxml-file Percorso di un file contenente una query FetchXML.
--sql Query SQL SELECT (anteprima).
--sql-file Percorso di un file contenente una query SQL.
--all, -a Seguire la paginazione per recuperare tutti i record.
--max-records Numero massimo di record da recuperare quando si usa --all. Impostazione predefinita: 100000.
--target Indirizzare a dataverse (impostazione predefinita) o all'ambiente collegato erp .
--cross-company Solo ERP. Eseguire query in tutte le aziende. Impostazione predefinita: società predefinita dell'utente.
--environment, -env Eseguire l'override dell'URL dell'ambiente.
--json Output JSON non elaborato.

data query esempi

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

Ulteriori informazioni

data update comando

Aggiornare uno o più campi in un record esistente, identificato dal relativo ID o da una chiave alternativa. Impostare le colonne di ricerca usando la @odata.bind sintassi .

data update Parametri

Parameter Description
--table, -t Nome del set di entità. Required.
--id, -i GUID del record.
--key, -k Chiave alternativa.
--data, -d Oggetto JSON con i campi da aggiornare.
--data-file Percorso di un file JSON con i dati di aggiornamento.
--return, -r Restituisce il record aggiornato completo.
--target Indirizzare a dataverse (impostazione predefinita) o all'ambiente collegato erp .
--environment, -env Eseguire l'override dell'URL dell'ambiente.
--json Output JSON non elaborato.

data update esempi

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

data upload comando

Caricare un file locale in una colonna di file Dataverse in un record esistente. Il comando seleziona automaticamente un caricamento a singola richiesta o in blocchi in base alle dimensioni del file, a meno che non si specifichi --mode. In modalità automatica, i file con dimensioni minori di 128 MB vengono caricati in una singola richiesta e i file di dimensioni maggiori usano un caricamento in blocchi. Quando si omette --mime-type, il comando deduce il tipo MIME dall'estensione di file. Per impostazione predefinita, le estensioni sconosciute sono application/octet-stream.

data upload Parametri

Parameter Description
--table, -t Schema della tabella o nome logico, ad esempio account. Required. Il comando risolve il set di entità dai metadati.
--id, -i GUID del record. Required.
--column, -c Nome dell'attributo della colonna di file. Required.
--file, -f Percorso del file locale. Required.
--mode, -m Strategia di caricamento: auto (impostazione predefinita), smallo chunk.
--mime-type Tipo MIME esplicito. Impostazione predefinita: dedotto dall'estensione di file.
--overwrite Sovrascrivere un file esistente. Per impostazione predefinita, il comando ha esito negativo se la colonna non è vuota.
--environment, -env Eseguire l'override dell'URL dell'ambiente.
--json Output JSON non elaborato.

data upload esempi

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 comando

Creare un record se non esiste o aggiornarlo in caso affermativo. Il record è identificato da una chiave alternativa. Informazioni su come usare una chiave alternativa per fare riferimento a un record

data upsert Parametri

Parameter Description
--table, -t Nome del set di entità. Required.
--key, -k Chiave alternativa. Required.
--data, -d Oggetto JSON con i valori di campo.
--data-file Percorso di un file JSON.
--update-only Esito negativo se il record non esiste (If-Match: *).
--create-only Esito negativo se il record esiste già (If-None-Match: *).
--return, -r Restituisce il record completo dopo l'operazione.
--target Indirizzare a dataverse (impostazione predefinita) o all'ambiente collegato erp .
--environment, -env Eseguire l'override dell'URL dell'ambiente.
--json Output JSON non elaborato.

data upsert esempi

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

erp batch cancel comando

Annullare un processo batch Finance and Operations in base al relativo RecId. Usare erp batch list per trovare .RecId

erp batch cancel esempi

dataverse erp batch cancel <recid>

erp batch list comando

Elencare i processi batch nell'istanza Finance and Operations collegata all'ambiente Dataverse. Il comando richiede un profilo di autenticazione connesso a un ambiente Dataverse con un'istanza Finance and Operations collegata. L'URL Finance and Operations viene derivato automaticamente dalla connessione Dataverse corrente.

erp batch list Parametri

Parameter Description
--company Filtrare in base alla persona giuridica (dataAreaId), ad esempio USMF.
--status Filtrare in base allo stato: Waiting, Executing, Finished, Erroro Cancelled.
--top Il numero massimo di risultati da restituire. Impostazione predefinita: 20.
--caption Filtra per didascalia (corrispondenza di sottostringa senza distinzione tra maiuscole e minuscole).
--json Output JSON non elaborato.

erp batch list esempi

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

install comando

Installare una versione specifica dell'interfaccia della riga di comando di Dataverse o eseguire l'aggiornamento alla versione più recente. Il comando rileva se l'interfaccia della riga di comando è stata installata a livello globale o se viene usata npx e installata di conseguenza.

install esempi

Installare la versione più recente:

dataverse install latest

Installare una versione specifica:

dataverse install 1.0.0

mcp comando

Avvia un server MCP (Model Context Protocol) che si connette all'ambiente in modo che gli assistenti di intelligenza artificiale come Claude Desktop possano interagire con i dati. La destinazione viene rilevata automaticamente dall'URL: un URL dataverse avvia il server MCP Dataverse e un URL finance and operations, ad esempio https://myorg.operations.dynamics.com, avvia il server MCP ERP.

Sintassi mcp

dataverse mcp <orgUrl> [options]

L'argomento <orgUrl> è l'URL dell'organizzazione, ad esempio https://myorg.crm.dynamics.com.

mcp Parametri

Parameter Description
--validate Convalidare gli endpoint MCP e l'installazione dell'autenticazione senza avviare il server.
--log-level Impostare il livello di registrazione: Trace, Debug, WarningInformation, , Erroro Critical. Impostazione predefinita: Warning.
--log-file Accedere a un file nella directory temporanea.
--preview Usare l'endpoint MCP di anteprima (api/mcp_preview anziché api/mcp). Non supportato per ERP.

mcp esempi

Convalidare l'installazione (un primo passaggio consigliato):

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

Avviare il server usando il trasporto stdio:

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

Usare l'endpoint di anteprima o abilitare la registrazione dei file di debug:

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

mcp allow comando

Assicurarsi che un'applicazione Microsoft Entra sia nell'elenco dei client consentiti dataverse MCP per l'ambiente del profilo corrente. Questo comando è un'alternativa al passaggio manuale dell'amministratore descritto nei prerequisiti. L'utente autenticato deve disporre delle autorizzazioni di amministratore di Dataverse nell'ambiente di destinazione.

Sintassi mcp allow

dataverse mcp allow <appId> [options]

L'argomento <appId> è l'ID applicazione (client) da consentire, come GUID.

mcp allow Parametri

Parameter Description
--erp Consentire l'applicazione nell'istanza Finance and Operations collegata anziché in Dataverse.

mcp allow esempi

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

Note

Finance and Operations memorizza nella cache l'elenco di elementi consentiti in AOS, quindi l'uso di un ID app appena consentito può richiedere fino a circa cinque minuti.

org list comando

Elencare tutti gli ambienti a cui è possibile accedere.

org list Parametri

Parameter Description
--filter Filtrare l'elenco degli ambienti in base a un termine di ricerca.
--json Output JSON non elaborato.

org list esempi

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

org who comando

Visualizzare informazioni sull'organizzazione e sull'utente corrente usando il profilo di autenticazione attivo. Il env comando è un alias per org.

org who Parametri

Parameter Description
--environment, -env Eseguire l'override dell'URL dell'ambiente.
--json Output JSON non elaborato.

org who esempi

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

Comandi di skill

Gestire le competenze di Dataverse, ovvero set di istruzioni riutilizzabili (un SKILL.md file e i relativi file di risorse) usati dagli agenti di intelligenza artificiale, archiviati nell'ambiente connesso. I comandi di primo livello skill forniscono operazioni di creazione, lettura, aggiornamento ed eliminazione nell'ambiente. In locale, le competenze vengono archiviate in .claude/skills/<name>/.

Note

I comandi di creazione e valutazione delle competenze, ad esempio make, getupdate, e eval, sono separati da questi comandi. Per altre informazioni, eseguire dataverse workspace skill --help.

skill delete comando

Eliminare una competenza e tutte le relative risorse dall'ambiente Dataverse attivo. Usare skill list per trovare nomi univoci delle competenze.

dataverse skill delete new_lead-qualification

skill download comando

Scaricare una o più competenze dall'ambiente Dataverse attivo su disco. Il comando scarica il SKILL.md file e tutti i file di risorse, mantenendo la struttura di directory. Usare skill list per trovare nomi univoci delle competenze.

Parameter Description
--all Scaricare tutte le competenze attive dall'ambiente. Non è possibile combinare un nome univoco di competenza.
--output, -o Directory di base per l'output. Impostazione predefinita: .claude/skills/. Con --all, ogni competenza viene scritta in <path>/<name>/.
--json Restituire il contenuto della competenza come JSON senza scrivere file. Facoltativamente, specificare un percorso di file in cui scrivere. 
dataverse skill download new_lead-qualification
dataverse skill download --all --output ./skills

skill list comando

Elencare tutte le competenze attive nell'ambiente Dataverse connesso.

Parameter Description
--resources, -r Elencare anche i file di risorse per ogni competenza.
--json Output come JSON. Facoltativamente, specificare un percorso di file in cui scrivere. 
dataverse skill list
dataverse skill list --resources

skill upload comando

Caricare una o più competenze dal disco nell'ambiente Dataverse attivo. Il comando supporta directory, file.zip , file con estensione skill e file md .

È possibile passare una competenza <name>, che viene risolta in .claude/skills/<name>/o esplicita <path> in una directory o in un file.

Parameter Description
--all Caricare tutte le competenze in .claude/skills/. Non è possibile combinare un nome o un percorso di competenza.
--json Restituisce il risultato come JSON. Facoltativamente, specificare un percorso di file in cui scrivere. 
dataverse skill upload lead-qualification
dataverse skill upload ./my-skill.zip
dataverse skill upload --all

Vedere anche

Usare i dati usando l'interfaccia della riga di comando di Dataverse

  • Last updated on