Naslaginformatie over Dataverse CLI (preview)

Note

  • Dit is een preview-functie.
  • Preview-functies zijn niet bedoeld voor productiegebruik en bieden mogelijk beperkte functionaliteit. Deze functies zijn beschikbaar vóór een officiële release zodat klanten vroeg toegang kunnen krijgen en feedback kunnen geven.

In dit artikel worden de opdrachten beschreven die beschikbaar zijn in de Dataverse CLI. Elke opdracht ondersteunt een --help optie die het gebruik, de opties en voorbeelden weergeeft. Opdrachten die gegevens retourneren, ondersteunen een --json optie voor onbewerkte JSON-uitvoer die nuttig is in scripts.

De volgende algemene opties kunnen worden gebruikt met elke opdracht:

Option Description
--log-level <level> Stel het logboekregistratieniveau in: , , , , of CriticalError. WarningInformationDebugTrace Standaard: Warning.
--log-file Meld u aan bij een bestand in de tijdelijke map in plaats van de console.
--context <value> Bewerkingscontext toegevoegd aan de User-Agent. U kunt ook de DATAVERSE_OPERATION_CONTEXT omgevingsvariabele instellen.
Command Description
api describe Een API beschrijven
api invoke Een API op naam aanroepen
api list Detecteerbare API's weergeven
api request Een geverifieerde HTTP-aanvraag verzenden
auth create Een nieuw verificatieprofiel maken
auth list Alle verificatieprofielen weergeven
auth remove Een verificatieprofiel verwijderen
auth select Het actieve verificatieprofiel selecteren
auth who Het huidige verificatieprofiel weergeven
data associate Twee records koppelen via een relatie
data count Records in een tabel tellen
data create Een nieuwe record maken
data delete Een record verwijderen
data describe Het schema van een entiteit beschrijven
data disassociate Een relatie tussen twee records verwijderen
data get Eén record ophalen op basis van id of alternatieve sleutel
data query Een OData-, FetchXML- of SQL-query uitvoeren
data update Een bestaande record bijwerken
data upload Een bestand uploaden naar een bestandskolom op een bestaande record
data upsert Een record maken of bijwerken met een alternatieve sleutel
erp batch cancel Een batchtaak voor financiën en bewerkingen annuleren
erp batch list Batchtaken voor financiën en bewerkingen vermelden
install Een specifieke versie installeren of bijwerken naar de nieuwste versie
mcp De MCP-server voor Dataverse of ERP starten
mcp allow Een app toestaan als EEN MCP-client
org list Alle toegankelijke omgevingen weergeven
org who Huidige organisatie- en gebruikersgegevens weergeven
skill delete Een vaardigheid verwijderen uit Dataverse
skill download Een vaardigheid downloaden van Dataverse
skill list Actieve vaardigheden in de omgeving vermelden
skill upload Een vaardigheid uploaden naar Dataverse

Note

Veel opdrachten ondersteunen een --target <dataverse\|erp> optie waarmee de bewerking wordt gerouteerd naar Dataverse (de standaardinstelling) of naar de gekoppelde ERP-omgeving (Finance and Operations). Opdrachten die verbinding maken met een omgeving ondersteunen een --environment <url> (-env) optie om de URL van de omgeving van het huidige profiel te overschrijven.

api describe opdracht

De metagegevens voor één API weergeven. Voor aangepaste API's van Dataverse bevat de uitvoer beschrijvingen van de aanvraagparameter en antwoordeigenschap wanneer de metagegevens deze leveren.

Dataverse-namen worden standaard niet voorafgegaan. U kunt ERP-gekwalificeerde namen in de vorm erp:ServiceGroup/Service/Operationgebruiken.

api describe Parameters

Parameter Description
--target Los een niet-gekwalificeerde naam op tegen dataverse of erp.
--service-group ALLEEN ERP. Besmal de opzoekbewerking tot één servicegroep.
--service ALLEEN ERP. Besmal de zoekfunctie voor bewerkingen tot één service.
--environment Overschrijf de URL van de Dataverse-omgeving.
--json Uitvoer onbewerkte JSON.

