Datavers CLI-referanse (forhåndsversjon)

Bemerkning

  • Dette er en evalueringsfunksjonalitet.
  • Forhåndsversjonsfunksjonene er ikke ment for produksjonsbruk og kan ha begrenset funksjonalitet. Disse funksjonene er tilgjengelige før en offisiell utgivelse, slik at kunder kan få tidlig tilgang og gi tilbakemeldinger.

Denne artikkelen beskriver kommandoene som er tilgjengelige i Dataverse CLI. Hver kommando støtter et --help alternativ som viser bruken, alternativene og eksemplene. Kommandoer som returnerer data, støtter et --json alternativ for rå JSON-utdata som er nyttige i skript.

Følgende globale alternativer kan brukes med en hvilken som helst kommando:

Alternativ Beskrivelse
--log-level <level> Angi loggingsnivå: Trace, , Debug, Information, Warningeller ErrorCritical. Standard: Warning.
--log-file Logg på en fil i den midlertidige katalogen i stedet for konsollen.
--context <value> Operasjonskontekst tilføyd til brukeragenten. Du kan også angi miljøvariabelen DATAVERSE_OPERATION_CONTEXT .
Kommando Beskrivelse
api describe Beskriv en API
api invoke Aktiver en API etter navn
api list Liste oppdagbare API-er
api request Sende en godkjent HTTP-forespørsel
auth create Opprett en ny godkjenningsprofil
auth list Vis alle godkjenningsprofiler
auth remove Fjerne en godkjenningsprofil
auth select Velg aktiv godkjenningsprofil
auth who Vis gjeldende godkjenningsprofil
data associate Koble to poster via en relasjon
data count Telle poster i en tabell
data create Opprett en ny post
data delete Slette en post
data describe Beskriv skjemaet for en enhet
data disassociate Fjerne en relasjon mellom to poster
data get Hente én enkelt post etter ID eller alternativ nøkkel
data query Kjøre en OData-, FetchXML- eller SQL-spørring
data update Oppdater en eksisterende oppføring
data upload Laste opp en fil til en filkolonne på en eksisterende post
data upsert Opprette eller oppdatere en post med alternativ nøkkel
erp batch cancel Avbryt en finans- og operasjonsgruppejobb
erp batch list Kjørselen Vis finans og operasjoner
install Installer en bestemt versjon, eller oppdater til den nyeste versjonen
mcp Start MCP-serveren for Dataverse eller ERP
mcp allow Tillat en app som en MCP-klient
org list Vis alle tilgjengelige miljøer
org who Vis gjeldende organisasjons- og brukerinformasjon
skill delete Slette en kompetanse fra Dataverse
skill download Last ned en ferdighet fra Dataverse
skill list Vis aktive ferdigheter i miljøet
skill upload Laste opp en kompetanse til Dataverse

Bemerkning

Mange kommandoer støtter et --target <dataverse\|erp> alternativ som ruter operasjonen til Dataverse (standard) eller til det koblede miljøet Finance and Operations (ERP). Kommandoer som kobler til et miljø, støtter et --environment <url> (-env) alternativ for å overstyre den gjeldende profilens nettadresse for miljøet.

api describe kommando

Vis metadataene for én enkelt API. For dataverse egendefinerte API-er inkluderer utdataene beskrivelser av forespørselsparameter og svaregenskaper når metadataene inneholder dem.

Dataversenavn er uprefikset som standard. Du kan bruke FEILP-kvalifiserte navn i skjemaet erp:ServiceGroup/Service/Operation.

api describe Parametere

Parameteren Beskrivelse
--target Løs et ukvalifisert navn mot dataverse eller erp.
--service-group Bare FEILP. Begrense operasjonsoppslaget til én tjenestegruppe.
--service Bare FEILP. Begrens operasjonsoppslaget til én tjeneste.
--environment Overstyr URL-adressen for dataversmiljøet.
--json Utdata 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

Aktiver en oppdaget API ved navn. Bruk name=value syntaks for parametere. Hvis en verdi inneholder mellomrom, siterer du hele tokenet. Noen dataverse API-er godtar en strengparameter der innholdet selv er JSON. I så fall kan du sende JSON-teksten som verdien ved å bruke skallets normale siterer og rømmer regler.

JSON-svar gjengis som standard i et egendefinert tekstformat som beholder utdataegenskapsnavnene. Bruk --json denne til å bevare den rå JSON-nyttelasten.

api invoke Parametere

