Dataverse CLI başvurusu (önizleme)

Note

Bu bir önizleme özelliğidir.
Önizleme özellikleri, üretimde kullanıma yönelik değildir ve sınırlı işlevselliğe sahip olabilir. Bu özellikler, müşterilerin erken erişim elde etmesi ve geri bildirim sağlaması amacıyla resmi sürümden önce kullanıma sunulur.

Bu makalede Dataverse CLI'da kullanılabilen komutlar açıklanmaktadır. Her komut kullanımını, seçeneklerini ve örneklerini listeleyen bir --help seçeneği destekler. Veri döndüren komutlar, betiklerde yararlı olan ham JSON çıkışı seçeneğini destekler --json .

Aşağıdaki genel seçenekler herhangi bir komutla kullanılabilir:

Option	Description
`--log-level <level>`	Günlük düzeyini ayarlayın: `Trace`, `Debug`, `Information`, `Warning`, `Error`, veya `Critical`. Varsayılan: `Warning`.
`--log-file`	Konsolu yerine geçici dizindeki bir dosyaya oturum açın.
`--context <value>`	User-Agent'a eklenen işlem bağlamı. Ortam değişkenini `DATAVERSE_OPERATION_CONTEXT` de ayarlayabilirsiniz.

Command	Description
`api describe`	API'yi açıklama
`api invoke`	Api'yi ada göre çağırma
`api list`	Bulunabilir API'leri listeleme
`api request`	Kimliği doğrulanmış http isteği gönderme
`auth create`	Yeni kimlik doğrulama profili oluşturma
`auth list`	Tüm kimlik doğrulama profillerini listeleme
`auth remove`	Kimlik doğrulama profilini kaldırma
`auth select`	Etkin kimlik doğrulama profilini seçme
`auth who`	Geçerli kimlik doğrulama profilini gösterme
`data associate`	İlişki aracılığıyla iki kaydı bağlama
`data count`	Tablodaki kayıtları sayma
`data create`	Yeni bir kayıt oluştur
`data delete`	Kayıt silme
`data describe`	Varlığın şemasını açıklama
`data disassociate`	İki kayıt arasındaki ilişkiyi kaldırma
`data get`	Kimlik veya alternatif anahtara göre tek bir kayıt alma
`data query`	OData, FetchXML veya SQL sorgusu yürütme
`data update`	Var olan kaydı güncelleştir
`data upload`	Var olan bir kayıtta dosya sütununa dosya yükleme
`data upsert`	Alternatif anahtarla kayıt oluşturma veya güncelleştirme
`erp batch cancel`	Finans ve İşlemler toplu işlemini iptal etme
`erp batch list`	Finans ve İşlemler toplu işlerini listeleme
`install`	Belirli bir sürümü yükleme veya en son sürüme güncelleştirme
`mcp`	Dataverse veya ERP için MCP sunucusunu başlatma
`mcp allow`	Uygulamaya MCP istemcisi olarak izin verme
`org list`	Tüm erişilebilir ortamları listeleme
`org who`	Geçerli kuruluş ve kullanıcı bilgilerini göster
`skill delete`	Dataverse'den beceri silme
`skill download`	Dataverse'den beceri indirme
`skill list`	Ortamdaki etkin becerileri listeleme
`skill upload`	Dataverse'e beceri yükleme

Note

Birçok komut, işlemi Dataverse'e (varsayılan) veya bağlı Finans ve İşlemler (ERP) ortamına yönlendiren bir --target <dataverse\|erp> seçeneği destekler. Bir ortama bağlanan komutlar, geçerli profilin ortam URL'sini geçersiz kılmak için bir --environment <url> (-env) seçeneğini destekler.

`api describe` komut

Tek bir API'nin meta verilerini gösterin. Dataverse özel API'leri için çıktı, meta veriler tarafından sağlandığında istek parametresi ve yanıt özelliği açıklamalarını içerir.

Dataverse adları varsayılan olarak ön eklenmemiş durumdadır. BIÇIMINDE erp:ServiceGroup/Service/OperationERP nitelikli adlar kullanabilirsiniz.

`api describe` Parametreler

Parameter	Description
`--target`	veya `erp`ile nitelenmemiş bir adı `dataverse` çözümleyin.
`--service-group`	Yalnızca ERP. İşlem aramasını bir hizmet grubuna daraltın.
`--service`	Yalnızca ERP. İşlem aramasını tek bir hizmete daraltın.
`--environment`	Dataverse ortam URL'sini geçersiz kılın.
`--json`	Çıkış ham JSON.

