Dataverse CLI препратка (предварителен преглед)

Забележка

Това е функция за предварителен преглед.
Функциите за предварителен преглед не са предназначени за производствена употреба и може да са с ограничена функционалност. Тези функции са достъпни преди официалното издание, за да могат клиентите да получат ранен достъп и да дадат обратна връзка.

Тази статия описва командите, налични в CLI на Dataverse. Всяка команда поддържа --help опция, която изброява нейното използване, опции и примери. Командите, които връщат данни, поддържат --json опция за необработен JSON изход, който е полезен в скриптове.

Следните глобални опции могат да се използват с всяка команда:

Опция	Описание
`--log-level <level>`	Задайте нивото на регистриране: `Trace`, , `InformationDebug`, `Warning`, `Error`, или `Critical`. По подразбиране: `Warning`.
`--log-file`	Влезте във файл във временната директория вместо в конзолата.
`--context <value>`	Контекст на операция, добавен към агента на потребителя. Можете също да зададете променливата на `DATAVERSE_OPERATION_CONTEXT` средата.

Command	Описание
`api describe`	Описание на API
`api invoke`	Извикване на API по име
`api list`	Списък с откриваеми API
`api request`	Изпращане на удостоверено HTTP искане
`auth create`	Създаване на нов профил за удостоверяване
`auth list`	Списък на всички профили за удостоверяване
`auth remove`	Премахване на профил за удостоверяване
`auth select`	Избор на активния профил за удостоверяване
`auth who`	Показване на текущия профил за удостоверяване
`data associate`	Свързване на два записа чрез релация
`data count`	Преброяване на записите в таблица
`data create`	Създаване на нов запис
`data delete`	Изтриване на запис
`data describe`	Описание на схема на обект
`data disassociate`	Премахване на релация между два записа
`data get`	Извличане на един запис по ИД или алтернативен ключ
`data query`	Изпълнение на OData, FetchXML или SQL заявка
`data update`	Актуализиране на съществуващ запис
`data upload`	Качване на файл в колона на файл в съществуващ запис
`data upsert`	Създаване или актуализиране на запис чрез алтернативен ключ
`erp batch cancel`	Отмяна на пакетно задание "Финанси и операции"
`erp batch list`	Пакетни задания "Финанси и операции" на списък
`install`	Инсталиране на конкретна версия или актуализиране до най-новата версия
`mcp`	Стартиране на MCP сървъра за Dataverse или ERP
`mcp allow`	Разрешаване на приложение като MCP клиент
`org list`	Избройте всички достъпни среди
`org who`	Показване на текущата организация и информация за потребителя
`skill delete`	Изтриване на умение от Dataverse
`skill download`	Изтегляне на умение от Dataverse
`skill list`	Избройте активните умения в средата
`skill upload`	Качване на умение в Dataverse

Забележка

Много команди поддържат --target <dataverse\|erp> опция, която маршрутизира операцията към Dataverse (по подразбиране) или към свързаната среда за финанси и операции (ERP). Командите, които се свързват към среда, поддържат --environment <url>-env() опция за заместване на URL адреса на средата на текущия профил.

`api describe` команда

Показване на метаданните за един API. За API по избор за Dataverse резултатът включва описания на параметрите на искането и свойствата на отговор, когато метаданните им ги предоставят.

По подразбиране имената на сървърите за данни не се предоставят. Можете да използвате имена, отговарящи на условията за ERP, във формуляра erp:ServiceGroup/Service/Operation.

`api describe` Параметри

Параметър	Описание
`--target`	Разрешаване на неквалифицирано име спрямо `dataverse` или `erp`.
`--service-group`	Само ERP. Стеснете търсенето на операцията до една група услуги.
`--service`	Само ERP. Стесняване на търсенето на операцията до една услуга.
`--environment`	Заместване на URL адреса на средата на dataverse.
`--json`	Изходна необработена JSON.

`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` команда