Parameteren Beskrivelse
--target Løs et ukvalifisert navn mot dataverse eller erp.
--service-group Bare FEILP. Begrense operasjonsoppslaget til én tjenestegruppe.
--service Bare FEILP. Begrens operasjonsoppslaget til én tjeneste.
--param Legg til en navngitt parameter i name=value skjemaet. Repeterbare.
--bind Bindingsbanen for enhetsbundne Dataverse API-er.
--method, -X Overstyr den utsatte HTTP-metoden.
--body Bruk en rå JSON-brødtekst i stedet for navngitte parametere.
--body-file Les en rå JSON-brødtekst fra en fil.
--header, -H Legg til en HTTP-topptekst i key:value skjemaet.
--include, -i Inkluder svarstatus og overskrifter.
--environment Overstyr URL-adressen for dataversmiljøet.
--json Utdata rå JSON i stedet for egendefinert tekst.

api invoke Eksempler

Aktiver en datavers funksjon. Dette eksemplet viser bruken av Dynamics 365 Contact Center CCaaS_GetPresence-funksjonen.

dataverse api invoke CCaaS_GetPresence ApiVersion=1.0

Aktiver handlingen Dataverse AISummarize med mellomrom i en parameterverdi:

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

Aktiver en egendefinert FEILP-tjeneste:

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

api list kommando

Vis synlige API-er, for eksempel dataverse egendefinerte API-er og ERP-aktiverbare tjenesteendepunkter. Resultatene viser API-identitet, egendefinert navn, type og beskrivelse når tilgjengelig. Du kan sende en valgfri spørringsterm for å filtrere resultatene.

api list Parametere

Parameteren Beskrivelse
--target Målsystemet som skal søkes: dataverse (standard) eller erp.
--service-group Bare FEILP. Filtrer til én enkelt tjenestegruppe.
--service Bare FEILP. Filtrer til én enkelt tjeneste.
--limit Maksimalt antall API-er som skal returneres. Standard: 50.
--page Det 1-baserte sidetallet ved sideveksling gjennom resultater. Standard: 1.
--environment Overstyr URL-adressen for dataversmiljøet.
--json Utdata 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å godkjent HTTP-forespørsel til Dataverse eller ERP. Bruk denne kommandoen når du trenger full kontroll over banen, metoden, toppteksten og brødteksten.

api request parametere

Parameteren Beskrivelse
--target Målsystemet: dataverse eller erp. Påkrevd.
--path Forespørselsbanen. Påkrevd.
--method, -X HTTP-metoden. Standard: GET, eller POST når en brødtekst er angitt.
--body En innebygd JSON-forespørselstekst.
--body-file En fil som inneholder meldingsteksten for et JSON-objekt.
--header, -H Legg til en HTTP-topptekst i key:value skjemaet.
--include, -i Inkluder svarstatus og overskrifter.
--environment Overstyr URL-adressen for dataversmiljø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

Opprett en ny godkjenningsprofil.

auth create Parametere

Bruk disse parameterne til å angi virkemåten til auth create kommandoen.

Parameteren Beskrivelse
--environment, -env URL-adressen for dataversmiljøet du vil godkjenne med.
--name, -n Et valgfritt navn for profilen. Bruk navnet til å velge profilen senere.
--cloud, -ci Målskyen: Public, UsGov, UsGovHigh, UsGovDodeller China.
--deviceCode, -dc Bruk godkjenningsflyten for enhetskode for miljøer uten nettleser.
--username, -un Brukernavnet for brukernavn og passordgodkjenning.
--password, -p Passordet for brukernavn og passordgodkjenning.
--applicationId, -id Program-ID-en (klient) for tjenestekontohavergodkjenning (SPN).
--clientSecret, -cs Klienthemmeligheten for godkjenning av tjenestekontohaver.
--certificateDiskPath, -cdp Banen til en PFX-sertifikatfil for sertifikatbasert godkjenning.
--certificatePassword, -cp Passordet for sertifikatet.
--tenant, -t Leier-ID-en. Obligatorisk for godkjenning av tjenestekontohaver.
--managedIdentity, -mi Bruk en Azure administrert identitet.
--githubFederated, -ghf Bruk GitHub Actions forbundsgodkjenning.
--azureDevOpsFederated, -adof Bruk Azure DevOps forbundsgodkjenning.
--clientid, -cid En egendefinert Microsoft Entra appklient-ID som skal brukes i stedet for standard Dataverse CLI-app.
--no-default-environment Ikke angi miljøet som standard.
--accept-cleartext-caching Tillat hurtigbuffer for plaintext-token på Linux.

