Referenční informace k rozhraní příkazového řádku služby Dataverse (Preview)

Note

• Toto je funkce Preview.
• Funkce Preview nejsou určené pro normální používání a mohou mít omezené fungování. Tyto funkce jsou dostupné před oficiálním vydáním, aby zákazníci mohli získat dřívější přístup a poskytnout zpětnou vazbu.

Tento článek popisuje příkazy dostupné v rozhraní příkazového řádku Dataverse. Každý příkaz podporuje --help možnost, která obsahuje seznam využití, možností a příkladů. Příkazy vracející data podporují --json možnost nezpracovaného výstupu JSON, který je užitečný ve skriptech.

Následující globální možnosti lze použít s libovolným příkazem:

Option	Description
--log-level <level>	Nastavte úroveň protokolování: Trace, Debug, InformationWarning, , Error, nebo Critical. Výchozí hodnota: Warning.
--log-file	Místo konzoly se přihlaste k souboru v dočasném adresáři.
--context <value>	Kontext operace připojený k uživatelskému agentu Můžete také nastavit proměnnou DATAVERSE_OPERATION_CONTEXT prostředí.

Command	Description
api describe	Popis rozhraní API
api invoke	Vyvolání rozhraní API podle názvu
api list	Výpis zjistitelných rozhraní API
api request	Odeslání ověřeného požadavku HTTP
auth create	Vytvoření nového profilu ověřování
auth list	Výpis všech profilů ověřování
auth remove	Odebrání ověřovacího profilu
auth select	Výběr aktivního ověřovacího profilu
auth who	Zobrazení aktuálního profilu ověřování
data associate	Propojení dvou záznamů prostřednictvím relace
data count	Počet záznamů v tabulce
data create	Vytvoření nového záznamu
data delete	Odstranění záznamu
data describe	Popis schématu entity
data disassociate	Odebrání relace mezi dvěma záznamy
data get	Načtení jednoho záznamu podle ID nebo alternativního klíče
data query	Spuštění dotazu OData, FetchXML nebo SQL
data update	Aktualizovat existující záznam
data upload	Nahrání souboru do sloupce souboru u existujícího záznamu
data upsert	Vytvoření nebo aktualizace záznamu podle alternativního klíče
erp batch cancel	Zrušení dávkové úlohy Finance and Operations
erp batch list	Výpis dávkových úloh Finance and Operations
install	Instalace konkrétní verze nebo aktualizace na nejnovější verzi
mcp	Spuštění serveru MCP pro Dataverse nebo ERP
mcp allow	Povolit aplikaci jako klienta MCP
org list	Výpis všech přístupných prostředí
org who	Zobrazení aktuálních informací o organizaci a uživateli
skill delete	Odstranění dovednosti z Dataverse
skill download	Stažení dovednosti z Dataverse
skill list	Výpis aktivních dovedností v prostředí
skill upload	Nahrání dovednosti do Služby Dataverse

Note

Mnoho příkazů podporuje --target <dataverse\|erp> možnost, která směruje operaci do služby Dataverse (výchozí) nebo do propojeného prostředí Finance and Operations (ERP). Příkazy, které se připojují k prostředí, podporují --environment <url> možnost (-env) přepsání adresy URL prostředí aktuálního profilu.

api describe příkaz

Zobrazí metadata pro jedno rozhraní API. Pro vlastní rozhraní API služby Dataverse výstup obsahuje popisy vlastností požadavku a parametru požadavku, když je metadata poskytují.

Názvy dataverse jsou ve výchozím nastavení nefixované. Ve formuláři erp:ServiceGroup/Service/Operationmůžete použít kvalifikované názvy ERP .

api describe parametry

Parameter	Description
--target	Vyřešte nekvalifikovaný název nebo dataverseerp.
--service-group	Pouze ERP. Zužte vyhledávání operace na jednu skupinu služeb.
--service	Pouze ERP. Zužte vyhledávání operace na jednu službu.
--environment	Přepište adresu URL prostředí Dataverse.
--json	Nezpracovaný formát JSON výstupu

