Informations de référence sur l’interface CLI Dataverse (préversion)

Note

  • Cette fonctionnalité est en version préliminaire.
  • Les fonctionnalités en version préliminaire ne sont pas destinées à une utilisation en production et peuvent être restreintes. Ces fonctionnalités sont mises à la disposition des clients avant le lancement officiel pour leur permettre d’y accéder en avant-première et de fournir des retours d’expérience.

Cet article décrit les commandes disponibles dans l’interface CLI Dataverse. Chaque commande prend en charge une --help option qui répertorie son utilisation, ses options et ses exemples. Les commandes qui retournent des données prennent en charge une option pour la --json sortie JSON brute utile dans les scripts.

Les options globales suivantes peuvent être utilisées avec n’importe quelle commande :

Option Description
--log-level <level> Définissez le niveau de journalisation : Trace, , DebugInformation, Warning, Error, ou Critical. Valeur par défaut : Warning.
--log-file Connectez-vous à un fichier dans le répertoire temporaire au lieu de la console.
--context <value> Contexte d’opération ajouté à l’agent utilisateur. Vous pouvez également définir la variable d’environnement DATAVERSE_OPERATION_CONTEXT .
Command Description
api describe Décrire une API
api invoke Appeler une API par nom
api list Répertorier les API détectables
api request Envoyer une requête HTTP authentifiée
auth create Créer un profil d’authentification
auth list Répertorier tous les profils d’authentification
auth remove Supprimer un profil d’authentification
auth select Sélectionner le profil d’authentification actif
auth who Afficher le profil d’authentification actuel
data associate Lier deux enregistrements via une relation
data count Compter les enregistrements dans une table
data create Créer un nouvel enregistrement
data delete Supprimer un enregistrement
data describe Décrire le schéma d’une entité
data disassociate Supprimer une relation entre deux enregistrements
data get Récupérer un enregistrement unique par ID ou autre clé
data query Exécuter une requête OData, FetchXML ou SQL
data update Mettre à jour un enregistrement existant
data upload Charger un fichier dans une colonne de fichier sur un enregistrement existant
data upsert Créer ou mettre à jour un enregistrement à l’aide d’une autre clé
erp batch cancel Annuler un travail de traitement par lots Finance et Opérations
erp batch list Répertorier les travaux de traitement par lots Finance et Opérations
install Installer une version spécifique ou effectuer une mise à jour vers la dernière version
mcp Démarrer le serveur MCP pour Dataverse ou ERP
mcp allow Autoriser une application en tant que client MCP
org list Répertorier tous les environnements accessibles
org who Afficher les informations actuelles de l’organisation et de l’utilisateur
skill delete Supprimer une compétence de Dataverse
skill download Télécharger une compétence à partir de Dataverse
skill list Répertorier les compétences actives dans l’environnement
skill upload Charger une compétence dans Dataverse

Note

De nombreuses commandes prennent en charge une --target <dataverse\|erp> option qui achemine l’opération vers Dataverse (valeur par défaut) ou vers l’environnement Finance and Operations (ERP) lié. Les commandes qui se connectent à un environnement prennent en charge une --environment <url> option (-env) pour remplacer l’URL d’environnement du profil actuel.

api describe commande

Afficher les métadonnées d’une SEULE API. Pour les API personnalisées Dataverse, la sortie inclut des descriptions de propriétés de paramètre de requête et de réponse lorsque les métadonnées les fournissent.

Les noms dataverses ne sont pas préfixés par défaut. Vous pouvez utiliser des noms qualifiés ERP dans le formulaire erp:ServiceGroup/Service/Operation.

Paramètres api describe

Paramètre Description
--target Résolvez un nom non qualifié par rapport dataverse à ou erp.
--service-group ERP uniquement. Limitez la recherche de l’opération à un groupe de services.
--service ERP uniquement. Limitez la recherche de l’opération à un service.
--environment Remplacez l’URL de l’environnement Dataverse.
--json Sortie JSON brute.