voorbeelden van 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 opdracht

Roep een gedetecteerde API aan op naam. Gebruik name=value de syntaxis voor parameters. Als een waarde spaties bevat, geeft u het hele token aan. Sommige Dataverse-API's accepteren een tekenreeksparameter waarvan de inhoud zelf JSON is. Geef in dat geval de JSON-tekst door als de waarde met behulp van de normale quoterings- en escaperegels van uw shell.

Standaard worden JSON-antwoorden weergegeven in een beschrijvende tekstindeling die de namen van de uitvoereigenschappen bewaart. Gebruik --json dit om de onbewerkte JSON-nettolading te behouden.

api invoke Parameters

Parameter Description
--target Los een niet-gekwalificeerde naam op tegen dataverse of erp.
--service-group ALLEEN ERP. Besmal de opzoekbewerking tot één servicegroep.
--service ALLEEN ERP. Besmal de zoekfunctie voor bewerkingen tot één service.
--param Voeg een benoemde parameter toe in name=value formulier. Herhaalbare.
--bind Het bindingspad voor entiteitsgebonden Dataverse-API's.
--method, -X Overschrijf de uitgestelde HTTP-methode.
--body Gebruik een onbewerkte JSON-hoofdtekst in plaats van benoemde parameters.
--body-file Lees een onbewerkte JSON-hoofdtekst uit een bestand.
--header, -H Voeg een HTTP-header toe in key:value een formulier.
--include, -i Neem de antwoordstatus en headers op.
--environment Overschrijf de URL van de Dataverse-omgeving.
--json Uitvoer onbewerkte JSON in plaats van beschrijvende tekst.

voorbeelden van api invoke

Roep een Dataverse-functie aan. In dit voorbeeld ziet u het gebruik van de functie Dynamics 365 Contact Center CCaaS_GetPresence.

dataverse api invoke CCaaS_GetPresence ApiVersion=1.0

Roep de actie Dataverse AISummarize aan met spaties in een parameterwaarde:

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

Roep een aangepaste ERP-service aan:

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

api list opdracht

Maak een lijst met detecteerbare API's, zoals aangepaste Dataverse-API's en invocable ERP-service-eindpunten. Resultaten tonen de API-identiteit, beschrijvende naam, soort en beschrijving, indien beschikbaar. U kunt een optionele queryterm doorgeven om de resultaten te filteren.

api list Parameters

Parameter Description
--target Het doelsysteem om te zoeken: dataverse (standaard) of erp.
--service-group ALLEEN ERP. Filter op één servicegroep.
--service ALLEEN ERP. Filteren op één service.
--limit Het maximum aantal API's dat moet worden geretourneerd. Standaard: 50.
--page Het paginanummer op basis van 1 bij het bladeren door resultaten. Standaard: 1.
--environment Overschrijf de URL van de Dataverse-omgeving.
--json Uitvoer onbewerkte JSON.

voorbeelden van 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 opdracht

Verzend een onbewerkte geverifieerde HTTP-aanvraag naar Dataverse of ERP. Gebruik deze opdracht wanneer u volledige controle nodig hebt over het pad, de methode, de headers en de hoofdtekst.

api request Parameters

Parameter Description
--target Het doelsysteem: dataverse of erp. Required.
--path Het aanvraagpad. Required.
--method, -X De HTTP-methode. Standaard: GETof POST wanneer een hoofdtekst wordt opgegeven.
--body Een inline JSON-aanvraagbody.
--body-file Een bestand dat een hoofdtekst van een JSON-objectaanvraag bevat.
--header, -H Voeg een HTTP-header toe in key:value een formulier.
--include, -i Neem de antwoordstatus en headers op.
--environment Overschrijf de URL van de Dataverse-omgeving.

voorbeelden van 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 opdracht

Maak een nieuw verificatieprofiel.

auth create Parameters

Gebruik deze parameters om het gedrag van de auth create opdracht op te geven.

