Rujukan CLI Dataverse (pratonton)

Nota

• Ini adalah ciri pratonton.
• Ciri pratonton bukan untuk kegunaan pengeluaran dan kefungsian mungkin terbatas. Ciri ini tersedia sebelum keluaran rasmi agar pelanggan boleh mendapat akses awal dan memberikan maklum balas.

Artikel ini menerangkan arahan yang tersedia dalam Dataverse CLI. Setiap arahan menyokong --help pilihan yang menyenaraikan penggunaan, pilihan, dan contoh. Arahan yang mengembalikan data menyokong --json pilihan output JSON mentah yang berguna dalam skrip.

Pilihan global berikut boleh digunakan dengan mana-mana arahan:

Pilihan	Perihalan
--log-level <level>	Tetapkan tahap pencatatan: Trace, Debug, , WarningInformation, Error, atau Critical. Lalai: Warning.
--log-file	Log masuk ke fail dalam direktori sementara dan bukannya konsol.
--context <value>	Konteks operasi ditambah pada User-Agent. Anda juga boleh menetapkan DATAVERSE_OPERATION_CONTEXT pembolehubah persekitaran.

Perintah	Perihalan
api describe	Terangkan API
api invoke	Memanggil API mengikut nama
api list	Senarai API yang boleh ditemui
api request	Hantar permintaan HTTP yang telah disahkan
auth create	Cipta profil pengesahan baru
auth list	Senaraikan semua profil pengesahan
auth remove	Buang profil pengesahan
auth select	Pilih profil pengesahan aktif
auth who	Tunjukkan profil pengesahan semasa
data associate	Pautkan dua rekod melalui hubungan
data count	Kira rekod dalam jadual
data create	Cipta rekod baru
data delete	Padamkan rekod
data describe	Terangkan skema entiti
data disassociate	Buang hubungan antara dua rekod
data get	Dapatkan satu rekod mengikut ID atau kunci alternatif
data query	Laksanakan pertanyaan OData, FetchXML, atau SQL
data update	Kemas kini rekod yang sedia ada
data upload	Muat naik fail ke lajur fail pada rekod sedia ada
data upsert	Cipta atau kemas kini rekod mengikut kunci alternatif
erp batch cancel	Batalkan tugas batch Kewangan dan Operasi
erp batch list	Senaraikan tugas kelompok Kewangan dan Operasi
install	Pasang versi tertentu, atau kemas kini ke versi terkini
mcp	Mulakan pelayan MCP untuk Dataverse atau ERP
mcp allow	Benarkan aplikasi sebagai klien MCP
org list	Senaraikan semua persekitaran yang boleh diakses
org who	Tunjukkan organisasi semasa dan maklumat pengguna
skill delete	Padam kemahiran dari Dataverse
skill download	Muat turun kemahiran dari Dataverse
skill list	Senaraikan kemahiran aktif dalam persekitaran
skill upload	Muat naik kemahiran ke Dataverse

Nota

Banyak arahan menyokong --target <dataverse\|erp> pilihan yang menghala operasi ke Dataverse (lalai) atau ke persekitaran Kewangan dan Operasi (ERP) yang dipautkan. Arahan yang menyambung ke persekitaran menyokong --environment <url> pilihan (-env) untuk menggantikan URL persekitaran profil semasa.

api describe Perintah

Paparkan metadata untuk satu API. Untuk API tersuai Dataverse, output termasuk parameter permintaan dan penerangan sifat respons apabila metadata menyediakannya.

Nama Dataverse secara lalai tidak diawali. Anda boleh menggunakan nama yang layak ERP dalam borang erp:ServiceGroup/Service/Operation.

api describe parameter

Parameter_	Perihalan
--target	Selesaikan nama yang tidak layak terhadap dataverse atau erp.
--service-group	ERP sahaja. Sempitkan carian operasi kepada satu kumpulan perkhidmatan.
--service	ERP sahaja. Sempitkan pencarian operasi kepada satu perkhidmatan.
--environment	Ganti URL persekitaran 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 ditemui mengikut nama. Gunakan name=value sintaks untuk parameter. Jika nilai mengandungi ruang, petikan keseluruhan token. Sesetengah API Dataverse menerima parameter rentetan yang kandungannya sendiri adalah JSON. Dalam kes itu, hantar teks JSON sebagai nilai dengan menggunakan peraturan pemetik dan pelarian biasa shell anda.

Secara lalai, respons JSON dipaparkan dalam format teks mesra yang mengekalkan nama sifat output. Gunakan --json untuk mengekalkan muatan JSON mentah.

api invoke parameter

Parameter_	Perihalan
--target	Selesaikan nama yang tidak layak terhadap dataverse atau erp.
--service-group	ERP sahaja. Sempitkan carian operasi kepada satu kumpulan perkhidmatan.
--service	ERP sahaja. Sempitkan pencarian operasi kepada satu perkhidmatan.
--param	Tambah parameter bernama dalam borang name=value . Boleh diulang.
--bind	Laluan pengikatan untuk API Dataverse yang terikat entiti.
--method, -X	Gantikan kaedah HTTP yang disimpulkan.
--body	Gunakan badan JSON mentah dan bukannya parameter bernama.
--body-file	Baca badan JSON mentah dari fail.
--header, -H	Tambah header HTTP dalam borang key:value .
--include, -i	Sertakan status respons dan tajuk.
--environment	Ganti URL persekitaran Dataverse.
--json	Keluarkan JSON mentah dan bukannya teks mesra.

api invoke Contoh

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

dataverse api invoke CCaaS_GetPresence ApiVersion=1.0

Panggil tindakan Dataverse AISummarize dengan ruang dalam nilai parameter:

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

Panggil perkhidmatan tersuai ERP:

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

api list Perintah

Senaraikan API yang boleh ditemui, seperti API tersuai Dataverse dan titik akhir perkhidmatan panggilan ERP. Keputusan menunjukkan identiti API, nama mesra, jenis, dan penerangan apabila tersedia. Anda boleh menghantar istilah pertanyaan pilihan untuk menapis hasil.

api list parameter

Parameter_	Perihalan
--target	Sistem sasaran untuk dicari: dataverse (lalai) atau erp.
--service-group	ERP sahaja. Tapis kepada satu kumpulan perkhidmatan.
--service	ERP sahaja. Tapis kepada satu perkhidmatan.
--limit	Bilangan maksimum API untuk dikembalikan. Lalai: 50.
--page	Nombor halaman berasaskan 1 semasa meneliti keputusan. Lalai: 1.
--environment	Ganti URL persekitaran 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

Hantar permintaan HTTP mentah yang disahkan ke Dataverse atau ERP. Gunakan arahan ini apabila anda memerlukan kawalan penuh ke atas laluan, kaedah, pengepala, dan badan.

api request parameter

Parameter_	Perihalan
--target	Sistem sasaran: dataverse atau erp. Diperlukan.
--path	Laluan permintaan. Diperlukan.
--method, -X	Kaedah HTTP. Lalai: GET, atau POST apabila satu badan dibekalkan.
--body	Badan permintaan JSON secara sebaris.
--body-file	Fail yang mengandungi badan permintaan objek JSON.
--header, -H	Tambah header HTTP dalam borang key:value .
--include, -i	Sertakan status respons dan tajuk.
--environment	Ganti URL persekitaran 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

Cipta profil pengesahan baru.

auth create parameter

Gunakan parameter ini untuk menentukan tingkah laku auth create arahan.

