Referencia da CLI Dataverse (vista previa)

Nota

  • Esta é unha funcionalidade de vista previa.
  • As funcionalidades de vista previa non se deseñaron para uso de produción e poden ter funcionalidade restrinxida. Estas funcionalidades están dispoñibles antes da versión oficial para que os clientes poidan obter acceso a elas rápido e fornecer comentarios.

Este artigo describe os comandos dispoñibles na CLI de Dataverse. Cada comando soporta unha --help opción que lista o seu uso, opcións e exemplos. Os comandos que devolven datos soportan unha --json opción para saída JSON en bruto que é útil nos scripts.

As seguintes opcións globais poden usarse con calquera comando:

Opción Descripción
--log-level <level> Establece o nivel de rexistro: Trace, Debug, Information, Warning, Error, ou Critical. Predeterminado: Warning.
--log-file Inicia sesión nun ficheiro no directorio temporal en vez da consola.
--context <value> Contexto da operación engadido ao User-Agent. Tamén podes configurar a DATAVERSE_OPERATION_CONTEXT variable de ambiente.
Comando Descripción
api describe Describe unha API
api invoke Invocar unha API polo seu nome
api list Lista de APIs descubribles
api request Envía unha solicitude HTTP autenticada
auth create Crear un novo perfil de autenticación
auth list Listar todos os perfís de autenticación
auth remove Eliminar un perfil de autenticación
auth select Seleccione o perfil de autenticación activa
auth who Mostrar o perfil de autenticación actual
data associate Enlaza dous rexistros mediante unha relación
data count Rexistros de conteo nunha táboa
data create Crear un novo rexistro
data delete Eliminar un rexistro
data describe Describe o esquema dunha entidade
data disassociate Eliminar unha relación entre dous rexistros
data get Recuperar un único rexistro por ID ou clave alternativa
data query Executa unha consulta OData, FetchXML ou SQL
data update Actualizar un rexistro existente
data upload Subir un ficheiro a unha columna de ficheiro nun rexistro existente
data upsert Crear ou actualizar un rexistro por clave alternativa
erp batch cancel Cancelar un traballo de lote de Finanzas e Operacións
erp batch list Lista de empregos de promoción de Finanzas e Operacións
install Instala unha versión específica ou actualiza á última versión
mcp Comeza o servidor MCP para Dataverse ou ERP
mcp allow Permitir unha aplicación como cliente MCP
org list Lista de todos os ambientes accesibles
org who Mostrar a organización actual e a información do usuario
skill delete Eliminar unha habilidade de Dataverse
skill download Descarga unha habilidade de Dataverse
skill list Listar as habilidades activas no ambiente
skill upload Sube unha habilidade a Dataverse

Nota

Moitos comandos soportan unha --target <dataverse\|erp> opción que enruta a operación a Dataverse (o valor predeterminado) ou ao entorno vinculado de Finanzas e Operacións (ERP). Os comandos que se conectan a un entorno soportan unha --environment <url> opción (-env) para sobrescribir a URL do entorno do perfil actual.

api describe Comando

Mostra os metadatos dunha única API. Para as APIs personalizadas de Dataverse, a saída inclúe descricións dos parámetros de solicitude e das propiedades de resposta cando os metadatos as proporcionan.

Os nomes do Dataverse non teñen prefixo por defecto. Podes usar nomes cualificados por ERP no formulario erp:ServiceGroup/Service/Operation.

api describe Parámetros

Parámetro Descripción
--target Resolver un nome non cualificado contra dataverse ou erp.
--service-group Só ERP. Restrinxe a busca de operacións a un só grupo de servizos.
--service Só ERP. Restrinxe a busca de operacións a un só servizo.
--environment Anula a URL do entorno Dataverse.
--json Saída en JSON en bruto.

api describe Exemplos

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

api invoke Comando

Invoca unha API descuberta polo nome. Usa name=value a sintaxe para os parámetros. Se un valor contén espazos, cita o token enteiro. Algunhas APIs de Dataverse aceptan un parámetro de cadea cuxo contido é el mesmo JSON. Nese caso, pasa o texto JSON como valor usando as regras normais de citas e escape do teu shell.

Por defecto, as respostas JSON preséntanse nun formato de texto amigable que mantén os nomes das propiedades de saída. Utilízao --json para preservar a carga útil JSON en bruto.

api invoke Parámetros

