Set perintah CLI Azure Digital Twins

  • Artikel

Selain mengelola instans Azure Digital Twins Anda di portal Azure, Azure Digital Twins juga memiliki set perintah untuk Azure CLI yang dapat Anda gunakan untuk melakukan sebagian besar tindakan utama dengan layanan. Artikel ini membahas kumpulan perintah Azure CLI untuk kembar Azure Digital termasuk penggunaannya, cara mendapatkannya, dan persyaratan untuk menggunakannya.

Beberapa tindakan yang dapat Anda lakukan menggunakan set perintah meliputi:

  • Mengelola instans Azure Digital Twins
  • Mengelola model
  • Mengelola digital twins
  • Mengelola hubungan kembaran
  • Mengonfigurasi titik akhir
  • Mengelola rute
  • Mengonfigurasi keamanan melalui kontrol akses berbasis peran Azure (Azure RBAC)

Set perintah disebut az dt, dan merupakan bagian dari ekstensi Azure IoT untuk Azure CLI. Anda dapat melihat daftar lengkap perintah dan penggunaannya sebagai bagian dari dokumentasi referensi untuk kumpulan perintah az iot: referensi perintah az dt.

Penggunaan (menyebarkan dan memvalidasi)

Selain mengelola instans Anda secara umum, CLI juga merupakan alat yang berguna untuk penyebaran dan validasi.

  • Perintah sarana kontrol dapat digunakan untuk membuat penyebaran instans baru dapat diulang atau diotomatisasi.
  • Perintah sarana data dapat digunakan untuk memeriksa nilai dalam instans Anda dengan cepat, dan memverifikasi bahwa operasi selesai seperti yang diharapkan.

Dapatkan kumpulan perintah

Perintah Azure Digital Twins adalah bagian dari ekstensi Azure IoT untuk Azure CLI (azure-iot), jadi ikuti langkah-langkah ini untuk memastikan Anda memiliki ekstensi terbaru azure-iot dengan az dt perintah.

Persyaratan versi CLI

Jika Anda menggunakan CLI Azure dengan PowerShell, paket ekstensi mengharuskan Anda untuk menggunakan versi Azure CLI 2.3.1 atau di atasnya.

Anda dapat memeriksa versi CLI Azure Anda dengan perintah CLI ini:

az --version

Untuk instruksi tentang cara memasang atau memperbarui Azure CLI ke versi yang lebih baru, lihat Pasang CLI Azure.

Dapatkan ekstensi

CLI Azure akan secara otomatis meminta Anda untuk memasang ekstensi pada penggunaan pertama perintah yang memerlukannya.

Atau, Anda dapat menggunakan perintah berikut untuk menginstal ekstensi sendiri kapan saja (atau memperbaruinya jika ternyata Anda sudah memiliki versi yang lebih lama). Perintah dapat dijalankan di Azure Cloud Shell atau CLI lokal Azure.

az extension add --upgrade --name azure-iot

Menggunakan karakter khusus dalam shell yang berbeda

Beberapa az dt perintah menggunakan karakter khusus yang mungkin harus diloloskan untuk penguraian yang tepat di lingkungan shell tertentu. Gunakan tips di bagian ini untuk membantu Anda mengetahui kapan harus melakukan ini di shell pilihan Anda.

Bash

Gunakan tips karakter khusus ini untuk lingkungan Bash.

Kueri

Dalam banyak kueri kembar $ , karakter digunakan untuk mereferensikan properti kembar $dtId . Saat menggunakan perintah kueri kembar az dt untuk mengkueri di lingkungan Cloud Shell Bash, lolos dari $ karakter dengan garis miring terbelakang (\).

Berikut adalah contoh kueri untuk kembar dengan perintah CLI di lingkungan Cloud Shell Bash:

az dt twin query --dt-name <instance-hostname-or-name> --query-command "SELECT * FROM DigitalTwins T Where T.\$dtId = 'room0'"

PowerShell

Gunakan tips karakter khusus ini untuk lingkungan PowerShell.

JSON sebaris

Beberapa perintah, seperti az dt twin create, memungkinkan Anda memasukkan informasi kembar dalam bentuk JSON sebaris. Saat memasukkan JSON sebaris di lingkungan PowerShell, keluar dari karakter kutipan ganda (") di dalam JSON dengan garis miring terbelakang (\).

Berikut adalah contoh pembuatan kembar dengan perintah CLI di PowerShell:

az dt twin create --dt-name <instance-hostname-or-name> --dtmi "dtmi:contosocom:DigitalTwins:Thermostat;1" --twin-id thermostat67 --properties '{\"Temperature\": 0.0}'

Tip

Banyak perintah yang mendukung JSON sebaris juga mendukung input sebagai jalur file, yang dapat membantu Anda menghindari persyaratan teks khusus shell.

Kueri

Dalam banyak kueri kembar $ , karakter digunakan untuk mereferensikan properti kembar $dtId . Saat menggunakan perintah kueri kembar az dt untuk mengkueri di lingkungan PowerShell, lolos dari $ karakter dengan karakter backtick.

Berikut adalah contoh kueri untuk kembar dengan perintah CLI di PowerShell:

az dt twin query --dt-name <instance-hostname-or-name> --query-command "SELECT * FROM DigitalTwins T Where T.`$dtId = 'room0'"

Windows CMD

Gunakan tips karakter khusus ini untuk Windows CMD lokal.

JSON sebaris

Beberapa perintah, seperti az dt twin create, memungkinkan Anda memasukkan informasi kembar dalam bentuk JSON sebaris. Saat memasukkan JSON sebaris di jendela Windows CMD lokal, sertakan nilai parameter dengan tanda kutip ganda (") alih-alih tanda kutip tunggal ('), dan karakter kutipan ganda escape di dalam JSON dengan garis miring terbelakang (\).

Berikut adalah contoh pembuatan kembar dengan perintah CLI di Windows CMD lokal:

az dt twin create --dt-name <instance-hostname-or-name> --dtmi "dtmi:contosocom:DigitalTwins:Thermostat;1" --twin-id thermostat67 --properties "{\"Temperature\": 0.0}"

Tip

Banyak perintah yang mendukung JSON sebaris juga mendukung input sebagai jalur file, yang dapat membantu Anda menghindari persyaratan teks khusus shell.

Langkah berikutnya

Jelajahi CLI dan serangkaian perintah lengkapnya melalui dokumen referensi: