Referensi Dataverse CLI (pratinjau)

Note

Ini adalah fitur pratinjau.
Fitur pratinjau tidak dibuat untuk penggunaan produksi dan mungkin memiliki fungsionalitas yang dibatasi. Fitur ini tersedia sebelum rilis resmi agar pelanggan bisa memperoleh akses awal dan memberikan tanggapan.

Artikel ini menjelaskan perintah yang tersedia di Dataverse CLI. Setiap perintah mendukung --help opsi yang mencantumkan penggunaan, opsi, dan contohnya. Perintah yang mengembalikan data mendukung --json opsi untuk output JSON mentah yang berguna dalam skrip.

Opsi global berikut dapat digunakan dengan perintah apa pun:

Option	Description
`--log-level <level>`	Atur tingkat pengelogan: `Trace`, , `DebugInformation`, `Warning`, `Error`, atau `Critical`. Standar: `Warning`.
`--log-file`	Masuk ke file di direktori sementara alih-alih konsol.
`--context <value>`	Konteks operasi ditambahkan ke User-Agent. Anda juga dapat mengatur `DATAVERSE_OPERATION_CONTEXT` variabel lingkungan.

Command	Description
`api describe`	Menjelaskan API
`api invoke`	Memanggil API berdasarkan nama
`api list`	Mencantumkan API yang dapat ditemukan
`api request`	Mengirim permintaan HTTP terautentikasi
`auth create`	Membuat profil autentikasi baru
`auth list`	Mencantumkan semua profil autentikasi
`auth remove`	Menghapus profil autentikasi
`auth select`	Pilih profil autentikasi aktif
`auth who`	Perlihatkan profil autentikasi saat ini
`data associate`	Menautkan dua rekaman melalui hubungan
`data count`	Menghitung rekaman dalam tabel
`data create`	Membuat rekaman baru
`data delete`	Hapus sebuah catatan
`data describe`	Menjelaskan skema entitas
`data disassociate`	Menghapus hubungan antara dua rekaman
`data get`	Mengambil satu rekaman menurut ID atau kunci alternatif
`data query`	Menjalankan kueri OData, FetchXML, atau SQL
`data update`	Perbarui data yang ada
`data upload`	Mengunggah file ke kolom file pada rekaman yang sudah ada
`data upsert`	Membuat atau memperbarui rekaman dengan kunci alternatif
`erp batch cancel`	Membatalkan pekerjaan batch Keuangan dan Operasi
`erp batch list`	Mencantumkan pekerjaan batch Keuangan dan Operasi
`install`	Menginstal versi tertentu, atau memperbarui ke versi terbaru
`mcp`	Memulai server MCP untuk Dataverse atau ERP
`mcp allow`	Mengizinkan aplikasi sebagai klien MCP
`org list`	Mencantumkan semua lingkungan yang dapat diakses
`org who`	Perlihatkan info organisasi dan pengguna saat ini
`skill delete`	Menghapus keterampilan dari Dataverse
`skill download`	Mengunduh keterampilan dari Dataverse
`skill list`	Mencantumkan keterampilan aktif di lingkungan
`skill upload`	Mengunggah keterampilan ke Dataverse

Note

Banyak perintah mendukung --target <dataverse\|erp> opsi yang merutekan operasi ke Dataverse (default) atau ke lingkungan Keuangan dan Operasi (ERP) yang ditautkan. Perintah yang tersambung ke lingkungan mendukung --environment <url> opsi (-env) untuk mengambil alih URL lingkungan profil saat ini.

`api describe` perintah

Tampilkan metadata untuk satu API. Untuk API kustom Dataverse, output menyertakan parameter permintaan dan deskripsi properti respons saat metadata menyediakannya.

Nama dataverse tidak diprefiks secara default. Anda dapat menggunakan nama yang memenuhi syarat ERP dalam formulir erp:ServiceGroup/Service/Operation.

`api describe` parameter

Parameter	Description
`--target`	Atasi nama yang tidak memenuhi syarat terhadap `dataverse` atau `erp`.
`--service-group`	Hanya ERP. Persempit pencarian operasi ke satu grup layanan.
`--service`	Hanya ERP. Persempit pencarian operasi ke satu layanan.
`--environment`	Ambil alih URL lingkungan Dataverse.
`--json`	Output JSON mentah.