příklady 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 příkaz

Vyvolá zjištěné rozhraní API podle názvu. Pro parametry použijte name=value syntaxi. Pokud hodnota obsahuje mezery, uvozujte celý token. Některá rozhraní API služby Dataverse přijímají řetězcový parametr, jehož obsah je samotný JSON. V takovém případě předejte text JSON jako hodnotu pomocí normálních uvozování a pravidel pro eskapaci prostředí.

Ve výchozím nastavení se odpovědi JSON vykreslují v popisovém textovém formátu, který uchovává názvy výstupních vlastností. Slouží --json k zachování nezpracované datové části JSON.

api invoke parametry

Parameter	Description
--target	Vyřešte nekvalifikovaný název nebo dataverseerp.
--service-group	Pouze ERP. Zužte vyhledávání operace na jednu skupinu služeb.
--service	Pouze ERP. Zužte vyhledávání operace na jednu službu.
--param	Přidejte pojmenovaný parametr ve name=value formuláři. Opakovatelný.
--bind	Cesta vazby pro rozhraní Dataverse API vázaná na entitu
--method, -X	Přepište odvozenou metodu HTTP.
--body	Místo pojmenovaných parametrů použijte nezpracovaný text JSON.
--body-file	Čtení nezpracovaného textu JSON ze souboru
--header, -H	Přidejte hlavičku HTTP ve key:value formuláři.
--include, -i	Zahrňte stav odpovědi a hlavičky.
--environment	Přepište adresu URL prostředí Dataverse.
--json	Výstup nezpracovaného formátu JSON místo popisného textu

příklady api invoke

Vyvolání funkce Dataverse Tento příklad ukazuje použití funkce Dynamics 365 Contact Center CCaaS_GetPresence.

dataverse api invoke CCaaS_GetPresence ApiVersion=1.0

Vyvolání akce Dataverse AISummarize s mezerami v hodnotě parametru:

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

Vyvolání vlastní služby ERP:

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

api list příkaz

Uveďte zjistitelná rozhraní API, jako jsou vlastní rozhraní API služby Dataverse a koncové body služeb s možností volání ERP. Výsledky zobrazují identitu rozhraní API, popisný název, druh a popis, pokud je k dispozici. Můžete předat volitelný termín dotazu pro filtrování výsledků.

api list parametry

Parameter	Description
--target	Cílový systém pro vyhledávání: dataverse (výchozí) nebo erp.
--service-group	Pouze ERP. Vyfiltrujte jednu skupinu služeb.
--service	Pouze ERP. Vyfiltrujte jednu službu.
--limit	Maximální počet rozhraní API, která se mají vrátit. Výchozí hodnota: 50.
--page	Číslo stránky založené na 1 se při stránkování výsledků. Výchozí hodnota: 1.
--environment	Přepište adresu URL prostředí Dataverse.
--json	Nezpracovaný formát JSON výstupu

příklady 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 příkaz

Odešle nezpracovaný ověřený požadavek HTTP do služby Dataverse nebo ERP. Tento příkaz použijte, pokud potřebujete úplnou kontrolu nad cestou, metodou, záhlavími a textem.

api request parametry

Parameter	Description
--target	Cílový systém: dataverse nebo erp. Required.
--path	Cesta požadavku. Required.
--method, -X	Metoda HTTP. Výchozí hodnota: GETnebo POST při zadání textu.
--body	Vložený text požadavku JSON.
--body-file	Soubor, který obsahuje text požadavku JSON.
--header, -H	Přidejte hlavičku HTTP ve key:value formuláři.
--include, -i	Zahrňte stav odpovědi a hlavičky.
--environment	Přepište adresu URL prostředí Dataverse.

příklady 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 příkaz

Vytvořte nový profil ověřování.

auth create parametry

Pomocí těchto parametrů můžete určit chování auth create příkazu.

