Справочник по интерфейсу командной строки dataverse (предварительная версия)

Note

Это предварительная версия функции.
Предварительные версии функций не предназначены для использования в производственной среде, а их функциональность может быть ограничена. Эти функции доступны до официального выпуска, чтобы клиенты могли получать ранний доступ и предоставлять отзывы.

В этой статье описываются команды, доступные в интерфейсе командной строки Dataverse. Каждая команда поддерживает --help параметр, который перечисляет его использование, параметры и примеры. Команды, возвращающие данные, поддерживают --json возможность необработанных выходных данных JSON, полезных в скриптах.

С любой командой можно использовать следующие глобальные параметры:

Опция	Description
`--log-level <level>`	Задайте уровень ведения журнала: `Trace`, `Debug`, `InformationWarningError`или .`Critical` По умолчанию: `Warning`.
`--log-file`	Войдите в файл во временном каталоге вместо консоли.
`--context <value>`	Контекст операции, добавленный к агенту пользователя. Можно также задать `DATAVERSE_OPERATION_CONTEXT` переменную среды.

Command	Description
`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

Note

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

`api describe` команда

Отображение метаданных для одного API. Для пользовательских API Dataverse выходные данные включают в себя описание свойств запроса и ответа, когда метаданные предоставляют их.

Имена с обратными данными по умолчанию нерекоменданны. Имена, управляемые ERP, можно использовать в форме erp:ServiceGroup/Service/Operation.

параметры `api describe`

Parameter	Description
`--target`	Устраните некавалифицированное имя или `dataverseerp`.
`--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`

Parameter	Description
`--target`	Устраните некавалифицированное имя или `dataverseerp`.
`--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`

Parameter	Description
`--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`

Parameter	Description
`--target`	Целевая система: `dataverse` или `erp`. Required.
`--path`	Путь запроса. Required.
`--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 команды.

Parameter	Description
`--environment`, `-env`	URL-адрес среды Dataverse, с помощью которой требуется пройти проверку подлинности.
`--name`, `-n`	Необязательное имя профиля. Используйте имя, чтобы выбрать профиль позже.
`--cloud`, `-ci`	Целевое облако: `Public`, , `UsGovHighUsGovUsGovDod`или .`China`
`--deviceCode`, `-dc`	Используйте поток проверки подлинности кода устройства для сред без браузера.
`--username`, `-un`	Имя пользователя для проверки подлинности имени пользователя и пароля.
`--password`, `-p`	Пароль для проверки подлинности имени пользователя и пароля.
`--applicationId`, `-id`	Идентификатор приложения (клиента) для проверки подлинности субъекта-службы .
`--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`

Parameter	Description
`--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`

Parameter	Description
`--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`

Parameter	Description
`--table`, `-t`	Имя набора сущностей первичной записи. Required.
`--id`, `-i`	GUID первичной записи. Required.
`--relationship`, `-rel`	Имя свойства навигации. Required.
`--related`	Имя набора сущностей связанной таблицы. Required.
`--related-id`	GUID связанной записи. Required.
`--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`

Parameter	Description
`--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`