auth create Eksempler

Eksemplene nedenfor viser hvordan du bruker auth create kommandoen.

Interaktiv godkjenning

Denne kommandoen åpner en nettleser eller systemdialogboks for mer informasjon.

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

Navngitt profil

Opprett en profil med et bestemt navn.

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

Enhetskodeflyt

Bruk enhetskodeflyten for miljøer uten nettleser.

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

Tjenesteprinsipp med klienthemmelighet

Bruk en tjenestekontohaver når du trenger uovervåket godkjenning, for eksempel i et CI/CD-datasamlebånd eller et annet automatisert skript der interaktiv pålogging ikke er mulig. Angi program-ID, klienthemmelighet og leier-ID for en appregistrering som har tilgang til miljøet.

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

Klient-ID for egendefinert Entra-app

Bruk din egen appregistrering i stedet for standard.

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

auth list kommando

Vis alle godkjenningsprofiler. Legg til --json for rå JSON-utdata.

auth list Eksempler

dataverse auth list
dataverse auth list --json

auth remove kommando

Fjern én eller alle godkjenningsprofiler.

auth remove Parametere

Parameteren Beskrivelse
--index, -i Fjern profilen med den angitte 1-baserte indeksen, som vist i auth list.
--name, -n Fjern profilen med det angitte navnet.
--all Fjern alle profiler.

auth remove Eksempler

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

auth select kommando

Velg aktiv godkjenningsprofil. Kjør kommandoen uten alternativer for å vise alle profiler.

auth select parametere

Parameteren Beskrivelse
--index, -i Velg profilen etter den 1-baserte indeksen, som vist i auth list.
--name, -n Velg profilen etter navn.

auth select Eksempler

Åpne en interaktiv velger. Bruk piltastene, eller skriv inn for å filtrere:

dataverse auth select

Velg en profil etter indeks eller navn:

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

auth who kommando

Vis gjeldende, aktiv godkjenningsprofil. Legg til --json for rå JSON-utdata.

auth who Eksempler

dataverse auth who
dataverse auth who --json

data associate kommando

Knytt to poster gjennom en navigasjonsegenskap (relasjon). Denne kommandoen støttes bare for Dataverse.

data associate Parametere

Parameteren Beskrivelse
--table, -t Enhetssettnavnet for primærposten. Påkrevd.
--id, -i GUID-en for den primære posten. Påkrevd.
--relationship, -rel Navnet på navigasjonsegenskapen. Påkrevd.
--related Enhetssettnavnet for den relaterte tabellen. Påkrevd.
--related-id GUID-en for den relaterte posten. Påkrevd.
--environment, -env Overstyr url-adressen for miljøet.
--json Utdata 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

Tell postene i en tabell, eventuelt filtrert.

data count parametere

Parameteren Beskrivelse
--table, -t Navnet på enhetssettet. Obligatorisk med mindre du bruker --fetchxml.
--filter, -f Et OData-uttrykk $filter .
--fetchxml En FetchXML-mengdespørring for komplekse antall.
--target Rute til dataverse (standard) eller det koblede erp miljøet.
--cross-company Bare FEILP. Tell på tvers av alle firmaer. Standard: brukerens standardselskap.
--environment, -env Overstyr url-adressen for miljøet.
--json Utdata rå JSON.

data count Eksempler

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

data create kommando

Opprett en ny post i en datavers tabell. Angi oppslagskolonner ved hjelp @odata.bind av syntaks.

data create Parametere

Parameteren Beskrivelse
--table, -t Navnet på enhetssettet. Påkrevd.
--data, -d Et JSON-objekt med feltverdiene.
--data-file Banen til en JSON-fil med postdataene.
--return, -r Returner den fullstendige opprettede posten.
--target Rute til dataverse (standard) eller det koblede erp miljøet.
--environment, -env Overstyr url-adressen for miljøet.
--json Utdata 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>)"}'

Tips

Brukes --data-file for kompleks JSON. Bruk --return --json denne til å hente den fullstendige opprettede posten.

data delete kommando

Slett én enkelt post etter primærnøkkelen eller en alternativ nøkkel.

data delete Parametere

Parameteren Beskrivelse
--table, -t Navnet på enhetssettet. Påkrevd.
--id, -i POST-GUIDen.
--key, -k En alternativ nøkkel.
--no-confirm Hopp over bekreftelsesledeteksten.
--target Rute til dataverse (standard) eller det koblede erp miljøet.
--environment, -env Overstyr url-adressen for miljøet.
--json Utdata rå JSON.