Parameter	Description
--environment, -env	Adresa URL prostředí Dataverse, ve které chcete provést ověření.
--name, -n	Volitelný název profilu. Název použijte k pozdějšímu výběru profilu.
--cloud, -ci	Cílový cloud: Public, UsGov, UsGovHigh, UsGovDodnebo China.
--deviceCode, -dc	Použijte tok ověřování kódu zařízení pro prostředí bez prohlížeče.
--username, -un	Uživatelské jméno pro ověřování uživatelským jménem a heslem.
--password, -p	Heslo pro ověřování uživatelským jménem a heslem.
--applicationId, -id	ID aplikace (klienta) pro ověřování instančního objektu (SPN).
--clientSecret, -cs	Tajný klíč klienta pro ověřování instančního objektu.
--certificateDiskPath, -cdp	Cesta k souboru certifikátu .pfx pro ověřování na základě certifikátů.
--certificatePassword, -cp	Heslo pro certifikát.
--tenant, -t	ID tenanta. Vyžaduje se pro ověřování instančního objektu.
--managedIdentity, -mi	Použijte spravovanou identitu Azure.
--githubFederated, -ghf	Použijte GitHub Actions federovaného ověřování.
--azureDevOpsFederated, -adof	Použijte Azure DevOps federovaného ověřování.
--clientid, -cid	Vlastní ID klienta aplikace Microsoft Entra, které se použije místo výchozí aplikace Rozhraní příkazového řádku Dataverse.
--no-default-environment	Nenastavujte prostředí jako výchozí.
--accept-cleartext-caching	Povolit mezipaměť tokenů prostého textu v Linuxu

příklady auth create

Následující příklady ukazují, jak příkaz použít auth create .

Interaktivní ověřování

Tento příkaz otevře dialogové okno prohlížeče nebo systému, kde najdete další informace.

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

Pojmenovaný profil

Vytvořte profil s konkrétním názvem.

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

Tok kódu zařízení

Použijte tok kódu zařízení pro prostředí bez prohlížeče.

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

Principál služby s tajným klíčem klienta

Instanční objekt použijte v případě, že potřebujete bezobslužné ověřování, například v kanálu CI/CD nebo jiném automatizovaném skriptu, kde interaktivní přihlášení není možné. Zadejte ID aplikace, tajný klíč klienta a ID tenanta registrace aplikace, která má přístup k prostředí.

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

ID klienta vlastní aplikace Entra

Místo výchozí registrace použijte vlastní registraci aplikace.

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

auth list příkaz

Zobrazí seznam všech profilů ověřování. Přidání --json pro nezpracovaný výstup JSON

příklady auth list

dataverse auth list
dataverse auth list --json

auth remove příkaz

Odeberte jeden nebo všechny profily ověřování.

auth remove parametry

Parameter	Description
--index, -i	Odeberte profil se zadaným indexem založeným na 1, jak je znázorněno v auth listtématu .
--name, -n	Odeberte profil se zadaným názvem.
--all	Odeberte všechny profily.

příklady auth remove

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

auth select příkaz

Vyberte aktivní ověřovací profil. Spuštěním příkazu bez možností zobrazte seznam všech profilů.

auth select parametry

Parameter	Description
--index, -i	Vyberte profil podle jeho indexu založeného na 1, jak je znázorněno v auth listtématu .
--name, -n	Vyberte profil podle názvu.

příklady auth select

Otevřete interaktivní výběr. K filtrování použijte klávesy se šipkami nebo zadejte:

dataverse auth select

Vyberte profil podle indexu nebo podle názvu:

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

auth who příkaz

Zobrazí aktuální aktivní ověřovací profil. Přidání --json pro nezpracovaný výstup JSON

příklady auth who

dataverse auth who
dataverse auth who --json

data associate příkaz

Přidružte dva záznamy prostřednictvím navigační vlastnosti (relace). Tento příkaz je podporován pouze pro Službu Dataverse.

data associate parametry

Parameter	Description
--table, -t	Název sady entit primárního záznamu. Required.
--id, -i	Identifikátor GUID primárního záznamu. Required.
--relationship, -rel	Název navigační vlastnosti. Required.
--related	Název sady entit související tabulky. Required.
--related-id	Identifikátor GUID souvisejícího záznamu. Required.
--environment, -env	Přepište adresu URL prostředí.
--json	Nezpracovaný formát JSON výstupu