Exemples api describe

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

api invoke commande

Appelez une API découverte par nom. Utilisez name=value la syntaxe des paramètres. Si une valeur contient des espaces, citez l’ensemble du jeton. Certaines API Dataverse acceptent un paramètre de chaîne dont le contenu est lui-même JSON. Dans ce cas, transmettez le texte JSON comme valeur à l’aide des règles normales de guillemets et d’échappement de votre interpréteur de commandes.

Par défaut, les réponses JSON sont affichées dans un format de texte convivial qui conserve les noms des propriétés de sortie. Permet --json de conserver la charge utile JSON brute.

Paramètres api invoke

Paramètre Description
--target Résolvez un nom non qualifié par rapport dataverse à ou erp.
--service-group ERP uniquement. Limitez la recherche de l’opération à un groupe de services.
--service ERP uniquement. Limitez la recherche de l’opération à un service.
--param Ajoutez un paramètre nommé sous name=value forme. Répétable.
--bind Chemin de liaison pour les API Dataverse liées à l’entité.
--method, -X Remplacez la méthode HTTP déduite.
--body Utilisez un corps JSON brut au lieu de paramètres nommés.
--body-file Lit un corps JSON brut à partir d’un fichier.
--header, -H Ajoutez un en-tête HTTP dans le key:value formulaire.
--include, -i Incluez l’état de la réponse et les en-têtes.
--environment Remplacez l’URL de l’environnement Dataverse.
--json Sortie json brut au lieu de texte convivial.

Exemples api invoke

Appelez une fonction Dataverse. Cet exemple montre l’utilisation de la fonction Dynamics 365 Contact Center CCaaS_GetPresence.

dataverse api invoke CCaaS_GetPresence ApiVersion=1.0

Appelez l’action DATAverse AISummarize avec des espaces dans une valeur de paramètre :

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

Appelez un service personnalisé ERP :

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

api list commande

Répertorier les API détectables, telles que les API personnalisées Dataverse et les points de terminaison de service invocables ERP. Les résultats indiquent l’identité de l’API, le nom convivial, le type et la description lorsqu’elles sont disponibles. Vous pouvez passer un terme de requête facultatif pour filtrer les résultats.

Paramètres api list

Paramètre Description
--target Système cible à rechercher : dataverse (par défaut) ou erp.
--service-group ERP uniquement. Filtrez sur un seul groupe de services.
--service ERP uniquement. Filtrez sur un seul service.
--limit Nombre maximal d’API à retourner. Valeur par défaut : 50.
--page Numéro de page basé sur 1 lors de la pagination des résultats. Valeur par défaut : 1.
--environment Remplacez l’URL de l’environnement Dataverse.
--json Sortie JSON brute.

Exemples 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

api request commande

Envoyez une requête HTTP authentifiée brute à Dataverse ou ERP. Utilisez cette commande lorsque vous avez besoin d’un contrôle total sur le chemin, la méthode, les en-têtes et le corps.

Paramètres api request

Paramètre Description
--target Le système cible : dataverse ou erp. Required.
--path chemin d'accès de la requête. Required.
--method, -X Méthode HTTP. Valeur par défaut : GETou POST lorsqu’un corps est fourni.
--body Corps de la requête JSON inline.
--body-file Fichier qui contient un corps de requête d’objet JSON.
--header, -H Ajoutez un en-tête HTTP dans le key:value formulaire.
--include, -i Incluez l’état de la réponse et les en-têtes.
--environment Remplacez l’URL de l’environnement Dataverse.

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

auth create commande

Créez un profil d’authentification.

Paramètres auth create

Utilisez ces paramètres pour spécifier le comportement de la auth create commande.

