Dataverse CLI-referens (förhandsversion)

Note

  • Detta är en förhandsgranskningsfunktion.
  • Förhandsversionsfunktioner ska inte användas i produktion och funktionerna kan vara begränsade. Dessa funktioner är tillgängliga före en officiell release så att kunderna kan få tidig tillgång och ge feedback.

I den här artikeln beskrivs de kommandon som är tillgängliga i Dataverse CLI. Varje kommando stöder ett --help alternativ som visar dess användning, alternativ och exempel. Kommandon som returnerar data stöder ett --json alternativ för råa JSON-utdata som är användbara i skript.

Följande globala alternativ kan användas med valfritt kommando:

Option Description
--log-level <level> Ange loggningsnivån: Trace, Debug, Information, Warning, Erroreller Critical. Standardvärde: Warning.
--log-file Logga in på en fil i den temporära katalogen i stället för konsolen.
--context <value> Åtgärdskontext som läggs till i användaragenten. Du kan också ange DATAVERSE_OPERATION_CONTEXT miljövariabeln.
Command Description
api describe Beskriva ett API
api invoke Anropa ett API efter namn
api list Lista identifieringsbara API:er
api request Skicka en autentiserad HTTP-begäran
auth create Skapa en ny autentiseringsprofil
auth list Visa en lista över alla autentiseringsprofiler
auth remove Ta bort en autentiseringsprofil
auth select Välj den aktiva autentiseringsprofilen
auth who Visa den aktuella autentiseringsprofilen
data associate Länka två poster via en relation
data count Räkna poster i en tabell
data create Skapa en ny post
data delete Ta bort en post
data describe Beskriva en entitets schema
data disassociate Ta bort en relation mellan två poster
data get Hämta en enskild post med ID eller alternativ nyckel
data query Köra en OData-, FetchXML- eller SQL-fråga
data update Uppdatera en befintlig post
data upload Ladda upp en fil till en filkolumn på en befintlig post
data upsert Skapa eller uppdatera en post med alternativ nyckel
erp batch cancel Avbryta ett batchjobb för ekonomi och drift
erp batch list Visa en lista över batchjobb för ekonomi och drift
install Installera en specifik version eller uppdatera till den senaste versionen
mcp Starta MCP-servern för Dataverse eller ERP
mcp allow Tillåt en app som en MCP-klient
org list Visa en lista över alla tillgängliga miljöer
org who Visa aktuell organisations- och användarinformation
skill delete Ta bort en färdighet från Dataverse
skill download Ladda ned en färdighet från Dataverse
skill list Visa en lista över aktiva kunskaper i miljön
skill upload Ladda upp en färdighet till Dataverse

Note

Många kommandon har stöd för ett --target <dataverse\|erp> alternativ som dirigerar åtgärden till Dataverse (standard) eller till den länkade erp-miljön (Finance and Operations). Kommandon som ansluter till en miljö stöder ett --environment <url> (-env) alternativ för att åsidosätta den aktuella profilens miljö-URL.

api describe kommando

Visa metadata för ett enda API. För anpassade API:er för Dataverse innehåller utdata egenskapsbeskrivningar för begäran och svar när metadata tillhandahåller dem.

Dataverse-namn är oförberedda som standard. Du kan använda ERP-kvalificerade namn i formuläret erp:ServiceGroup/Service/Operation.

api describe Parametrar

Parameter Description
--target Lös ett okvalificerat namn mot dataverse eller erp.
--service-group ENDAST ERP. Begränsa åtgärdssökningen till en tjänstgrupp.
--service ENDAST ERP. Begränsa åtgärdssökningen till en tjänst.
--environment Åsidosätt URL:en för Dataverse-miljön.
--json Utdata för rå JSON.

api describe exempel

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

api invoke kommando

Anropa ett identifierat API med namn. Använd name=value syntax för parametrar. Om ett värde innehåller blanksteg citerar du hela token. Vissa Dataverse-API:er accepterar en strängparameter vars innehåll själva är JSON. I så fall skickar du JSON-texten som värde med hjälp av gränssnittets normala regler för citat och undantag.

Som standard återges JSON-svar i ett eget textformat som behåller utdataegenskapsnamnen. Använd --json för att bevara den råa JSON-nyttolasten.

api invoke Parametrar

