Dataverse-CLI-reference (prøveversion)

Bemærkning

  • Dette er en forhåndsversionsfunktion.
  • Forhåndsversionsfunktionerne er ikke beregnet til produktionsformål og kan have begrænset funktionalitet. Disse funktioner er tilgængelige før en officiel udgivelse, så kunderne kan få tidlig adgang og give feedback.

I denne artikel beskrives de kommandoer, der er tilgængelige i kommandolinjegrænsefladen Dataverse. Hver kommando understøtter en --help indstilling, der viser dens brug, indstillinger og eksempler. Kommandoer, der returnerer data, understøtter en --json indstilling for rå JSON-output, der er nyttig i scripts.

Følgende globale indstillinger kan bruges sammen med en hvilken som helst kommando:

Mulighed Beskrivelse
--log-level <level> Angiv logføringsniveauet: Trace, Debug, Information, WarningErroreller Critical. Standard: Warning.
--log-file Log på en fil i den midlertidige mappe i stedet for konsollen.
--context <value> Handlingskonteksten er føjet til Brugeragenten. Du kan også angive miljøvariablen DATAVERSE_OPERATION_CONTEXT .
Kommando Beskrivelse
api describe Beskriv en API
api invoke Aktivér en API efter navn
api list Vis fundne API'er
api request Send en godkendt HTTP-anmodning
auth create Opret en ny godkendelsesprofil
auth list Vis alle godkendelsesprofiler
auth remove Fjern en godkendelsesprofil
auth select Vælg den aktive godkendelsesprofil
auth who Vis den aktuelle godkendelsesprofil
data associate Sammenbind to poster via en relation
data count Antal poster i en tabel
data create Oprette en ny post
data delete Slette en post
data describe Beskriv en enheds skema
data disassociate Fjern en relation mellem to poster
data get Hent en enkelt post efter id eller alternativ nøgle
data query Udfør en OData-, FetchXML- eller SQL-forespørgsel
data update Opdater en eksisterende post
data upload Overfør en fil til en filkolonne i en eksisterende post
data upsert Opret eller opdater en post ved hjælp af en alternativ nøgle
erp batch cancel Annuller kørslen Finance and Operations
erp batch list Vis kørsler af finance and operations
install Installér en bestemt version, eller opdater til den nyeste version
mcp Start MCP-serveren for Dataverse eller ERP
mcp allow Tillad en app som en MCP-klient
org list Vis alle tilgængelige miljøer
org who Vis aktuelle organisations- og brugeroplysninger
skill delete Slet en færdighed fra Dataverse
skill download Download en færdighed fra Dataverse
skill list Angiv aktive færdigheder i miljøet
skill upload Upload en færdighed til Dataverse

Bemærkning

Mange kommandoer understøtter en --target <dataverse\|erp> indstilling, der dirigerer handlingen til Dataverse (standarden) eller til det sammenkædede ERP-miljø (Finance and Operations). Kommandoer, der opretter forbindelse til et miljø, understøtter en --environment <url> (-env) indstilling for at tilsidesætte den aktuelle profils URL-adresse til miljøet.

api describe kommando

Vis metadataene for en enkelt API. For brugerdefinerede API'er for Dataverse indeholder outputtet beskrivelser af anmodningsparametre og svaregenskaber, når metadataene leverer dem.

Dataversenavne fjernes som standard. Du kan bruge ERP-kvalificerede navne i formen erp:ServiceGroup/Service/Operation.

api describe Parametre

Parameter Beskrivelse
--target Løs et ikke-kvalificeret navn i forhold til dataverse eller erp.
--service-group Kun ERP. Begræns handlingsopslag til én tjenestegruppe.
--service Kun ERP. Begræns handlingsopslag til én tjeneste.
--environment Tilsidesæt URL-adressen til Dataverse-miljøet.
--json Output rå JSON.

api describe Eksempler

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

api invoke kommando