`api describe` contoh

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

`api invoke` perintah

Panggil API yang ditemukan berdasarkan nama. Gunakan name=value sintaks untuk parameter. Jika nilai berisi spasi, kutip seluruh token. Beberapa API Dataverse menerima parameter string yang kontennya sendiri adalah JSON. Dalam hal ini, berikan teks JSON sebagai nilai dengan menggunakan aturan kutipan dan pelepasan normal shell Anda.

Secara default, respons JSON dirender dalam format teks ramah yang mempertahankan nama properti output. Gunakan --json untuk mempertahankan payload JSON mentah.

`api invoke` parameter

Parameter	Description
`--target`	Atasi nama yang tidak memenuhi syarat terhadap `dataverse` atau `erp`.
`--service-group`	Hanya ERP. Persempit pencarian operasi ke satu grup layanan.
`--service`	Hanya ERP. Persempit pencarian operasi ke satu layanan.
`--param`	Tambahkan parameter bernama dalam `name=value` formulir. Berulang.
`--bind`	Jalur pengikatan untuk API Dataverse yang terikat entitas.
`--method`, `-X`	Ambil alih metode HTTP yang disimpulkan.
`--body`	Gunakan isi JSON mentah alih-alih parameter bernama.
`--body-file`	Baca isi JSON mentah dari file.
`--header`, `-H`	Tambahkan header HTTP dalam `key:value` formulir.
`--include`, `-i`	Sertakan status respons dan header.
`--environment`	Ambil alih URL lingkungan Dataverse.
`--json`	Keluarkan JSON mentah alih-alih teks yang ramah.

`api invoke` contoh

Memanggil fungsi Dataverse. Contoh ini menunjukkan penggunaan fungsi CCaaS_GetPresence Dynamics 365 Contact Center.

dataverse api invoke CCaaS_GetPresence ApiVersion=1.0

Panggil tindakan Dataverse AISummarize dengan spasi dalam nilai parameter:

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

Panggil layanan kustom ERP:

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

`api list` perintah

Cantumkan API yang dapat ditemukan, seperti API kustom Dataverse dan titik akhir layanan yang dapat dipanggil ERP. Hasil menunjukkan identitas API, nama yang mudah diingat, jenis, dan deskripsi saat tersedia. Anda bisa meneruskan istilah kueri opsional untuk memfilter hasilnya.

`api list` parameter

Parameter	Description
`--target`	Sistem target untuk mencari: `dataverse` (default) atau `erp`.
`--service-group`	Hanya ERP. Filter ke satu grup layanan.
`--service`	Hanya ERP. Filter ke satu layanan.
`--limit`	Jumlah maksimum API yang akan dikembalikan. Standar: `50`.
`--page`	Nomor halaman berbasis 1 saat penomoran melalui hasil. Standar: `1`.
`--environment`	Ambil alih URL lingkungan Dataverse.
`--json`	Output JSON mentah.

`api list` contoh

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

Kirim permintaan HTTP terautentikasi mentah ke Dataverse atau ERP. Gunakan perintah ini saat Anda memerlukan kontrol penuh atas jalur, metode, header, dan isi.

`api request` parameter

Parameter	Description
`--target`	Sistem target: `dataverse` atau `erp`. Required.
`--path`	Jalur permintaan. Required.
`--method`, `-X`	Metode HTTP. Default: `GET`, atau `POST` saat isi disediakan.
`--body`	Isi permintaan JSON sebaris.
`--body-file`	File yang berisi isi permintaan objek JSON.
`--header`, `-H`	Tambahkan header HTTP dalam `key:value` formulir.
`--include`, `-i`	Sertakan status respons dan header.
`--environment`	Ambil alih URL lingkungan Dataverse.

`api request` contoh

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

Buat profil autentikasi baru.

`auth create` parameter

Gunakan parameter ini untuk menentukan perilaku auth create perintah.