Parameter Description
--environment, -env De URL voor de Dataverse-omgeving waarmee u zich wilt verifiëren.
--name, -n Een optionele naam voor het profiel. Gebruik de naam om het profiel later te selecteren.
--cloud, -ci De doelcloud: Public, UsGov, UsGovHigh, of UsGovDodChina.
--deviceCode, -dc Gebruik de verificatiestroom voor apparaatcode voor omgevingen zonder browser.
--username, -un De gebruikersnaam voor verificatie van gebruikersnaam en wachtwoord.
--password, -p Het wachtwoord voor gebruikersnaam en wachtwoordverificatie.
--applicationId, -id De toepassings-id (client) voor SPN-verificatie (service-principal).
--clientSecret, -cs Het clientgeheim voor verificatie van de service-principal.
--certificateDiskPath, -cdp Het pad naar een PFX-certificaatbestand voor verificatie op basis van certificaten.
--certificatePassword, -cp Het wachtwoord voor het certificaat.
--tenant, -t De tenant-id. Vereist voor verificatie van de service-principal.
--managedIdentity, -mi Gebruik een Azure beheerde identiteit.
--githubFederated, -ghf Gebruik GitHub Actions federatieve verificatie.
--azureDevOpsFederated, -adof Gebruik Azure DevOps federatieve verificatie.
--clientid, -cid Een aangepaste Microsoft Entra app-client-id die moet worden gebruikt in plaats van de standaard Dataverse CLI-app.
--no-default-environment Stel de omgeving niet in als de standaardinstelling.
--accept-cleartext-caching Sta een cache met teksttoken zonder opmaak toe in Linux.

voorbeelden van auth create

In de volgende voorbeelden ziet u hoe u de auth create opdracht gebruikt.

Interactieve verificatie

Met deze opdracht opent u een browser- of systeemdialoogvenster voor aanvullende informatie.

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

Benoemd profiel

Maak een profiel met een specifieke naam.

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

Apparaatcodestroomproces

Gebruik de apparaatcodestroom voor omgevingen zonder browser.

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

Service-principal met clientgeheim

Gebruik een service-principal wanneer u verificatie zonder toezicht nodig hebt, zoals in een CI/CD-pijplijn of een ander geautomatiseerd script waarbij interactieve aanmelding niet mogelijk is. Geef de toepassings-id, het clientgeheim en de tenant-id op van een app-registratie die toegang heeft tot de omgeving.

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

Client-id van aangepaste Entra-app

Gebruik uw eigen app-registratie in plaats van de standaardinstelling.

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

auth list opdracht

Geef alle verificatieprofielen weer. Toevoegen --json voor onbewerkte JSON-uitvoer.

voorbeelden van auth list

dataverse auth list
dataverse auth list --json

auth remove opdracht

Verwijder een of alle verificatieprofielen.

auth remove Parameters

Parameter Description
--index, -i Verwijder het profiel met de opgegeven 1-gebaseerde index, zoals wordt weergegeven in auth list.
--name, -n Verwijder het profiel met de opgegeven naam.
--all Verwijder alle profielen.

voorbeelden van auth remove

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

auth select opdracht

Selecteer het actieve verificatieprofiel. Voer de opdracht uit zonder opties om alle profielen weer te geven.

auth select Parameters

Parameter Description
--index, -i Selecteer het profiel op basis van de 1-gebaseerde index, zoals wordt weergegeven in auth list.
--name, -n Selecteer het profiel op naam.

voorbeelden van auth select

Open een interactieve kiezer. Gebruik de pijltoetsen of typ om te filteren:

dataverse auth select

Selecteer een profiel op index of op naam:

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

auth who opdracht

Het huidige actieve verificatieprofiel weergeven. Toevoegen --json voor onbewerkte JSON-uitvoer.

voorbeelden van auth who

dataverse auth who
dataverse auth who --json

data associate opdracht

Koppel twee records via een navigatie-eigenschap (relatie). Deze opdracht wordt alleen ondersteund voor Dataverse.

data associate Parameters

Parameter Description
--table, -t De naam van de entiteitsset van de primaire record. Required.
--id, -i De GUID van de primaire record. Required.
--relationship, -rel De naam van de navigatie-eigenschap. Required.
--related De naam van de entiteitsset van de gerelateerde tabel. Required.
--related-id De GUID van de gerelateerde record. Required.
--environment, -env Overschrijf de omgevings-URL.
--json Uitvoer onbewerkte JSON.