Aktivér en registreret API ved navn. Brug name=value syntaks til parametre. Hvis en værdi indeholder mellemrum, skal du citere hele tokenet. Nogle Dataverse-API'er accepterer en strengparameter, hvis indhold selv er JSON. I så fald skal du overføre JSON-teksten som værdien ved hjælp af shell'ens normale regler for anførselstegn og escapeaping.

JSON-svar gengives som standard i et brugervenligt tekstformat, der bevarer navnene på outputegenskaben. Bruges --json til at bevare den rå JSON-nyttedata.

api invoke Parametre

Parameter Beskrivelse
--target Løs et ikke-kvalificeret navn i forhold til dataverse eller erp.
--service-group Kun ERP. Begræns handlingsopslag til én tjenestegruppe.
--service Kun ERP. Begræns handlingsopslag til én tjeneste.
--param Tilføj en navngivet parameter i name=value formularen. Repeterbare.
--bind Bindingsstien for objektbundne Dataverse-API'er.
--method, -X Tilsidesæt den udledte HTTP-metode.
--body Brug en rå JSON-brødtekst i stedet for navngivne parametre.
--body-file Læs en rå JSON-brødtekst fra en fil.
--header, -H Tilføj en HTTP-header i key:value formular.
--include, -i Medtag svarstatus og overskrifter.
--environment Tilsidesæt URL-adressen til Dataverse-miljøet.
--json Skriv rå JSON i stedet for læsevenlig tekst.

api invoke Eksempler

Aktivér en Dataverse-funktion. I dette eksempel vises brugen af funktionen Dynamics 365 Contact Center CCaaS_GetPresence.

dataverse api invoke CCaaS_GetPresence ApiVersion=1.0

Aktivér handlingen Dataverse AISummarize med mellemrum i en parameterværdi:

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

Aktivér en brugerdefineret ERP-tjeneste:

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

api list kommando

Opret en liste over de API'er, der kan findes, f.eks. brugerdefinerede API'er for Dataverse og de tjenesteslutpunkter, der kan deaktiveres af ERP. Resultaterne viser API-identiteten, det fulde navn, typen og beskrivelsen, når den er tilgængelig. Du kan sende et valgfrit forespørgselsord for at filtrere resultaterne.

api list parametre

Parameter Beskrivelse
--target Det destinationssystem, der skal søges i: dataverse (standard) eller erp.
--service-group Kun ERP. Filtrer til en enkelt tjenestegruppe.
--service Kun ERP. Filtrer til en enkelt tjeneste.
--limit Det maksimale antal API'er, der skal returneres. Standard: 50.
--page Det 1-baserede sidetal ved gennemsøgning af resultater. Standard: 1.
--environment Tilsidesæt URL-adressen til Dataverse-miljøet.
--json Output rå JSON.

api list Eksempler

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 kommando

Send en rå godkendt HTTP-anmodning til Dataverse eller ERP. Brug denne kommando, når du har brug for fuld kontrol over stien, metoden, overskrifterne og brødteksten.

api request Parametre

Parameter Beskrivelse
--target Destinationssystemet: dataverse eller erp. Krævet.
--path Anmodningsstien. Krævet.
--method, -X HTTP-metoden. Standard: GET, eller POST når der angives en brødtekst.
--body En indbygget JSON-anmodningstekst.
--body-file En fil, der indeholder brødteksten i en JSON-objektanmodning.
--header, -H Tilføj en HTTP-header i key:value formular.
--include, -i Medtag svarstatus og overskrifter.
--environment Tilsidesæt URL-adressen til Dataverse-miljøet.

api request Eksempler

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 kommando

Opret en ny godkendelsesprofil.

auth create parametre

Brug disse parametre til at angive funktionsmåden auth create for kommandoen.