Parameter	Description
`--environment`, `-env`	URL untuk lingkungan Dataverse yang ingin Anda autentikasi.
`--name`, `-n`	Nama opsional untuk profil. Gunakan nama untuk memilih profil nanti.
`--cloud`, `-ci`	Cloud target: `Public`, , `UsGovUsGovHigh`, `UsGovDod`, atau `China`.
`--deviceCode`, `-dc`	Gunakan alur autentikasi kode perangkat, untuk lingkungan tanpa browser.
`--username`, `-un`	Nama pengguna untuk autentikasi nama pengguna dan kata sandi.
`--password`, `-p`	Kata sandi untuk autentikasi nama pengguna dan kata sandi.
`--applicationId`, `-id`	ID aplikasi (klien) untuk autentikasi perwakilan layanan (SPN).
`--clientSecret`, `-cs`	Rahasia klien untuk autentikasi perwakilan layanan.
`--certificateDiskPath`, `-cdp`	Jalur ke file sertifikat .pfx untuk autentikasi berbasis sertifikat.
`--certificatePassword`, `-cp`	Kata sandi untuk sertifikat.
`--tenant`, `-t`	ID penyewa. Diperlukan untuk autentikasi perwakilan layanan.
`--managedIdentity`, `-mi`	Gunakan identitas terkelola Azure.
`--githubFederated`, `-ghf`	Gunakan autentikasi gabungan GitHub Actions.
`--azureDevOpsFederated`, `-adof`	Gunakan autentikasi gabungan Azure DevOps.
`--clientid`, `-cid`	ID klien aplikasi Microsoft Entra kustom untuk digunakan alih-alih aplikasi Dataverse CLI default.
`--no-default-environment`	Jangan atur lingkungan sebagai default.
`--accept-cleartext-caching`	Izinkan cache token teks biasa di Linux.

`auth create` contoh

Contoh berikut menunjukkan cara menggunakan auth create perintah .

Autentikasi interaktif

Perintah ini membuka dialog browser atau sistem untuk informasi tambahan.

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

Profil bernama

Buat profil dengan nama tertentu.

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

Alur kode perangkat

Gunakan alur kode perangkat untuk lingkungan tanpa browser.

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

Perwakilan layanan dengan rahasia klien

Gunakan perwakilan layanan saat Anda memerlukan autentikasi tanpa pengawas, seperti dalam alur CI/CD atau skrip otomatis lainnya di mana proses masuk interaktif tidak dimungkinkan. Berikan ID aplikasi, rahasia klien, dan ID penyewa pendaftaran aplikasi yang memiliki akses ke lingkungan.

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

ID klien aplikasi Entra kustom

Gunakan pendaftaran aplikasi Anda sendiri alih-alih default.

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

`auth list` perintah

Mencantumkan semua profil autentikasi. Tambahkan --json untuk output JSON mentah.

`auth list` contoh

dataverse auth list
dataverse auth list --json

`auth remove` perintah

Hapus satu atau semua profil autentikasi.

`auth remove` parameter

Parameter	Description
`--index`, `-i`	Hapus profil dengan indeks berbasis 1 yang ditentukan, seperti yang ditunjukkan dalam `auth list`.
`--name`, `-n`	Hapus profil dengan nama yang ditentukan.
`--all`	Hapus semua profil.

`auth remove` contoh

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

`auth select` perintah

Pilih profil autentikasi aktif. Jalankan perintah tanpa opsi untuk mencantumkan semua profil.

`auth select` parameter

Parameter	Description
`--index`, `-i`	Pilih profil berdasarkan indeks berbasis 1-nya, seperti yang ditunjukkan dalam `auth list`.
`--name`, `-n`	Pilih profil menurut nama.

`auth select` contoh

Buka pemilih interaktif. Gunakan tombol panah, atau ketik untuk memfilter:

dataverse auth select

Pilih profil menurut indeks atau berdasarkan nama:

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

`auth who` perintah

Tampilkan profil autentikasi aktif saat ini. Tambahkan --json untuk output JSON mentah.

`auth who` contoh

dataverse auth who
dataverse auth who --json

`data associate` perintah

Kaitkan dua rekaman melalui properti navigasi (hubungan). Perintah ini hanya didukung untuk Dataverse.