Parameter Description
--target Lös ett okvalificerat namn mot dataverse eller erp.
--service-group ENDAST ERP. Begränsa åtgärdssökningen till en tjänstgrupp.
--service ENDAST ERP. Begränsa åtgärdssökningen till en tjänst.
--param Lägg till en namngiven parameter i name=value formulär. Repeterbar.
--bind Bindningssökvägen för entitetsbundna Dataverse-API:er.
--method, -X Åsidosätt den härledda HTTP-metoden.
--body Använd en rå JSON-brödtext i stället för namngivna parametrar.
--body-file Läs en rå JSON-brödtext från en fil.
--header, -H Lägg till ett HTTP-huvud i key:value formulär.
--include, -i Inkludera svarsstatus och rubriker.
--environment Åsidosätt URL:en för Dataverse-miljön.
--json Mata ut rå JSON i stället för egen text.

api invoke exempel

Anropa en Dataverse-funktion. Det här exemplet visar användningen av funktionen Dynamics 365 Contact Center CCaaS_GetPresence.

dataverse api invoke CCaaS_GetPresence ApiVersion=1.0

Anropa åtgärden Dataverse AISummarize med blanksteg i ett parametervärde:

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

Anropa en anpassad ERP-tjänst:

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

api list kommando

Visa en lista över identifieringsbara API:er, till exempel anpassade API:er för Dataverse och TJÄNSTslutpunkter som kan användas av ERP. Resultaten visar API-identitet, eget namn, typ och beskrivning när det är tillgängligt. Du kan skicka en valfri frågeterm för att filtrera resultatet.

api list Parametrar

Parameter Description
--target Målsystemet för sökning: dataverse (standard) eller erp.
--service-group ENDAST ERP. Filtrera till en enda tjänstgrupp.
--service ENDAST ERP. Filtrera till en enda tjänst.
--limit Det maximala antalet API:er som ska returneras. Standardvärde: 50.
--page Det 1-baserade sidnumret vid växling genom resultat. Standardvärde: 1.
--environment Åsidosätt URL:en för Dataverse-miljön.
--json Utdata för rå JSON.

api list exempel

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

Skicka en rå autentiserad HTTP-begäran till Dataverse eller ERP. Använd det här kommandot när du behöver fullständig kontroll över sökvägen, metoden, rubrikerna och brödtexten.

api request Parametrar

Parameter Description
--target Målsystemet: dataverse eller erp. Required.
--path Sökvägen för begäran. Required.
--method, -X HTTP-metoden. Standard: GET, eller POST när en brödtext tillhandahålls.
--body En infogad JSON-begärandetext.
--body-file En fil som innehåller en JSON-objektbegärandetext.
--header, -H Lägg till ett HTTP-huvud i key:value formulär.
--include, -i Inkludera svarsstatus och rubriker.
--environment Åsidosätt URL:en för Dataverse-miljön.

api request exempel

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

Skapa en ny autentiseringsprofil.

auth create Parametrar

Använd dessa parametrar för att ange kommandots auth create beteende.

Parameter Description
--environment, -env URL:en för den Dataverse-miljö som du vill autentisera med.
--name, -n Ett valfritt namn för profilen. Använd namnet för att välja profilen senare.
--cloud, -ci Målmolnet: Public, UsGov, UsGovHigh, UsGovDodeller China.
--deviceCode, -dc Använd autentiseringsflödet för enhetskod för miljöer utan webbläsare.
--username, -un Användarnamnet för autentisering med användarnamn och lösenord.
--password, -p Lösenordet för autentisering med användarnamn och lösenord.
--applicationId, -id Program-ID (klient)-ID för autentisering med tjänstens huvudnamn (SPN).
--clientSecret, -cs Klienthemligheten för autentisering med tjänstens huvudnamn.
--certificateDiskPath, -cdp Sökvägen till en .pfx-certifikatfil för certifikatbaserad autentisering.
--certificatePassword, -cp Lösenordet för certifikatet.
--tenant, -t Klientorganisations-ID:t. Krävs för autentisering med tjänstens huvudnamn.
--managedIdentity, -mi Använd en Azure hanterad identitet.
--githubFederated, -ghf Använd GitHub Actions federerad autentisering.
--azureDevOpsFederated, -adof Använd Azure DevOps federerad autentisering.
--clientid, -cid Ett anpassat Microsoft Entra appklient-ID som ska användas i stället för standardappen för Dataverse CLI.
--no-default-environment Ange inte miljön som standard.
--accept-cleartext-caching Tillåt en cache för klartexttoken i Linux.