příklady data associate

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

data count příkaz

Spočítejte záznamy v tabulce, volitelně filtrované.

data count parametry

Parameter	Description
--table, -t	Název sady entit. Povinné, pokud nepoužíváte --fetchxml.
--filter, -f	Výraz OData $filter .
--fetchxml	Agregační dotaz FetchXML pro komplexní počty
--target	Směrujte na dataverse (výchozí) nebo propojené erp prostředí.
--cross-company	Pouze ERP. Spočítejte si všechny společnosti. Výchozí hodnota: výchozí společnost uživatele.
--environment, -env	Přepište adresu URL prostředí.
--json	Nezpracovaný formát JSON výstupu

příklady data count

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

data create příkaz

Vytvořte nový záznam v tabulce Dataverse. Nastavte vyhledávací sloupce pomocí @odata.bind syntaxe.

data create parametry

Parameter	Description
--table, -t	Název sady entit. Required.
--data, -d	Objekt JSON s hodnotami polí.
--data-file	Cesta k souboru JSON s daty záznamu.
--return, -r	Vrátí úplný vytvořený záznam.
--target	Směrujte na dataverse (výchozí) nebo propojené erp prostředí.
--environment, -env	Přepište adresu URL prostředí.
--json	Nezpracovaný formát JSON výstupu

příklady 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

Používá se --data-file pro komplexní JSON. Slouží --return --json k získání úplného vytvořeného záznamu.

data delete příkaz

Odstraňte jeden záznam podle jeho primárního klíče nebo alternativního klíče.

data delete parametry

Parameter	Description
--table, -t	Název sady entit. Required.
--id, -i	Identifikátor GUID záznamu.
--key, -k	Alternativní klíč.
--no-confirm	Přeskočte potvrzovací výzvu.
--target	Směrujte na dataverse (výchozí) nebo propojené erp prostředí.
--environment, -env	Přepište adresu URL prostředí.
--json	Nezpracovaný formát JSON výstupu

příklady data delete

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

data describe příkaz

Popis schématu entity OData Pro Dataverse příkaz volá s EntityDefinitions(LogicalName='<table>') řízeným $expand parametrem --include, plus druhé volání customapis , kdy --include actions je nastaveno. Předdefinované akce Dataverse, jako Assign jsou a SetState nejsou uvedené. Pro ERP jedno volání, které /Metadata/PublicEntities vrátí vlastnosti, vázané akce a navigace dohromady.

data describe parametry

Parameter	Description
--target	Cíl: dataverse (výchozí) nebo erp.
--table, -t	Required. Pro Službu Dataverse je logický název, například account. Pro ERP název sady entit, například BatchJobs.
--include	Seznam oddílů oddělených čárkami, které mají obsahovat: entity, properties, relations, actionsnebo all. Aliasy: attributes=properties, relationships=relations. Výchozí hodnota pro ERP: all. Výchozí hodnota pro Dataverse: entity,properties.
--json	Nezpracovaný formát JSON výstupu

příklady 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 příkaz

Odeberte relaci mezi dvěma záznamy. Tento příkaz je podporován pouze pro Službu Dataverse.

data disassociate parametry

Parameter	Description
--table, -t	Název sady entit primárního záznamu. Required.
--id, -i	Identifikátor GUID primárního záznamu. Required.
--relationship, -rel	Název navigační vlastnosti. Required.
--related-id	Identifikátor GUID souvisejícího záznamu pro relaci M:N. Vynechání tohoto parametru pro vymazání vyhledávání.
--environment, -env	Přepište adresu URL prostředí.
--json	Nezpracovaný formát JSON výstupu

příklady data disassociate

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

data get příkaz

Načtěte jeden záznam podle ID (primárního klíče) nebo alternativního klíče.

data get parametry