Paramètre Description
--environment, -env URL de l’environnement Dataverse avec lequel vous souhaitez vous authentifier.
--name, -n Nom facultatif du profil. Utilisez le nom pour sélectionner le profil ultérieurement.
--cloud, -ci Le cloud cible : Public, , UsGovHighUsGov, UsGovDod, ou China.
--deviceCode, -dc Utilisez le flux d’authentification du code de l’appareil, pour les environnements sans navigateur.
--username, -un Nom d’utilisateur pour l’authentification par nom d’utilisateur et mot de passe.
--password, -p Mot de passe pour l’authentification par nom d’utilisateur et mot de passe.
--applicationId, -id ID d’application (client) pour l’authentification du principal de service (SPN).
--clientSecret, -cs Clé secrète client pour l’authentification du principal de service.
--certificateDiskPath, -cdp Chemin d’accès à un fichier de certificat .pfx pour l’authentification basée sur un certificat.
--certificatePassword, -cp Le mot de passe du certificat.
--tenant, -t ID du client. Obligatoire pour l’authentification du principal de service.
--managedIdentity, -mi Utilisez une identité managée Azure.
--githubFederated, -ghf Utilisez GitHub Actions authentification fédérée.
--azureDevOpsFederated, -adof Utilisez Azure DevOps authentification fédérée.
--clientid, -cid ID client d’application Microsoft Entra personnalisé à utiliser au lieu de l’application CLI Dataverse par défaut.
--no-default-environment Ne définissez pas l’environnement comme valeur par défaut.
--accept-cleartext-caching Autoriser un cache de jetons en texte clair sur Linux.

Exemples auth create

Les exemples suivants montrent comment utiliser la auth create commande.

Authentification interactive

Cette commande ouvre une boîte de dialogue navigateur ou système pour obtenir des informations supplémentaires.

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

Profil nommé

Créez un profil avec un nom spécifique.

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

Flux de code de périphérique

Utilisez le flux de code de l’appareil pour les environnements sans navigateur.

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

Principal du service avec secret client

Utilisez un principal de service lorsque vous avez besoin d’une authentification sans assistance, comme dans un pipeline CI/CD ou un autre script automatisé où la connexion interactive n’est pas possible. Fournissez l’ID d’application, la clé secrète client et l’ID de locataire d’une inscription d’application qui a accès à l’environnement.

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

ID client de l’application Entra personnalisée

Utilisez votre propre inscription d’application au lieu de la valeur par défaut.

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

auth list commande

Répertoriez tous les profils d’authentification. Ajouter --json pour la sortie JSON brute.

Exemples auth list

dataverse auth list
dataverse auth list --json

auth remove commande

Supprimez un ou tous les profils d’authentification.

Paramètres auth remove

Paramètre Description
--index, -i Supprimez le profil avec l’index de base 1 spécifié, comme indiqué dans auth list.
--name, -n Supprimez le profil avec le nom spécifié.
--all Supprimez tous les profils.

Exemples auth remove

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

auth select commande

Sélectionnez le profil d’authentification actif. Exécutez la commande sans options pour répertorier tous les profils.

Paramètres auth select

Paramètre Description
--index, -i Sélectionnez le profil par son index basé sur 1, comme indiqué dans auth list.
--name, -n Sélectionnez le profil par nom.

Exemples auth select

Ouvrez un sélecteur interactif. Utilisez les touches de direction ou tapez pour filtrer :

dataverse auth select

Sélectionnez un profil par index ou par nom :

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

auth who commande

Affichez le profil d’authentification actif et actif. Ajouter --json pour la sortie JSON brute.

Exemples auth who

dataverse auth who
dataverse auth who --json

data associate commande

Associez deux enregistrements par le biais d’une propriété de navigation (relation). Cette commande est prise en charge uniquement pour Dataverse.

Paramètres data associate

