Referencia de la CLI de Dataverse (versión preliminar)

Note

  • Esta es una característica en vista previa.
  • Las características en vista previa no se han diseñado para un uso de producción y pueden tener una funcionalidad restringida. Estas características están disponibles antes del lanzamiento oficial para que los clientes puedan tener un acceso anticipado y proporcionar comentarios.

En este artículo se describen los comandos disponibles en la CLI de Dataverse. Cada comando admite una --help opción que enumera su uso, opciones y ejemplos. Los comandos que devuelven datos admiten una --json opción para la salida JSON sin procesar que resulta útil en los scripts.

Las siguientes opciones globales se pueden usar con cualquier comando:

Opción Description
--log-level <level> Establezca el nivel de registro: Trace, , InformationDebug, Warning, Erroro Critical. Valor predeterminado: Warning.
--log-file Inicie sesión en un archivo en el directorio temporal en lugar de en la consola.
--context <value> Contexto de operación anexado al agente de usuario. También puede establecer la variable de DATAVERSE_OPERATION_CONTEXT entorno.
Command Description
api describe Descripción de una API
api invoke Invocación de una API por nombre
api list Enumerar API detectables
api request Envío de una solicitud HTTP autenticada
auth create Creación de un nuevo perfil de autenticación
auth list Enumerar todos los perfiles de autenticación
auth remove Eliminación de un perfil de autenticación
auth select Selección del perfil de autenticación activo
auth who Mostrar el perfil de autenticación actual
data associate Vincular dos registros a través de una relación
data count Recuento de registros en una tabla
data create Crear un registro nuevo
data delete Eliminar un registro
data describe Describir el esquema de una entidad
data disassociate Quitar una relación entre dos registros
data get Recuperación de un único registro por identificador o clave alternativa
data query Ejecución de una consulta OData, FetchXML o SQL
data update Actualizar un registro existente
data upload Carga de un archivo en una columna de archivo en un registro existente
data upsert Creación o actualización de un registro mediante clave alternativa
erp batch cancel Cancelación de un trabajo por lotes de finanzas y operaciones
erp batch list Enumeración de trabajos por lotes de finanzas y operaciones
install Instalar una versión específica o actualizar a la versión más reciente
mcp Iniciar el servidor MCP para Dataverse o ERP
mcp allow Permitir una aplicación como cliente MCP
org list Enumerar todos los entornos accesibles
org who Mostrar la información actual de la organización y del usuario
skill delete Eliminación de una aptitud de Dataverse
skill download Descarga de una aptitud de Dataverse
skill list Enumeración de aptitudes activas en el entorno
skill upload Carga de una aptitud en Dataverse

Note

Muchos comandos admiten una --target <dataverse\|erp> opción que enruta la operación a Dataverse (valor predeterminado) o al entorno vinculado Finance and Operations (ERP). Los comandos que se conectan a un entorno admiten una --environment <url> opción (-env) para invalidar la dirección URL del entorno del perfil actual.

Comando api describe

Mostrar los metadatos de una sola API. En el caso de las API personalizadas de Dataverse, la salida incluye descripciones de parámetros de solicitud y de propiedades de respuesta cuando los metadatos los proporcionan.

Los nombres de Dataverse no están prefijos de forma predeterminada. Puede usar nombres calificados de ERP con el formato erp:ServiceGroup/Service/Operation.

Parámetros api describe

Parameter Description
--target Resuelva un nombre no completo con dataverse o erp.
--service-group ERP sólo. Restrinja la búsqueda de la operación a un grupo de servicios.
--service ERP sólo. Restrinja la búsqueda de la operación a un servicio.
--environment Invalide la dirección URL del entorno de Dataverse.
--json Salida JSON sin formato.

ejemplos de api describe

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

Comando api invoke

Invoque una API detectada por nombre. Use name=value la sintaxis para los parámetros. Si un valor contiene espacios, comillas el token completo. Algunas API de Dataverse aceptan un parámetro de cadena cuyo contenido es JSON. En ese caso, pase el texto JSON como valor mediante las reglas normales de comillas y escape del shell.

De forma predeterminada, las respuestas JSON se representan en un formato de texto descriptivo que mantiene los nombres de las propiedades de salida. Use --json para conservar la carga JSON sin procesar.

Parámetros api invoke