`api describe` örnekleri

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

`api invoke` komut

Bulunan API'leri ada göre çağır. Parametreler için söz dizimlerini kullanın name=value . Bir değer boşluk içeriyorsa belirtecin tamamını tırnak içine alın. Bazı Dataverse API'leri, içeriği kendileri JSON olan bir dize parametresini kabul eder. Bu durumda, kabuğunuzun normal alıntı ve kaçış kurallarını kullanarak JSON metnini değer olarak geçirin.

Varsayılan olarak, JSON yanıtları çıkış özelliği adlarını tutan kolay bir metin biçiminde işlenir. Ham JSON yükünü korumak için kullanın --json .

`api invoke` Parametreler

Parameter	Description
`--target`	veya `erp`ile nitelenmemiş bir adı `dataverse` çözümleyin.
`--service-group`	Yalnızca ERP. İşlem aramasını bir hizmet grubuna daraltın.
`--service`	Yalnızca ERP. İşlem aramasını tek bir hizmete daraltın.
`--param`	Forma adlandırılmış parametre `name=value` ekleyin. Tekrarlanabilir.
`--bind`	Varlığa bağlı Dataverse API'leri için bağlama yolu.
`--method`, `-X`	Çıkarsanan HTTP yöntemini geçersiz kılın.
`--body`	Adlandırılmış parametreler yerine ham bir JSON gövdesi kullanın.
`--body-file`	Bir dosyadan ham JSON gövdesini okuyun.
`--header`, `-H`	Formda bir HTTP üst bilgisi `key:value` ekleyin.
`--include`, `-i`	Yanıt durumunu ve üst bilgileri ekleyin.
`--environment`	Dataverse ortam URL'sini geçersiz kılın.
`--json`	Kolay metin yerine ham JSON çıktısı.

`api invoke` örnekleri

Dataverse işlevini çağırın. Bu örnekte Dynamics 365 Contact Center CCaaS_GetPresence işlevinin kullanımı gösterilmektedir.

dataverse api invoke CCaaS_GetPresence ApiVersion=1.0

Parametre değerinde boşluklarla Dataverse AISummarize eylemini çağırın:

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

Erp özel hizmetini çağırma:

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

`api list` komut

Dataverse özel API'leri ve ERP çağrılabilen hizmet uç noktaları gibi bulunabilir API'leri listeleyin. Sonuçlar kullanılabilir olduğunda API kimliğini, kolay adı, türünü ve açıklamasını gösterir. Sonuçları filtrelemek için isteğe bağlı bir sorgu terimi geçirebilirsiniz.

`api list` Parametreler

Parameter	Description
`--target`	Aranacak hedef sistem: `dataverse` (varsayılan) veya `erp`.
`--service-group`	Yalnızca ERP. Tek bir hizmet grubuna göre filtreleyin.
`--service`	Yalnızca ERP. Tek bir hizmete göre filtreleyin.
`--limit`	Döndürülecek en fazla API sayısı. Varsayılan: `50`.
`--page`	Sonuçlar arasında sayfalama yaparken 1 tabanlı sayfa numarası. Varsayılan: `1`.
`--environment`	Dataverse ortam URL'sini geçersiz kılın.
`--json`	Çıkış ham JSON.

`api list` örnekleri

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

Dataverse veya ERP'ye ham kimliği doğrulanmış bir HTTP isteği gönderin. Yol, yöntem, üst bilgiler ve gövde üzerinde tam denetime ihtiyacınız olduğunda bu komutu kullanın.

`api request` Parametreler

Parameter	Description
`--target`	Hedef sistem: `dataverse` veya `erp`. Gerekli.
`--path`	İstek yolu. Gerekli.
`--method`, `-X`	HTTP yöntemi. Varsayılan: `GET`veya `POST` bir gövde sağlandığında.
`--body`	Satır içi JSON istek gövdesi.
`--body-file`	JSON nesne isteği gövdesini içeren bir dosya.
`--header`, `-H`	Formda bir HTTP üst bilgisi `key:value` ekleyin.
`--include`, `-i`	Yanıt durumunu ve üst bilgileri ekleyin.
`--environment`	Dataverse ortam URL'sini geçersiz kılın.

`api request` örnekleri

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

Yeni bir kimlik doğrulama profili oluşturun.

`auth create` Parametreler

Komutun davranışını auth create belirtmek için bu parametreleri kullanın.