Parameter	Description
--table, -t	Název sady entit. Required.
--id, -i	Identifikátor GUID záznamu (primární klíč).
--key, -k	Alternativní klíč, například "col='val'".
--select, -s	Čárkami oddělený seznam sloupců ($select).
--expand, -x	Výraz OData $expand pro související záznamy.
--target	Směrujte na dataverse (výchozí) nebo propojené erp prostředí.
--environment, -env	Přepište adresu URL prostředí.
--json	Nezpracovaný formát JSON výstupu

příklady 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 příkaz

Spusťte dotaz OData, FetchXML nebo SQL na tabulku Dataverse.

data query parametry

Parameter	Description
--table, -t	Název sady entit pro dotaz. Vyžaduje se pro dotazy OData.
--select, -s	Čárkami oddělený seznam sloupců ($select).
--filter, -f	Výraz OData $filter .
--orderby, -o	Výraz OData $orderby .
--top	Maximální počet záznamů, které se mají vrátit (1–5000).
--expand, -x	Výraz OData $expand pro související záznamy.
--fetchxml	Vložený dotaz FetchXML.
--fetchxml-file	Cesta k souboru, který obsahuje dotaz FetchXML.
--sql	Dotaz SQL SELECT (Preview)
--sql-file	Cesta k souboru, který obsahuje dotaz SQL.
--all, -a	Pokud chcete načíst všechny záznamy, postupujte podle stránkování.
--max-records	Maximální počet záznamů, které se mají načíst při použití --all. Výchozí hodnota: 100000.
--target	Směrujte na dataverse (výchozí) nebo propojené erp prostředí.
--cross-company	Pouze ERP. Dotazování napříč všemi společnostmi Výchozí hodnota: výchozí společnost uživatele.
--environment, -env	Přepište adresu URL prostředí.
--json	Nezpracovaný formát JSON výstupu

příklady 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

Další informace

• Použití OData k dotazování dat
• Dotazování dat pomocí FetchXML v Dataverse
• Použití SQL k dotazování dat pomocí webového rozhraní API služby Dataverse

data update příkaz

Aktualizujte jedno nebo více polí u existujícího záznamu, která jsou identifikována jeho ID nebo alternativním klíčem. Nastavte vyhledávací sloupce pomocí @odata.bind syntaxe.

data update parametry

Parameter	Description
--table, -t	Název sady entit. Required.
--id, -i	Identifikátor GUID záznamu.
--key, -k	Alternativní klíč.
--data, -d	Objekt JSON s poli, která se mají aktualizovat.
--data-file	Cesta k souboru JSON s aktualizačními daty.
--return, -r	Vrátí úplný aktualizovaný záznam.
--target	Směrujte na dataverse (výchozí) nebo propojené erp prostředí.
--environment, -env	Přepište adresu URL prostředí.
--json	Nezpracovaný formát JSON výstupu

příklady data update

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

data upload příkaz

Nahrajte místní soubor do sloupce souboru Dataverse u existujícího záznamu. Příkaz automaticky vybere nahrávání s jedním požadavkem nebo blokem dat na základě velikosti souboru, pokud nezadáte --mode. V automatickém režimu se soubory do 128 MB nahrávají do jediného požadavku a větší soubory používají blokované nahrávání. Když vynecháte --mime-type, příkaz odvodí typ MIME z přípony souboru. Ve výchozím nastavení application/octet-streamjsou neznámá rozšíření .

data upload parametry

Parameter	Description
--table, -t	Schéma tabulky nebo logický název, například account. Required. Příkaz přeloží sadu entit z metadat.
--id, -i	Identifikátor GUID záznamu. Required.
--column, -c	Název atributu sloupce souboru. Required.
--file, -f	Cesta k místnímu souboru. Required.
--mode, -m	Strategie nahrávání: auto (výchozí) smallnebo chunk.
--mime-type	Explicitní typ MIME. Výchozí hodnota: Odvozeno z přípony souboru.
--overwrite	Přepište existující soubor. Ve výchozím nastavení příkaz selže, pokud sloupec není prázdný.
--environment, -env	Přepište adresu URL prostředí.
--json	Nezpracovaný formát JSON výstupu