Paramètre Description
--table, -t Nom du jeu d’entités de l’enregistrement principal. Required.
--id, -i GUID de l’enregistrement principal. Required.
--relationship, -rel Nom de la propriété de navigation. Required.
--related Nom du jeu d’entités de la table associée. Required.
--related-id GUID de l’enregistrement associé. Required.
--environment, -env Remplacez l’URL de l’environnement.
--json Sortie JSON brute.

Exemples data associate

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

data count commande

Comptez les enregistrements dans une table, éventuellement filtrés.

Paramètres data count

Paramètre Description
--table, -t Nom du jeu d’entités. Obligatoire, sauf si vous utilisez --fetchxml.
--filter, -f Expression OData $filter .
--fetchxml Requête d’agrégation FetchXML pour les nombres complexes.
--target Route vers dataverse (par défaut) ou l’environnement lié erp .
--cross-company ERP uniquement. Comptez parmi toutes les entreprises. Valeur par défaut : société par défaut de l’utilisateur.
--environment, -env Remplacez l’URL de l’environnement.
--json Sortie JSON brute.

Exemples data count

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

data create commande

Créez un enregistrement dans une table Dataverse. Définissez les colonnes de recherche à l’aide de la @odata.bind syntaxe.

Paramètres data create

Paramètre Description
--table, -t Nom du jeu d’entités. Required.
--data, -d Objet JSON avec les valeurs de champ.
--data-file Chemin d’accès à un fichier JSON avec les données d’enregistrement.
--return, -r Retournez l’enregistrement créé complet.
--target Route vers dataverse (par défaut) ou l’environnement lié erp .
--environment, -env Remplacez l’URL de l’environnement.
--json Sortie JSON brute.

Exemples 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

Utiliser --data-file pour un JSON complexe. Permet --return --json d’obtenir l’enregistrement créé complet.

data delete commande

Supprimez un enregistrement unique par sa clé primaire ou par une autre clé.

Paramètres data delete

Paramètre Description
--table, -t Nom du jeu d’entités. Required.
--id, -i GUID d’enregistrement.
--key, -k Une autre clé.
--no-confirm Ignorez l’invite de confirmation.
--target Route vers dataverse (par défaut) ou l’environnement lié erp .
--environment, -env Remplacez l’URL de l’environnement.
--json Sortie JSON brute.

Exemples data delete

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

data describe commande

Décrire le schéma d’une entité OData. Pour Dataverse, la commande appelle EntityDefinitions(LogicalName='<table>') pilotée $expand par --include, ainsi qu’un deuxième appel à customapis quand --include actions est défini. Les actions Dataverse intégrées telles que Assign et SetState ne sont pas énumérées. Pour ERP, un seul appel pour /Metadata/PublicEntities renvoyer des propriétés, des actions liées et des navigations ensemble.

Paramètres data describe

Paramètre Description
--target Cible : dataverse (par défaut) ou erp.
--table, -t Required. Pour Dataverse, le nom logique, tel que account. Pour ERP, le nom du jeu d’entités, tel que BatchJobs.
--include Liste séparée par des virgules des sections à inclure : entity, , properties, relations, actionsou all. Alias : attributes=properties, . relationships=relations Valeur par défaut pour ERP : all. Valeur par défaut pour Dataverse : entity,properties.
--json Sortie JSON brute.

Exemples data describe

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

data disassociate commande

Supprimez une relation entre deux enregistrements. Cette commande est prise en charge uniquement pour Dataverse.

Paramètres data disassociate

Paramètre Description
--table, -t Nom du jeu d’entités de l’enregistrement principal. Required.
--id, -i GUID de l’enregistrement principal. Required.
--relationship, -rel Nom de la propriété de navigation. Required.
--related-id GUID de l’enregistrement associé, pour une relation plusieurs-à-plusieurs. Omettez ce paramètre pour effacer une recherche.
--environment, -env Remplacez l’URL de l’environnement.
--json Sortie JSON brute.

Exemples data disassociate

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

data get commande

Récupérez un enregistrement unique par son ID (clé primaire) ou par une autre clé.