Parámetro Descripción
--target Resolver un nome non cualificado contra dataverse ou erp.
--service-group Só ERP. Restrinxe a busca de operacións a un só grupo de servizos.
--service Só ERP. Restrinxe a busca de operacións a un só servizo.
--param Engade un parámetro nomeado en name=value forma. Repetible.
--bind O camiño de vinculación para as APIs Dataverse vinculadas a entidades.
--method, -X Anula o método HTTP inferido.
--body Usa un corpo JSON en bruto en lugar de parámetros nomeados.
--body-file Le un corpo JSON en bruto dun ficheiro.
--header, -H Engade unha cabeceira HTTP en key:value formulario.
--include, -i Inclúe o estado da resposta e as cabeceiras.
--environment Anula a URL do entorno Dataverse.
--json Emite JSON en bruto en vez de texto amigable.

api invoke Exemplos

Invoca unha función Dataverse. Este exemplo mostra o uso da función Dynamics 365 Contact Center CCaaS_GetPresence.

dataverse api invoke CCaaS_GetPresence ApiVersion=1.0

Invoca a acción Dataverse AISummarize con espazos nun valor de parámetro:

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

Invocar un servizo personalizado ERP:

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

api list Comando

Lista APIs descubribles, como APIs personalizadas de Dataverse e puntos finais de servizo invocables ERP. Os resultados mostran a identidade da API, nome amigable, tipo e descrición cando están dispoñibles. Podes pasar un termo de consulta opcional para filtrar os resultados.

api list Parámetros

Parámetro Descripción
--target O sistema obxectivo para buscar: dataverse (por defecto) ou erp.
--service-group Só ERP. Filtra a un único grupo de servizo.
--service Só ERP. Filtra a un único servizo.
--limit O número máximo de APIs para devolver. Predeterminado: 50.
--page O número de páxina baseado en 1 ao pasar os resultados. Predeterminado: 1.
--environment Anula a URL do entorno Dataverse.
--json Saída en JSON en bruto.

api list Exemplos

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

Envía unha solicitude HTTP autenticada en bruto a Dataverse ou ERP. Usa este comando cando precises control total sobre o camiño, método, cabeceiras e corpo.

api request Parámetros

Parámetro Descripción
--target O sistema obxectivo: dataverse ou erp. Obrigatorio.
--path O camiño das peticións. Obrigatorio.
--method, -X O método HTTP. Predeterminado: GET, ou POST cando se abastece un corpo.
--body Un corpo de solicitude JSON en liña.
--body-file Un ficheiro que contén o corpo da solicitude dun obxecto JSON.
--header, -H Engade unha cabeceira HTTP en key:value formulario.
--include, -i Inclúe o estado da resposta e as cabeceiras.
--environment Anula a URL do entorno Dataverse.

api request Exemplos

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

Crea un novo perfil de autenticación.

auth create Parámetros

Usa estes parámetros para especificar o comportamento do auth create comando.

Parámetro Descripción
--environment, -env A URL do entorno Dataverse coa que queres autenticarte.
--name, -n Un nome opcional para o perfil. Usa o nome para seleccionar o perfil máis adiante.
--cloud, -ci A nube obxectivo: Public, UsGov, UsGovHigh, UsGovDod, ou China.
--deviceCode, -dc Usa o fluxo de autenticación por código do dispositivo, para ambientes sen navegador.
--username, -un O nome de usuario para a autenticación de nome de usuario e contrasinal.
--password, -p O contrasinal para o nome de usuario e a autenticación do contrasinal.
--applicationId, -id O ID da aplicación (cliente) para a autenticación do principal de servizo (SPN).
--clientSecret, -cs O segredo do cliente para a autenticación principal do servizo.
--certificateDiskPath, -cdp O camiño cara a un ficheiro de certificado .pfx para autenticación baseada en certificados.
--certificatePassword, -cp O contrasinal do certificado.
--tenant, -t O ID do inquilino. Requírese para a autenticación do principal do servizo.
--managedIdentity, -mi Usa unha identidade xestionada en Azure.
--githubFederated, -ghf Usa a autenticación federada de GitHub Actions.
--azureDevOpsFederated, -adof Usa a autenticación federada de Azure DevOps.
--clientid, -cid Un ID de cliente personalizado para a aplicación Microsoft Entra para usar en lugar da aplicación CLI predeterminada de Dataverse.
--no-default-environment Non poñas o ambiente como predeterminado.
--accept-cleartext-caching Permite unha caché de tokens en texto plano en Linux.