auth create exempel

Följande exempel visar hur du auth create använder kommandot.

Interaktiv autentisering

Det här kommandot öppnar en webbläsar- eller systemdialogruta för ytterligare information.

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

Namngiven profil

Skapa en profil med ett specifikt namn.

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

Enhetskodflöde

Använd enhetskodflödet för miljöer utan webbläsare.

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

Tjänstens huvudnamn med klienthemlighet

Använd ett huvudnamn för tjänsten när du behöver obevakad autentisering, till exempel i en CI/CD-pipeline eller ett annat automatiserat skript där interaktiv inloggning inte är möjlig. Ange program-ID, klienthemlighet och klient-ID för en appregistrering som har åtkomst till miljön.

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

Anpassat Klient-ID för Entra-appar

Använd din egen appregistrering i stället för standardinställningen.

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

auth list kommando

Visa en lista över alla autentiseringsprofiler. Lägg till --json för råA JSON-utdata.

auth list exempel

dataverse auth list
dataverse auth list --json

auth remove kommando

Ta bort en eller alla autentiseringsprofiler.

auth remove Parametrar

Parameter Description
--index, -i Ta bort profilen med det angivna 1-baserade indexet, som du ser i auth list.
--name, -n Ta bort profilen med det angivna namnet.
--all Ta bort alla profiler.

auth remove exempel

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

auth select kommando

Välj den aktiva autentiseringsprofilen. Kör kommandot utan alternativ för att visa alla profiler.

auth select Parametrar

Parameter Description
--index, -i Välj profilen efter dess 1-baserade index, som du ser i auth list.
--name, -n Välj profilen efter namn.

auth select exempel

Öppna en interaktiv väljare. Använd piltangenterna eller skriv för att filtrera:

dataverse auth select

Välj en profil efter index eller efter namn:

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

auth who kommando

Visa den aktuella aktiva autentiseringsprofilen. Lägg till --json för råA JSON-utdata.

auth who exempel

dataverse auth who
dataverse auth who --json

data associate kommando

Associera två poster via en navigeringsegenskap (relation). Det här kommandot stöds endast för Dataverse.

data associate Parametrar

Parameter Description
--table, -t Entitetsuppsättningens namn på den primära posten. Required.
--id, -i GUID för den primära posten. Required.
--relationship, -rel Namnet på navigeringsegenskapen. Required.
--related Entitetsuppsättningens namn på den relaterade tabellen. Required.
--related-id GUID för den relaterade posten. Required.
--environment, -env Åsidosätt miljö-URL:en.
--json Utdata för rå JSON.

data associate exempel

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

data count kommando

Räkna posterna i en tabell, eventuellt filtrerade.

data count Parametrar

Parameter Description
--table, -t Namnet på entitetsuppsättningen. Krävs om du inte använder --fetchxml.
--filter, -f Ett OData-uttryck $filter .
--fetchxml En FetchXML-aggregeringsfråga för komplexa antal.
--target Dirigera till dataverse (standard) eller den länkade erp miljön.
--cross-company ENDAST ERP. Räkna över alla företag. Standard: användarens standardföretag.
--environment, -env Åsidosätt miljö-URL:en.
--json Utdata för rå JSON.

data count exempel

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

data create kommando

Skapa en ny post i en Dataverse-tabell. Ange uppslagskolumner med hjälp @odata.bind av syntax.

data create Parametrar

Parameter Description
--table, -t Namnet på entitetsuppsättningen. Required.
--data, -d Ett JSON-objekt med fältvärdena.
--data-file Sökvägen till en JSON-fil med postdata.
--return, -r Returnera den fullständiga skapade posten.
--target Dirigera till dataverse (standard) eller den länkade erp miljön.
--environment, -env Åsidosätt miljö-URL:en.
--json Utdata för rå JSON.

data create exempel

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

Tip

Används --data-file för komplex JSON. Använd --return --json för att hämta den fullständiga skapade posten.

data delete kommando

Ta bort en enskild post med dess primära nyckel eller med en alternativ nyckel.

data delete Parametrar

Parameter Description
--table, -t Namnet på entitetsuppsättningen. Required.
--id, -i Postens GUID.
--key, -k En alternativ nyckel.
--no-confirm Hoppa över bekräftelseprompten.
--target Dirigera till dataverse (standard) eller den länkade erp miljön.
--environment, -env Åsidosätt miljö-URL:en.
--json Utdata för rå JSON.