Извикване на открит API по име. Използване на name=value синтаксис за параметри. Ако една стойност съдържа интервали, цитирайте целия маркер. Някои API на Dataverse приемат параметър на низ, чието съдържание са JSON. В този случай предавайте JSON текста като стойност, като използвате нормалните правила за цитиране и излизане от обвивката.

По подразбиране JSON отговорите се рендират в удобен текстов формат, който запазва имената на изходните свойства. Използвайте --json , за да запазите суровия полезен обем JSON.

`api invoke` Параметри

Параметър	Описание
`--target`	Разрешаване на неквалифицирано име спрямо `dataverse` или `erp`.
`--service-group`	Само ERP. Стеснете търсенето на операцията до една група услуги.
`--service`	Само ERP. Стесняване на търсенето на операцията до една услуга.
`--param`	Добавяне на наименуван параметър във `name=value` формуляр. Повторим.
`--bind`	Пътят на обвързване за СВЪРЗАНИ с обект API на Dataverse.
`--method`, `-X`	Заместване на подразбирания HTTP метод.
`--body`	Използвайте необработенО JSON тяло вместо наименувани параметри.
`--body-file`	Прочетете необработено JSON тяло от файл.
`--header`, `-H`	Добавяне на HTTP заглавка във `key:value` формуляр.
`--include`, `-i`	Включете състоянието и заглавките на отговора.
`--environment`	Заместване на URL адреса на средата на dataverse.
`--json`	Изходно необработенО JSON вместо удобен текст.

`api invoke` Примери

Извикване на функция Dataverse. Този пример показва използването на функцията Dynamics 365 Contact Center CCaaS_GetPresence.

dataverse api invoke CCaaS_GetPresence ApiVersion=1.0

Извикване на действието Dataverse AISummarize с интервали в стойност на параметър:

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

Извикване на потребителска услуга на ERP:

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

`api list` команда

Списък с откриваеми API, като например API по избор за Dataverse и ERP крайни точки на услугата, които могат да бъдат одобрявани. Резултатите показват самоличността на API, истинското име, вида и описанието, когато са налични. Можете да подадете незадължителен израз на заявка, за да филтрирате резултатите.

`api list` Параметри

Параметър	Описание
`--target`	Целевата система за търсене: `dataverse` (по подразбиране) или `erp`.
`--service-group`	Само ERP. Филтриране до една група услуги.
`--service`	Само ERP. Филтриране до една услуга.
`--limit`	Максималният брой API, които да се върнат. По подразбиране: `50`.
`--page`	Номерът на страница, базиран на 1, когато се странира през резултатите. По подразбиране: `1`.
`--environment`	Заместване на URL адреса на средата на dataverse.
`--json`	Изходна необработена JSON.

`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` команда

Изпратете необработена удостоверена HTTP заявка до Dataverse или ERP. Използвайте тази команда, когато имате нужда от пълен контрол върху пътя, метода, заглавките и основния текст.

`api request` Параметри

Параметър	Описание
`--target`	Целевата система: `dataverse` или `erp`. Задължително.
`--path`	Пътят на искането. Задължително.
`--method`, `-X`	HTTP методът. По подразбиране: `GET`или `POST` когато е предоставен основен текст.
`--body`	Вграден JSON основен текст.
`--body-file`	Файл, съдържащ тялото на заявка за JSON обект.
`--header`, `-H`	Добавяне на HTTP заглавка във `key:value` формуляр.
`--include`, `-i`	Включете състоянието и заглавките на отговора.
`--environment`	Заместване на URL адреса на средата на dataverse.

`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` команда

Създаване на нов профил за удостоверяване.

`auth create` Параметри

Използвайте тези параметри, за да зададете поведението на командата auth create .