auth create Exemplos

Os seguintes exemplos demostran como usar o auth create comando.

Autenticación interactiva

Este comando abre un navegador ou un diálogo do sistema para obter información adicional.

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

Perfil nomeado

Crea un perfil cun nome específico.

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

Fluxo de código do dispositivo

Usa o fluxo de código do dispositivo para ambientes sen navegador.

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

Principal do servizo con segredo do cliente

Usa un principal de servizo cando precises autenticación sen supervisión, como nun pipeline CI/CD ou outro script automatizado onde non sexa posible iniciar sesión interactivamente. Proporciona o ID da aplicación, o secreto do cliente e o ID do inquilino dunha aplicación rexistrada que teña acceso ao entorno.

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

ID de cliente personalizado da aplicación Entra

Usa o rexistro da túa propia aplicación en lugar do predeterminado.

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

auth list Comando

Lista todos os perfís de autenticación. Engade --json para saída JSON en bruto.

auth list Exemplos

dataverse auth list
dataverse auth list --json

auth remove Comando

Elimina un ou todos os perfís de autenticación.

auth remove Parámetros

Parámetro Descripción
--index, -i Elimina o perfil co índice especificado baseado en 1, como se mostra en auth list.
--name, -n Elimina o perfil co nome especificado.
--all Elimina todos os perfís.

auth remove Exemplos

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

auth select Comando

Selecciona o perfil de autenticación activa. Executa o comando sen opcións para listar todos os perfís.

auth select Parámetros

Parámetro Descripción
--index, -i Seleccione o perfil polo seu índice baseado en 1, como se mostra en auth list.
--name, -n Selecciona o perfil polo nome.

auth select Exemplos

Abre un selector interactivo. Usa as frechas ou escribe para filtrar:

dataverse auth select

Selecciona un perfil por índice ou por nome:

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

auth who Comando

Mostrar o perfil de autenticación actual e activo. Engade --json para saída JSON en bruto.

auth who Exemplos

dataverse auth who
dataverse auth who --json

data associate Comando

Asocia dous rexistros a través dunha propiedade de navegación (relación). Este comando é compatible só con Dataverse.

data associate Parámetros

Parámetro Descripción
--table, -t O nome do conxunto da entidade do rexistro principal. Obrigatorio.
--id, -i O GUID do rexistro principal. Obrigatorio.
--relationship, -rel O nome da propiedade de navegación. Obrigatorio.
--related O nome do conxunto de entidades da táboa relacionada. Obrigatorio.
--related-id O GUID do rexistro relacionado. Obrigatorio.
--environment, -env Anula a URL do entorno.
--json Saída en JSON en bruto.

data associate Exemplos

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

data count Comando

Conta os rexistros nunha táboa, opcionalmente filtrado.

data count Parámetros

Parámetro Descripción
--table, -t O nome do conxunto da entidade. Obrigatorio a non ser que uses --fetchxml.
--filter, -f Unha expresión OData $filter .
--fetchxml Unha consulta agregada FetchXML para contas complexas.
--target Ruta a dataverse (por defecto) ou ao entorno vinculado erp .
--cross-company Só ERP. Conta en todas as compañías. Por defecto: a empresa predeterminada do usuario.
--environment, -env Anula a URL do entorno.
--json Saída en JSON en bruto.

data count Exemplos

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

data create Comando

Crea un novo rexistro nunha táboa Dataverse. Configura columnas de consulta usando @odata.bind sintaxe.

data create Parámetros

Parámetro Descripción
--table, -t O nome do conxunto da entidade. Obrigatorio.
--data, -d Un obxecto JSON cos valores do campo.
--data-file O camiño a un ficheiro JSON cos datos do rexistro.
--return, -r Devolve o rexistro completo creado.
--target Ruta a dataverse (por defecto) ou ao entorno vinculado erp .
--environment, -env Anula a URL do entorno.
--json Saída en JSON en bruto.

data create Exemplos

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

Suxestión

Úsao --data-file para JSON complexo. Usa --return --json para obter o rexistro completo creado.

data delete Comando

Elimina un único rexistro pola súa clave primaria ou por unha clave alternativa.

data delete Parámetros

Parámetro Descripción
--table, -t O nome do conxunto da entidade. Obrigatorio.
--id, -i O rexistro GUID.
--key, -k Unha tonalidade alternativa.
--no-confirm Salta o prompt de confirmación.
--target Ruta a dataverse (por defecto) ou ao entorno vinculado erp .
--environment, -env Anula a URL do entorno.
--json Saída en JSON en bruto.