`data associate` parameter

Parameter	Description
`--table`, `-t`	Nama kumpulan entitas dari rekaman utama. Required.
`--id`, `-i`	GUID rekaman utama. Required.
`--relationship`, `-rel`	Nama properti navigasi. Required.
`--related`	Nama kumpulan entitas tabel terkait. Required.
`--related-id`	GUID rekaman terkait. Required.
`--environment`, `-env`	Ambil alih URL lingkungan.
`--json`	Output JSON mentah.

`data associate` contoh

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

`data count` perintah

Hitung rekaman dalam tabel, difilter secara opsional.

`data count` parameter

Parameter	Description
`--table`, `-t`	Nama kumpulan entitas. Diperlukan kecuali Anda menggunakan `--fetchxml`.
`--filter`, `-f`	Ekspresi OData `$filter` .
`--fetchxml`	Kueri agregat FetchXML untuk jumlah kompleks.
`--target`	Rutekan ke `dataverse` (default) atau lingkungan tertaut `erp` .
`--cross-company`	Hanya ERP. Hitung di semua perusahaan. Default: perusahaan default pengguna.
`--environment`, `-env`	Ambil alih URL lingkungan.
`--json`	Output JSON mentah.

`data count` contoh

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

`data create` perintah

Buat rekaman baru dalam tabel Dataverse. Atur kolom pencarian dengan menggunakan @odata.bind sintaksis.

`data create` parameter

Parameter	Description
`--table`, `-t`	Nama kumpulan entitas. Required.
`--data`, `-d`	Objek JSON dengan nilai bidang.
`--data-file`	Jalur ke file JSON dengan data rekaman.
`--return`, `-r`	Mengembalikan rekaman lengkap yang dibuat.
`--target`	Rutekan ke `dataverse` (default) atau lingkungan tertaut `erp` .
`--environment`, `-env`	Ambil alih URL lingkungan.
`--json`	Output JSON mentah.

`data create` contoh

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

Tip

Gunakan --data-file untuk JSON yang kompleks. Gunakan --return --json untuk mendapatkan rekaman lengkap yang dibuat.

`data delete` perintah

Hapus satu rekaman dengan kunci utamanya atau dengan kunci alternatif.

`data delete` parameter

Parameter	Description
`--table`, `-t`	Nama kumpulan entitas. Required.
`--id`, `-i`	GUID rekaman.
`--key`, `-k`	Kunci alternatif.
`--no-confirm`	Lewati perintah konfirmasi.
`--target`	Rutekan ke `dataverse` (default) atau lingkungan tertaut `erp` .
`--environment`, `-env`	Ambil alih URL lingkungan.
`--json`	Output JSON mentah.

`data delete` contoh

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

`data describe` perintah

Menjelaskan skema entitas OData. Untuk Dataverse, perintah memanggil EntityDefinitions(LogicalName='<table>') dengan $expand didorong oleh --include, ditambah panggilan kedua ke customapis kapan --include actions diatur. Tindakan Dataverse bawaan seperti Assign dan SetState tidak dijumlahkan. Untuk ERP, satu panggilan untuk /Metadata/PublicEntities mengembalikan properti, tindakan terikat, dan navigasi bersama-sama.

`data describe` parameter

Parameter	Description
`--target`	Target: `dataverse` (default) atau `erp`.
`--table`, `-t`	Required. Untuk Dataverse, nama logis, seperti `account`. Untuk ERP, nama kumpulan entitas, seperti `BatchJobs`.
`--include`	Daftar bagian yang dipisahkan koma untuk disertakan: `entity`, , `properties`, `actionsrelations`, atau `all`. Alias: `attributes`=`properties`, . `relationships`=`relations` Default untuk ERP: `all`. Default untuk Dataverse: `entity,properties`.
`--json`	Output JSON mentah.

`data describe` contoh

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

`data disassociate` perintah

Hapus hubungan antara dua rekaman. Perintah ini hanya didukung untuk Dataverse.

`data disassociate` parameter