data delete Eksempler

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

data describe kommando

Beskriv skjemaet til en OData-enhet. For Datavers kaller kommandoen EntityDefinitions(LogicalName='<table>') opp med $expand drevet av --include, pluss et annet kall til customapis når --include actions er angitt. Innebygde dataverse handlinger, for eksempel Assign og SetState ikke listes opp. For FEILP returnerer et enkelt kall egenskaper /Metadata/PublicEntities , bundne handlinger og navigasjoner sammen.

data describe Parametere

Parameteren Beskrivelse
--target Målet: dataverse (standard) eller erp.
--table, -t Påkrevd. For Dataverse, det logiske navnet, for eksempel account. For FEILP er enhetssettets navn, for eksempel BatchJobs.
--include En kommadelt liste over inndelinger som skal inkluderes: entity, , properties, relationseller actionsall. Aliaser: attributes=properties, relationships=relations. Standard for FEILP: all. Standard for datavers: entity,properties.
--json Utdata 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 relasjon mellom to poster. Denne kommandoen støttes bare for Dataverse.

data disassociate Parametere

Parameteren Beskrivelse
--table, -t Enhetssettnavnet for primærposten. Påkrevd.
--id, -i GUID-en for den primære posten. Påkrevd.
--relationship, -rel Navnet på navigasjonsegenskapen. Påkrevd.
--related-id GUID-en for den relaterte posten, for en mange-til-mange-relasjon. Utelat denne parameteren for å fjerne et oppslag.
--environment, -env Overstyr url-adressen for miljøet.
--json Utdata rå JSON.

data disassociate Eksempler

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

data get kommando

Hent én enkelt post etter ID -en (primærnøkkel) eller en alternativ nøkkel.

data get Parametere

Parameteren Beskrivelse
--table, -t Navnet på enhetssettet. Påkrevd.
--id, -i POST-GUID (primærnøkkel).
--key, -k En alternativ nøkkel, for eksempel "col='val'".
--select, -s En kommadelt liste over kolonner ($select).
--expand, -x Et OData-uttrykk $expand for relaterte poster.
--target Rute til dataverse (standard) eller det koblede erp miljøet.
--environment, -env Overstyr url-adressen for miljøet.
--json Utdata 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

Utfør en OData-, FetchXML- eller SQL-spørring mot en Datavers-tabell.

data query Parametere

Parameteren Beskrivelse
--table, -t Enhetssettets navn til spørring. Obligatorisk for OData-spørringer.
--select, -s En kommadelt liste over kolonner ($select).
--filter, -f Et OData-uttrykk $filter .
--orderby, -o Et OData-uttrykk $orderby .
--top Maksimalt antall poster som skal returneres (1-5000).
--expand, -x Et OData-uttrykk $expand for relaterte poster.
--fetchxml En innebygd FetchXML-spørring.
--fetchxml-file Banen til en fil som inneholder en FetchXML-spørring.
--sql En SQL-spørring SELECT (forhåndsversjon).
--sql-file Banen til en fil som inneholder en SQL-spørring.
--all, -a Følg paginering for å hente alle postene.
--max-records Maksimalt antall poster som skal hentes når du bruker --all. Standard: 100000.
--target Rute til dataverse (standard) eller det koblede erp miljøet.
--cross-company Bare FEILP. Spør på tvers av alle firmaer. Standard: brukerens standardselskap.
--environment, -env Overstyr url-adressen for miljøet.
--json Utdata 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

Mer informasjon

data update kommando

Oppdater ett eller flere felt på en eksisterende post, identifisert av ID-en eller av en alternativ nøkkel. Angi oppslagskolonner ved hjelp @odata.bind av syntaks.

data update parametere

Parameteren Beskrivelse
--table, -t Navnet på enhetssettet. Påkrevd.
--id, -i POST-GUIDen.
--key, -k En alternativ nøkkel.
--data, -d Et JSON-objekt med feltene som skal oppdateres.
--data-file Banen til en JSON-fil med oppdateringsdataene.
--return, -r Returner den fullstendig oppdaterte posten.
--target Rute til dataverse (standard) eller det koblede erp miljøet.
--environment, -env Overstyr url-adressen for miljøet.
--json Utdata rå JSON.

data update Eksempler

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

data upload kommando