data delete exempel

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

data describe kommando

Beskriv en OData-entitets schema. För Dataverse anropar EntityDefinitions(LogicalName='<table>') kommandot med $expand driven av --include, plus ett andra anrop till customapis när --include actions har angetts. Inbyggda Dataverse-åtgärder som Assign och SetState räknas inte upp. För ERP returnerar ett enda anrop till /Metadata/PublicEntities egenskaper, bundna åtgärder och navigering tillsammans.

data describe Parametrar

Parameter Description
--target Målet: dataverse (standard) eller erp.
--table, -t Required. För Dataverse, det logiska namnet, till exempel account. För ERP, entitetsuppsättningens namn, till exempel BatchJobs.
--include En kommaavgränsad lista med avsnitt som ska innehålla: entity, properties, relations, actions, eller all. Alias: attributes=properties, . relationships=relations Standard för ERP: all. Standard för Dataverse: entity,properties.
--json Utdata för rå JSON.

data describe exempel

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

data disassociate kommando

Ta bort en relation mellan två poster. Det här kommandot stöds endast för Dataverse.

data disassociate Parametrar

Parameter Description
--table, -t Entitetsuppsättningens namn på den primära posten. Required.
--id, -i GUID för den primära posten. Required.
--relationship, -rel Namnet på navigeringsegenskapen. Required.
--related-id GUID för den relaterade posten för en många-till-många-relation. Utelämna den här parametern för att rensa ett uppslag.
--environment, -env Åsidosätt miljö-URL:en.
--json Utdata för rå JSON.

data disassociate exempel

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

data get kommando

Hämta en enskild post med dess ID (primärnyckel) eller med en alternativ nyckel.

data get Parametrar

Parameter Description
--table, -t Namnet på entitetsuppsättningen. Required.
--id, -i Postens GUID (primärnyckel).
--key, -k En alternativ nyckel, till exempel "col='val'".
--select, -s En kommaavgränsad lista med kolumner ($select).
--expand, -x Ett OData-uttryck $expand för relaterade poster.
--target Dirigera till dataverse (standard) eller den länkade erp miljön.
--environment, -env Åsidosätt miljö-URL:en.
--json Utdata för rå JSON.

data get exempel

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

Kör en OData-, FetchXML- eller SQL-fråga mot en Dataverse-tabell.

data query Parametrar

Parameter Description
--table, -t Entiteten anger namnet på frågan. Krävs för OData-frågor.
--select, -s En kommaavgränsad lista med kolumner ($select).
--filter, -f Ett OData-uttryck $filter .
--orderby, -o Ett OData-uttryck $orderby .
--top Det maximala antalet poster som ska returneras (1–5 000).
--expand, -x Ett OData-uttryck $expand för relaterade poster.
--fetchxml En infogad FetchXML-fråga.
--fetchxml-file Sökvägen till en fil som innehåller en FetchXML-fråga.
--sql En SQL-fråga SELECT (förhandsversion).
--sql-file Sökvägen till en fil som innehåller en SQL-fråga.
--all, -a Följ sidnumreringen för att hämta alla poster.
--max-records Det maximala antalet poster som ska hämtas när du använder --all. Standardvärde: 100000.
--target Dirigera till dataverse (standard) eller den länkade erp miljön.
--cross-company ENDAST ERP. Fråga i alla företag. Standard: användarens standardföretag.
--environment, -env Åsidosätt miljö-URL:en.
--json Utdata för rå JSON.

data query exempel

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

Learn more

data update kommando

Uppdatera ett eller flera fält på en befintlig post, identifierad med dess ID eller av en alternativ nyckel. Ange uppslagskolumner med hjälp @odata.bind av syntax.

data update Parametrar

Parameter Description
--table, -t Namnet på entitetsuppsättningen. Required.
--id, -i Postens GUID.
--key, -k En alternativ nyckel.
--data, -d Ett JSON-objekt med fälten som ska uppdateras.
--data-file Sökvägen till en JSON-fil med uppdateringsdata.
--return, -r Returnera den fullständiga uppdaterade posten.
--target Dirigera till dataverse (standard) eller den länkade erp miljön.
--environment, -env Åsidosätt miljö-URL:en.
--json Utdata för rå JSON.