Paramètres data get

Paramètre Description
--table, -t Nom du jeu d’entités. Required.
--id, -i GUID d’enregistrement (clé primaire).
--key, -k Une autre clé, par exemple "col='val'".
--select, -s Liste séparée par des virgules de colonnes ($select).
--expand, -x Expression OData $expand pour les enregistrements associés.
--target Route vers dataverse (par défaut) ou l’environnement lié erp .
--environment, -env Remplacez l’URL de l’environnement.
--json Sortie JSON brute.

Exemples 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"

data query commande

Exécutez une requête OData, FetchXML ou SQL sur une table Dataverse.

Paramètres data query

Paramètre Description
--table, -t Nom du jeu d’entités à interroger. Obligatoire pour les requêtes OData.
--select, -s Liste séparée par des virgules de colonnes ($select).
--filter, -f Expression OData $filter .
--orderby, -o Expression OData $orderby .
--top Nombre maximal d’enregistrements à retourner (1 à 5 000).
--expand, -x Expression OData $expand pour les enregistrements associés.
--fetchxml Requête FetchXML inline.
--fetchxml-file Chemin d’accès à un fichier qui contient une requête FetchXML.
--sql Requête SQL SELECT (préversion).
--sql-file Chemin d’accès à un fichier qui contient une requête SQL.
--all, -a Suivez la pagination pour récupérer tous les enregistrements.
--max-records Nombre maximal d’enregistrements à récupérer lors de l’utilisation --all. Valeur par défaut : 100000.
--target Route vers dataverse (par défaut) ou l’environnement lié erp .
--cross-company ERP uniquement. Interrogez toutes les entreprises. Valeur par défaut : société par défaut de l’utilisateur.
--environment, -env Remplacez l’URL de l’environnement.
--json Sortie JSON brute.

Exemples 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

En savoir plus

data update commande

Mettez à jour un ou plusieurs champs sur un enregistrement existant, identifiés par son ID ou par une autre clé. Définissez les colonnes de recherche à l’aide de la @odata.bind syntaxe.

Paramètres data update

Paramètre Description
--table, -t Nom du jeu d’entités. Required.
--id, -i GUID d’enregistrement.
--key, -k Une autre clé.
--data, -d Objet JSON avec les champs à mettre à jour.
--data-file Chemin d’accès à un fichier JSON avec les données de mise à jour.
--return, -r Retournez l’enregistrement mis à jour complet.
--target Route vers dataverse (par défaut) ou l’environnement lié erp .
--environment, -env Remplacez l’URL de l’environnement.
--json Sortie JSON brute.

Exemples data update

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

data upload commande

Chargez un fichier local dans une colonne de fichier Dataverse sur un enregistrement existant. La commande sélectionne automatiquement un chargement à requête unique ou en bloc en fonction de la taille du fichier, sauf si vous spécifiez --mode. En mode automatique, les fichiers de moins de 128 Mo sont chargés dans une seule requête, et les fichiers plus volumineux utilisent un chargement en bloc. Lorsque vous omettez --mime-type, la commande déduit le type MIME de l’extension de fichier. Extensions inconnues par défaut sur application/octet-stream.

Paramètres data upload

Paramètre Description
--table, -t Schéma de table ou nom logique, tel que account. Required. La commande résout le jeu d’entités à partir de métadonnées.
--id, -i GUID d’enregistrement. Required.
--column, -c Nom de l’attribut de colonne de fichier. Required.
--file, -f Chemin d’accès au fichier local. Required.
--mode, -m Stratégie de chargement : auto (par défaut), smallou chunk.
--mime-type Type MIME explicite. Valeur par défaut : déduit de l’extension de fichier.
--overwrite Remplacez un fichier existant. Par défaut, la commande échoue si la colonne n’est pas vide.
--environment, -env Remplacez l’URL de l’environnement.
--json Sortie JSON brute.