Параметър	Описание
`--environment`, `-env`	URL адресът за средата на Dataverse, с която искате да се удостоверите.
`--name`, `-n`	Незадължително име за профила. Използвайте името, за да изберете профила по-късно.
`--cloud`, `-ci`	Целевият облак: `Public`, `UsGov`, `UsGovHigh`, `UsGovDod`или `China`.
`--deviceCode`, `-dc`	Използвайте потока за удостоверяване на кода на устройството за среди без браузър.
`--username`, `-un`	Потребителското име за удостоверяване на потребителско име и парола.
`--password`, `-p`	Паролата за удостоверяване с потребителско име и парола.
`--applicationId`, `-id`	ИД на приложението (клиента) за удостоверяване на главен субект на услуга (SPN).
`--clientSecret`, `-cs`	Тайната на клиента за удостоверяване на субекта на услугата.
`--certificateDiskPath`, `-cdp`	Пътят до .pfx файл със сертификат за удостоверяване, базирано на сертификат.
`--certificatePassword`, `-cp`	Паролата за сертификата.
`--tenant`, `-t`	ИД на клиента. Задължително за удостоверяване на субекта на услугата.
`--managedIdentity`, `-mi`	Използвайте Azure управлявана самоличност.
`--githubFederated`, `-ghf`	Използвайте GitHub Actions външно удостоверяване.
`--azureDevOpsFederated`, `-adof`	Използвайте Azure DevOps външно удостоверяване.
`--clientid`, `-cid`	Потребителски ИД на клиент на Microsoft Entra приложение, който да се използва вместо CLI приложението по подразбиране Dataverse.
`--no-default-environment`	Не задавайте средата като среда по подразбиране.
`--accept-cleartext-caching`	Разрешаване на кеш с обикновен текст в Linux.

`auth create` Примери

Следващите примери показват как да използвате командата auth create .

Интерактивно удостоверяване

Тази команда отваря браузър или системен диалогов прозорец за допълнителна информация.

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

Наименуван профил

Създайте профил с конкретно име.

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

Поток на код на устройство

Използвайте потока с код на устройство за среди без браузър.

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

Главен субект на услуга с клиентската тайна

Използвайте главен субект на услуга, когато се нуждаете от ненаблюдаван удостоверяване, като например в канал за CI/CD или друг автоматизиран скрипт, при който интерактивното влизане не е възможно. Предоставете ИД на приложението, тайната на клиента и ИД на клиент на регистрация на приложение, което има достъп до средата.

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

Потребителски ИД на клиент на приложение Entra

Използвайте собствена регистрация на приложение вместо тази по подразбиране.

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

`auth list` команда

Избройте всички профили за удостоверяване. Добавете --json за необработен JSON изход.

`auth list` Примери

dataverse auth list
dataverse auth list --json

`auth remove` команда

Премахване на един или всички профили за удостоверяване.

`auth remove` Параметри

Параметър	Описание
`--index`, `-i`	Премахнете профила със зададения базиран на 1 индекс, както е показано в `auth list`.
`--name`, `-n`	Премахнете профила със зададеното име.
`--all`	Премахване на всички профили.

`auth remove` Примери

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

`auth select` команда

Изберете активния профил за удостоверяване. Изпълнете командата без опции за изброяване на всички профили.

`auth select` Параметри

Параметър	Описание
`--index`, `-i`	Изберете профила по неговия базиран на 1 индекс, както е показано в `auth list`.
`--name`, `-n`	Изберете профила по име.

`auth select` Примери

Отваряне на интерактивен избор. Използвайте клавишите със стрелки или въведете, за да филтрирате:

dataverse auth select

Изберете профил по индекс или по име:

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

`auth who` команда

Показване на текущия, активен профил за удостоверяване. Добавете --json за необработен JSON изход.

`auth who` Примери

dataverse auth who
dataverse auth who --json

`data associate` команда

Свързване на два записа чрез свойство за навигация (релация). Тази команда се поддържа само за Dataverse.

`data associate` Параметри