Parameter	Description
`--environment`, `-env`	Kimlik doğrulaması yapmak istediğiniz Dataverse ortamının URL'si.
`--name`, `-n`	Profil için isteğe bağlı bir ad. Profili daha sonra seçmek için adı kullanın.
`--cloud`, `-ci`	Hedef bulut: `Public`, `UsGov`, `UsGovHigh`, `UsGovDod`veya `China`.
`--deviceCode`, `-dc`	Tarayıcı olmayan ortamlar için cihaz kodu kimlik doğrulama akışını kullanın.
`--username`, `-un`	Kullanıcı adı ve parola kimlik doğrulaması için kullanıcı adı.
`--password`, `-p`	Kullanıcı adı ve parola kimlik doğrulaması için parola.
`--applicationId`, `-id`	Hizmet sorumlusu (SPN) kimlik doğrulaması için uygulama (istemci) kimliği.
`--clientSecret`, `-cs`	Hizmet sorumlusu kimlik doğrulaması için istemci gizli dizisi.
`--certificateDiskPath`, `-cdp`	Sertifika tabanlı kimlik doğrulaması için .pfx sertifika dosyasının yolu.
`--certificatePassword`, `-cp`	Sertifikanın parolası.
`--tenant`, `-t`	Kiracı kimliği. Hizmet sorumlusu kimlik doğrulaması için gereklidir.
`--managedIdentity`, `-mi`	yönetilen Azure bir kimlik kullanın.
`--githubFederated`, `-ghf`	Federasyon kimlik doğrulaması GitHub Actions kullanın.
`--azureDevOpsFederated`, `-adof`	Federasyon kimlik doğrulaması Azure DevOps kullanın.
`--clientid`, `-cid`	Varsayılan Dataverse CLI uygulaması yerine kullanılacak özel bir Microsoft Entra uygulaması istemci kimliği.
`--no-default-environment`	Ortamı varsayılan olarak ayarlamayın.
`--accept-cleartext-caching`	Linux'ta düz metin belirteci önbelleğine izin verin.

`auth create` örnekleri

Aşağıdaki örneklerde komutun nasıl kullanılacağı gösterilmektedir auth create .

Etkileşimli kimlik doğrulaması

Bu komut, ek bilgi için bir tarayıcı veya sistem iletişim kutusu açar.

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

Adlandırılmış profil

Belirli bir ada sahip bir profil oluşturun.

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

Cihaz kodu akışı

Tarayıcı olmayan ortamlar için cihaz kodu akışını kullanın.

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

İstemci sırrı ile hizmet asıl

Ci/CD işlem hattı veya etkileşimli oturum açmanın mümkün olmadığı başka bir otomatik betik gibi katılımsız kimlik doğrulamasına ihtiyacınız olduğunda hizmet sorumlusu kullanın. Ortama erişimi olan bir uygulama kaydının uygulama kimliğini, istemci gizli dizisini ve kiracı kimliğini sağlayın.

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

Özel Entra uygulaması istemci kimliği

Varsayılan yerine kendi uygulama kaydınızı kullanın.

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

`auth list` komut

Tüm kimlik doğrulama profillerini listeleyin. Ham JSON çıkışı için ekleyin --json .

`auth list` örnekleri

dataverse auth list
dataverse auth list --json

`auth remove` komut

Kimlik doğrulama profillerinden birini veya tümünü kaldırın.

`auth remove` Parametreler

Parameter	Description
`--index`, `-i`	içinde gösterildiği `auth list`gibi belirtilen 1 tabanlı dizine sahip profili kaldırın.
`--name`, `-n`	Belirtilen ada sahip profili kaldırın.
`--all`	Tüm profilleri kaldırın.

`auth remove` örnekleri

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

`auth select` komut

Etkin kimlik doğrulama profilini seçin. Tüm profilleri listeleme seçenekleri olmadan komutunu çalıştırın.

`auth select` Parametreler

Parameter	Description
`--index`, `-i`	profilinde gösterildiği gibi 1 tabanlı dizinine `auth list`göre seçin.
`--name`, `-n`	Profili ada göre seçin.

`auth select` örnekleri

Etkileşimli bir seçici açın. Ok tuşlarını kullanın veya filtrelemek için yazın:

dataverse auth select

Dizine veya ada göre bir profil seçin:

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

`auth who` komut

Geçerli, etkin kimlik doğrulama profilini gösterin. Ham JSON çıkışı için ekleyin --json .

`auth who` örnekleri

dataverse auth who
dataverse auth who --json

`data associate` komut