Exemples 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

data upsert commande

Créez un enregistrement s’il n’existe pas ou mettez-le à jour s’il le fait. L’enregistrement est identifié par une autre clé. Apprenez à utiliser une autre clé pour référencer un enregistrement

Paramètres data upsert

Paramètre Description
--table, -t Nom du jeu d’entités. Required.
--key, -k Une autre clé. Required.
--data, -d Objet JSON avec les valeurs de champ.
--data-file Chemin d’accès à un fichier JSON.
--update-only Échec si l’enregistrement n’existe pas (If-Match: *).
--create-only Échec si l’enregistrement existe déjà (If-None-Match: *).
--return, -r Retournez l’enregistrement complet après l’opération.
--target Route vers dataverse (par défaut) ou l’environnement lié erp .
--environment, -env Remplacez l’URL de l’environnement.
--json Sortie JSON brute.

Exemples data upsert

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

erp batch cancel commande

Annulez un travail de traitement par lots Finance and Operations par son RecId. Permet erp batch list de rechercher le RecId.

Exemples erp batch cancel

dataverse erp batch cancel <recid>

erp batch list commande

Répertoriez les tâches par lots sur l’instance Finance et Operations liée à votre environnement Dataverse. La commande nécessite un profil d’authentification connecté à un environnement Dataverse qui a une instance Finance et Operations liée. L’URL finance et opérations est dérivée automatiquement de la connexion Dataverse actuelle.

Paramètres erp batch list