voorbeelden van data associate

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

data count opdracht

Tel de records in een tabel, eventueel gefilterd.

data count Parameters

Parameter Description
--table, -t De naam van de entiteitsset. Vereist tenzij u gebruikt --fetchxml.
--filter, -f Een OData-expressie $filter .
--fetchxml Een fetchXML-statistische query voor complexe aantallen.
--target Route naar dataverse (standaard) of de gekoppelde erp omgeving.
--cross-company ALLEEN ERP. Tel mee in alle bedrijven. Standaard: het standaardbedrijf van de gebruiker.
--environment, -env Overschrijf de omgevings-URL.
--json Uitvoer onbewerkte JSON.

voorbeelden van data count

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

data create opdracht

Maak een nieuwe record in een Dataverse-tabel. Opzoekkolommen instellen met behulp van @odata.bind syntaxis.

data create Parameters

Parameter Description
--table, -t De naam van de entiteitsset. Required.
--data, -d Een JSON-object met de veldwaarden.
--data-file Het pad naar een JSON-bestand met de recordgegevens.
--return, -r Retourneert de volledige gemaakte record.
--target Route naar dataverse (standaard) of de gekoppelde erp omgeving.
--environment, -env Overschrijf de omgevings-URL.
--json Uitvoer onbewerkte JSON.

voorbeelden van 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

Gebruiken --data-file voor complexe JSON. Gebruik --return --json dit om de volledige gemaakte record op te halen.

data delete opdracht

Eén record verwijderen op basis van de primaire sleutel of door een alternatieve sleutel.

data delete Parameters

Parameter Description
--table, -t De naam van de entiteitsset. Required.
--id, -i De record-GUID.
--key, -k Een alternatieve sleutel.
--no-confirm Sla de bevestigingsprompt over.
--target Route naar dataverse (standaard) of de gekoppelde erp omgeving.
--environment, -env Overschrijf de omgevings-URL.
--json Uitvoer onbewerkte JSON.

voorbeelden van data delete

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

data describe opdracht

Beschrijf het schema van een OData-entiteit. Voor Dataverse wordt de opdracht aangeroepen EntityDefinitions(LogicalName='<table>') met $expand aangestuurd door --include, plus een tweede aanroep naar customapis wanneer --include actions deze is ingesteld. Ingebouwde Dataverse-acties, zoals Assign en SetState worden niet geïnventariseerd. Voor ERP retourneert één aanroep om eigenschappen, afhankelijke acties en navigatie samen te /Metadata/PublicEntities retourneren.

data describe Parameters

Parameter Description
--target Het doel: dataverse (standaard) of erp.
--table, -t Required. Voor Dataverse, de logische naam, zoals account. Voor ERP is de naam van de entiteitsset, zoals BatchJobs.
--include Een door komma's gescheiden lijst met secties, zoals: entity, propertiesrelations, , of actionsall. Aliassen: attributes=properties, relationships=relations. Standaard voor ERP: all. Standaardinstelling voor Dataverse: entity,properties.
--json Uitvoer onbewerkte JSON.

voorbeelden van 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 opdracht

Een relatie tussen twee records verwijderen. Deze opdracht wordt alleen ondersteund voor Dataverse.

data disassociate Parameters

Parameter Description
--table, -t De naam van de entiteitsset van de primaire record. Required.
--id, -i De GUID van de primaire record. Required.
--relationship, -rel De naam van de navigatie-eigenschap. Required.
--related-id De GUID van de gerelateerde record, voor een veel-op-veel-relatie. Laat deze parameter weg om een zoekactie te wissen.
--environment, -env Overschrijf de omgevings-URL.
--json Uitvoer onbewerkte JSON.

voorbeelden van data disassociate

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

data get opdracht

Haal één record op met de id (primaire sleutel) of door een alternatieve sleutel.

data get Parameters