Bir gezinti özelliği (ilişki) aracılığıyla iki kaydı ilişkilendirin. Bu komut yalnızca Dataverse için desteklenir.

`data associate` Parametreler

Parameter	Description
`--table`, `-t`	Birincil kaydın varlık kümesi adı. Gerekli.
`--id`, `-i`	Birincil kaydın GUID değeri. Gerekli.
`--relationship`, `-rel`	Gezinti özelliği adı. Gerekli.
`--related`	İlgili tablonun varlık kümesi adı. Gerekli.
`--related-id`	İlgili kaydın GUID değeri. Gerekli.
`--environment`, `-env`	Ortam URL'sini geçersiz kılın.
`--json`	Çıkış ham JSON.

`data associate` örnekleri

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

`data count` komut

İsteğe bağlı olarak filtrelenmiş bir tablodaki kayıtları sayma.

`data count` Parametreler

Parameter	Description
`--table`, `-t`	Varlık kümesi adı. kullanmadığınız `--fetchxml`sürece gereklidir.
`--filter`, `-f`	OData `$filter` ifadesi.
`--fetchxml`	Karmaşık sayılar için FetchXML toplama sorgusu.
`--target`	`dataverse` (varsayılan) veya bağlı `erp` ortama yönlendirin.
`--cross-company`	Yalnızca ERP. Tüm şirketler genelinde sayma. Varsayılan: kullanıcının varsayılan şirketi.
`--environment`, `-env`	Ortam URL'sini geçersiz kılın.
`--json`	Çıkış ham JSON.

`data count` örnekleri

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

`data create` komut

Dataverse tablosunda yeni bir kayıt oluşturun. Söz dizimini kullanarak @odata.bind arama sütunlarını ayarlayın.

`data create` Parametreler

Parameter	Description
`--table`, `-t`	Varlık kümesi adı. Gerekli.
`--data`, `-d`	Alan değerlerine sahip bir JSON nesnesi.
`--data-file`	Kayıt verilerini içeren bir JSON dosyasının yolu.
`--return`, `-r`	Oluşturulan kaydın tamamını döndürür.
`--target`	`dataverse` (varsayılan) veya bağlı `erp` ortama yönlendirin.
`--environment`, `-env`	Ortam URL'sini geçersiz kılın.
`--json`	Çıkış ham JSON.

`data create` örnekleri

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

Tip

Karmaşık JSON için kullanın --data-file . Oluşturulan kaydın tamamını almak için kullanın --return --json .

`data delete` komut

Tek bir kaydı birincil anahtarıyla veya alternatif bir anahtarla silin.

`data delete` Parametreler

Parameter	Description
`--table`, `-t`	Varlık kümesi adı. Gerekli.
`--id`, `-i`	Kayıt GUID'i.
`--key`, `-k`	Alternatif bir anahtar.
`--no-confirm`	Onay istemini atlayın.
`--target`	`dataverse` (varsayılan) veya bağlı `erp` ortama yönlendirin.
`--environment`, `-env`	Ortam URL'sini geçersiz kılın.
`--json`	Çıkış ham JSON.

`data delete` örnekleri

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

`data describe` komut

OData varlığının şemasını açıklama. Dataverse için komutu, tarafından çalıştırılan --includeile ve ayarlandığı zaman --include actions için customapis ikinci bir çağrıyla $expand birlikte öğesini çağırırEntityDefinitions(LogicalName='<table>'). ve gibi AssignSetState yerleşik Dataverse eylemleri numaralandırılamaz. ERP için tek bir çağrı /Metadata/PublicEntities özellikleri, ilişkili eylemleri ve gezintileri birlikte döndürür.

`data describe` Parametreler

Parameter	Description
`--target`	Hedef: `dataverse` (varsayılan) veya `erp`.
`--table`, `-t`	Gerekli. Dataverse için, gibi `account`mantıksal ad. ERP için varlık kümesi adı, örneğin `BatchJobs`.
`--include`	Eklenecek bölümlerin virgülle ayrılmış listesi: `entity`, `properties`, `relations`, `actions`veya `all`. Diğer adlar: `attributes`=`properties`, . `relationships`=`relations` ERP için varsayılan: `all`. Dataverse için varsayılan: `entity,properties`.
`--json`	Çıkış ham JSON.

`data describe` örnekleri

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

`data disassociate` komut

İki kayıt arasındaki ilişkiyi kaldırın. Bu komut yalnızca Dataverse için desteklenir.

`data disassociate` Parametreler