Параметър	Описание
`--table`, `-t`	Името на набора от обекти на първичния запис. Задължително.
`--id`, `-i`	GUID на първичния запис. Задължително.
`--relationship`, `-rel`	Името на свойството за навигация. Задължително.
`--related`	Името на набора от обекти на свързаната таблица. Задължително.
`--related-id`	GUID на свързания запис. Задължително.
`--environment`, `-env`	Заместване на URL адреса на средата.
`--json`	Изходна необработена JSON.

`data associate` Примери

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

`data count` команда

Преброяване на записите в таблица, по желание филтрирани.

`data count` Параметри

Параметър	Описание
`--table`, `-t`	Името на набора от обекти. Задължително, освен ако не използвате `--fetchxml`.
`--filter`, `-f`	Израз на OData `$filter` .
`--fetchxml`	Агрегатна заявка FetchXML за комплексни бройки.
`--target`	Маршрутизиране към `dataverse` (по подразбиране) или свързаната `erp` среда.
`--cross-company`	Само ERP. Преброяване във всички фирми. По подразбиране: фирмата по подразбиране на потребителя.
`--environment`, `-env`	Заместване на URL адреса на средата.
`--json`	Изходна необработена JSON.

`data count` Примери

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

`data create` команда

Създаване на нов запис в таблица на Dataverse. Задаване на колони за справки с помощта на @odata.bind синтаксис.

`data create` Параметри

Параметър	Описание
`--table`, `-t`	Името на набора от обекти. Задължително.
`--data`, `-d`	JSON обект със стойности на полета.
`--data-file`	Пътят до JSON файл с данните от записа.
`--return`, `-r`	Върнете пълния създаден запис.
`--target`	Маршрутизиране към `dataverse` (по подразбиране) или свързаната `erp` среда.
`--environment`, `-env`	Заместване на URL адреса на средата.
`--json`	Изходна необработена JSON.

`data create` Примери

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

Съвет

Използва се --data-file за комплекс JSON. Използвайте --return --json , за да получите пълния създаден запис.

`data delete` команда

Изтриване на един запис от неговия първичен ключ или чрез алтернативен ключ.

`data delete` Параметри

Параметър	Описание
`--table`, `-t`	Името на набора от обекти. Задължително.
`--id`, `-i`	GUID на записа.
`--key`, `-k`	Алтернативен ключ.
`--no-confirm`	Пропуснете подканата за потвърждение.
`--target`	Маршрутизиране към `dataverse` (по подразбиране) или свързаната `erp` среда.
`--environment`, `-env`	Заместване на URL адреса на средата.
`--json`	Изходна необработена JSON.

`data delete` Примери

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

`data describe` команда

Опишете схемата на обект на OData. За Dataverse командата се извиква EntityDefinitions(LogicalName='<table>') , $expand управлявана от --include, плюс второ повикване, customapis когато --include actions е зададено. Вградените действия dataverse, като Assign например и SetState не се изброяват. За ERP – едно повикване /Metadata/PublicEntities за връщане на свойства, обвързани действия и навигации заедно.

`data describe` Параметри

Параметър	Описание
`--target`	Целта: `dataverse` (по подразбиране) или `erp`.
`--table`, `-t`	Задължително. За Dataverse логическото име, като `account`например . За ERP името на набора от обекти, като `BatchJobs`например .
`--include`	Разделен със запетаи списък със секции, който да включва: `entity`, `properties`, `relations`, `actions`, или `all`. Псевдоними: `attributes`=`properties`, . `relationships`=`relations` По подразбиране за ERP: `all`. По подразбиране за Dataverse: `entity,properties`.
`--json`	Изходна необработена JSON.

`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` команда

Премахване на релация между два записа. Тази команда се поддържа само за Dataverse.

`data disassociate` Параметри