data delete Exemplos

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

data describe Comando

Describe o esquema dunha entidade OData. Para Dataverse, o comando chama EntityDefinitions(LogicalName='<table>') con $expand conducido por --include, máis unha segunda chamada a customapis cando --include actions está establecido. As accións integradas de Dataverse como Assign e SetState non están enumeradas. Para ERP, unha única chamada devolve /Metadata/PublicEntities propiedades, accións limitadas e navegacións xuntas.

data describe Parámetros

Parámetro Descripción
--target O obxectivo: dataverse (por defecto) ou erp.
--table, -t Obrigatorio. Para Dataverse, o nome lóxico, como account. Para ERP, o nome do conxunto de entidades, como BatchJobs.
--include Unha lista separada por comas de seccións para incluír: entity, properties, relations, actions, ou all. Alias: attributes=properties, . relationships=relations Predeterminado para ERP: all. Predeterminado para Dataverse: entity,properties.
--json Saída en JSON en bruto.

data describe Exemplos

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

data disassociate Comando

Elimina unha relación entre dous rexistros. Este comando é compatible só con Dataverse.

data disassociate Parámetros

Parámetro Descripción
--table, -t O nome do conxunto da entidade do rexistro principal. Obrigatorio.
--id, -i O GUID do rexistro principal. Obrigatorio.
--relationship, -rel O nome da propiedade de navegación. Obrigatorio.
--related-id O GUID do rexistro relacionado, para unha relación de moitos a moitos. Omite este parámetro para borrar unha consulta.
--environment, -env Anula a URL do entorno.
--json Saída en JSON en bruto.

data disassociate Exemplos

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

data get Comando

Recuperar un único rexistro polo seu ID (clave primaria) ou por unha clave alternativa.

data get Parámetros

Parámetro Descripción
--table, -t O nome do conxunto da entidade. Obrigatorio.
--id, -i O rexistro GUID (clave primaria).
--key, -k Unha tonalidade alternativa, por "col='val'"exemplo .
--select, -s Unha lista de columnas separada por comas ($select).
--expand, -x Unha expresión OData $expand para rexistros relacionados.
--target Ruta a dataverse (por defecto) ou ao entorno vinculado erp .
--environment, -env Anula a URL do entorno.
--json Saída en JSON en bruto.

data get Exemplos

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

Executa unha consulta OData, FetchXML ou SQL sobre unha táboa Dataverse.

data query Parámetros

Parámetro Descripción
--table, -t A entidade estableceu o nome para consultar. Requirido para consultas OData.
--select, -s Unha lista de columnas separada por comas ($select).
--filter, -f Unha expresión OData $filter .
--orderby, -o Unha expresión OData $orderby .
--top O número máximo de rexistros para devolver (1-5000).
--expand, -x Unha expresión OData $expand para rexistros relacionados.
--fetchxml Unha consulta FetchXML en liña.
--fetchxml-file O camiño a un ficheiro que contén unha consulta FetchXML.
--sql Unha consulta SQL SELECT (vista prèvia).
--sql-file O camiño a un ficheiro que contén unha consulta SQL.
--all, -a Segue a paginación para recuperar todos os rexistros.
--max-records O número máximo de rexistros a recuperar ao usar --all. Predeterminado: 100000.
--target Ruta a dataverse (por defecto) ou ao entorno vinculado erp .
--cross-company Só ERP. Consulta en todas as empresas. Por defecto: a empresa predeterminada do usuario.
--environment, -env Anula a URL do entorno.
--json Saída en JSON en bruto.

data query Exemplos

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áis información

data update Comando

Actualiza un ou máis campos nun rexistro existente, identificados polo seu ID ou por unha clave alternativa. Configura columnas de consulta usando @odata.bind sintaxe.

data update Parámetros

Parámetro Descripción
--table, -t O nome do conxunto da entidade. Obrigatorio.
--id, -i O rexistro GUID.
--key, -k Unha tonalidade alternativa.
--data, -d Un obxecto JSON cos campos para actualizar.
--data-file O camiño cara a un ficheiro JSON cos datos de actualización.
--return, -r Devolve o rexistro completo actualizado.
--target Ruta a dataverse (por defecto) ou ao entorno vinculado erp .
--environment, -env Anula a URL do entorno.
--json Saída en JSON en bruto.

data update Exemplos

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

data upload Comando