Parameter	Description
`--table`, `-t`	Nama kumpulan entitas dari rekaman utama. Required.
`--id`, `-i`	GUID rekaman utama. Required.
`--relationship`, `-rel`	Nama properti navigasi. Required.
`--related-id`	GUID rekaman terkait, untuk hubungan banyak ke banyak. Hilangkan parameter ini untuk menghapus pencarian.
`--environment`, `-env`	Ambil alih URL lingkungan.
`--json`	Output JSON mentah.

`data disassociate` contoh

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

`data get` perintah

Ambil satu rekaman dengan ID -nya (kunci primer) atau dengan kunci alternatif.

`data get` parameter

Parameter	Description
`--table`, `-t`	Nama kumpulan entitas. Required.
`--id`, `-i`	GUID rekaman (kunci primer).
`--key`, `-k`	Kunci alternatif, misalnya `"col='val'"`.
`--select`, `-s`	Daftar kolom yang dipisahkan koma (`$select`).
`--expand`, `-x`	Ekspresi OData `$expand` untuk rekaman terkait.
`--target`	Rutekan ke `dataverse` (default) atau lingkungan tertaut `erp` .
`--environment`, `-env`	Ambil alih URL lingkungan.
`--json`	Output JSON mentah.

`data get` contoh

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

Jalankan kueri OData, FetchXML, atau SQL terhadap tabel Dataverse.

`data query` parameter

Parameter	Description
`--table`, `-t`	Entitas menetapkan nama ke kueri. Diperlukan untuk kueri OData.
`--select`, `-s`	Daftar kolom yang dipisahkan koma (`$select`).
`--filter`, `-f`	Ekspresi OData `$filter` .
`--orderby`, `-o`	Ekspresi OData `$orderby` .
`--top`	Jumlah maksimum rekaman yang akan dikembalikan (1-5000).
`--expand`, `-x`	Ekspresi OData `$expand` untuk rekaman terkait.
`--fetchxml`	Kueri FetchXML sebaris.
`--fetchxml-file`	Jalur ke file yang berisi kueri FetchXML.
`--sql`	Kueri SQL `SELECT` (pratinjau).
`--sql-file`	Jalur ke file yang berisi kueri SQL.
`--all`, `-a`	Ikuti penomoran halaman untuk mengambil semua rekaman.
`--max-records`	Jumlah maksimum rekaman yang akan diambil saat menggunakan `--all`. Standar: `100000`.
`--target`	Rutekan ke `dataverse` (default) atau lingkungan tertaut `erp` .
`--cross-company`	Hanya ERP. Kueri di semua perusahaan. Default: perusahaan default pengguna.
`--environment`, `-env`	Ambil alih URL lingkungan.
`--json`	Output JSON mentah.

`data query` contoh

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

Pelajari lebih lanjut

`data update` perintah

Perbarui satu atau beberapa bidang pada rekaman yang sudah ada, yang diidentifikasi oleh ID-nya atau oleh kunci alternatif. Atur kolom pencarian dengan menggunakan @odata.bind sintaksis.

`data update` parameter

Parameter	Description
`--table`, `-t`	Nama kumpulan entitas. Required.
`--id`, `-i`	GUID rekaman.
`--key`, `-k`	Kunci alternatif.
`--data`, `-d`	Objek JSON dengan bidang yang akan diperbarui.
`--data-file`	Jalur ke file JSON dengan data pembaruan.
`--return`, `-r`	Mengembalikan catatan lengkap yang diperbarui.
`--target`	Rutekan ke `dataverse` (default) atau lingkungan tertaut `erp` .
`--environment`, `-env`	Ambil alih URL lingkungan.
`--json`	Output JSON mentah.

`data update` contoh

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

`data upload` perintah

Unggah file lokal ke dalam kolom file Dataverse pada rekaman yang sudah ada. Perintah secara otomatis memilih permintaan tunggal atau unggahan yang dipotong berdasarkan ukuran file, kecuali Anda menentukan --mode. Dalam mode otomatis, file di bawah 128 MB diunggah dalam satu permintaan, dan file yang lebih besar menggunakan unggahan yang dipotong. Saat Anda menghilangkan --mime-type, perintah menyimpulkan jenis MIME dari ekstensi file. Ekstensi yang tidak diketahui default ke application/octet-stream.