Last opp en lokal fil til en Dataverse-filkolonne på en eksisterende post. Kommandoen velger automatisk en enkeltforespørsel eller delopplasting basert på filstørrelsen, med mindre du angir --mode. I automatisk modus lastes filer under 128 MB opp i én enkelt forespørsel, og større filer bruker en delt opplasting. Når du utelater --mime-type, utleder kommandoen MIME-typen fra filtypen. Ukjente filtyper er som standard .application/octet-stream

data upload Parametere

Parameteren Beskrivelse
--table, -t Tabellskjemaet eller det logiske navnet, for eksempel account. Påkrevd. Kommandoen løser enhetssettet fra metadata.
--id, -i POST-GUIDen. Påkrevd.
--column, -c Attributtnavnet for filkolonnen. Påkrevd.
--file, -f Banen til den lokale filen. Påkrevd.
--mode, -m Opplastingsstrategien: auto (standard), smalleller chunk.
--mime-type En eksplisitt MIME-type. Standard: utledet fra filtypen.
--overwrite Overskriv en eksisterende fil. Kommandoen mislykkes som standard hvis kolonnen ikke er tom.
--environment, -env Overstyr url-adressen for miljøet.
--json Utdata 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

Opprett en post hvis den ikke finnes, eller oppdater den hvis den gjør det. Posten identifiseres av en alternativ nøkkel. Lær hvordan du bruker en alternativ nøkkel til å referere til en post

data upsert Parametere

Parameteren Beskrivelse
--table, -t Navnet på enhetssettet. Påkrevd.
--key, -k En alternativ nøkkel. Påkrevd.
--data, -d Et JSON-objekt med feltverdiene.
--data-file Banen til en JSON-fil.
--update-only Mislykkes hvis posten ikke finnes (If-Match: *).
--create-only Mislykkes hvis posten allerede finnes (If-None-Match: *).
--return, -r Returner hele posten etter operasjonen.
--target Rute til dataverse (standard) eller det koblede erp miljøet.
--environment, -env Overstyr url-adressen for miljøet.
--json Utdata rå JSON.

data upsert Eksempler

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

erp batch cancel kommando

Avbryt en finans- og operasjonsgruppejobb etter dens RecId. Bruk erp batch list denne til å finne RecId.

erp batch cancel Eksempler

dataverse erp batch cancel <recid>

erp batch list kommando

Vis satsvise jobber i finans- og operasjonsforekomsten som er koblet til dataversmiljøet. Kommandoen krever en godkjenningsprofil som er koblet til et dataversmiljø som har en koblet finance and operations-forekomst. URL-adressen for økonomi og operasjoner hentes automatisk fra den gjeldende dataverse tilkoblingen.

erp batch list Parametere