Parameter Description
--target Resuelva un nombre no completo con dataverse o erp.
--service-group ERP sólo. Restrinja la búsqueda de la operación a un grupo de servicios.
--service ERP sólo. Restrinja la búsqueda de la operación a un servicio.
--param Agregue un parámetro con nombre en name=value el formulario. Repetible.
--bind Ruta de acceso de enlace para las API de Dataverse enlazadas a entidades.
--method, -X Invalide el método HTTP inferido.
--body Use un cuerpo JSON sin formato en lugar de parámetros con nombre.
--body-file Lee un cuerpo JSON sin formato de un archivo.
--header, -H Agregue un encabezado HTTP en key:value el formulario.
--include, -i Incluya el estado de respuesta y los encabezados.
--environment Invalide la dirección URL del entorno de Dataverse.
--json Genera JSON sin formato en lugar de texto descriptivo.

ejemplos de api invoke

Invoque una función dataverse. En este ejemplo se muestra el uso de la función Dynamics 365 Contact Center CCaaS_GetPresence.

dataverse api invoke CCaaS_GetPresence ApiVersion=1.0

Invoque la acción Dataverse AISummarize con espacios en un valor de parámetro:

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

Invocación de un servicio personalizado ERP:

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

Comando api list

Enumere las API detectables, como las API personalizadas de Dataverse y los puntos de conexión de servicio invocables de ERP. Los resultados muestran la identidad de la API, el nombre descriptivo, el tipo y la descripción cuando están disponibles. Puede pasar un término de consulta opcional para filtrar los resultados.

Parámetros api list

Parameter Description
--target Sistema de destino que se va a buscar: dataverse (valor predeterminado) o erp.
--service-group ERP sólo. Filtre por un único grupo de servicios.
--service ERP sólo. Filtre por un único servicio.
--limit Número máximo de API que se van a devolver. Valor predeterminado: 50.
--page Número de página basado en 1 al paginar a través de los resultados. Valor predeterminado: 1.
--environment Invalide la dirección URL del entorno de Dataverse.
--json Salida JSON sin formato.

ejemplos de api list

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

Comando api request

Envíe una solicitud HTTP autenticada sin procesar a Dataverse o ERP. Use este comando cuando necesite control total sobre la ruta de acceso, el método, los encabezados y el cuerpo.

Parámetros api request

Parameter Description
--target Sistema de destino: dataverse o erp. Required.
--path Ruta de acceso de la solicitud. Required.
--method, -X Método HTTP. Valor predeterminado: GETo POST cuando se proporciona un cuerpo.
--body Un cuerpo de solicitud JSON insertado.
--body-file Archivo que contiene un cuerpo de solicitud de objeto JSON.
--header, -H Agregue un encabezado HTTP en key:value el formulario.
--include, -i Incluya el estado de respuesta y los encabezados.
--environment Invalide la dirección URL del entorno de Dataverse.

ejemplos de api request

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 "{}"

Comando auth create

Cree un nuevo perfil de autenticación.

Parámetros auth create

Use estos parámetros para especificar el comportamiento del auth create comando.

Parameter Description
--environment, -env Dirección URL del entorno de Dataverse con la que desea autenticarse.
--name, -n Un nombre opcional para el perfil. Use el nombre para seleccionar el perfil más adelante.
--cloud, -ci La nube de destino: Public, UsGov, UsGovHigh, UsGovDodo China.
--deviceCode, -dc Use el flujo de autenticación de código de dispositivo para entornos sin explorador.
--username, -un Nombre de usuario para la autenticación de nombre de usuario y contraseña.
--password, -p Contraseña para la autenticación de nombre de usuario y contraseña.
--applicationId, -id Identificador de aplicación (cliente) para la autenticación de entidad de servicio (SPN).
--clientSecret, -cs Secreto de cliente para la autenticación de la entidad de servicio.
--certificateDiskPath, -cdp Ruta de acceso a un archivo de certificado .pfx para la autenticación basada en certificados.
--certificatePassword, -cp La contraseña del certificado
--tenant, -t El identificador de inquilino. Se requiere para la autenticación de la entidad de servicio.
--managedIdentity, -mi Use una identidad administrada Azure.
--githubFederated, -ghf Use Acciones de GitHub autenticación federada.
--azureDevOpsFederated, -adof Use Azure DevOps autenticación federada.
--clientid, -cid Un identificador de cliente de aplicación de Microsoft Entra personalizado que se usará en lugar de la aplicación predeterminada de la CLI de Dataverse.
--no-default-environment No establezca el entorno como predeterminado.
--accept-cleartext-caching Permitir una caché de tokens de texto no cifrado en Linux.