Parameter_	Perihalan
--environment, -env	URL untuk persekitaran Dataverse yang anda ingin gunakan untuk pengesahan.
--name, -n	Nama pilihan untuk profil. Gunakan nama tersebut untuk memilih profil kemudian.
--cloud, -ci	Awan sasaran: Public, , UsGov, UsGovHigh, UsGovDodatau China.
--deviceCode, -dc	Gunakan aliran pengesahan kod peranti, untuk persekitaran tanpa pelayar.
--username, -un	Nama pengguna untuk pengesahan nama pengguna dan kata laluan.
--password, -p	Kata laluan untuk pengesahan nama pengguna dan kata laluan.
--applicationId, -id	ID aplikasi (klien) untuk pengesahan prinsipal perkhidmatan (SPN).
--clientSecret, -cs	Rahsia klien untuk pengesahan prinsipal perkhidmatan.
--certificateDiskPath, -cdp	Laluan ke fail sijil .pfx untuk pengesahan berasaskan sijil.
--certificatePassword, -cp	Kata laluan untuk sijil.
--tenant, -t	ID penyewa. Diperlukan untuk pengesahan prinsipal perkhidmatan.
--managedIdentity, -mi	Gunakan identiti terurus Azure.
--githubFederated, -ghf	Gunakan pengesahan federasi GitHub Actions.
--azureDevOpsFederated, -adof	Gunakan Azure DevOps federated authentication.
--clientid, -cid	ID klien aplikasi Microsoft Entra tersuai untuk digunakan menggantikan aplikasi CLI Dataverse lalai.
--no-default-environment	Jangan tetapkan persekitaran sebagai lalai.
--accept-cleartext-caching	Benarkan cache token teks biasa pada Linux.

auth create Contoh

Contoh berikut menunjukkan cara menggunakan arahan tersebut auth create .

Pengesahan interaktif

Arahan ini membuka dialog pelayar atau sistem untuk maklumat tambahan.

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

Profil bernama

Cipta profil dengan nama tertentu.

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

Aliran kod peranti

Gunakan aliran kod peranti untuk persekitaran tanpa pelayar.

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

Prinsipal perkhidmatan dengan rahsia klien

Gunakan prinsipal perkhidmatan apabila anda memerlukan pengesahan tanpa pengawasan, seperti dalam saluran CI/CD atau skrip automatik lain di mana log masuk interaktif tidak dibenarkan. Berikan ID aplikasi, rahsia klien, dan ID penyewa pendaftaran aplikasi yang mempunyai akses ke persekitaran.

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

ID klien aplikasi Entra tersuai

Gunakan pendaftaran aplikasi anda sendiri dan bukannya aplikasi lalai.

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

auth list Perintah

Senaraikan semua profil pengesahan. Tambah --json untuk output JSON mentah.

auth list Contoh

dataverse auth list
dataverse auth list --json

auth remove Perintah

Buang satu atau semua profil pengesahan.

auth remove parameter

Parameter_	Perihalan
--index, -i	Buang profil dengan indeks berasaskan 1 yang ditentukan, seperti yang ditunjukkan dalam auth list.
--name, -n	Buang profil dengan nama yang ditetapkan.
--all	Buang semua profil.

auth remove Contoh

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

auth select Perintah

Pilih profil pengesahan aktif. Jalankan arahan tanpa pilihan untuk menyenaraikan semua profil.

auth select parameter

Parameter_	Perihalan
--index, -i	Pilih profil mengikut indeks berasaskan 1, seperti yang ditunjukkan dalam auth list.
--name, -n	Pilih profil mengikut nama.

auth select Contoh

Buka pemilih interaktif. Gunakan kekunci anak panah, atau taip untuk menapis:

dataverse auth select

Pilih profil mengikut indeks atau nama:

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

auth who Perintah

Tunjukkan profil pengesahan semasa yang aktif. Tambah --json untuk output JSON mentah.

auth who Contoh

dataverse auth who
dataverse auth who --json

data associate Perintah

Kaitkan dua rekod melalui sifat navigasi (hubungan). Arahan ini disokong hanya untuk Dataverse.

data associate parameter