Parameter	Description
`--table`, `-t`	Birincil kaydın varlık kümesi adı. Gerekli.
`--id`, `-i`	Birincil kaydın GUID değeri. Gerekli.
`--relationship`, `-rel`	Gezinti özelliği adı. Gerekli.
`--related-id`	Çoka çok ilişkisi için ilgili kaydın GUID değeri. Aramayı temizlemek için bu parametreyi atla.
`--environment`, `-env`	Ortam URL'sini geçersiz kılın.
`--json`	Çıkış ham JSON.

`data disassociate` örnekleri

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

`data get` komut

Tek bir kaydı kimliğine (birincil anahtar) veya alternatif bir anahtara göre alın.

`data get` Parametreler

Parameter	Description
`--table`, `-t`	Varlık kümesi adı. Gerekli.
`--id`, `-i`	Kayıt GUID'i (birincil anahtar).
`--key`, `-k`	Alternatif bir anahtar, örneğin `"col='val'"`.
`--select`, `-s`	Virgülle ayrılmış sütun listesi (`$select`).
`--expand`, `-x`	İlgili kayıtlar için bir OData `$expand` ifadesi.
`--target`	`dataverse` (varsayılan) veya bağlı `erp` ortama yönlendirin.
`--environment`, `-env`	Ortam URL'sini geçersiz kılın.
`--json`	Çıkış ham JSON.

`data get` örnekleri

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

Dataverse tablosunda OData, FetchXML veya SQL sorgusu yürütür.

`data query` Parametreler

Parameter	Description
`--table`, `-t`	Sorgu için varlık kümesi adı. OData sorguları için gereklidir.
`--select`, `-s`	Virgülle ayrılmış sütun listesi (`$select`).
`--filter`, `-f`	OData `$filter` ifadesi.
`--orderby`, `-o`	OData `$orderby` ifadesi.
`--top`	Döndürülecek en fazla kayıt sayısı (1-5000).
`--expand`, `-x`	İlgili kayıtlar için bir OData `$expand` ifadesi.
`--fetchxml`	Satır içi FetchXML sorgusu.
`--fetchxml-file`	FetchXML sorgusu içeren dosyanın yolu.
`--sql`	SQL `SELECT` sorgusu (önizleme).
`--sql-file`	SQL sorgusu içeren bir dosyanın yolu.
`--all`, `-a`	Tüm kayıtları almak için sayfalandırmayı izleyin.
`--max-records`	kullanılırken `--all`alınacak en fazla kayıt sayısı. Varsayılan: `100000`.
`--target`	`dataverse` (varsayılan) veya bağlı `erp` ortama yönlendirin.
`--cross-company`	Yalnızca ERP. Tüm şirketler arasında sorgulama. Varsayılan: kullanıcının varsayılan şirketi.
`--environment`, `-env`	Ortam URL'sini geçersiz kılın.
`--json`	Çıkış ham JSON.

`data query` örnekleri

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

Daha fazla bilgi edinin

`data update` komut

Var olan bir kayıtta kimliğiyle veya alternatif bir anahtarla tanımlanan bir veya daha fazla alanı güncelleştirin. Söz dizimini kullanarak @odata.bind arama sütunlarını ayarlayın.

`data update` Parametreler

Parameter	Description
`--table`, `-t`	Varlık kümesi adı. Gerekli.
`--id`, `-i`	Kayıt GUID'i.
`--key`, `-k`	Alternatif bir anahtar.
`--data`, `-d`	Güncelleştirilecek alanları içeren bir JSON nesnesi.
`--data-file`	Güncelleştirme verilerini içeren bir JSON dosyasının yolu.
`--return`, `-r`	Güncelleştirilmiş kaydın tamamını döndürür.
`--target`	`dataverse` (varsayılan) veya bağlı `erp` ortama yönlendirin.
`--environment`, `-env`	Ortam URL'sini geçersiz kılın.
`--json`	Çıkış ham JSON.

`data update` örnekleri

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

`data upload` komut

Var olan bir kayıtta dataverse dosya sütununa yerel bir dosya yükleyin. komutu, siz belirtmediğiniz --modesürece dosya boyutuna göre otomatik olarak tek istekli veya öbekli bir karşıya yükleme seçer. Otomatik modda, 128 MB'ın altındaki dosyalar tek bir istekte karşıya yüklenir ve daha büyük dosyalar öbekli karşıya yükleme kullanır. atladığınızda --mime-type, komut dosya uzantısından MIME türünü çıkartır. Bilinmeyen uzantılar varsayılan olarak olarak application/octet-streambelirlenir.

`data upload` Parametreler