ejemplos de auth create

En los ejemplos siguientes se muestra cómo usar el auth create comando .

Autenticación interactiva

Este comando abre un cuadro de diálogo del sistema o del explorador para obtener información adicional.

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

Perfil con nombre

Cree un perfil con un nombre específico.

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

Flujo de código de dispositivo

Use el flujo de código del dispositivo para entornos sin explorador.

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

Entidad de servicio con secreto de cliente

Use una entidad de servicio cuando necesite autenticación desatendida, como en una canalización de CI/CD u otro script automatizado en el que el inicio de sesión interactivo no sea posible. Proporcione el identificador de aplicación, el secreto de cliente y el identificador de inquilino de un registro de aplicación que tenga acceso al entorno.

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

Id. de cliente de aplicación Entra personalizado

Use su propio registro de aplicaciones en lugar del valor predeterminado.

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

Comando auth list

Enumera todos los perfiles de autenticación. Agregue --json para la salida JSON sin formato.

ejemplos de auth list

dataverse auth list
dataverse auth list --json

Comando auth remove

Quite uno o todos los perfiles de autenticación.

Parámetros auth remove

Parameter Description
--index, -i Quite el perfil con el índice basado en 1 especificado, como se muestra en auth list.
--name, -n Quite el perfil con el nombre especificado.
--all Quite todos los perfiles.

ejemplos de auth remove

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

Comando auth select

Seleccione el perfil de autenticación activo. Ejecute el comando sin opciones para enumerar todos los perfiles.

Parámetros auth select

Parameter Description
--index, -i Seleccione el perfil por su índice basado en 1, como se muestra en auth list.
--name, -n Seleccione el perfil por nombre.

ejemplos de auth select

Abra un selector interactivo. Use las teclas de dirección o escriba para filtrar:

dataverse auth select

Seleccione un perfil por índice o por nombre:

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

Comando auth who

Muestra el perfil de autenticación activo actual. Agregue --json para la salida JSON sin formato.

ejemplos de auth who

dataverse auth who
dataverse auth who --json

Comando data associate

Asocie dos registros a través de una propiedad de navegación (relación). Este comando solo se admite para Dataverse.

Parámetros data associate

Parameter Description
--table, -t Nombre del conjunto de entidades del registro principal. Required.
--id, -i GUID del registro principal. Required.
--relationship, -rel Nombre de la propiedad de navegación. Required.
--related Nombre del conjunto de entidades de la tabla relacionada. Required.
--related-id Guid del registro relacionado. Required.
--environment, -env Invalide la dirección URL del entorno.
--json Salida JSON sin formato.

ejemplos de data associate

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

Comando data count

Cuente los registros de una tabla, opcionalmente filtrados.

Parámetros data count

Parameter Description
--table, -t Nombre del conjunto de entidades. Necesario a menos que use --fetchxml.
--filter, -f Expresión OData $filter .
--fetchxml Una consulta de agregado FetchXML para recuentos complejos.
--target Enrutar a dataverse (valor predeterminado) o al entorno vinculado erp .
--cross-company ERP sólo. Contar en todas las empresas. Valor predeterminado: la empresa predeterminada del usuario.
--environment, -env Invalide la dirección URL del entorno.
--json Salida JSON sin formato.

ejemplos de data count

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

Comando data create

Cree un registro en una tabla de Dataverse. Establezca columnas de búsqueda mediante @odata.bind la sintaxis .

Parámetros data create

Parameter Description
--table, -t Nombre del conjunto de entidades. Required.
--data, -d Objeto JSON con los valores de campo.
--data-file Ruta de acceso a un archivo JSON con los datos de registro.
--return, -r Devuelve el registro creado completo.
--target Enrutar a dataverse (valor predeterminado) o al entorno vinculado erp .
--environment, -env Invalide la dirección URL del entorno.
--json Salida JSON sin formato.

ejemplos de data create

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

Tip

Se usa --data-file para JSON complejo. Use --return --json para obtener el registro creado completo.

Comando data delete

Elimine un único registro por su clave principal o por una clave alternativa.

Parámetros data delete

Parameter Description
--table, -t Nombre del conjunto de entidades. Required.
--id, -i GUID de registro.
--key, -k Una clave alternativa.
--no-confirm Omita el mensaje de confirmación.
--target Enrutar a dataverse (valor predeterminado) o al entorno vinculado erp .
--environment, -env Invalide la dirección URL del entorno.
--json Salida JSON sin formato.