Sube un ficheiro local a unha columna de ficheiro Dataverse nun rexistro existente. O comando selecciona automaticamente unha solicitude única ou unha subida fragmentada segundo o tamaño do ficheiro, a menos que especifiques --mode. En modo automático, os ficheiros de menos de 128 MB súbense nunha única solicitude, e os ficheiros máis grandes usan unha subida fragmentada. Cando omites --mime-type, o comando infire o tipo MIME da extensión do ficheiro. As extensións descoñecidas teñen por defecto .application/octet-stream

data upload Parámetros

Parámetro Descripción
--table, -t O esquema da táboa ou nome lóxico, como account. Obrigatorio. O comando resolve o conxunto de entidades a partir dos metadatos.
--id, -i O rexistro GUID. Obrigatorio.
--column, -c O nome do atributo da columna do ficheiro. Obrigatorio.
--file, -f O camiño ao ficheiro local. Obrigatorio.
--mode, -m A estratexia de subida: auto (por defecto), small, ou chunk.
--mime-type Un tipo MIME explícito. Por defecto: inferido da extensión do ficheiro.
--overwrite Sobrescribe un ficheiro existente. Por defecto, o comando falla se a columna non está baleira.
--environment, -env Anula a URL do entorno.
--json Saída en JSON en bruto.

data upload Exemplos

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

Crea un rexistro se non existe, ou actualízao se existe. O disco identifícase por unha tonalidade alternativa. Aprende a usar unha clave alternativa para referenciar un rexistro

data upsert Parámetros

Parámetro Descripción
--table, -t O nome do conxunto da entidade. Obrigatorio.
--key, -k Unha tonalidade alternativa. Obrigatorio.
--data, -d Un obxecto JSON cos valores do campo.
--data-file O camiño cara a un ficheiro JSON.
--update-only Falla se o rexistro non existe (If-Match: *).
--create-only Fallo se o rexistro xa existe (If-None-Match: *).
--return, -r Devolve o rexistro completo despois da operación.
--target Ruta a dataverse (por defecto) ou ao entorno vinculado erp .
--environment, -env Anula a URL do entorno.
--json Saída en JSON en bruto.

data upsert Exemplos

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

erp batch cancel Comando

Cancela un traballo lotado de Finanzas e Operacións polo seu RecId. Úsase erp batch list para atopar o RecId.

erp batch cancel Exemplos

dataverse erp batch cancel <recid>

erp batch list Comando

Lista os traballos en lote na instancia de Finanzas e Operacións que está vinculada ao teu entorno Dataverse. O comando require un perfil de autenticación conectado a un entorno Dataverse que teña unha instancia de Finanzas e Operacións vinculada. A URL de Finanzas e Operacións deriva automaticamente da conexión Dataverse actual.

erp batch list Parámetros

Parámetro Descripción
--company Filtra por entidade legal (dataAreaId), como USMF.
--status Filtrar por estado: Waiting, Executing, Finished, Error, ou Cancelled.
--top O número máximo de resultados para devolver. Predeterminado: 20.
--caption Filtrar por subtítulo (coincidencia de subcadeas insensibles a maiúsculas).
--json Saída en JSON en bruto.

erp batch list Exemplos

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

install Comando

Instala unha versión específica da CLI de Dataverse, ou actualiza á última versión. O comando detecta se instalaches a CLI globalmente ou se a estás usando npx e instálase en consecuencia.

install Exemplos

Instala a última versión:

dataverse install latest

Instala unha versión específica:

dataverse install 1.0.0

mcp Comando

Inicia un servidor Model Context Protocol (MCP) que se conecta ao teu entorno, para que asistentes de IA como Claude Desktop poidan interactuar cos teus datos. O obxectivo detéctese automaticamente desde a URL: unha URL de Dataverse inicia o servidor MCP de Dataverse, e unha URL de Finanzas e Operacións, como https://myorg.operations.dynamics.com, inicia o servidor ERP MCP.

mcp Sintaxe

dataverse mcp <orgUrl> [options]

O <orgUrl> argumento é, por exemplo https://myorg.crm.dynamics.com, a URL da túa organización.

mcp Parámetros

Parámetro Descripción
--validate Valida os puntos finais MCP e a configuración da autenticación sen iniciar o servidor.
--log-level Establece o nivel de rexistro: Trace, Debug, Information, Warning, Error, ou Critical. Predeterminado: Warning.
--log-file Inicia sesión nun ficheiro no directorio temporal.
--preview Usa o endpoint de previsualización MCP (api/mcp_preview en lugar de api/mcp). Non está soportado para ERP.