Parameter Beskrivelse
--environment, -env URL-adressen til det Dataverse-miljø, du vil godkende med.
--name, -n Et valgfrit navn til profilen. Brug navnet til at vælge profilen senere.
--cloud, -ci Destinationsskyen: Public, UsGov, UsGovHigh, UsGovDodeller China.
--deviceCode, -dc Brug godkendelsesflowet for enhedskoden til miljøer uden en browser.
--username, -un Brugernavnet til godkendelse af brugernavn og adgangskode.
--password, -p Adgangskoden til godkendelse af brugernavn og adgangskode.
--applicationId, -id Program-id'et (klient) for spn-godkendelse (Service Principal).
--clientSecret, -cs Klienthemmeligheden for godkendelse af tjenesteprincipal.
--certificateDiskPath, -cdp Stien til en .pfx-certifikatfil til certifikatbaseret godkendelse.
--certificatePassword, -cp Adgangskoden til certifikatet.
--tenant, -t Lejer-id'et. Påkrævet til godkendelse af tjenesteprincipal.
--managedIdentity, -mi Brug en Azure administreret identitet.
--githubFederated, -ghf Brug GitHub Actions organisationsnetværksgodkendelse.
--azureDevOpsFederated, -adof Brug Azure DevOps organisationsnetværksgodkendelse.
--clientid, -cid Et brugerdefineret Microsoft Entra appklient-id, der skal bruges i stedet for standardappen Dataverse CLI.
--no-default-environment Angiv ikke miljøet som standard.
--accept-cleartext-caching Tillad cachelagring af et almindeligt token på Linux.

auth create Eksempler

Følgende eksempler viser, hvordan du bruger kommandoen auth create .

Interaktiv godkendelse

Denne kommando åbner en browser eller systemdialogboks for at få flere oplysninger.

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

Navngivet profil

Opret en profil med et bestemt navn.

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

Enhedskodeflow

Brug enhedskodeflowet til miljøer uden en browser.

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

Serviceprincipal med klienthemmelighed

Brug en tjenesteprincipal, når du har brug for automatisk godkendelse, f.eks. i en CI/CD-pipeline eller et andet automatiseret script, hvor interaktivt logon ikke er muligt. Angiv program-id'et, klienthemmeligheden og lejer-id'et for en appregistrering, der har adgang til miljøet.

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

Klient-id for brugerdefineret entra-app

Brug din egen appregistrering i stedet for standarden.

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

auth list kommando

Vis alle godkendelsesprofiler. Tilføj --json for rå JSON-output.

auth list Eksempler

dataverse auth list
dataverse auth list --json

auth remove kommando

Fjern en eller alle godkendelsesprofiler.

auth remove Parametre

Parameter Beskrivelse
--index, -i Fjern profilen med det angivne 1-baserede indeks, som vist i auth list.
--name, -n Fjern profilen med det angivne navn.
--all Fjern alle profiler.

auth remove Eksempler

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

auth select kommando

Vælg den aktive godkendelsesprofil. Kør kommandoen uden indstillinger for at få vist alle profiler.

auth select Parametre

Parameter Beskrivelse
--index, -i Vælg profilen efter det 1-baserede indeks som vist i auth list.
--name, -n Vælg profilen efter navn.

auth select Eksempler

Åbn en interaktiv vælger. Brug piletasterne, eller skriv til at filtrere:

dataverse auth select

Vælg en profil efter indeks eller efter navn:

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

auth who kommando

Vis den aktuelle aktive godkendelsesprofil. Tilføj --json for rå JSON-output.

auth who Eksempler

dataverse auth who
dataverse auth who --json

data associate kommando

Knyt to poster via en navigationsegenskab (relation). Denne kommando understøttes kun for Dataverse.

data associate Parametre

Parameter Beskrivelse
--table, -t Navnet på objektsættet for den primære post. Krævet.
--id, -i GUID for den primære post. Krævet.
--relationship, -rel Navnet på navigationsegenskaben. Krævet.
--related Navnet på objektsættet for den relaterede tabel. Krævet.
--related-id GUID'et for den relaterede post. Krævet.
--environment, -env Tilsidesæt URL-adressen til miljøet.
--json Output rå JSON.