Parameter	Description
`--table`, `-t`	Имя набора сущностей. Required.
`--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>)"}'

Tip

Используется --data-file для сложного JSON. Используется --return --json для получения полной созданной записи.

`data delete` команда

Удалите одну запись по первичному ключу или альтернативным ключом.

параметры `data delete`

Parameter	Description
`--table`, `-t`	Имя набора сущностей. Required.
`--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`

Parameter	Description
`--target`	Целевой объект: `dataverse` (по умолчанию) или `erp`.
`--table`, `-t`	Required. Для Dataverse логическое имя, например `account`. Для ERP имя набора сущностей, например `BatchJobs`.
`--include`	Список разделов, разделенных запятыми, включая: `entity`, , `properties`, `relationsactions`или `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`

Parameter	Description
`--table`, `-t`	Имя набора сущностей первичной записи. Required.
`--id`, `-i`	GUID первичной записи. Required.
`--relationship`, `-rel`	Имя свойства навигации. Required.
`--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`

Parameter	Description
`--table`, `-t`	Имя набора сущностей. Required.
`--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`

Parameter	Description
`--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`

Parameter	Description
`--table`, `-t`	Имя набора сущностей. Required.
`--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`

Parameter	Description
`--table`, `-t`	Схема таблицы или логическое имя, например `account`. Required. Команда разрешает набор сущностей из метаданных.
`--id`, `-i`	GUID записи. Required.
`--column`, `-c`	Имя атрибута столбца файла. Required.
`--file`, `-f`	Путь к локальному файлу. Required.
`--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`

Parameter	Description
`--table`, `-t`	Имя набора сущностей. Required.
`--key`, `-k`	Альтернативный ключ. Required.
`--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` команда

Вывод списка пакетных заданий в экземпляре Finance and Operations, связанном с средой Dataverse. Для выполнения команды требуется профиль проверки подлинности, подключенный к среде Dataverse с связанным экземпляром Finance и Operations. URL-адрес "Финансы и операции" автоматически извлекается из текущего подключения Dataverse.

параметры `erp batch list`

Parameter	Description
`--company`	Фильтрация по юридическому лицу (`dataAreaId`например `USMF`.
`--status`	Фильтрация по состоянию: `Waiting`, , `ExecutingFinished`, `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` команда

Установите определенную версию интерфейса командной строки Dataverse или обновите ее до последней версии. Команда определяет, установлена ли среда КОМАНДНОй строки глобально или используется npx и устанавливается соответствующим образом.

примеры `install`

Установите последнюю версию:

dataverse install latest

Установите определенную версию:

dataverse install 1.0.0

`mcp` команда

Запускает сервер протокола контекста модели (MCP), который подключается к вашей среде, чтобы помощники ИИ, такие как Claude Desktop, могли взаимодействовать с данными. Целевой объект автоматически обнаруживается из URL-адреса: URL-адрес dataverse запускает сервер MCP Dataverse, а ТАКЖЕ URL-адрес финансов и операций, например https://myorg.operations.dynamics.com, запускает сервер ERP MCP.

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

dataverse mcp <orgUrl> [options]

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

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

Parameter	Description
`--validate`	Проверьте конечные точки MCP и настройку проверки подлинности без запуска сервера.
`--log-level`	Задайте уровень ведения журнала: `Trace`, `Debug`, `InformationWarningError`или .`Critical` По умолчанию: `Warning`.
`--log-file`	Войдите в файл во временном каталоге.
`--preview`	Используйте конечную точку MCP предварительной версии (`api/mcp_preview` вместо `api/mcp`). Не поддерживается для 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 находится в списке разрешенных клиентов Dataverse MCP для среды текущего профиля. Эта команда является альтернативой шагу администратора вручную, описанному в предварительных требованиях. Прошедший проверку подлинности пользователь должен иметь разрешения администратора Dataverse в целевой среде.

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

dataverse mcp allow <appId> [options]

Аргументом <appId> является идентификатор приложения (клиента), разрешающий в качестве GUID.

параметры `mcp allow`

Parameter	Description
`--erp`	Разрешите приложению связанный экземпляр Finance и Operations вместо Dataverse.

примеры `mcp allow`

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

Note

Финансы и операции кэшируют список разрешений в AOS, поэтому только что разрешенный идентификатор приложения может занять до пяти минут, чтобы ввести в силу.

`org list` команда

Список всех сред, к которым можно получить доступ.

параметры `org list`

Parameter	Description
`--filter`	Отфильтруйте список сред по термину поиска.
`--json`	Выходные данные необработанного JSON.

примеры `org list`

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

`org who` команда

Отображение сведений о текущей организации и пользователе с помощью активного профиля проверки подлинности. Команда env — это псевдоним для org.

параметры `org who`

Parameter	Description
`--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 файлом и его файлами ресурсов), используемыми агентами ИИ, которые хранятся в подключенной среде. Команды верхнего уровня skill предоставляют операции создания, чтения, обновления и удаления в среде. Локально навыки хранятся в .claude/skills/<name>/разделе .

Note

Команды разработки и оценки навыков, такие как make, updategetи eval, отделены от этих команд. Чтобы получить дополнительные сведения, запустите dataverse workspace skill --help.

`skill delete` команда

Удалите навык и все его ресурсы из активной среды Dataverse. Используйте skill list для поиска уникальных имен навыка.

dataverse skill delete new_lead-qualification

`skill download` команда

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

Parameter	Description
`--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.

Parameter	Description
`--resources`, `-r`	Также список файлов ресурсов для каждого навыка.
`--json`	Выходные данные в формате JSON. При необходимости укажите путь к файлу для записи.

dataverse skill list
dataverse skill list --resources

`skill upload` команда

Отправьте один или несколько навыков с диска в активную среду Dataverse. Эта команда поддерживает каталоги, .zip файлы, файлы .skill и MD-файлы .

Вы можете передать навык <name>, разрешающий .claude/skills/<name>/или явный <path> в каталог или файл.

Parameter	Description
`--all`	Отправьте все навыки в `.claude/skills/`разделе . Не удается объединить с именем или путем навыка.
`--json`	Выводит результат в формате JSON. При необходимости укажите путь к файлу для записи.

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

См. также

Работа с данными с помощью интерфейса командной строки Dataverse

Обратная связь

Были ли сведения на этой странице полезными?

Last updated on 2026-08-01

Справочник по интерфейсу командной строки dataverse (предварительная версия)

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`.