mcp Exemplos

Valida a configuración (un primeiro paso recomendado):

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

Comeza o servidor usando o transporte stdio:

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

Usa o punto final de previsualización ou activa o rexistro de ficheiros de depuración:

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

mcp allow Comando

Asegúrate de que unha aplicación Microsoft Entra estea na lista de clientes permitidos de Dataverse MCP para o entorno do perfil actual. Este comando é unha alternativa ao paso manual de administración descrito nos prerequisitos. O usuario autenticado debe ter permisos de administrador de Dataverse no entorno obxectivo.

mcp allow Sintaxe

dataverse mcp allow <appId> [options]

O <appId> argumento é que o ID da aplicación (cliente) debe permitir, como un GUID.

mcp allow Parámetros

Parámetro Descripción
--erp Permite a aplicación na instancia vinculada de Finanzas e Operacións en lugar de Dataverse.

mcp allow Exemplos

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

Nota

Finanzas e Operacións almacena en caché a lista de permisos no AOS, polo que un ID de aplicación recentemente permitido pode tardar ata uns cinco minutos en facer efecto.

org list Comando

Fai unha lista de todos os ambientes aos que poidas acceder.

org list Parámetros

Parámetro Descripción
--filter Filtra a lista de ambientes por un termo de busca.
--json Saída en JSON en bruto.

org list Exemplos

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

org who Comando

Mostrar información sobre a organización actual e o usuario, usando o perfil de autenticación activa. O env comando é un alias para org.

org who Parámetros

Parámetro Descripción
--environment, -env Anula a URL do entorno.
--json Saída en JSON en bruto.

org who Exemplos

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

skill Comandos

Xestiona as habilidades de Dataverse—conxuntos de instrucións reutilizables (un SKILL.md ficheiro e os seus ficheiros de recursos) que usan os axentes de IA—que se almacenan no entorno conectado. Os comandos skill de nivel superior proporcionan operacións de crear, ler, actualizar e eliminar contra o entorno. Localmente, as habilidades almacénanse baixo .claude/skills/<name>/.

Nota

Os comandos de creación e avaliación de habilidades, como make, update, get, e eval, son separados destes comandos. Para máis información, executa dataverse workspace skill --help.

skill delete Comando

Elimina unha habilidade e todos os seus recursos do entorno activo Dataverse. Utilízao skill list para atopar nomes únicos de habilidades.

dataverse skill delete new_lead-qualification

skill download Comando

Descarga unha ou máis habilidades do entorno activo Dataverse ao disco. O comando descarga o SKILL.md ficheiro e todos os ficheiros de recursos, preservando a estrutura de directorios. Utilízao skill list para atopar nomes únicos de habilidades.

Parámetro Descripción
--all Descarga todas as habilidades activas do entorno. Non se pode combinar cun nome único dunha habilidade.
--output, -o O directorio base para a saída. Predeterminado: .claude/skills/. Con --all, cada habilidade escríbese en <path>/<name>/.
--json Saca o contido da habilidade en JSON sen escribir ficheiros. Opcionalmente, especifica un camiño de ficheiro para escribir. 
dataverse skill download new_lead-qualification
dataverse skill download --all --output ./skills

skill list Comando

Lista todas as habilidades activas no entorno Dataverse conectado.

Parámetro Descripción
--resources, -r Tamén lista os ficheiros de recursos para cada habilidade.
--json Saída en JSON. Opcionalmente, especifica un camiño de ficheiro para escribir. 
dataverse skill list
dataverse skill list --resources

skill upload Comando

Sube unha ou máis habilidades desde o disco ao entorno activo Dataverse. O comando soporta directorios, ficheiros.zip , ficheiros .skill e ficheiros .md .

Podes pasar unha habilidade <name>, que resolve a .claude/skills/<name>/, ou unha explícita <path> a un directorio ou ficheiro.

Parámetro Descripción
--all Sube todas as habilidades baixo .claude/skills/. Non se pode combinar cun nome ou camiño dunha habilidade.
--json Emite o resultado en JSON. Opcionalmente, especifica un camiño de ficheiro para escribir. 
dataverse skill upload lead-qualification
dataverse skill upload ./my-skill.zip
dataverse skill upload --all

Ver tamén

Traballar con datos usando a CLI Dataverse

  • Última actualización o