`data upload` parameter

Parameter	Description
`--table`, `-t`	Skema tabel atau nama logis, seperti `account`. Required. Perintah menyelesaikan kumpulan entitas dari metadata.
`--id`, `-i`	GUID rekaman. Required.
`--column`, `-c`	Nama atribut kolom file. Required.
`--file`, `-f`	Jalur ke file lokal. Required.
`--mode`, `-m`	Strategi unggahan: `auto` (default), `small`, atau `chunk`.
`--mime-type`	Jenis MIME eksplisit. Default: disimpulkan dari ekstensi file.
`--overwrite`	Timpa file yang ada. Secara default, perintah gagal jika kolom tidak kosong.
`--environment`, `-env`	Ambil alih URL lingkungan.
`--json`	Output JSON mentah.

`data upload` contoh

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

Buat catatan jika tidak ada, atau perbarui jika tidak. Rekaman diidentifikasi oleh kunci alternatif. Pelajari cara menggunakan kunci alternatif untuk mereferensikan rekaman

`data upsert` parameter

Parameter	Description
`--table`, `-t`	Nama kumpulan entitas. Required.
`--key`, `-k`	Kunci alternatif. Required.
`--data`, `-d`	Objek JSON dengan nilai bidang.
`--data-file`	Jalur ke file JSON.
`--update-only`	Gagal jika rekaman tidak ada (`If-Match: *`).
`--create-only`	Gagal jika rekaman sudah ada (`If-None-Match: *`).
`--return`, `-r`	Mengembalikan rekaman lengkap setelah operasi.
`--target`	Rutekan ke `dataverse` (default) atau lingkungan tertaut `erp` .
`--environment`, `-env`	Ambil alih URL lingkungan.
`--json`	Output JSON mentah.

`data upsert` contoh

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

`erp batch cancel` perintah

Batalkan pekerjaan batch Keuangan dan Operasi dengan RecId. Gunakan erp batch list untuk menemukan RecId.

`erp batch cancel` contoh

dataverse erp batch cancel <recid>

`erp batch list` perintah

Cantumkan pekerjaan batch pada instans Keuangan dan Operasi yang ditautkan ke lingkungan Dataverse Anda. Perintah ini memerlukan profil autentikasi yang terhubung ke lingkungan Dataverse yang memiliki instans Keuangan dan Operasi tertaut. URL Keuangan dan Operasi berasal secara otomatis dari koneksi Dataverse saat ini.

`erp batch list` parameter

Parameter	Description
`--company`	Filter menurut badan hukum (`dataAreaId`), seperti `USMF`.
`--status`	Filter menurut status: `Waiting`, , `FinishedExecuting`, `Error`, atau `Cancelled`.
`--top`	Jumlah maksimum hasil yang akan dikembalikan. Standar: `20`.
`--caption`	Filter menurut keterangan (kecocokan substring yang tidak peka huruf besar/kecil).
`--json`	Output JSON mentah.

`erp batch list` contoh

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

`install` perintah

Instal versi tertentu dari Dataverse CLI, atau perbarui ke versi terbaru. Perintah mendeteksi apakah Anda menginstal CLI secara global atau menggunakan npx dan menginstal yang sesuai.

`install` contoh

Instal versi terbaru:

dataverse install latest

Instal versi tertentu:

dataverse install 1.0.0

`mcp` perintah

Memulai server Model Context Protocol (MCP) yang terhubung ke lingkungan Anda, sehingga asisten AI seperti Claude Desktop dapat berinteraksi dengan data Anda. Target terdeteksi secara otomatis dari URL: URL Dataverse memulai server MCP Dataverse, dan URL Keuangan dan Operasi, seperti https://myorg.operations.dynamics.com, memulai server MCP ERP.

`mcp` sintaksis

dataverse mcp <orgUrl> [options]

Argumennya <orgUrl> adalah URL organisasi Anda, misalnya https://myorg.crm.dynamics.com.

`mcp` parameter