Parameter Description
--table, -t De naam van de entiteitsset. Required.
--id, -i De record-GUID (primaire sleutel).
--key, -k Een alternatieve sleutel, bijvoorbeeld "col='val'".
--select, -s Een door komma's gescheiden lijst met kolommen ($select).
--expand, -x Een OData-expressie $expand voor gerelateerde records.
--target Route naar dataverse (standaard) of de gekoppelde erp omgeving.
--environment, -env Overschrijf de omgevings-URL.
--json Uitvoer onbewerkte JSON.

voorbeelden van 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 opdracht

Voer een OData-, FetchXML- of SQL-query uit op een Dataverse-tabel.

data query Parameters

Parameter Description
--table, -t De naam van de entiteit die wordt ingesteld om een query uit te voeren. Vereist voor OData-query's.
--select, -s Een door komma's gescheiden lijst met kolommen ($select).
--filter, -f Een OData-expressie $filter .
--orderby, -o Een OData-expressie $orderby .
--top Het maximum aantal records dat moet worden geretourneerd (1-5000).
--expand, -x Een OData-expressie $expand voor gerelateerde records.
--fetchxml Een inline FetchXML-query.
--fetchxml-file Het pad naar een bestand dat een FetchXML-query bevat.
--sql Een SQL-query SELECT (preview).
--sql-file Het pad naar een bestand dat een SQL-query bevat.
--all, -a Volg paginering om alle records op te halen.
--max-records Het maximum aantal records dat moet worden opgehaald bij gebruik --all. Standaard: 100000.
--target Route naar dataverse (standaard) of de gekoppelde erp omgeving.
--cross-company ALLEEN ERP. Query's uitvoeren op alle bedrijven. Standaard: het standaardbedrijf van de gebruiker.
--environment, -env Overschrijf de omgevings-URL.
--json Uitvoer onbewerkte JSON.

voorbeelden van 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

Meer informatie

data update opdracht

Werk een of meer velden in een bestaande record bij, geïdentificeerd door de id of door een alternatieve sleutel. Opzoekkolommen instellen met behulp van @odata.bind syntaxis.

data update Parameters

Parameter Description
--table, -t De naam van de entiteitsset. Required.
--id, -i De record-GUID.
--key, -k Een alternatieve sleutel.
--data, -d Een JSON-object met de velden die moeten worden bijgewerkt.
--data-file Het pad naar een JSON-bestand met de updategegevens.
--return, -r Retourneer de volledige bijgewerkte record.
--target Route naar dataverse (standaard) of de gekoppelde erp omgeving.
--environment, -env Overschrijf de omgevings-URL.
--json Uitvoer onbewerkte JSON.

voorbeelden van data update

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

data upload opdracht

Upload een lokaal bestand naar een dataverse-bestandskolom op een bestaande record. Met de opdracht wordt automatisch één aanvraag of gesegmenteerde upload geselecteerd op basis van de bestandsgrootte, tenzij u opgeeft --mode. In de automatische modus worden bestanden van minder dan 128 MB geüpload in één aanvraag en grotere bestanden maken gebruik van een gesegmenteerde upload. Wanneer u weglaat --mime-type, wordt met de opdracht het MIME-type afgeleid van de bestandsextensie. Onbekende extensies zijn standaard ingesteld op application/octet-stream.

data upload Parameters

Parameter Description
--table, -t Het tabelschema of de logische naam, zoals account. Required. Met de opdracht wordt de entiteitsset omgezet vanuit metagegevens.
--id, -i De record-GUID. Required.
--column, -c De naam van het kenmerk van de bestandskolom. Required.
--file, -f Het pad naar het lokale bestand. Required.
--mode, -m De uploadstrategie: auto (standaard), smallof chunk.
--mime-type Een expliciet MIME-type. Standaard: afgeleid van de bestandsextensie.
--overwrite Een bestaand bestand overschrijven. De opdracht mislukt standaard als de kolom niet leeg is.
--environment, -env Overschrijf de omgevings-URL.
--json Uitvoer onbewerkte JSON.

voorbeelden van 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 opdracht

Maak een record als deze niet bestaat of werk deze bij als dat wel het geval is. De record wordt geïdentificeerd met een alternatieve sleutel. Leer hoe u een alternatieve sleutel gebruikt om te verwijzen naar een record