Параметър	Описание
`--table`, `-t`	Името на набора от обекти на първичния запис. Задължително.
`--id`, `-i`	GUID на първичния запис. Задължително.
`--relationship`, `-rel`	Името на свойството за навигация. Задължително.
`--related-id`	GUID на свързания запис за релация "много към много". Пропуснете този параметър, за да изчистите справка.
`--environment`, `-env`	Заместване на URL адреса на средата.
`--json`	Изходна необработена JSON.

`data disassociate` Примери

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

`data get` команда

Извличане на един запис по неговия ИД (първичен ключ) или чрез алтернативен ключ.

`data get` Параметри

Параметър	Описание
`--table`, `-t`	Името на набора от обекти. Задължително.
`--id`, `-i`	GUID на записа (първичен ключ).
`--key`, `-k`	Алтернативен ключ, например `"col='val'"`.
`--select`, `-s`	Разделен със запетаи списък с колони (`$select`).
`--expand`, `-x`	Израз на OData `$expand` за свързани записи.
`--target`	Маршрутизиране към `dataverse` (по подразбиране) или свързаната `erp` среда.
`--environment`, `-env`	Заместване на URL адреса на средата.
`--json`	Изходна необработена JSON.

`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` команда

Изпълняване на OData, FetchXML или SQL заявка спрямо таблица dataverse.

`data query` параметри

Параметър	Описание
`--table`, `-t`	Името на набора от обекти за заявка. Задължително за заявки на OData.
`--select`, `-s`	Разделен със запетаи списък с колони (`$select`).
`--filter`, `-f`	Израз на OData `$filter` .
`--orderby`, `-o`	Израз на OData `$orderby` .
`--top`	Максималният брой записи за връщане (1-5000).
`--expand`, `-x`	Израз на OData `$expand` за свързани записи.
`--fetchxml`	Вградена заявка FetchXML.
`--fetchxml-file`	Пътят до файл, който съдържа fetchXML заявка.
`--sql`	SQL `SELECT` заявка (визуализация).
`--sql-file`	Пътят до файл, който съдържа SQL заявка.
`--all`, `-a`	Следвайте странирането, за да извлечете всички записи.
`--max-records`	Максималният брой записи за извличане при използване на `--all`. По подразбиране: `100000`.
`--target`	Маршрутизиране към `dataverse` (по подразбиране) или свързаната `erp` среда.
`--cross-company`	Само ERP. Заявка във всички фирми. По подразбиране: фирмата по подразбиране на потребителя.
`--environment`, `-env`	Заместване на URL адреса на средата.
`--json`	Изходна необработена JSON.