data associate Eksempler

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

data count kommando

Tæl posterne i en tabel, eventuelt filtreret.

data count Parametre

Parameter Beskrivelse
--table, -t Navnet på objektsættet. Påkrævet, medmindre du bruger --fetchxml.
--filter, -f Et OData-udtryk $filter .
--fetchxml En FetchXML-aggregeringsforespørgsel for komplekse optællinger.
--target Rute til dataverse (standard) eller det sammenkædede erp miljø.
--cross-company Kun ERP. Antal på tværs af alle firmaer. Standard: brugerens standardfirma.
--environment, -env Tilsidesæt URL-adressen til miljøet.
--json Output rå JSON.

data count Eksempler

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

data create kommando

Opret en ny post i en Dataverse-tabel. Angiv opslagskolonner ved hjælp @odata.bind af syntaks.

data create Parametre

Parameter Beskrivelse
--table, -t Navnet på objektsættet. Krævet.
--data, -d Et JSON-objekt med feltværdierne.
--data-file Stien til en JSON-fil med postdataene.
--return, -r Returner den fulde oprettede post.
--target Rute til dataverse (standard) eller det sammenkædede erp miljø.
--environment, -env Tilsidesæt URL-adressen til miljøet.
--json Output rå JSON.

data create Eksempler

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

Tip

Bruges --data-file til kompleks JSON. Bruges --return --json til at få den fulde oprettede post.

data delete kommando

Slet en enkelt post ved hjælp af den primære nøgle eller ved hjælp af en alternativ nøgle.

data delete Parametre

Parameter Beskrivelse
--table, -t Navnet på objektsættet. Krævet.
--id, -i Post-GUID'et.
--key, -k En alternativ nøgle.
--no-confirm Spring bekræftelsesprompten over.
--target Rute til dataverse (standard) eller det sammenkædede erp miljø.
--environment, -env Tilsidesæt URL-adressen til miljøet.
--json Output rå JSON.

data delete Eksempler

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

data describe kommando

Beskriv skemaet for en OData-enhed. For Dataverse kalder EntityDefinitions(LogicalName='<table>') kommandoen med $expand drevet af --includeplus et andet kald til customapis , når --include actions er angivet. Indbyggede Dataverse-handlinger, f.eks Assign . og SetState er ikke optæltet. For ERP returnerer et enkelt kald /Metadata/PublicEntities egenskaber, bundne handlinger og navigationer sammen.

data describe Parametre

Parameter Beskrivelse
--target Destinationen: dataverse (standard) eller erp.
--table, -t Krævet. For Dataverse er det logiske navn, f.eks account. . For ERP er navnet på objektsættet, f.eks BatchJobs. .
--include En kommasepareret liste over sektioner, der skal indeholde: entity, properties, relations, actionseller all. Aliasser: attributes=properties, relationships=relations. Standard for ERP: all. Standard for Dataverse: entity,properties.
--json Output rå JSON.

data describe Eksempler

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

data disassociate kommando

Fjern en relation mellem to poster. Denne kommando understøttes kun for Dataverse.

data disassociate Parametre

Parameter Beskrivelse
--table, -t Navnet på objektsættet for den primære post. Krævet.
--id, -i GUID for den primære post. Krævet.
--relationship, -rel Navnet på navigationsegenskaben. Krævet.
--related-id GUID'et for den relaterede post for en mange til mange-relation. Udelad denne parameter for at rydde et opslag.
--environment, -env Tilsidesæt URL-adressen til miljøet.
--json Output rå JSON.

data disassociate Eksempler

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

data get kommando

Hent en enkelt post ved hjælp af dens id (primær nøgle) eller ved hjælp af en alternativ nøgle.

data get Parametre