Parameter	Description
`--table`, `-t`	Tablo şeması veya gibi mantıksal ad `account`. Gerekli. komutu meta verilerden varlık kümesini çözümler.
`--id`, `-i`	Kayıt GUID'i. Gerekli.
`--column`, `-c`	Dosya sütunu öznitelik adı. Gerekli.
`--file`, `-f`	Yerel dosyanın yolu. Gerekli.
`--mode`, `-m`	Karşıya yükleme stratejisi: `auto` (varsayılan), `small`veya `chunk`.
`--mime-type`	Açık bir MIME türü. Varsayılan: dosya uzantısından çıkarılır.
`--overwrite`	Var olan bir dosyanın üzerine yaz. Varsayılan olarak, sütun boş değilse komut başarısız olur.
`--environment`, `-env`	Ortam URL'sini geçersiz kılın.
`--json`	Çıkış ham JSON.

`data upload` örnekleri

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

Yoksa bir kayıt oluşturun veya varsa güncelleştirin. Kayıt, alternatif bir anahtarla tanımlanır. Kayda başvurmak için alternatif anahtar kullanmayı öğrenin

`data upsert` Parametreler

Parameter	Description
`--table`, `-t`	Varlık kümesi adı. Gerekli.
`--key`, `-k`	Alternatif bir anahtar. Gerekli.
`--data`, `-d`	Alan değerlerine sahip bir JSON nesnesi.
`--data-file`	JSON dosyasının yolu.
`--update-only`	Kayıt yoksa başarısız olur (`If-Match: *`).
`--create-only`	Kayıt zaten varsa (`If-None-Match: *` başarısız olur).
`--return`, `-r`	İşlemden sonra tam kaydı döndürür.
`--target`	`dataverse` (varsayılan) veya bağlı `erp` ortama yönlendirin.
`--environment`, `-env`	Ortam URL'sini geçersiz kılın.
`--json`	Çıkış ham JSON.

`data upsert` örnekleri

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

`erp batch cancel` komut

Bir Finans ve İşlemler toplu işini tarafından iptal etme RecId. öğesini bulmak RecIdiçin kullanınerp batch list.

`erp batch cancel` örnekleri

dataverse erp batch cancel <recid>

`erp batch list` komut

Dataverse ortamınıza bağlı Finance and Operations örneğinde toplu işleri listeleyin. komutu, bağlı finans ve operasyon örneğine sahip dataverse ortamına bağlı bir kimlik doğrulama profili gerektirir. Finans ve İşlemler URL'si, geçerli Dataverse bağlantısından otomatik olarak türetilir.

`erp batch list` Parametreler

Parameter	Description
`--company`	Gibi `USMF`tüzel kişiliğe (`dataAreaId` ) göre filtreleyin.
`--status`	Duruma göre filtrele: `Waiting`, `Executing`, `Finished`, `Error`veya `Cancelled`.
`--top`	Döndürülecek en fazla sonuç sayısı. Varsayılan: `20`.
`--caption`	Resim yazısına göre filtreleme (büyük/küçük harfe duyarlı olmayan alt dize eşleşmesi).
`--json`	Çıkış ham JSON.

`erp batch list` örnekleri

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

`install` komut

Dataverse CLI'nın belirli bir sürümünü yükleyin veya en son sürüme güncelleştirin. Komutu, CLI'yi genel olarak mı yüklediğinizi yoksa buna göre kullanıp npx yüklemediğini algılar.

`install` örnekleri

En son sürümü yükleyin:

dataverse install latest

Belirli bir sürümü yükleyin:

dataverse install 1.0.0

`mcp` komut

Claude Desktop gibi yapay zeka yardımcılarının verilerinizle etkileşim kurabilmesi için ortamınıza bağlanan bir Model Bağlam Protokolü (MCP) sunucusu başlatır. Hedef URL'den otomatik olarak algılanır: Dataverse URL'si Dataverse MCP sunucusunu başlatır ve gibi https://myorg.operations.dynamics.combir Finans ve İşlemLER URL'si ERP MCP sunucusunu başlatır.

`mcp` söz dizimi

dataverse mcp <orgUrl> [options]

<orgUrl> Bağımsız değişken, kuruluşunuzun URL'sidir, örneğinhttps://myorg.crm.dynamics.com.

`mcp` Parametreler