Parameter	Description
`--validate`	Validasi titik akhir MCP dan penyiapan autentikasi tanpa memulai server.
`--log-level`	Atur tingkat pengelogan: `Trace`, , `DebugInformation`, `Warning`, `Error`, atau `Critical`. Standar: `Warning`.
`--log-file`	Masuk ke file di direktori sementara.
`--preview`	Gunakan titik akhir MCP pratinjau (`api/mcp_preview` bukan `api/mcp`). Tidak didukung untuk ERP.

`mcp` contoh

Validasi penyiapan (langkah pertama yang direkomendasikan):

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

Mulai server dengan menggunakan transportasi stdio:

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

Gunakan titik akhir pratinjau, atau aktifkan pengelogan file debug:

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

`mcp allow` perintah

Pastikan bahwa aplikasi Microsoft Entra ada dalam daftar klien yang diizinkan Dataverse MCP untuk lingkungan profil saat ini. Perintah ini adalah alternatif untuk langkah admin manual yang dijelaskan dalam prasyarat. Pengguna yang diautentikasi harus memiliki izin admin Dataverse pada lingkungan target.

`mcp allow` sintaksis

dataverse mcp allow <appId> [options]

Argumen <appId> adalah ID aplikasi (klien) untuk diizinkan, sebagai GUID.

`mcp allow` parameter

Parameter	Description
`--erp`	Izinkan aplikasi pada instans Keuangan dan Operasi yang ditautkan alih-alih Dataverse.

`mcp allow` contoh

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

Note

Keuangan dan Operasi menyimpan daftar yang diizinkan di AOS, sehingga ID aplikasi yang baru diizinkan dapat memakan waktu hingga sekitar lima menit untuk diterapkan.

`org list` perintah

Mencantumkan semua lingkungan yang dapat Anda akses.

`org list` parameter

Parameter	Description
`--filter`	Filter daftar lingkungan menurut istilah pencarian.
`--json`	Output JSON mentah.

`org list` contoh

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

`org who` perintah

Tampilkan informasi tentang organisasi dan pengguna saat ini, menggunakan profil autentikasi aktif. Perintah env adalah alias untuk org.

`org who` parameter

Parameter	Description
`--environment`, `-env`	Ambil alih URL lingkungan.
`--json`	Output JSON mentah.

`org who` contoh

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

`skill` Perintah

Mengelola keterampilan Dataverse—set instruksi yang dapat digunakan kembali ( SKILL.md file dan file sumber dayanya) yang digunakan agen AI—yang disimpan di lingkungan yang terhubung. Perintah tingkat skill atas menyediakan operasi buat, baca, perbarui, dan hapus terhadap lingkungan. Secara lokal, keterampilan disimpan di bawah .claude/skills/<name>/.

Note

Perintah penulisan dan evaluasi keterampilan, seperti make, , updateget, dan eval, terpisah dari perintah ini. Untuk informasi selengkapnya, jalankan dataverse workspace skill --help.

`skill delete` perintah

Hapus keterampilan dan semua sumber dayanya dari lingkungan Dataverse aktif. Gunakan skill list untuk menemukan nama unik keterampilan.

dataverse skill delete new_lead-qualification

`skill download` perintah

Unduh satu atau beberapa keterampilan dari lingkungan Dataverse aktif ke disk. Perintah mengunduh SKILL.md file dan semua file sumber daya, mempertahankan struktur direktori. Gunakan skill list untuk menemukan nama unik keterampilan.

Parameter	Description
`--all`	Unduh semua keterampilan aktif dari lingkungan. Tidak dapat dikombinasikan dengan nama unik keterampilan.
`--output`, `-o`	Direktori dasar untuk output. Standar: `.claude/skills/`. Dengan `--all`, setiap keterampilan ditulis ke `<path>/<name>/`.
`--json`	Keluarkan konten keterampilan sebagai JSON tanpa menulis file. Secara opsional tentukan jalur file yang akan ditulis.

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

`skill list` perintah

Mencantumkan semua keterampilan aktif di lingkungan Dataverse yang terhubung.

Parameter	Description
`--resources`, `-r`	Cantumkan juga file sumber daya untuk setiap keterampilan.
`--json`	Output sebagai JSON. Secara opsional tentukan jalur file yang akan ditulis.

dataverse skill list
dataverse skill list --resources