Parameter_	Perihalan
--table, -t	Nama set entiti bagi rekod utama. Diperlukan.
--id, -i	GUID rekod utama. Diperlukan.
--relationship, -rel	Nama sifat navigasi. Diperlukan.
--related	Nama set entiti bagi jadual berkaitan. Diperlukan.
--related-id	GUID rekod berkaitan. Diperlukan.
--environment, -env	Ganti URL persekitaran.
--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

Kira rekod dalam jadual, yang boleh ditapis.

data count parameter

Parameter_	Perihalan
--table, -t	Nama set entiti. Diperlukan kecuali anda menggunakan --fetchxml.
--filter, -f	Ekspresi OData $filter .
--fetchxml	Pertanyaan agregat FetchXML untuk kiraan kompleks.
--target	Laluan ke dataverse (lalai) atau persekitaran yang dipautkan erp .
--cross-company	ERP sahaja. Kira di semua syarikat. Lalai: syarikat lalai pengguna.
--environment, -env	Ganti URL persekitaran.
--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

Cipta rekod baru dalam jadual Dataverse. Tetapkan lajur carian menggunakan sintaks @odata.bind .

data create parameter

Parameter_	Perihalan
--table, -t	Nama set entiti. Diperlukan.
--data, -d	Objek JSON dengan nilai medan.
--data-file	Laluan ke fail JSON dengan data rekod.
--return, -r	Kembalikan rekod penuh yang dicipta.
--target	Laluan ke dataverse (lalai) atau persekitaran yang dipautkan erp .
--environment, -env	Ganti URL persekitaran.
--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>)"}'

Petua

Gunakan --data-file untuk JSON yang kompleks. Gunakan --return --json untuk mendapatkan rekod penuh yang dicipta.

data delete Perintah

Padamkan satu rekod dengan kunci utama atau kunci alternatif.

data delete parameter

Parameter_	Perihalan
--table, -t	Nama set entiti. Diperlukan.
--id, -i	GUID rekod.
--key, -k	Kunci alternatif.
--no-confirm	Langkau prompt pengesahan.
--target	Laluan ke dataverse (lalai) atau persekitaran yang dipautkan erp .
--environment, -env	Ganti URL persekitaran.
--json	Output JSON mentah.

data delete Contoh

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

data describe Perintah

Terangkan skema entiti OData. Untuk Dataverse, arahan memanggil EntityDefinitions(LogicalName='<table>') dengan $expand didorong oleh --include, ditambah panggilan kedua kepada customapis apabila --include actions ditetapkan. Tindakan terbina dalam Dataverse seperti dan AssignSetState tidak disenaraikan. Untuk ERP, satu panggilan ke mengembalikan /Metadata/PublicEntities sifat, tindakan terikat, dan navigasi bersama-sama.

data describe parameter

Parameter_	Perihalan
--target	Sasaran: dataverse (lalai) atau erp.
--table, -t	Diperlukan. Untuk Dataverse, nama logik, seperti account. Untuk ERP, nama set entiti, seperti BatchJobs.
--include	Senarai bahagian yang dipisahkan koma untuk merangkumi: entity, , relationsproperties, actions, atau all. Nama samaran: attributes=properties, . relationships=relations Lalai untuk ERP: all. Lalai 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

Buang hubungan antara dua rekod. Arahan ini disokong hanya untuk Dataverse.

data disassociate parameter

Parameter_	Perihalan
--table, -t	Nama set entiti bagi rekod utama. Diperlukan.
--id, -i	GUID rekod utama. Diperlukan.
--relationship, -rel	Nama sifat navigasi. Diperlukan.
--related-id	GUID rekod berkaitan, untuk hubungan banyak-ke-banyak. Abaikan parameter ini untuk membersihkan carian.
--environment, -env	Ganti URL persekitaran.
--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

Dapatkan satu rekod berdasarkan ID (kunci utama) atau dengan kunci alternatif.

data get parameter