data upsert Parameters

Parameter Description
--table, -t De naam van de entiteitsset. Required.
--key, -k Een alternatieve sleutel. Required.
--data, -d Een JSON-object met de veldwaarden.
--data-file Het pad naar een JSON-bestand.
--update-only Mislukt als de record niet bestaat (If-Match: *).
--create-only Mislukt als de record al bestaat (If-None-Match: *).
--return, -r Retourneer de volledige record na de bewerking.
--target Route naar dataverse (standaard) of de gekoppelde erp omgeving.
--environment, -env Overschrijf de omgevings-URL.
--json Uitvoer onbewerkte JSON.

voorbeelden van data upsert

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

erp batch cancel opdracht

Annuleer een batchtaak voor financiën en bewerkingen op basis van de taak RecId. Gebruik erp batch list deze om de RecId.

voorbeelden van erp batch cancel

dataverse erp batch cancel <recid>

erp batch list opdracht

Maak een lijst met batchtaken op het exemplaar van Financiën en Operations die is gekoppeld aan uw Dataverse-omgeving. Voor de opdracht is een verificatieprofiel vereist dat is verbonden met een Dataverse-omgeving met een gekoppeld exemplaar van Finance and Operations. De URL voor Financiën en Bewerkingen wordt automatisch afgeleid van de huidige Dataverse-verbinding.

erp batch list Parameters