příklady 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 příkaz

Vytvořte záznam, pokud neexistuje, nebo ho v případě potřeby aktualizujte. Záznam je identifikován alternativním klíčem. Naučte se používat alternativní klíč pro odkaz na záznam.

data upsert parametry

Parameter	Description
--table, -t	Název sady entit. Required.
--key, -k	Alternativní klíč. Required.
--data, -d	Objekt JSON s hodnotami polí.
--data-file	Cesta k souboru JSON.
--update-only	Selhání, pokud záznam neexistuje (If-Match: *).
--create-only	Selhání, pokud záznam již existuje (If-None-Match: *).
--return, -r	Po operaci vrátí celý záznam.
--target	Směrujte na dataverse (výchozí) nebo propojené erp prostředí.
--environment, -env	Přepište adresu URL prostředí.
--json	Nezpracovaný formát JSON výstupu

příklady data upsert

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

erp batch cancel příkaz

Zrušení dávkové úlohy Finance and Operations podle jeho RecId. Slouží erp batch list k vyhledání souboru RecId.

příklady erp batch cancel

dataverse erp batch cancel <recid>

erp batch list příkaz

Zobrazte seznam dávkových úloh v instanci Finance and Operations, která je propojená s prostředím Dataverse. Příkaz vyžaduje profil ověřování připojený k prostředí Dataverse, které má propojenou instanci Finance and Operations. Adresa URL pro finance a operace se odvozuje automaticky z aktuálního připojení Dataverse.

erp batch list parametry

Parameter	Description
--company	Filtrovat podle právnické osoby (dataAreaId), například USMF.
--status	Filtrovat podle stavu: Waiting, Executing, Finished, Errornebo Cancelled.
--top	Maximální počet výsledků, které se mají vrátit. Výchozí hodnota: 20.
--caption	Filtrovat podle titulku (shoda podřetětětce nerozlišující malá a velká písmena).
--json	Nezpracovaný formát JSON výstupu

příklady erp batch list

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

install příkaz

Nainstalujte konkrétní verzi rozhraní příkazového řádku Dataverse nebo aktualizujte na nejnovější verzi. Příkaz zjistí, jestli jste rozhraní příkazového řádku nainstalovali globálně nebo jestli ho používáte npx a instaluje odpovídajícím způsobem.

příklady install

Nainstalujte nejnovější verzi:

dataverse install latest

Nainstalujte konkrétní verzi:

dataverse install 1.0.0

mcp příkaz

Spustí server MCP (Model Context Protocol), který se připojí k vašemu prostředí, aby asistenti umělé inteligence, jako je Claude Desktop, mohli pracovat s vašimi daty. Cíl se automaticky zjistí z adresy URL: Adresa URL služby Dataverse spustí server Dataverse MCP a adresu URL pro finance a provoz, například https://myorg.operations.dynamics.comspuštění serveru ERP MCP.

Syntaxe mcp

dataverse mcp <orgUrl> [options]

Argumentem <orgUrl> je adresa URL vaší organizace, například https://myorg.crm.dynamics.com.

mcp parametry

Parameter	Description
--validate	Ověřte koncové body MCP a nastavení ověřování bez spuštění serveru.
--log-level	Nastavte úroveň protokolování: Trace, Debug, InformationWarning, Errornebo Critical. Výchozí hodnota: Warning.
--log-file	Přihlaste se k souboru v dočasném adresáři.
--preview	Použijte koncový bod MCP ve verzi Preview (api/mcp_preview místo api/mcp). Nepodporuje se pro ERP.

příklady mcp

Ověřte nastavení (doporučený první krok):

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

Spusťte server pomocí přenosu stdio:

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

Použijte koncový bod preview nebo povolte protokolování ladicího souboru:

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

mcp allow příkaz

Ujistěte se, že je aplikace Microsoft Entra v seznamu povolených klientů McP služby Dataverse pro prostředí aktuálního profilu. Tento příkaz je alternativou k ručnímu kroku správce popsanému v požadavcích. Ověřený uživatel musí mít v cílovém prostředí oprávnění správce Dataverse.