Parameter_	Perihalan
--table, -t	Nama set entiti. Diperlukan.
--id, -i	Rekod GUID (kunci utama).
--key, -k	Kunci alternatif, contohnya "col='val'".
--select, -s	Senarai lajur yang dipisahkan dengan koma ($select).
--expand, -x	Ungkapan OData $expand untuk rekod berkaitan.
--target	Laluan ke dataverse (lalai) atau persekitaran yang dipautkan erp .
--environment, -env	Ganti URL persekitaran.
--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

Laksanakan pertanyaan OData, FetchXML, atau SQL terhadap jadual Dataverse.

data query parameter

Parameter_	Perihalan
--table, -t	Entiti menetapkan nama kepada pertanyaan. Diperlukan untuk pertanyaan OData.
--select, -s	Senarai lajur yang dipisahkan dengan koma ($select).
--filter, -f	Ekspresi OData $filter .
--orderby, -o	Ekspresi OData $orderby .
--top	Bilangan maksimum rekod yang perlu dikembalikan (1-5000).
--expand, -x	Ungkapan OData $expand untuk rekod berkaitan.
--fetchxml	Pertanyaan FetchXML dalam talian.
--fetchxml-file	Laluan ke fail yang mengandungi pertanyaan FetchXML.
--sql	Pertanyaan SQL SELECT (pratonton).
--sql-file	Laluan ke fail yang mengandungi pertanyaan SQL.
--all, -a	Ikuti penpaginahan untuk mendapatkan semua rekod.
--max-records	Bilangan maksimum rekod yang perlu diambil apabila menggunakan --all. Lalai: 100000.
--target	Laluan ke dataverse (lalai) atau persekitaran yang dipautkan erp .
--cross-company	ERP sahaja. Pertanyaan merentasi semua syarikat. Lalai: syarikat lalai pengguna.
--environment, -env	Ganti URL persekitaran.
--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

Ketahui lebih lanjut

• Gunakan OData untuk membuat pertanyaan data
• Pertanyaan Data Menggunakan FetchXML dalam Dataverse
• Gunakan SQL untuk membuat pertanyaan data menggunakan Dataverse Web API

data update Perintah

Kemas kini satu atau lebih medan pada rekod sedia ada, dikenal pasti melalui ID atau kunci alternatif. Tetapkan lajur carian menggunakan sintaks @odata.bind .

data update parameter

Parameter_	Perihalan
--table, -t	Nama set entiti. Diperlukan.
--id, -i	GUID rekod.
--key, -k	Kunci alternatif.
--data, -d	Objek JSON dengan medan untuk dikemas kini.
--data-file	Laluan ke fail JSON dengan data kemas kini.
--return, -r	Pulangkan rekod penuh yang dikemas kini.
--target	Laluan ke dataverse (lalai) atau persekitaran yang dipautkan erp .
--environment, -env	Ganti URL persekitaran.
--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

Muat naik fail tempatan ke dalam lajur fail Dataverse pada rekod sedia ada. Arahan ini secara automatik memilih satu permintaan atau muat naik berpecah berdasarkan saiz fail, kecuali anda menetapkan --mode. Dalam mod auto, fail di bawah 128 MB dimuat naik dalam satu permintaan, dan fail yang lebih besar menggunakan muat naik berpotongan. Apabila anda mengabaikan --mime-type, arahan tersebut menyimpulkan jenis MIME daripada sambungan fail. Sambungan tidak dikenali secara lalai kepada application/octet-stream.

data upload parameter

Parameter_	Perihalan
--table, -t	Skema jadual atau nama logik, seperti account. Diperlukan. Arahan ini menyelesaikan set entiti daripada metadata.
--id, -i	GUID rekod. Diperlukan.
--column, -c	Nama atribut lajur fail. Diperlukan.
--file, -f	Laluan ke fail tempatan. Diperlukan.
--mode, -m	Strategi muat naik: auto (lalai), small, atau chunk.
--mime-type	Jenis MIME yang eksplisit. Lalai: disimpulkan daripada sambungan fail.
--overwrite	Timpa semula fail sedia ada. Secara lalai, arahan gagal jika lajur tidak kosong.
--environment, -env	Ganti URL persekitaran.
--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