ejemplos de data delete

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

Comando data describe

Describir el esquema de una entidad OData. Para Dataverse, el comando llama EntityDefinitions(LogicalName='<table>') a con $expand controlado por --include, además de una segunda llamada a customapis cuando --include actions se establece. Las acciones integradas de Dataverse como Assign y SetState no se enumeran. Para ERP, una sola llamada a /Metadata/PublicEntities devuelve propiedades, acciones enlazadas y navegaciones juntas.

Parámetros data describe

Parameter Description
--target Destino: dataverse (valor predeterminado) o erp.
--table, -t Required. Para Dataverse, el nombre lógico, como account. Para ERP, el nombre del conjunto de entidades, como BatchJobs.
--include Lista separada por comas de secciones que se van a incluir: entity, properties, relations, actionso all. Alias: attributes=properties, . relationships=relations Valor predeterminado para ERP: all. Valor predeterminado para Dataverse: entity,properties.
--json Salida JSON sin formato.

ejemplos de data describe

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

Comando data disassociate

Quite una relación entre dos registros. Este comando solo se admite para Dataverse.

Parámetros data disassociate

Parameter Description
--table, -t Nombre del conjunto de entidades del registro principal. Required.
--id, -i GUID del registro principal. Required.
--relationship, -rel Nombre de la propiedad de navegación. Required.
--related-id GUID del registro relacionado para una relación de varios a varios. Omita este parámetro para borrar una búsqueda.
--environment, -env Invalide la dirección URL del entorno.
--json Salida JSON sin formato.

ejemplos de data disassociate

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

Comando data get

Recupere un único registro por su identificador (clave principal) o por una clave alternativa.

Parámetros data get

Parameter Description
--table, -t Nombre del conjunto de entidades. Required.
--id, -i GUID de registro (clave principal).
--key, -k Una clave alternativa, por ejemplo "col='val'", .
--select, -s Una lista separada por comas de columnas ($select).
--expand, -x Expresión OData $expand para registros relacionados.
--target Enrutar a dataverse (valor predeterminado) o al entorno vinculado erp .
--environment, -env Invalide la dirección URL del entorno.
--json Salida JSON sin formato.

ejemplos de data get

dataverse data get --table accounts --id 00000000-0000-0000-0000-000000000001
dataverse data get --target erp --table Currencies --key "CurrencyCode='AED'" --select "CurrencyCode,Name"

Comando data query

Ejecute una consulta OData, FetchXML o SQL en una tabla de Dataverse.

Parámetros data query

Parameter Description
--table, -t Nombre del conjunto de entidades que se va a consultar. Necesario para las consultas de OData.
--select, -s Una lista separada por comas de columnas ($select).
--filter, -f Expresión OData $filter .
--orderby, -o Expresión OData $orderby .
--top Número máximo de registros que se van a devolver (1-5000).
--expand, -x Expresión OData $expand para registros relacionados.
--fetchxml Una consulta FetchXML insertada.
--fetchxml-file Ruta de acceso a un archivo que contiene una consulta FetchXML.
--sql Una consulta SQL SELECT (versión preliminar).
--sql-file Ruta de acceso a un archivo que contiene una consulta SQL.
--all, -a Siga la paginación para recuperar todos los registros.
--max-records Número máximo de registros que se van a recuperar al usar --all. Valor predeterminado: 100000.
--target Enrutar a dataverse (valor predeterminado) o al entorno vinculado erp .
--cross-company ERP sólo. Consulta en todas las empresas. Valor predeterminado: la empresa predeterminada del usuario.
--environment, -env Invalide la dirección URL del entorno.
--json Salida JSON sin formato.

ejemplos de data query

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

Aprende más

Comando data update

Actualice uno o varios campos en un registro existente, identificado por su identificador o por una clave alternativa. Establezca columnas de búsqueda mediante @odata.bind la sintaxis .

Parámetros data update

Parameter Description
--table, -t Nombre del conjunto de entidades. Required.
--id, -i GUID de registro.
--key, -k Una clave alternativa.
--data, -d Objeto JSON con los campos que se van a actualizar.
--data-file Ruta de acceso a un archivo JSON con los datos de actualización.
--return, -r Devuelve el registro actualizado completo.
--target Enrutar a dataverse (valor predeterminado) o al entorno vinculado erp .
--environment, -env Invalide la dirección URL del entorno.
--json Salida JSON sin formato.