Parameter Description
--company Filteren op juridische entiteit (dataAreaIdzoals USMF.
--status Filteren op status: Waiting, Executing, Finished, , Errorof Cancelled.
--top Het maximum aantal resultaten dat moet worden geretourneerd. Standaard: 20.
--caption Filteren op bijschrift (hoofdlettergevoelige subtekenreeksovereenkomst).
--json Uitvoer onbewerkte JSON.

voorbeelden van erp batch list

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

install opdracht

Installeer een specifieke versie van de Dataverse CLI of werk deze bij naar de nieuwste versie. Met de opdracht wordt gedetecteerd of u de CLI globaal hebt geïnstalleerd of dat u dienovereenkomstig gebruikt npx en installeert.

voorbeelden van install

Installeer de meest recente versie:

dataverse install latest

Installeer een specifieke versie:

dataverse install 1.0.0

mcp opdracht

Hiermee start u een MCP-server (Model Context Protocol) die verbinding maakt met uw omgeving, zodat AI-assistenten zoals Claude Desktop kunnen communiceren met uw gegevens. Het doel wordt automatisch gedetecteerd vanuit de URL: een Dataverse-URL start de Dataverse MCP-server en een URL voor Financiën en Operations, zoals https://myorg.operations.dynamics.com, start de ERP MCP-server.

mcp syntaxis

dataverse mcp <orgUrl> [options]

Het <orgUrl> argument is bijvoorbeeld https://myorg.crm.dynamics.comde URL van uw organisatie.

mcp Parameters

Parameter Description
--validate Valideer de MCP-eindpunten en verificatie-instellingen zonder de server te starten.
--log-level Stel het logboekregistratieniveau in: , , , , of CriticalError. WarningInformationDebugTrace Standaard: Warning.
--log-file Meld u aan bij een bestand in de tijdelijke map.
--preview Gebruik het MCP-voorbeeldeindpunt (api/mcp_preview in plaats van api/mcp). Niet ondersteund voor ERP.

voorbeelden van mcp

Valideer de installatie (een aanbevolen eerste stap):

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

Start de server met behulp van het stdio-transport:

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

Gebruik het preview-eindpunt of schakel logboekregistratie van foutopsporingsbestanden in:

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

mcp allow opdracht

Zorg ervoor dat een Microsoft Entra-toepassing in de lijst met toegestane Dataverse MCP-clients voor de omgeving van het huidige profiel staat. Deze opdracht is een alternatief voor de handmatige beheerdersstap die wordt beschreven in de vereisten. De geverifieerde gebruiker moet dataverse-beheerdersmachtigingen hebben voor de doelomgeving.

mcp allow syntaxis

dataverse mcp allow <appId> [options]

Het <appId> argument is de toepassings-id (client) die moet worden toegestaan als een GUID.

mcp allow Parameters

Parameter Description
--erp Sta de toepassing toe op het gekoppelde exemplaar van Financiën en Operations in plaats van Dataverse.

voorbeelden van mcp allow

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

Note

Finance and Operations slaat de acceptatielijst in de AOS in de cache op, zodat het tot ongeveer vijf minuten kan duren voordat een nieuw toegestane app-id van kracht wordt.

org list opdracht

Geef alle omgevingen weer waartoe u toegang hebt.

org list Parameters

Parameter Description
--filter Filter de lijst met omgevingen op een zoekterm.
--json Uitvoer onbewerkte JSON.

voorbeelden van org list

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

org who opdracht

Geef informatie weer over de huidige organisatie en gebruiker met behulp van het actieve verificatieprofiel. De env opdracht is een alias voor org.

org who Parameters

Parameter Description
--environment, -env Overschrijf de omgevings-URL.
--json Uitvoer onbewerkte JSON.

voorbeelden van org who

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

skill opdrachten

Beheer Dataverse-vaardigheden( herbruikbare instructiesets (een SKILL.md bestand en de bijbehorende resourcebestanden) die AI-agents gebruiken, die worden opgeslagen in de verbonden omgeving. De opdrachten op het hoogste niveau skill bieden bewerkingen voor maken, lezen, bijwerken en verwijderen voor de omgeving. Lokaal worden vaardigheden opgeslagen onder .claude/skills/<name>/.

Note

Opdrachten voor het ontwerpen en evalueren van vaardigheden, zoals make, updateen get, evalstaan los van deze opdrachten. Voer dataverse workspace skill --help uit voor meer informatie.

skill delete opdracht

Verwijder een vaardigheid en alle bijbehorende resources uit de actieve Dataverse-omgeving. Gebruik skill list dit om unieke namen van vaardigheden te vinden.

dataverse skill delete new_lead-qualification

skill download opdracht

Download een of meer vaardigheden van de actieve Dataverse-omgeving naar schijf. Met de opdracht worden het SKILL.md bestand en alle resourcebestanden gedownload, waarbij de mapstructuur behouden blijft. Gebruik skill list dit om unieke namen van vaardigheden te vinden.

Parameter Description
--all Download alle actieve vaardigheden uit de omgeving. Kan niet worden gecombineerd met een unieke naam voor vaardigheden.
--output, -o De basismap voor uitvoer. Standaard: .claude/skills/. Met --all, elke vaardigheid wordt geschreven naar <path>/<name>/.
--json Uitvoer van de vaardigheidsinhoud als JSON zonder bestanden te schrijven. Geef desgewenst een bestandspad op waar u naar wilt schrijven. 
dataverse skill download new_lead-qualification
dataverse skill download --all --output ./skills

skill list opdracht

Vermeld alle actieve vaardigheden in de verbonden Dataverse-omgeving.

Parameter Description
--resources, -r Vermeld ook de resourcebestanden voor elke vaardigheid.
--json Uitvoer als JSON. Geef desgewenst een bestandspad op waar u naar wilt schrijven. 
dataverse skill list
dataverse skill list --resources

skill upload opdracht

Upload een of meer vaardigheden van schijf naar de actieve Dataverse-omgeving. De opdracht ondersteunt mappen, .zip bestanden, .skill-bestanden en .md-bestanden .

U kunt een vaardigheid <name>doorgeven, die wordt omgezet in .claude/skills/<name>/of een expliciete <path> map of bestand.

Parameter Description
--all Upload alle vaardigheden onder .claude/skills/. Kan niet worden gecombineerd met een vaardigheidsnaam of -pad.
--json Voer het resultaat uit als JSON. Geef desgewenst een bestandspad op waar u naar wilt schrijven. 
dataverse skill upload lead-qualification
dataverse skill upload ./my-skill.zip
dataverse skill upload --all

Zie ook

Werken met gegevens met behulp van de Dataverse CLI

  • Last updated on