Parameter Beskrivelse
--table, -t Navnet på objektsættet. Krævet.
--id, -i Post-GUID (primær nøgle).
--key, -k En alternativ nøgle, f.eks "col='val'". .
--select, -s En kommasepareret liste over kolonner ($select).
--expand, -x Et OData-udtryk $expand for relaterede poster.
--target Rute til dataverse (standard) eller det sammenkædede erp miljø.
--environment, -env Tilsidesæt URL-adressen til miljøet.
--json Output rå JSON.

data get Eksempler

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 kommando

Udfør en OData-, FetchXML- eller SQL-forespørgsel mod en Dataverse-tabel.

data query parametre

Parameter Beskrivelse
--table, -t Det objektsætnavn, der skal forespørge. Påkrævet til OData-forespørgsler.
--select, -s En kommasepareret liste over kolonner ($select).
--filter, -f Et OData-udtryk $filter .
--orderby, -o Et OData-udtryk $orderby .
--top Det maksimale antal poster, der skal returneres (1-5000).
--expand, -x Et OData-udtryk $expand for relaterede poster.
--fetchxml En indbygget FetchXML-forespørgsel.
--fetchxml-file Stien til en fil, der indeholder en FetchXML-forespørgsel.
--sql En SQL-forespørgsel SELECT (prøveversion).
--sql-file Stien til en fil, der indeholder en SQL-forespørgsel.
--all, -a Følg sideinddeling for at hente alle poster.
--max-records Det maksimale antal poster, der kan hentes, når du bruger --all. Standard: 100000.
--target Rute til dataverse (standard) eller det sammenkædede erp miljø.
--cross-company Kun ERP. Forespørgsel på tværs af alle firmaer. Standard: brugerens standardfirma.
--environment, -env Tilsidesæt URL-adressen til miljøet.
--json Output rå JSON.

data query Eksempler

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

Lær mere

data update kommando

Opdater et eller flere felter i en eksisterende post, der er identificeret ved dens id eller af en alternativ nøgle. Angiv opslagskolonner ved hjælp @odata.bind af syntaks.

data update Parametre

Parameter Beskrivelse
--table, -t Navnet på objektsættet. Krævet.
--id, -i Post-GUID'et.
--key, -k En alternativ nøgle.
--data, -d Et JSON-objekt med de felter, der skal opdateres.
--data-file Stien til en JSON-fil med opdateringsdataene.
--return, -r Returner den fulde opdaterede post.
--target Rute til dataverse (standard) eller det sammenkædede erp miljø.
--environment, -env Tilsidesæt URL-adressen til miljøet.
--json Output rå JSON.

data update Eksempler

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

data upload kommando

Overfør en lokal fil til en Dataverse-filkolonne på en eksisterende post. Kommandoen vælger automatisk en enkelt anmodning eller segmenteret overførsel baseret på filstørrelsen, medmindre du angiver --mode. I automatisk tilstand uploades filer under 128 MB i en enkelt anmodning, og større filer bruger en segmenteret upload. Når du udelader --mime-type, udleder kommandoen MIME-typen fra filtypenavnet. Ukendte filtypenavne er som standard application/octet-stream.

data upload Parametre

Parameter Beskrivelse
--table, -t Tabelskemaet eller det logiske navn, f.eks account. . Krævet. Kommandoen fortolker det objekt, der er angivet ud fra metadata.
--id, -i Post-GUID'et. Krævet.
--column, -c Attributnavnet for filkolonnen. Krævet.
--file, -f Stien til den lokale fil. Krævet.
--mode, -m Uploadstrategien: auto (standard), smalleller chunk.
--mime-type En eksplicit MIME-type. Standard: udledt fra filtypenavnet.
--overwrite Overskriv en eksisterende fil. Kommandoen mislykkes som standard, hvis kolonnen ikke er tom.
--environment, -env Tilsidesæt URL-adressen til miljøet.
--json Output rå JSON.

data upload Eksempler

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 kommando