Parameteren Beskrivelse
--company Filtrer etter juridisk enhet (dataAreaIdfor eksempel USMF.
--status Filtrer etter status: Waiting, Executing, Finished, Erroreller Cancelled.
--top Maksimalt antall resultater som skal returneres. Standard: 20.
--caption Filtrer etter bildetekst (skille mellom store og små bokstaver).
--json Utdata 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

Installer en bestemt versjon av Dataverse CLI, eller oppdater til den nyeste versjonen. Kommandoen oppdager om du installerte CLI globalt eller bruker npx og installerer tilsvarende.

install Eksempler

Installer den nyeste versjonen:

dataverse install latest

Installer en bestemt versjon:

dataverse install 1.0.0

mcp kommando

Starter en MCP-server (Model Context Protocol) som kobles til miljøet ditt, slik at AI-assistenter som Claude Desktop kan samhandle med dataene dine. Målet oppdages automatisk fra URL-adressen: En datavers URL-adresse starter Datavers MCP-serveren, og en URL-adresse for økonomi og operasjoner, for eksempel https://myorg.operations.dynamics.com, starter ERP MCP-serveren.

mcp syntaks

dataverse mcp <orgUrl> [options]

Argumentet <orgUrl> er organisasjonens NETTADRESSE, for eksempel https://myorg.crm.dynamics.com.

mcp Parametere

Parameteren Beskrivelse
--validate Valider MCP-endepunktene og godkjenningsoppsettet uten å starte serveren.
--log-level Angi loggingsnivå: Trace, , Debug, Information, Warningeller ErrorCritical. Standard: Warning.
--log-file Logg på en fil i den midlertidige katalogen.
--preview Bruk forhåndsversjonen av MCP-endepunktet (api/mcp_preview i stedet for api/mcp). Støttes ikke for FEILP.

mcp Eksempler

Valider oppsettet (et anbefalt første trinn):

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

Start serveren ved hjelp av stdiotransporten:

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

Bruk forhåndsvisningsendepunktet, eller aktiver feilsøking av fillogging:

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

mcp allow kommando

Kontroller at et Microsoft Entra program er i datavers mcp tillatte klienter-listen for gjeldende profilmiljø. Denne kommandoen er et alternativ til det manuelle administrasjonstrinnet som er beskrevet i forutsetningene. Den godkjente brukeren må ha administratortillatelser for Dataverse i målmiljøet.

mcp allow syntaks

dataverse mcp allow <appId> [options]

Argumentet <appId> er program-IDen (klient)-IDen som skal tillates, som en GUID.

mcp allow Parametere

Parameteren Beskrivelse
--erp Tillat programmet i den koblede finance- og operasjonsforekomsten i stedet for datavers.

mcp allow Eksempler

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

Bemerkning

Økonomi og operasjoner bufrer tillatelseslisten i AOS, slik at en nylig tillatt app-ID kan ta opptil fem minutter å tre i kraft.

org list kommando

Vis alle miljøer du har tilgang til.

org list Parametere

Parameteren Beskrivelse
--filter Filtrer listen over miljøer etter et søkeord.
--json Utdata rå JSON.

org list Eksempler

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

org who kommando

Vis informasjon om gjeldende organisasjon og bruker ved hjelp av den aktive godkjenningsprofilen. Kommandoen env er et alias for org.

org who Parametere

Parameteren Beskrivelse
--environment, -env Overstyr url-adressen for miljøet.
--json Utdata rå JSON.

org who Eksempler

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

skill kommandoer

Behandle dataverse ferdigheter – gjenbrukbare instruksjonssett (en SKILL.md fil og dens ressursfiler) som AI-agenter bruker– som er lagret i det tilkoblede miljøet. Kommandoene på øverste nivå skill gir opprettings-, lese-, oppdaterings- og sletteoperasjoner mot miljøet. Lokalt lagres ferdigheter under .claude/skills/<name>/.

Bemerkning

Kommandoene Kompetanseredigering og evaluering, for eksempel make, update, getog eval, er atskilt fra disse kommandoene. Hvis du vil ha mer informasjon, kan du kjøre dataverse workspace skill --help.

skill delete kommando

Slett en kompetanse og alle ressursene fra det aktive Dataverse-miljøet. Bruk skill list denne til å finne unike navn på ferdigheter.

dataverse skill delete new_lead-qualification

skill download kommando

Last ned én eller flere ferdigheter fra det aktive dataversmiljøet til disken. Kommandoen laster SKILL.md ned filen og alle ressursfilene, og beholder katalogstrukturen. Bruk skill list denne til å finne unike navn på ferdigheter.

Parameteren Beskrivelse
--all Last ned alle aktive ferdigheter fra miljøet. Kan ikke kombineres med unike ferdigheter.
--output, -o Basiskatalogen for utdata. Standard: .claude/skills/. Med --allskrives hver kompetanse til <path>/<name>/.
--json Skriv ut kompetanseinnholdet som JSON uten å skrive filer. Du kan også angi en filbane du vil skrive til. 
dataverse skill download new_lead-qualification
dataverse skill download --all --output ./skills

skill list kommando

Vis alle aktive ferdigheter i det tilkoblede Dataverse-miljøet.

Parameteren Beskrivelse
--resources, -r Vis også ressursfilene for hver kompetanse.
--json Utdata som JSON. Du kan også angi en filbane du vil skrive til. 
dataverse skill list
dataverse skill list --resources

skill upload kommando

Last opp én eller flere ferdigheter fra disk til det aktive Dataverse-miljøet. Kommandoen støtter kataloger, .zip filer, .skill-filer og MD-filer .

Du kan sende en kompetanse <name>, som løses til .claude/skills/<name>/, eller en eksplisitt <path> til en katalog eller fil.

Parameteren Beskrivelse
--all Last opp alle ferdigheter under .claude/skills/. Kan ikke kombineres med et kompetansenavn eller bane.
--json Utdata resultatet som JSON. Du kan også angi en filbane du vil skrive til. 
dataverse skill upload lead-qualification
dataverse skill upload ./my-skill.zip
dataverse skill upload --all

Se også

Arbeide med data ved hjelp av Dataverse CLI

  • Last updated on