Syntaxe mcp allow

dataverse mcp allow <appId> [options]

Argumentem <appId> je ID aplikace (klienta), které se má povolit, jako identifikátor GUID.

mcp allow parametry

Parameter	Description
--erp	Povolte aplikaci v propojené instanci Finance and Operations místo Dataverse.

příklady mcp allow

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

Note

Finance and Operations ukládá seznam povolených do mezipaměti v AOS, takže může trvat až pět minut, než se nově povolené ID aplikace projeví.

org list příkaz

Zobrazte seznam všech prostředí, ke kterým máte přístup.

org list parametry

Parameter	Description
--filter	Filtrujte seznam prostředí podle hledaného termínu.
--json	Nezpracovaný formát JSON výstupu

příklady org list

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

org who příkaz

Umožňuje zobrazit informace o aktuální organizaci a uživateli pomocí aktivního ověřovacího profilu. Příkaz env je alias pro org.

org who parametry

Parameter	Description
--environment, -env	Přepište adresu URL prostředí.
--json	Nezpracovaný formát JSON výstupu

příklady org who

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

skill příkazy

Spravujte dovednosti v Dataverse – opakovaně použitelné instrukční sady ( SKILL.md soubor a jeho soubory prostředků), které používají agenti AI– které jsou uložené v připojeném prostředí. Příkazy nejvyšší úrovně skill poskytují operace vytvoření, čtení, aktualizace a odstranění v prostředí. Místně se dovednosti ukládají v části .claude/skills/<name>/.

Note

Příkazy pro vytváření dovedností a hodnocení, například make, update, geta eval, jsou oddělené od těchto příkazů. Další informace potřebujete spustit dataverse workspace skill --help.

skill delete příkaz

Odstraňte dovednost a všechny její prostředky z aktivního prostředí Dataverse. Umožňuje skill list najít jedinečné názvy dovedností.

dataverse skill delete new_lead-qualification

skill download příkaz

Stáhněte si jednu nebo více dovedností z aktivního prostředí Dataverse na disk. Příkaz stáhne SKILL.md soubor a všechny soubory prostředků a zachová adresářovou strukturu. Umožňuje skill list najít jedinečné názvy dovedností.

Parameter	Description
--all	Stáhněte si všechny aktivní dovednosti z prostředí. Nelze kombinovat s jedinečným názvem dovednosti.
--output, -o	Základní adresář pro výstup. Výchozí hodnota: .claude/skills/. S --all, každá dovednost je napsána <path>/<name>/na .
--json	Vypište obsah dovedností jako JSON, aniž byste museli zapisovat soubory. Volitelně můžete zadat cestu k souboru, do které se má zapisovat.

dataverse skill download new_lead-qualification
dataverse skill download --all --output ./skills

skill list příkaz

Vypište všechny aktivní dovednosti v připojeném prostředí Dataverse.

Parameter	Description
--resources, -r	Uveďte také soubory prostředků pro každou dovednost.
--json	Výstup ve formátu JSON Volitelně můžete zadat cestu k souboru, do které se má zapisovat.

dataverse skill list
dataverse skill list --resources

skill upload příkaz

Nahrajte jednu nebo více dovedností z disku do aktivního prostředí Dataverse. Příkaz podporuje adresáře, .zip soubory, soubory .skill a soubory .md .

Můžete předat dovednost <name>, která se přeloží na .claude/skills/<name>/, nebo explicitně <path> do adresáře nebo souboru.

Parameter	Description
--all	Nahrajte všechny dovednosti v části .claude/skills/. Nelze kombinovat s názvem dovednosti nebo cestou.
--json	Výstup výsledku ve formátu JSON. Volitelně můžete zadat cestu k souboru, do které se má zapisovat.

dataverse skill upload lead-qualification
dataverse skill upload ./my-skill.zip
dataverse skill upload --all

Viz také

Práce s daty pomocí rozhraní příkazového řádku Dataverse