Opret en post, hvis den ikke findes, eller opdater den, hvis den gør. Posten identificeres med en alternativ nøgle. Få mere at vide om, hvordan du bruger en alternativ nøgle til at referere til en post

data upsert parametre

Parameter Beskrivelse
--table, -t Navnet på objektsættet. Krævet.
--key, -k En alternativ nøgle. Krævet.
--data, -d Et JSON-objekt med feltværdierne.
--data-file Stien til en JSON-fil.
--update-only Mislykkes, hvis posten ikke findes (If-Match: *).
--create-only Mislykkes, hvis posten allerede findes (If-None-Match: *).
--return, -r Returner den fulde post efter handlingen.
--target Rute til dataverse (standard) eller det sammenkædede erp miljø.
--environment, -env Tilsidesæt URL-adressen til miljøet.
--json Output rå JSON.

data upsert Eksempler

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

erp batch cancel kommando

Annuller kørslen Finance and Operations ved hjælp af kørslen RecId. Bruges erp batch list til at finde RecId.

erp batch cancel Eksempler

dataverse erp batch cancel <recid>

erp batch list kommando

Vis batchjob på forekomsten Finance and Operations, der er knyttet til dit Dataverse-miljø. Kommandoen kræver en godkendelsesprofil, der er forbundet til et Dataverse-miljø, der har en sammenkædet forekomst af Finance and Operations. URL-adressen til Finance and Operations afledes automatisk fra den aktuelle Dataverse-forbindelse.

erp batch list Parametre

Parameter Beskrivelse
--company Filtrer efter juridisk enhed (dataAreaId), f.eks USMF. .
--status Filtrer efter status: Waiting, Executing, Finished, Erroreller Cancelled.
--top Det maksimale antal resultater, der skal returneres. Standard: 20.
--caption Filtrer efter billedtekst (der skelnes mellem store og små bogstaver i understrengen).
--json Output rå JSON.

erp batch list Eksempler

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

install kommando

Installér en bestemt version af Dataverse-kommandolinjegrænsefladen, eller opdater til den nyeste version. Kommandoen registrerer, om du har installeret kommandolinjegrænsefladen globalt eller bruger npx og installerer i overensstemmelse hermed.

install Eksempler

Installér den nyeste version:

dataverse install latest

Installér en bestemt version:

dataverse install 1.0.0

mcp kommando

Starter en MCP-server (Model Context Protocol), der opretter forbindelse til dit miljø, så AI-assistenter som f.eks. Claude Desktop kan interagere med dine data. Destinationen registreres automatisk fra URL-adressen: En URL-adresse til dataverse starter Dataverse MCP-serveren, og en URL-adresse til Finance and Operations, f.eks https://myorg.operations.dynamics.com. , starter ERP MCP-serveren.

mcp syntaks

dataverse mcp <orgUrl> [options]

Argumentet <orgUrl> er organisationens URL-adresse, f.eks https://myorg.crm.dynamics.com. .

mcp Parametre

Parameter Beskrivelse
--validate Valider MCP-slutpunkterne og godkendelseskonfigurationen uden at starte serveren.
--log-level Angiv logføringsniveauet: Trace, Debug, Information, WarningErroreller Critical. Standard: Warning.
--log-file Log på en fil i den midlertidige mappe.
--preview Brug mcp-slutpunktet for eksempelvisningen (api/mcp_preview i stedet for api/mcp). Understøttes ikke for ERP.

mcp Eksempler

Valider konfigurationen (et anbefalet første trin):

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

Start serveren ved hjælp af stdio-transporten:

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

Brug eksempelslutpunktet, eller aktivér logføring af fejlfindingsfiler:

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

mcp allow kommando

Sørg for, at et Microsoft Entra program findes på listen Over tilladte dataverse MCP-klienter for den aktuelle profils miljø. Denne kommando er et alternativ til det manuelle administratortrin, der er beskrevet i forudsætningerne. Den godkendte bruger skal have tilladelser som Dataverse-administrator til destinationsmiljøet.