ejemplos de data update

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

Comando data upload

Cargue un archivo local en una columna de archivo de Dataverse en un registro existente. El comando selecciona automáticamente una carga fragmentada o solicitud única en función del tamaño del archivo, a menos que especifique --mode. En el modo automático, los archivos menores de 128 MB se cargan en una sola solicitud y los archivos más grandes usan una carga fragmentada. Cuando se omite --mime-type, el comando deduce el tipo MIME de la extensión de archivo. Extensiones desconocidas predeterminadas para application/octet-stream.

Parámetros data upload

Parameter Description
--table, -t Esquema de tabla o nombre lógico, como account. Required. El comando resuelve el conjunto de entidades a partir de metadatos.
--id, -i GUID de registro. Required.
--column, -c Nombre del atributo de columna de archivo. Required.
--file, -f Ruta de acceso al archivo local. Required.
--mode, -m Estrategia de carga: auto (valor predeterminado), smallo chunk.
--mime-type Tipo MIME explícito. Valor predeterminado: se deduce de la extensión de archivo.
--overwrite Sobrescriba un archivo existente. De forma predeterminada, se produce un error en el comando si la columna no está vacía.
--environment, -env Invalide la dirección URL del entorno.
--json Salida JSON sin formato.

ejemplos de data upload

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

Comando data upsert

Cree un registro si no existe o actualícelo si lo hace. El registro se identifica mediante una clave alternativa. Aprenda a usar una clave alternativa para hacer referencia a un registro.

Parámetros data upsert

Parameter Description
--table, -t Nombre del conjunto de entidades. Required.
--key, -k Una clave alternativa. Required.
--data, -d Objeto JSON con los valores de campo.
--data-file Ruta de acceso a un archivo JSON.
--update-only Produce un error si el registro no existe (If-Match: *).
--create-only Produce un error si el registro ya existe (If-None-Match: *).
--return, -r Devuelve el registro completo después de la operación.
--target Enrutar a dataverse (valor predeterminado) o al entorno vinculado erp .
--environment, -env Invalide la dirección URL del entorno.
--json Salida JSON sin formato.

ejemplos de data upsert

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

Comando erp batch cancel

Cancele un trabajo por lotes de Finance and Operations por su RecId. Use erp batch list para buscar .RecId

ejemplos de erp batch cancel

dataverse erp batch cancel <recid>

Comando erp batch list

Enumere los trabajos por lotes en la instancia de Finance and Operations que esté vinculada al entorno de Dataverse. El comando requiere un perfil de autenticación conectado a un entorno de Dataverse que tenga una instancia vinculada de Finance and Operations. La dirección URL de Finance and Operations se deriva automáticamente de la conexión actual de Dataverse.

Parámetros erp batch list

Parameter Description
--company Filtre por entidad jurídica (dataAreaId), como USMF.
--status Filtre por estado: Waiting, Executing, Finished, Erroro Cancelled.
--top El número máximo de resultados que se devolverán. Valor predeterminado: 20.
--caption Filtre por título (coincidencia de subcadena sin distinción entre mayúsculas y minúsculas).
--json Salida JSON sin formato.

ejemplos de erp batch list

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

Comando install

Instale una versión específica de la CLI de Dataverse o actualice a la versión más reciente. El comando detecta si ha instalado la CLI globalmente o npx usa e instala en consecuencia.

ejemplos de install

Instale la última versión:

dataverse install latest

Instale una versión específica:

dataverse install 1.0.0

Comando mcp

Inicia un servidor de Protocolo de contexto de modelo (MCP) que se conecta a su entorno, de modo que los asistentes de IA, como Claude Desktop, puedan interactuar con los datos. El destino se detecta automáticamente desde la dirección URL: una dirección URL de Dataverse inicia el servidor MCP de Dataverse y una dirección URL de Finance and Operations, como https://myorg.operations.dynamics.com, inicia el servidor MCP de ERP.

sintaxis de mcp

dataverse mcp <orgUrl> [options]

El <orgUrl> argumento es la dirección URL de la organización, por ejemplo https://myorg.crm.dynamics.com.

Parámetros mcp

Parameter Description
--validate Valide los puntos de conexión de MCP y la configuración de autenticación sin iniciar el servidor.
--log-level Establezca el nivel de registro: Trace, , InformationDebug, Warning, Erroro Critical. Valor predeterminado: Warning.
--log-file Inicie sesión en un archivo en el directorio temporal.
--preview Use la versión preliminar del punto de conexión de MCP (api/mcp_preview en lugar de api/mcp). No se admite para ERP.