Parameter	Description
`--validate`	Sunucuyu başlatmadan MCP uç noktalarını ve kimlik doğrulama kurulumunu doğrulayın.
`--log-level`	Günlük düzeyini ayarlayın: `Trace`, `Debug`, `Information`, `Warning`, `Error`, veya `Critical`. Varsayılan: `Warning`.
`--log-file`	Geçici dizindeki bir dosyaya oturum açın.
`--preview`	Önizleme MCP uç noktasını (`api/mcp_preview` yerine) `api/mcp`kullanın. ERP için desteklenmez.

`mcp` örnekleri

Kurulumu doğrulayın (önerilen ilk adım):

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

Stdio aktarımını kullanarak sunucuyu başlatın:

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

Önizleme uç noktasını kullanın veya hata ayıklama dosyası günlüğünü etkinleştirin:

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

`mcp allow` komut

Bir Microsoft Entra uygulamasının geçerli profilin ortamı için Dataverse MCP izin verilen istemciler listesinde olduğundan emin olun. Bu komut, önkoşullarda açıklanan el ile yönetici adımına bir alternatiftir. Kimliği doğrulanmış kullanıcının hedef ortamda Dataverse yönetici izinleri olmalıdır.

`mcp allow` söz dizimi

dataverse mcp allow <appId> [options]

<appId> Bağımsız değişken, GUID olarak izin vermek için uygulama (istemci) kimliğidir.

`mcp allow` Parametreler

Parameter	Description
`--erp`	Uygulamaya Dataverse yerine bağlı Finans ve İşlemler örneğinde izin verin.

`mcp allow` örnekleri

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

Note

Finans ve İşlemler, AOS'ta izin verilenler listesini önbelleğe alır, bu nedenle yeni izin verilen uygulama kimliğinin geçerlilik kazanması yaklaşık beş dakika sürebilir.

`org list` komut

Erişebileceğiniz tüm ortamları listeleyin.

`org list` Parametreler

Parameter	Description
`--filter`	Ortam listesini bir arama terimine göre filtreleyin.
`--json`	Çıkış ham JSON.

`org list` örnekleri

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

`org who` komut

Etkin kimlik doğrulama profilini kullanarak geçerli kuruluş ve kullanıcı hakkındaki bilgileri gösterin. env komutu için orgbir diğer addır.

`org who` Parametreler

Parameter	Description
`--environment`, `-env`	Ortam URL'sini geçersiz kılın.
`--json`	Çıkış ham JSON.

`org who` örnekleri

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

`skill` Komutlar

Bağlı ortamda depolanan, yapay zeka aracılarının kullandığı yeniden kullanılabilir yönerge kümeleri (bir SKILL.md dosya ve kaynak dosyaları) olan Dataverse becerilerini yönetin. Üst düzey skill komutlar ortamda oluşturma, okuma, güncelleştirme ve silme işlemleri sağlar. Yerel olarak, beceriler altında .claude/skills/<name>/depolanır.

Note

, update, getve gibi makebeceri yazma ve evaldeğerlendirme komutları bu komutlardan ayrıdır. Daha fazla bilgi için bkz. dataverse workspace skill --help.

`skill delete` komut

Bir beceriyi ve tüm kaynaklarını etkin Dataverse ortamından silin. Beceri benzersiz adlarını bulmak için kullanın skill list .

dataverse skill delete new_lead-qualification

`skill download` komut

Etkin Dataverse ortamından diske bir veya daha fazla beceri indirin. komutu, dizin yapısını koruyarak dosyayı ve tüm kaynak dosyalarını indirir SKILL.md . Beceri benzersiz adlarını bulmak için kullanın skill list .

Parameter	Description
`--all`	Ortamdaki tüm etkin becerileri indirin. Beceri benzersiz adıyla birleştirilemiyor.
`--output`, `-o`	Çıktı için temel dizin. Varsayılan: `.claude/skills/`. ile `--all`her beceri öğesine `<path>/<name>/`yazılır.
`--json`	Dosya yazmadan beceri içeriğini JSON olarak çıktısını alma. İsteğe bağlı olarak, yazılacak bir dosya yolu belirtin.

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

`skill list` komut

Bağlı Dataverse ortamındaki tüm etkin becerileri listeleyin.

Parameter	Description
`--resources`, `-r`	Ayrıca her beceri için kaynak dosyalarını listeleyin.
`--json`	JSON olarak çıktı. İsteğe bağlı olarak, yazılacak bir dosya yolu belirtin.

dataverse skill list
dataverse skill list --resources

`skill upload` komut

Diskten etkin Dataverse ortamına bir veya daha fazla beceri yükleyin. komutu dizinleri, .zip dosyalarını, .skill dosyalarını ve .md dosyalarını destekler.