mcp allow syntaks

dataverse mcp allow <appId> [options]

Argumentet <appId> er det program-id (klient),der skal tillades som GUID.

mcp allow Parametre

Parameter Beskrivelse
--erp Tillad programmet på den sammenkædede forekomst af Finance and Operations i stedet for Dataverse.

mcp allow Eksempler

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

Bemærkning

Finance and Operations cachelagrer listen over tilladte i AOS, så det kan tage op til ca. fem minutter, før et app-id, der er tilladt for nylig, træder i kraft.

org list kommando

Vis alle de miljøer, du har adgang til.

org list parametre

Parameter Beskrivelse
--filter Filtrer listen over miljøer efter et søgeord.
--json Output rå JSON.

org list Eksempler

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

org who kommando

Vis oplysninger om den aktuelle organisation og bruger ved hjælp af den aktive godkendelsesprofil. Kommandoen env er et alias for org.

org who parametre

Parameter Beskrivelse
--environment, -env Tilsidesæt URL-adressen til miljøet.
--json Output rå JSON.

org who Eksempler

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

skill kommandoer

Administrer Dataverse-færdigheder – genanvendelige instruktionssæt (en SKILL.md fil og dens ressourcefiler), som AI-agenter bruger – der er gemt i det forbundne miljø. Kommandoerne på øverste niveau skill indeholder handlinger til oprettelse, læsning, opdatering og sletning i forhold til miljøet. Lokalt gemmes færdigheder under .claude/skills/<name>/.

Bemærkning

Kommandoer til oprettelse og evaluering af færdigheder, f.eks make. , update, getog eval, er adskilt fra disse kommandoer. Du kan få flere oplysninger ved at køre dataverse workspace skill --help.

skill delete kommando

Slet en færdighed og alle dens ressourcer fra det aktive Dataverse-miljø. Bruges skill list til at finde entydige navne på færdigheder.

dataverse skill delete new_lead-qualification

skill download kommando

Download en eller flere færdigheder fra det aktive Dataverse-miljø til disken. Kommandoen downloader SKILL.md filen og alle ressourcefiler, så mappestrukturen bevares. Bruges skill list til at finde entydige navne på færdigheder.

Parameter Beskrivelse
--all Download alle aktive færdigheder fra miljøet. Kan ikke kombineres med et entydigt navn på en færdighed.
--output, -o Basismappen for output. Standard: .claude/skills/. Med --allskrives hver færdighed til <path>/<name>/.
--json Skriv kompetenceindholdet som JSON uden at skrive filer. Angiv eventuelt en filsti, der skal skrives til. 
dataverse skill download new_lead-qualification
dataverse skill download --all --output ./skills

skill list kommando

Angiv alle aktive færdigheder i det forbundne Dataverse-miljø.

Parameter Beskrivelse
--resources, -r Angiv også ressourcefilerne for hver færdighed.
--json Skriv som JSON. Angiv eventuelt en filsti, der skal skrives til. 
dataverse skill list
dataverse skill list --resources

skill upload kommando

Upload en eller flere færdigheder fra disken til det aktive Dataverse-miljø. Kommandoen understøtter mapper, .zip filer, .skill-filer og .md-filer .

Du kan bestå en færdighed <name>, som omsættes til .claude/skills/<name>/eller eksplicit <path> til en mappe eller fil.

Parameter Beskrivelse
--all Upload alle færdigheder under .claude/skills/. Kan ikke kombineres med et kompetencenavn eller en sti.
--json Skriv resultatet som JSON. Angiv eventuelt en filsti, der skal skrives til. 
dataverse skill upload lead-qualification
dataverse skill upload ./my-skill.zip
dataverse skill upload --all

Se også

Arbejd med data ved hjælp af dataverse-kommandolinjegrænsefladen

  • Last updated on