`skill upload` perintah

Unggah satu atau beberapa keterampilan dari disk ke lingkungan Dataverse aktif. Perintah ini mendukung direktori, file.zip , file .skill , dan file .md .

Anda dapat meneruskan keterampilan <name>, yang menyelesaikan ke .claude/skills/<name>/, atau eksplisit <path> ke direktori atau file.

Parameter	Description
`--all`	Unggah semua keterampilan di bawah `.claude/skills/`. Tidak dapat dikombinasikan dengan nama atau jalur keterampilan.
`--json`	Keluarkan hasilnya sebagai JSON. Secara opsional tentukan jalur file yang akan ditulis.

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

Saran dan Komentar

Apakah halaman ini membantu?

Last updated on 2026-08-01

Referensi Dataverse CLI (pratinjau)

api describe perintah

api describe parameter

api describe contoh

api invoke perintah

api invoke parameter

api invoke contoh

api list perintah

api list parameter

api list contoh

api request perintah

api request parameter

api request contoh

auth create perintah

auth create parameter

auth create contoh

Autentikasi interaktif

Profil bernama

Alur kode perangkat

Perwakilan layanan dengan rahasia klien

ID klien aplikasi Entra kustom

auth list perintah

auth list contoh

auth remove perintah

auth remove parameter

auth remove contoh

auth select perintah

auth select parameter

auth select contoh

auth who perintah

auth who contoh

data associate perintah

data associate parameter

data associate contoh

data count perintah

data count parameter

data count contoh

data create perintah

data create parameter

data create contoh

data delete perintah

data delete parameter

data delete contoh

data describe perintah

data describe parameter

data describe contoh

data disassociate perintah

data disassociate parameter

data disassociate contoh

data get perintah

data get parameter

data get contoh

data query perintah

data query parameter

data query contoh

Pelajari lebih lanjut

data update perintah

data update parameter

data update contoh

data upload perintah

data upload parameter

data upload contoh

data upsert perintah

data upsert parameter

data upsert contoh

erp batch cancel perintah

erp batch cancel contoh

erp batch list perintah

erp batch list parameter

erp batch list contoh

install perintah

install contoh

mcp perintah

mcp sintaksis

mcp parameter

mcp contoh

mcp allow perintah

mcp allow sintaksis

mcp allow parameter

mcp allow contoh

`api describe` perintah

`api describe` parameter

`api describe` contoh

`api invoke` perintah

`api invoke` parameter

`api invoke` contoh

`api list` perintah

`api list` parameter

`api list` contoh

`api request` perintah

`api request` parameter

`api request` contoh

`auth create` perintah

`auth create` parameter

`auth create` contoh

`auth list` perintah

`auth list` contoh

`auth remove` perintah

`auth remove` parameter

`auth remove` contoh

`auth select` perintah

`auth select` parameter

`auth select` contoh

`auth who` perintah

`auth who` contoh

`data associate` perintah

`data associate` parameter

`data associate` contoh

`data count` perintah

`data count` parameter

`data count` contoh

`data create` perintah

`data create` parameter

`data create` contoh

`data delete` perintah

`data delete` parameter

`data delete` contoh

`data describe` perintah

`data describe` parameter

`data describe` contoh

`data disassociate` perintah

`data disassociate` parameter

`data disassociate` contoh

`data get` perintah

`data get` parameter

`data get` contoh

`data query` perintah

`data query` parameter

`data query` contoh

`data update` perintah

`data update` parameter

`data update` contoh

`data upload` perintah

`data upload` parameter

`data upload` contoh

`data upsert` perintah

`data upsert` parameter

`data upsert` contoh

`erp batch cancel` perintah

`erp batch cancel` contoh

`erp batch list` perintah

`erp batch list` parameter

`erp batch list` contoh

`install` perintah

`install` contoh

`mcp` perintah

`mcp` sintaksis

`mcp` parameter

`mcp` contoh

`mcp allow` perintah

`mcp allow` sintaksis

`mcp allow` parameter

`mcp allow` contoh

`org list` perintah

`org list` parameter

`org list` contoh

`org who` perintah

`org who` parameter

`org who` contoh

`skill` Perintah