Cipta rekod jika ia tidak wujud, atau kemas kini jika ada. Rekod ini dikenal pasti dengan kunci alternatif. Belajar menggunakan kunci alternatif untuk merujuk rekod

data upsert parameter

Parameter_	Perihalan
--table, -t	Nama set entiti. Diperlukan.
--key, -k	Kunci alternatif. Diperlukan.
--data, -d	Objek JSON dengan nilai medan.
--data-file	Laluan ke fail JSON.
--update-only	Gagal jika rekod tidak wujud (If-Match: *).
--create-only	Gagal jika rekod sudah wujud (If-None-Match: *).
--return, -r	Kembalikan rekod penuh selepas pembedahan.
--target	Laluan ke dataverse (lalai) atau persekitaran yang dipautkan erp .
--environment, -env	Ganti URL persekitaran.
--json	Output JSON mentah.

data upsert Contoh

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

erp batch cancel Perintah

Batalkan kerja batch Kewangan dan Operasi dengan RecId. Gunakan erp batch list untuk mencari .RecId

erp batch cancel Contoh

dataverse erp batch cancel <recid>

erp batch list Perintah

Senaraikan tugasan kelompok pada instans Kewangan dan Operasi yang dipautkan ke persekitaran Dataverse anda. Arahan ini memerlukan profil pengesahan yang disambungkan ke persekitaran Dataverse yang mempunyai instans Kewangan dan Operasi yang dipautkan. URL Kewangan dan Operasi diperoleh secara automatik daripada sambungan Dataverse semasa.

erp batch list parameter