`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

Научете повече

`data update` команда

Актуализиране на едно или повече полета в съществуващ запис, идентифицирано по неговия ИД или чрез алтернативен ключ. Задаване на колони за справки с помощта на @odata.bind синтаксис.

`data update` Параметри

Параметър	Описание
`--table`, `-t`	Името на набора от обекти. Задължително.
`--id`, `-i`	GUID на записа.
`--key`, `-k`	Алтернативен ключ.
`--data`, `-d`	JSON обект с полетата за актуализиране.
`--data-file`	Пътят до JSON файл с данните за актуализиране.
`--return`, `-r`	Върнете пълния актуализиран запис.
`--target`	Маршрутизиране към `dataverse` (по подразбиране) или свързаната `erp` среда.
`--environment`, `-env`	Заместване на URL адреса на средата.
`--json`	Изходна необработена JSON.

`data update` Примери

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

`data upload` команда

Качване на локален файл в колона на файл на Dataverse на съществуващ запис. Командата автоматично избира качване с една заявка или блок въз основа на размера на файла, освен ако не зададете --mode. В автоматичен режим файлове под 128 МБ се качват с една заявка, а по-големите файлове използват качени части. Когато изпуснете --mime-type, командата определя типа MIME от разширението на файла. Неизвестни разширения по подразбиране на application/octet-stream.

`data upload` Параметри

Параметър	Описание
`--table`, `-t`	Схемата на таблицата или логическото име, като `account`например . Задължително. Командата преобразува набора от обекти от метаданните.
`--id`, `-i`	GUID на записа. Задължително.
`--column`, `-c`	Името на атрибута на колоната на файла. Задължително.
`--file`, `-f`	Пътят до локалния файл. Задължително.
`--mode`, `-m`	Стратегията за качване: `auto` (по подразбиране), `small`или `chunk`.
`--mime-type`	Явен MIME тип. По подразбиране: подразбира се от разширението на файла.
`--overwrite`	Заместване на съществуващ файл. По подразбиране командата е неуспешна, ако колоната не е празна.
`--environment`, `-env`	Заместване на URL адреса на средата.
`--json`	Изходна необработена JSON.

`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` команда

Създайте запис, ако не съществува, или го актуализирайте, ако има такъв. Записът се идентифицира с алтернативен ключ. Научете как да използвате алтернативен ключ за препратка към запис

`data upsert` параметри

Параметър	Описание
`--table`, `-t`	Името на набора от обекти. Задължително.
`--key`, `-k`	Алтернативен ключ. Задължително.
`--data`, `-d`	JSON обект със стойности на полета.
`--data-file`	Пътят до JSON файл.
`--update-only`	Неуспешно, ако записът не съществува (`If-Match: *`).
`--create-only`	Неуспешно, ако записът вече съществува (`If-None-Match: *`).
`--return`, `-r`	Върнете пълния запис след операцията.
`--target`	Маршрутизиране към `dataverse` (по подразбиране) или свързаната `erp` среда.
`--environment`, `-env`	Заместване на URL адреса на средата.
`--json`	Изходна необработена JSON.

`data upsert` Примери

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

`erp batch cancel` команда

Отмяна на пакетно задание "Финанси и операции" с неговия RecId. Използвайте erp batch list , за да намерите RecId.

`erp batch cancel` Примери

dataverse erp batch cancel <recid>

`erp batch list` команда

Списък на пакетни задания в екземпляра "Финанси" и "Операции", който е свързан с вашата среда на Dataverse. Командата изисква профил за удостоверяване, свързан към среда на Dataverse, която има свързан екземпляр на финанси и операции. URL адресът на финансите и операциите се извлича автоматично от текущата връзка на Dataverse.

`erp batch list` Параметри

Параметър	Описание
`--company`	Филтриране по юридическо лице (`dataAreaId`), като `USMF`например .
`--status`	Филтриране по състояние: `Waiting`, `Executing`, `Finished`, `Error`или `Cancelled`.
`--top`	Максималният брой резултати, които трябва да се върнат. По подразбиране: `20`.
`--caption`	Филтриране по надпис (нечувствително към малки и главни букви съвпадение).
`--json`	Изходна необработена JSON.

`erp batch list` Примери

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

`install` команда

Инсталирайте конкретна версия на CLI на Dataverse или актуализирайте до най-новата версия. Командата открива дали сте инсталирали CLI глобално, или използвате npx и съответно инсталира.

`install` Примери

Инсталирайте най-новата версия:

dataverse install latest

Инсталиране на конкретна версия:

dataverse install 1.0.0

`mcp` команда

Стартира MCP сървър, който се свързва с вашата среда, така че AI помощника, като например Claude Desktop, да могат да взаимодействат с вашите данни. Целта се открива автоматично от URL адреса: URL адрес на Dataverse стартира MCP сървъра Dataverse и URL адрес на финанси и операции, като https://myorg.operations.dynamics.comнапример , стартира MCP сървъра на ERP.

`mcp` Синтаксис

dataverse mcp <orgUrl> [options]

Аргументът е URL адресът <orgUrl> на вашата организация, например https://myorg.crm.dynamics.com.

`mcp` параметри

Параметър	Описание
`--validate`	Проверете крайните точки на MCP и настройката за удостоверяване, без да стартирате сървъра.
`--log-level`	Задайте нивото на регистриране: `Trace`, , `InformationDebug`, `Warning`, `Error`, или `Critical`. По подразбиране: `Warning`.
`--log-file`	Влезте във файл във временната директория.
`--preview`	Използвайте крайната точка за предварителен преглед на `api/mcp`MCP (`api/mcp_preview` вместо ). Не се поддържа за ERP.

`mcp` Примери

Проверка на настройката (препоръчителна първа стъпка):

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

Стартирайте сървъра с помощта на stdio транспорт:

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

Използвайте крайната точка за визуализация или разрешете регистрирането на файлове за отстраняване на грешки:

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

`mcp allow` команда

Уверете се, че дадено Microsoft Entra приложение е в списъка с разрешени MCP на Dataverse клиенти за средата на текущия профил. Тази команда е алтернатива на стъпката за ръчно администриране, описана в предварителните изисквания. Удостовереният потребител трябва да има разрешения на администратор на Dataverse за целевата среда.

`mcp allow` Синтаксис

dataverse mcp allow <appId> [options]

Аргументът <appId> е ИД на приложение (клиент) за разрешаване като GUID.

`mcp allow` Параметри

Параметър	Описание
`--erp`	Разрешете на приложението в свързания екземпляр Финанси и операции вместо в Dataverse.

`mcp allow` Примери

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

Забележка

Финанси и операции кешира списъка с разрешени адреси в AOS, така че новопозволеният ИД на приложение може да отнеме до пет минути, за да влезе в сила.

`org list` команда

Избройте всички среди, до които имате достъп.

`org list` Параметри

Параметър	Описание
`--filter`	Филтриране на списъка със среди по израз за търсене.
`--json`	Изходна необработена JSON.

`org list` Примери

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

`org who` команда

Показване на информация за текущата организация и потребител с помощта на активния профил за удостоверяване. Командата env е псевдоним за org.

`org who` Параметри

Параметър	Описание
`--environment`, `-env`	Заместване на URL адреса на средата.
`--json`	Изходна необработена JSON.

`org who` Примери

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

`skill` Команди

Управлявайте уменията на Dataverse – набори от инструкции за многократна употреба ( SKILL.md файл и неговите ресурсни файлове), които AI агентите използват – които се съхраняват в свързаната среда. Командите от най-горно ниво skill предоставят операции за създаване, четене, актуализиране и изтриване в средата. Локално уменията се съхраняват под .claude/skills/<name>/.

Забележка

Командите за авторство и оценка на умения, като makeнапример , update, getи eval, са отделни от тези команди. За повече информация изпълнете dataverse workspace skill --help.

`skill delete` команда

Изтрийте умение и всичките му ресурси от активната среда на Dataverse. Използвайте skill list , за да намерите уникални имена на умения.

dataverse skill delete new_lead-qualification

`skill download` команда

Изтеглете едно или повече умения от активната среда на Dataverse на диск. Командата SKILL.md изтегля файла и всички ресурсни файлове, запазвайки структурата на директорията. Използвайте skill list , за да намерите уникални имена на умения.

Параметър	Описание
`--all`	Изтеглете всички активни умения от средата. Не може да се комбинира с уникално име на умение.
`--output`, `-o`	Базовата директория за извеждане. По подразбиране: `.claude/skills/`. С `--all`всяко умение се записва на `<path>/<name>/`.
`--json`	Изходящи съдържанието на уменията като JSON, без да пишете файлове. Ако желаете, задайте път до файла, в който да се записва.

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

`skill list` команда

Избройте всички активни умения в свързаната среда на Dataverse.

Параметър	Описание
`--resources`, `-r`	Също така избройте ресурсните файлове за всяко умение.
`--json`	Изход като JSON. Ако желаете, задайте път до файла, в който да се записва.

dataverse skill list
dataverse skill list --resources

`skill upload` команда

Качете едно или повече умения от диска в активната среда на Dataverse. Командата поддържа директории, .zip файлове, .skill файлове и .md файлове.

Можете да преминете дадено умение <name>, което се свежде до .claude/skills/<name>/или до указател <path> или файл.

Параметър	Описание
`--all`	Качете всички умения под `.claude/skills/`. Не може да се комбинира с име на умение или път.
`--json`	Извеждане на резултата като JSON. Ако желаете, задайте път до файла, в който да се записва.

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

Вж. също

Работа с данни с помощта на CLI на Dataverse

Обратна връзка

Тази страница полезна ли беше?

Last updated on 2026-08-01

Dataverse CLI препратка (предварителен преглед)

api describe команда

api describe Параметри

api describe Примери

api invoke команда

api invoke Параметри

api invoke Примери

api list команда

api list Параметри

api list Примери

api request команда

api request Параметри

api request Примери

auth create команда

auth create Параметри

auth create Примери

Интерактивно удостоверяване

Наименуван профил

Поток на код на устройство

Главен субект на услуга с клиентската тайна

Потребителски ИД на клиент на приложение Entra

auth list команда

auth list Примери

auth remove команда

auth remove Параметри

auth remove Примери

auth select команда

auth select Параметри

auth select Примери

auth who команда

auth who Примери

data associate команда

data associate Параметри

data associate Примери

data count команда

data count Параметри

data count Примери

data create команда

data create Параметри

data create Примери

data delete команда

data delete Параметри

data delete Примери

data describe команда

data describe Параметри

data describe Примери

data disassociate команда

data disassociate Параметри

data disassociate Примери

data get команда

data get Параметри

data get Примери

data query команда

data query параметри

data query Примери

Научете повече

data update команда

data update Параметри

data update Примери

data upload команда

data upload Параметри

data upload Примери

data upsert команда

data upsert параметри

data upsert Примери

erp batch cancel команда

erp batch cancel Примери

erp batch list команда

erp batch list Параметри

erp batch list Примери

install команда

install Примери

mcp команда

mcp Синтаксис

mcp параметри

mcp Примери

mcp allow команда

mcp allow Синтаксис

mcp allow Параметри

mcp allow Примери

`api describe` команда

`api describe` Параметри

`api describe` Примери

`api invoke` команда

`api invoke` Параметри

`api invoke` Примери

`api list` команда

`api list` Параметри

`api list` Примери

`api request` команда

`api request` Параметри

`api request` Примери

`auth create` команда

`auth create` Параметри

`auth create` Примери

`auth list` команда

`auth list` Примери

`auth remove` команда

`auth remove` Параметри

`auth remove` Примери

`auth select` команда

`auth select` Параметри

`auth select` Примери

`auth who` команда

`auth who` Примери

`data associate` команда

`data associate` Параметри

`data associate` Примери

`data count` команда

`data count` Параметри

`data count` Примери

`data create` команда

`data create` Параметри

`data create` Примери

`data delete` команда

`data delete` Параметри

`data delete` Примери

`data describe` команда

`data describe` Параметри

`data describe` Примери

`data disassociate` команда

`data disassociate` Параметри

`data disassociate` Примери

`data get` команда

`data get` Параметри

`data get` Примери

`data query` команда

`data query` параметри

`data query` Примери

`data update` команда

`data update` Параметри

`data update` Примери

`data upload` команда

`data upload` Параметри

`data upload` Примери

`data upsert` команда

`data upsert` параметри

`data upsert` Примери

`erp batch cancel` команда

`erp batch cancel` Примери

`erp batch list` команда

`erp batch list` Параметри

`erp batch list` Примери

`install` команда

`install` Примери

`mcp` команда

`mcp` Синтаксис

`mcp` параметри

`mcp` Примери

`mcp allow` команда

`mcp allow` Синтаксис

`mcp allow` Параметри

`mcp allow` Примери

`org list` команда

`org list` Параметри

`org list` Примери

`org who` команда

`org who` Параметри

`org who` Примери

`skill` Команди