data update exempel

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

data upload kommando

Ladda upp en lokal fil till en Dataverse-filkolumn på en befintlig post. Kommandot väljer automatiskt en enskild begäran eller segmenterad uppladdning baserat på filstorleken, såvida du inte anger --mode. I automatiskt läge laddas filer under 128 MB upp i en enda begäran, och större filer använder en segmenterad uppladdning. När du utelämnar --mime-typehärleder kommandot MIME-typen från filnamnstillägget. Okända tillägg är som standard application/octet-stream.

data upload Parametrar

Parameter Description
--table, -t Tabellschemat eller det logiska namnet, till exempel account. Required. Kommandot löser entitetsuppsättningen från metadata.
--id, -i Postens GUID. Required.
--column, -c Namnet på filkolumnattributet. Required.
--file, -f Sökvägen till den lokala filen. Required.
--mode, -m Uppladdningsstrategin: auto (standard), small, eller chunk.
--mime-type En explicit MIME-typ. Standard: härleds från filnamnstillägget.
--overwrite Skriv över en befintlig fil. Som standard misslyckas kommandot om kolumnen inte är tom.
--environment, -env Åsidosätt miljö-URL:en.
--json Utdata för rå JSON.

data upload exempel

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

Skapa en post om den inte finns eller uppdatera den om den gör det. Posten identifieras av en alternativ nyckel. Lär dig att använda en alternativ nyckel för att referera till en post

data upsert Parametrar

Parameter Description
--table, -t Namnet på entitetsuppsättningen. Required.
--key, -k En alternativ nyckel. Required.
--data, -d Ett JSON-objekt med fältvärdena.
--data-file Sökvägen till en JSON-fil.
--update-only Det går inte om posten inte finns (If-Match: *).
--create-only Det går inte om posten redan finns (If-None-Match: *).
--return, -r Returnera den fullständiga posten efter åtgärden.
--target Dirigera till dataverse (standard) eller den länkade erp miljön.
--environment, -env Åsidosätt miljö-URL:en.
--json Utdata för rå JSON.

data upsert exempel

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

erp batch cancel kommando

Avbryt batchjobbet Finance and Operations med dess RecId. Använd erp batch list för att hitta RecId.

erp batch cancel exempel

dataverse erp batch cancel <recid>

erp batch list kommando

Visa en lista över batchjobb på den ekonomi- och driftinstans som är länkad till din Dataverse-miljö. Kommandot kräver en autentiseringsprofil som är ansluten till en Dataverse-miljö som har en länkad Finance and Operations-instans. URL:en för ekonomi och drift härleds automatiskt från den aktuella Dataverse-anslutningen.

erp batch list Parametrar

Parameter Description
--company Filtrera efter juridisk person (dataAreaId), till exempel USMF.
--status Filtrera efter status: Waiting, Executing, Finished, Erroreller Cancelled.
--top Det maximala antalet resultat som ska returneras. Standardvärde: 20.
--caption Filtrera efter bildtext (skiftlägesokänslig delsträngsmatchning).
--json Utdata för rå JSON.

erp batch list exempel

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

install kommando

Installera en specifik version av Dataverse CLI eller uppdatera till den senaste versionen. Kommandot identifierar om du har installerat CLI globalt eller använder npx och installerar därefter.

install exempel

Installera den senaste versionen:

dataverse install latest

Installera en specifik version:

dataverse install 1.0.0

mcp kommando

Startar en MCP-server (Model Context Protocol) som ansluter till din miljö, så att AI-assistenter som Claude Desktop kan interagera med dina data. Målet identifieras automatiskt från URL:en: en Dataverse-URL startar Dataverse MCP-servern och en ekonomi- och åtgärds-URL, till https://myorg.operations.dynamics.comexempel , startar ERP MCP-servern.

mcp Syntax

dataverse mcp <orgUrl> [options]

Argumentet <orgUrl> är din organisations URL, till exempel https://myorg.crm.dynamics.com.

mcp Parametrar

Parameter Description
--validate Verifiera MCP-slutpunkterna och autentiseringskonfigurationen utan att starta servern.
--log-level Ange loggningsnivån: Trace, Debug, Information, Warning, Erroreller Critical. Standardvärde: Warning.
--log-file Logga in på en fil i den temporära katalogen.
--preview Använd mcp-slutpunkten för förhandsversionen (api/mcp_preview i stället api/mcpför ). Stöds inte för ERP.