ejemplos de mcp

Valide la configuración (un primer paso recomendado):

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

Inicie el servidor mediante el transporte stdio:

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

Use el punto de conexión de vista previa o habilite el registro de archivos de depuración:

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

Comando mcp allow

Asegúrese de que una aplicación de Microsoft Entra esté en la lista de clientes permitidos de Dataverse MCP para el entorno del perfil actual. Este comando es una alternativa al paso de administrador manual descrito en los requisitos previos. El usuario autenticado debe tener permisos de administrador de Dataverse en el entorno de destino.

sintaxis de mcp allow

dataverse mcp allow <appId> [options]

El <appId> argumento es el identificador de aplicación (cliente) que se va a permitir, como GUID.

Parámetros mcp allow

Parameter Description
--erp Permita la aplicación en la instancia vinculada de Finance and Operations en lugar de Dataverse.

ejemplos de mcp allow

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

Note

Finance and Operations almacena en caché la lista de permitidos en AOS, por lo que un identificador de aplicación recién permitido puede tardar hasta cinco minutos en surtir efecto.

Comando org list

Enumere todos los entornos a los que puede acceder.

Parámetros org list

Parameter Description
--filter Filtre la lista de entornos por un término de búsqueda.
--json Salida JSON sin formato.

ejemplos de org list

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

Comando org who

Mostrar información sobre la organización y el usuario actuales mediante el perfil de autenticación activo. El env comando es un alias para org.

Parámetros org who

Parameter Description
--environment, -env Invalide la dirección URL del entorno.
--json Salida JSON sin formato.

ejemplos de org who

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

comandos de skill

Administrar aptitudes de Dataverse: conjuntos de instrucciones reutilizables (un SKILL.md archivo y sus archivos de recursos) que usan los agentes de INTELIGENCIA ARTIFICIAL que se almacenan en el entorno conectado. Los comandos de nivel skill superior proporcionan operaciones de creación, lectura, actualización y eliminación en el entorno. Localmente, las aptitudes se almacenan en .claude/skills/<name>/.

Note

Los comandos de creación y evaluación de aptitudes, como make, update, gety eval, son independientes de estos comandos. Para más información, vea dataverse workspace skill --help.

Comando skill delete

Elimine una aptitud y todos sus recursos del entorno activo de Dataverse. Use skill list para buscar nombres únicos de aptitud.

dataverse skill delete new_lead-qualification

Comando skill download

Descargue una o varias aptitudes del entorno activo de Dataverse en el disco. El comando descarga el SKILL.md archivo y todos los archivos de recursos, conservando la estructura de directorios. Use skill list para buscar nombres únicos de aptitud.

Parameter Description
--all Descargue todas las aptitudes activas del entorno. No se puede combinar con un nombre único de aptitud.
--output, -o Directorio base para la salida. Valor predeterminado: .claude/skills/. Con --all, cada aptitud se escribe en <path>/<name>/.
--json Genera el contenido de la aptitud como JSON sin escribir archivos. Opcionalmente, especifique una ruta de acceso de archivo en la que escribir. 
dataverse skill download new_lead-qualification
dataverse skill download --all --output ./skills

Comando skill list

Enumere todas las aptitudes activas en el entorno de Dataverse conectado.

Parameter Description
--resources, -r Enumera también los archivos de recursos de cada aptitud.
--json Salida como JSON. Opcionalmente, especifique una ruta de acceso de archivo en la que escribir. 
dataverse skill list
dataverse skill list --resources

Comando skill upload

Cargue una o varias aptitudes del disco en el entorno activo de Dataverse. El comando admite directorios, archivos.zip , archivos .skill y archivos .md .

Puede pasar una aptitud <name>, que se resuelve .claude/skills/<name>/en o en un directorio o archivo explícitos <path> .

Parameter Description
--all Cargue todas las aptitudes en .claude/skills/. No se puede combinar con un nombre de aptitud ni una ruta de acceso.
--json Genera el resultado como JSON. Opcionalmente, especifique una ruta de acceso de archivo en la que escribir. 
dataverse skill upload lead-qualification
dataverse skill upload ./my-skill.zip
dataverse skill upload --all

Véase también

Trabajar con datos mediante la CLI de Dataverse

  • Last updated on