Parameter_	Perihalan
--company	Tapis mengikut entiti undang-undang (dataAreaId), seperti USMF.
--status	Tapis mengikut status: Waiting, Executing, Finished, Error, atau Cancelled.
--top	Jumlah maksimum hasil yang perlu dikembalikan. Lalai: 20.
--caption	Tapis mengikut kapsyen (padanan substring yang tidak sensitif 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

Pasang versi khusus Dataverse CLI, atau kemas kini ke versi terkini. Arahan mengesan sama ada anda memasang CLI secara global atau sedang menggunakan npx dan memasang dengan sewajarnya.

install Contoh

Pasang versi terkini:

dataverse install latest

Pasang versi tertentu:

dataverse install 1.0.0

mcp Perintah

Memulakan pelayan Model Context Protocol (MCP) yang bersambung ke persekitaran anda, supaya pembantu AI seperti Claude Desktop boleh berinteraksi dengan data anda. Sasaran dikesan secara automatik dari URL: URL Dataverse memulakan pelayan MCP Dataverse, dan URL Kewangan dan Operasi, seperti https://myorg.operations.dynamics.com, memulakan pelayan MCP ERP.

mcp sintaks

dataverse mcp <orgUrl> [options]

Hujahnya <orgUrl> ialah URL organisasi anda, contohnya https://myorg.crm.dynamics.com.

mcp parameter

Parameter_	Perihalan
--validate	Sahkan titik akhir MCP dan tetapan pengesahan tanpa memulakan pelayan.
--log-level	Tetapkan tahap pencatatan: Trace, Debug, , WarningInformation, Error, atau Critical. Lalai: Warning.
--log-file	Log masuk ke fail dalam direktori sementara.
--preview	Gunakan titik akhir MCP pratonton (api/mcp_preview menggantikan api/mcp). Tidak disokong untuk ERP.

mcp Contoh

Sahkan persediaan (langkah pertama yang disyorkan):

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

Mulakan pelayan dengan menggunakan stdio transport:

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

Gunakan titik akhir pratonton, atau aktifkan log fail 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 aplikasi Microsoft Entra berada dalam senarai klien yang dibenarkan MCP Dataverse untuk persekitaran profil semasa. Arahan ini adalah alternatif kepada langkah pentadbir manual yang diterangkan dalam prasyarat. Pengguna yang disahkan mesti mempunyai kebenaran pentadbir Dataverse pada persekitaran sasaran.

mcp allow sintaks

dataverse mcp allow <appId> [options]

Hujahnya <appId> ialah ID aplikasi (klien) yang akan dibenarkan, sebagai GUID.

mcp allow parameter

Parameter_	Perihalan
--erp	Benarkan aplikasi pada instans Kewangan dan Operasi yang dipautkan dan bukannya Dataverse.

mcp allow Contoh

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

Nota

Finance and Operations menyimpan senarai kebenaran dalam AOS, jadi ID aplikasi yang baru dibenarkan boleh mengambil masa sehingga kira-kira lima minit untuk berkuat kuasa.

org list Perintah

Senaraikan semua persekitaran yang boleh anda akses.

org list parameter

Parameter_	Perihalan
--filter	Tapis senarai persekitaran mengikut istilah carian.
--json	Output JSON mentah.

org list Contoh

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

org who Perintah

Tunjukkan maklumat tentang organisasi dan pengguna semasa, menggunakan profil pengesahan aktif. Arahan ini env adalah alias untuk org.

org who parameter

Parameter_	Perihalan
--environment, -env	Ganti URL persekitaran.
--json	Output JSON mentah.

org who Contoh

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

skill arahan

Urus kemahiran Dataverse—set arahan boleh guna semula (fail SKILL.md dan fail sumbernya) yang digunakan oleh ejen AI—yang disimpan dalam persekitaran yang bersambung. Arahan peringkat skill atas menyediakan operasi cipta, baca, kemas kini, dan padam terhadap persekitaran. Secara tempatan, kemahiran disimpan di bawah .claude/skills/<name>/.

Nota

Arahan pengarang dan penilaian kemahiran, seperti make, update, get, dan eval, adalah berasingan daripada arahan ini. Untuk maklumat lanjut, jalankan dataverse workspace skill --help.

skill delete Perintah

Padamkan kemahiran dan semua sumbernya dari persekitaran Dataverse yang aktif. Gunakan skill list untuk mencari nama unik kemahiran.

dataverse skill delete new_lead-qualification

skill download Perintah

Muat turun satu atau lebih kemahiran dari persekitaran Dataverse aktif ke cakera. Arahan ini memuat SKILL.md turun fail dan semua fail sumber, mengekalkan struktur direktori. Gunakan skill list untuk mencari nama unik kemahiran.

Parameter_	Perihalan
--all	Muat turun semua kemahiran aktif dari persekitaran. Tidak boleh digabungkan dengan nama unik kemahiran.
--output, -o	Direktori asas untuk output. Lalai: .claude/skills/. Dengan --all, setiap kemahiran ditulis kepada <path>/<name>/.
--json	Keluarkan kandungan kemahiran sebagai JSON tanpa menulis fail. Secara pilihan, tentukan laluan fail untuk ditulis.

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

skill list Perintah

Senaraikan semua kemahiran aktif dalam persekitaran Dataverse yang bersambung.

Parameter_	Perihalan
--resources, -r	Juga senaraikan fail sumber untuk setiap kemahiran.
--json	Output sebagai JSON. Secara pilihan, tentukan laluan fail untuk ditulis.

dataverse skill list
dataverse skill list --resources

skill upload Perintah

Muat naik satu atau lebih kemahiran dari cakera ke persekitaran Dataverse yang aktif. Arahan ini menyokong direktori, fail .zip , fail .skill , dan fail .md .

Anda boleh menghantar kemahiran <name>, yang menyelesaikan kepada .claude/skills/<name>/, atau explicit <path> ke direktori atau fail.

Parameter_	Perihalan
--all	Muat naik semua kemahiran di bawah .claude/skills/. Tidak boleh digabungkan dengan nama atau laluan kemahiran.
--json	Keluarkan hasil sebagai JSON. Secara pilihan, tentukan laluan fail untuk ditulis.

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

Lihat juga

Bekerja dengan data menggunakan Dataverse CLI