için çözümlenen .claude/skills/<name>/bir beceriyi veya bir dizine veya dosyaya açık <path> bir beceri <name>geçirebilirsiniz.

Parameter	Description
`--all`	altındaki `.claude/skills/`tüm becerileri karşıya yükleyin. Beceri adı veya yol ile birleştirilemiyor.
`--json`	Sonucu JSON olarak çıktısını alır. İsteğe bağlı olarak, yazılacak bir dosya yolu belirtin.

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

Ayrıca bakınız

Dataverse CLI kullanarak verilerle çalışma

Geri Bildirim

Bu sayfayı yararlı buldunuz mu?

Last updated on 2026-08-01

Dataverse CLI başvurusu (önizleme)

api describe komut

api describe Parametreler

api describe örnekleri

api invoke komut

api invoke Parametreler

api invoke örnekleri

api list komut

api list Parametreler

api list örnekleri

api request komut

api request Parametreler

api request örnekleri

auth create komut

auth create Parametreler

auth create örnekleri

Etkileşimli kimlik doğrulaması

Adlandırılmış profil

Cihaz kodu akışı

İstemci sırrı ile hizmet asıl

Özel Entra uygulaması istemci kimliği

auth list komut

auth list örnekleri

auth remove komut

auth remove Parametreler

auth remove örnekleri

auth select komut

auth select Parametreler

auth select örnekleri

auth who komut

auth who örnekleri

data associate komut

data associate Parametreler

data associate örnekleri

data count komut

data count Parametreler

data count örnekleri

data create komut

data create Parametreler

data create örnekleri

data delete komut

data delete Parametreler

data delete örnekleri

data describe komut

data describe Parametreler

data describe örnekleri

data disassociate komut

data disassociate Parametreler

data disassociate örnekleri

data get komut

data get Parametreler

data get örnekleri

data query komut

data query Parametreler

data query örnekleri

Daha fazla bilgi edinin

data update komut

data update Parametreler

data update örnekleri

data upload komut

data upload Parametreler

data upload örnekleri

data upsert komut

data upsert Parametreler

data upsert örnekleri

erp batch cancel komut

erp batch cancel örnekleri

erp batch list komut

erp batch list Parametreler

erp batch list örnekleri

install komut

install örnekleri

mcp komut

mcp söz dizimi

mcp Parametreler

mcp örnekleri

mcp allow komut

mcp allow söz dizimi

mcp allow Parametreler

mcp allow örnekleri

`api describe` komut

`api describe` Parametreler

`api describe` örnekleri

`api invoke` komut

`api invoke` Parametreler

`api invoke` örnekleri

`api list` komut

`api list` Parametreler

`api list` örnekleri

`api request` komut

`api request` Parametreler

`api request` örnekleri

`auth create` komut

`auth create` Parametreler

`auth create` örnekleri

`auth list` komut

`auth list` örnekleri

`auth remove` komut

`auth remove` Parametreler

`auth remove` örnekleri

`auth select` komut

`auth select` Parametreler

`auth select` örnekleri

`auth who` komut

`auth who` örnekleri

`data associate` komut

`data associate` Parametreler

`data associate` örnekleri

`data count` komut

`data count` Parametreler

`data count` örnekleri

`data create` komut

`data create` Parametreler

`data create` örnekleri

`data delete` komut

`data delete` Parametreler

`data delete` örnekleri

`data describe` komut

`data describe` Parametreler

`data describe` örnekleri

`data disassociate` komut

`data disassociate` Parametreler

`data disassociate` örnekleri

`data get` komut

`data get` Parametreler

`data get` örnekleri

`data query` komut

`data query` Parametreler

`data query` örnekleri

`data update` komut

`data update` Parametreler

`data update` örnekleri

`data upload` komut

`data upload` Parametreler

`data upload` örnekleri

`data upsert` komut

`data upsert` Parametreler

`data upsert` örnekleri

`erp batch cancel` komut

`erp batch cancel` örnekleri

`erp batch list` komut

`erp batch list` Parametreler

`erp batch list` örnekleri

`install` komut

`install` örnekleri

`mcp` komut

`mcp` söz dizimi

`mcp` Parametreler

`mcp` örnekleri

`mcp allow` komut

`mcp allow` söz dizimi

`mcp allow` Parametreler

`mcp allow` örnekleri

`org list` komut

`org list` Parametreler

`org list` örnekleri

`org who` komut

`org who` Parametreler

`org who` örnekleri

`skill` Komutlar