Paramètre Description
--company Filtrer par entité juridique (dataAreaIdpar exemple USMF.
--status Filtrer par état : Waiting, , FinishedExecuting, Error, ou Cancelled.
--top Le nombre maximal de résultats à renvoyer. Valeur par défaut : 20.
--caption Filtrer par légende (correspondance de sous-chaîne ne respectant pas la casse).
--json Sortie JSON brute.

Exemples erp batch list

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

install commande

Installez une version spécifique de l’interface CLI Dataverse ou mettez à jour vers la dernière version. La commande détecte si vous avez installé l’interface CLI globalement ou si vous utilisez npx et installez en conséquence.

Exemples install

Installez la dernière version :

dataverse install latest

Installez une version spécifique :

dataverse install 1.0.0

mcp commande

Démarre un serveur MCP (Model Context Protocol) qui se connecte à votre environnement, afin que les assistants IA tels que Claude Desktop puissent interagir avec vos données. La cible est détectée automatiquement à partir de l’URL : une URL dataverse démarre le serveur Dataverse MCP et une URL Finance et Operations, par exemple https://myorg.operations.dynamics.com, démarre le serveur ERP MCP.

Syntaxe de mcp

dataverse mcp <orgUrl> [options]

L’argument <orgUrl> est l’URL de votre organisation, par exemple https://myorg.crm.dynamics.com.

Paramètres mcp

Paramètre Description
--validate Validez les points de terminaison MCP et la configuration de l’authentification sans démarrer le serveur.
--log-level Définissez le niveau de journalisation : Trace, , DebugInformation, Warning, Error, ou Critical. Valeur par défaut : Warning.
--log-file Connectez-vous à un fichier dans le répertoire temporaire.
--preview Utilisez le point de terminaison MCP en préversion (api/mcp_preview au lieu de api/mcp). Non pris en charge pour ERP.

Exemples mcp

Validez la configuration (une première étape recommandée) :

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

Démarrez le serveur à l’aide du transport stdio :

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

Utilisez le point de terminaison en préversion ou activez la journalisation des fichiers de débogage :

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

mcp allow commande

Vérifiez qu'une application Microsoft Entra se trouve dans la liste des clients autorisés Dataverse MCP pour l'environnement du profil actuel. Cette commande est une alternative à l’étape d’administration manuelle décrite dans les conditions préalables. L’utilisateur authentifié doit disposer d’autorisations d’administrateur Dataverse sur l’environnement cible.

Syntaxe de mcp allow

dataverse mcp allow <appId> [options]

L’argument <appId> est l’ID d’application (client) à autoriser, en tant que GUID.

Paramètres mcp allow

Paramètre Description
--erp Autorisez l’application sur l’instance Finance et Operations liée au lieu de Dataverse.

Exemples mcp allow

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

Note

Finance and Operations met en cache la liste verte dans AOS, de sorte qu’un ID d’application nouvellement autorisé peut prendre jusqu’à cinq minutes.

org list commande

Répertoriez tous les environnements auxquels vous pouvez accéder.

Paramètres org list

Paramètre Description
--filter Filtrez la liste des environnements par un terme de recherche.
--json Sortie JSON brute.

Exemples org list

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

org who commande

Affichez des informations sur l’organisation et l’utilisateur actuels, à l’aide du profil d’authentification actif. La env commande est un alias pour org.

Paramètres org who

Paramètre Description
--environment, -env Remplacez l’URL de l’environnement.
--json Sortie JSON brute.

Exemples org who

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

Commandes skill

Gérez les compétences Dataverse ( ensembles d’instructions réutilisables (un SKILL.md fichier et ses fichiers de ressources) utilisés par les agents IA, stockés dans l’environnement connecté. Les commandes de niveau skill supérieur fournissent des opérations de création, de lecture, de mise à jour et de suppression sur l’environnement. Localement, les compétences sont stockées sous .claude/skills/<name>/.

Note

Les commandes de création et d’évaluation des compétences, telles que make, , updategetet eval, sont distinctes de ces commandes. Pour plus d’informations, exécuter dataverse workspace skill --help.

skill delete commande

Supprimez une compétence et toutes ses ressources de l’environnement Dataverse actif. Permet skill list de rechercher des noms uniques de compétences.

dataverse skill delete new_lead-qualification

skill download commande

Téléchargez une ou plusieurs compétences à partir de l’environnement Dataverse actif sur disque. La commande télécharge le SKILL.md fichier et tous les fichiers de ressources, en conservant la structure du répertoire. Permet skill list de rechercher des noms uniques de compétences.

Paramètre Description
--all Téléchargez toutes les compétences actives à partir de l’environnement. Impossible de combiner un nom unique de compétence.
--output, -o Répertoire de base pour la sortie. Valeur par défaut : .claude/skills/. Avec --all, chaque compétence est écrite dans <path>/<name>/.
--json Affichez le contenu de compétence au format JSON sans écrire de fichiers. Spécifiez éventuellement un chemin d’accès de fichier dans lequel écrire. 
dataverse skill download new_lead-qualification
dataverse skill download --all --output ./skills

skill list commande

Répertoriez toutes les compétences actives dans l’environnement Dataverse connecté.

Paramètre Description
--resources, -r Répertoriez également les fichiers de ressources pour chaque compétence.
--json Sortie au format JSON. Spécifiez éventuellement un chemin d’accès de fichier dans lequel écrire. 
dataverse skill list
dataverse skill list --resources

skill upload commande

Chargez une ou plusieurs compétences à partir du disque dans l’environnement Dataverse actif. La commande prend en charge les répertoires, les fichiers.zip , les fichiers .skill et les fichiers .md .

Vous pouvez passer une compétence <name>, qui se résout à .claude/skills/<name>/, ou un répertoire ou un fichier explicite <path> .

Paramètre Description
--all Chargez toutes les compétences sous .claude/skills/. Impossible de combiner un nom de compétence ou un chemin d’accès.
--json Sortie du résultat au format JSON. Spécifiez éventuellement un chemin d’accès de fichier dans lequel écrire. 
dataverse skill upload lead-qualification
dataverse skill upload ./my-skill.zip
dataverse skill upload --all

Voir aussi

Utiliser des données à l’aide de l’interface CLI Dataverse

  • Last updated on