mcp exempel

Verifiera konfigurationen (ett rekommenderat första steg):

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

Starta servern med hjälp av stdio-transporten:

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

Använd förhandsgranskningsslutpunkten eller aktivera loggning av felsökningsfiler:

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

mcp allow kommando

Se till att ett Microsoft Entra program finns i listan över tillåtna MCP-klienter i Dataverse för den aktuella profilens miljö. Det här kommandot är ett alternativ till det manuella administratörssteget som beskrivs i förutsättningarna. Den autentiserade användaren måste ha administratörsbehörigheter för Dataverse för målmiljön.

mcp allow Syntax

dataverse mcp allow <appId> [options]

Argumentet <appId> är det program-ID (klient)-ID som ska tillåtas, som ett GUID.

mcp allow Parametrar

Parameter Description
--erp Tillåt programmet på den länkade Finance and Operations-instansen i stället för Dataverse.

mcp allow exempel

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

Note

Ekonomi och drift cachelagrar listan över tillåtna i AOS, så ett nyligen tillåtet app-ID kan ta upp till cirka fem minuter att börja gälla.

org list kommando

Visa en lista över alla miljöer som du kan komma åt.

org list Parametrar

Parameter Description
--filter Filtrera listan över miljöer efter en söktermen.
--json Utdata för rå JSON.

org list exempel

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

org who kommando

Visa information om den aktuella organisationen och användaren med hjälp av den aktiva autentiseringsprofilen. Kommandot env är ett alias för org.

org who Parametrar

Parameter Description
--environment, -env Åsidosätt miljö-URL:en.
--json Utdata för rå JSON.

org who exempel

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

skill Kommandon

Hantera Dataverse-kunskaper – återanvändbara instruktionsuppsättningar (en SKILL.md fil och dess resursfiler) som AI-agenter använder – som lagras i den anslutna miljön. De översta kommandona skill tillhandahåller åtgärder för att skapa, läsa, uppdatera och ta bort mot miljön. Lokalt lagras färdigheter under .claude/skills/<name>/.

Note

Behörighetsredigerings- och utvärderingskommandon, till exempel make, update, getoch eval, är separata från dessa kommandon. Kör dataverse workspace skill --help för mer information.

skill delete kommando

Ta bort en färdighet och alla dess resurser från den aktiva Dataverse-miljön. Använd skill list för att hitta unika namn på kunskaper.

dataverse skill delete new_lead-qualification

skill download kommando

Ladda ned en eller flera kunskaper från den aktiva Dataverse-miljön till disken. Kommandot laddar ned SKILL.md filen och alla resursfiler, vilket bevarar katalogstrukturen. Använd skill list för att hitta unika namn på kunskaper.

Parameter Description
--all Ladda ned alla aktiva kunskaper från miljön. Det går inte att kombinera med ett unikt kunskapsnamn.
--output, -o Baskatalogen för utdata. Standardvärde: .claude/skills/. Med --allskrivs varje färdighet till <path>/<name>/.
--json Mata ut kunskapsinnehållet som JSON utan att skriva filer. Du kan också ange en filsökväg att skriva till. 
dataverse skill download new_lead-qualification
dataverse skill download --all --output ./skills

skill list kommando

Visa en lista över alla aktiva kunskaper i den anslutna Dataverse-miljön.

Parameter Description
--resources, -r Visa även resursfilerna för varje färdighet.
--json Utdata som JSON. Du kan också ange en filsökväg att skriva till. 
dataverse skill list
dataverse skill list --resources

skill upload kommando

Ladda upp en eller flera kunskaper från disken till den aktiva Dataverse-miljön. Kommandot stöder kataloger, .zip filer, .skill-filer och .md-filer .

Du kan skicka en färdighet <name>, som matchar till .claude/skills/<name>/, eller en explicit <path> till en katalog eller fil.

Parameter Description
--all Ladda upp alla kunskaper under .claude/skills/. Det går inte att kombinera med ett kunskapsnamn eller en sökväg.
--json Mata ut resultatet som JSON. Du kan också ange en filsökväg att skriva till. 
dataverse skill upload lead-qualification
dataverse skill upload ./my-skill.zip
dataverse skill upload --all

Se även

Arbeta med data med hjälp av Dataverse CLI

  • Last updated on