Perangkat perintah CLI Azure Digital Twins

Selain mengelola instans Azure Digital Twins Anda di portal Microsoft 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 Azure Digital twins termasuk penggunaannya, cara mendapatkannya, dan persyaratan untuk menggunakannya.

Beberapa tindakan yang dapat Anda lakukan menggunakan set perintah meliputi:

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

Kumpulan 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 sekumpulan perintah az iot: referensi perintah az dt.

Menggunakan (mengoperasikan 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 data plane dapat digunakan untuk dengan cepat memeriksa nilai dalam instans Anda, dan memastikan bahwa operasi selesai sesuai yang diharapkan.

Dapatkan set 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 Azure CLI dengan PowerShell, versi Azure CLI Anda harus 2.3.1 atau lebih besar sebagai persyaratan paket ekstensi.

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

az --version

Untuk petunjuk tentang cara menginstal atau memperbarui Azure CLI ke versi yang lebih baru, lihat Cara menginstal Azure CLI.

Mendapatkan ekstensi

Azure CLI secara otomatis meminta Anda menginstal ekstensi pada penggunaan pertama perintah yang memerlukannya.

Jika tidak, 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 Azure CLI lokal.

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 menghindari penggunaan karakter khusus dalam shell pilihan Anda.

Bash (sebuah bahasa shell dan bahasa perintah untuk Unix)

Gunakan tips karakter khusus ini untuk lingkungan Bash.

Pertanyaan

Dalam banyak kueri kembar, karakter $ digunakan untuk mereferensikan properti $dtId kembar. Saat menggunakan perintah az dt twin query untuk melakukan kueri dalam lingkungan Cloud Shell Bash, melewati karakter $ dengan garis miring terbalik (\).

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 dalam baris

Beberapa perintah, seperti az dt twin create, memungkinkan Anda memasukkan informasi kembar dalam bentuk JSON sebaris. Saat memasukkan JSON sebaris di lingkungan PowerShell, karakter kutipan ganda di dalam JSON perlu di-escape dengan menambahkan backslash (").

Berikut adalah contoh membuat 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}'

Petunjuk / Saran

Banyak perintah yang mendukung JSON inline juga mendukung input berupa path file, yang dapat membantu Anda menghindari persyaratan teks khusus shell.

Pertanyaan

Dalam banyak kueri kembar, karakter $ digunakan untuk mereferensikan properti $dtId kembar. Saat menggunakan perintah az dt twin query untuk melakukan kueri di lingkungan PowerShell, gunakan tanda backtick untuk menghindari karakter $ tersebut.

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 CMD Windows lokal.

JSON dalam baris

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 keluar dari karakter kutipan ganda di dalam JSON dengan garis miring terbelakang (\).

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

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

Petunjuk / Saran

Banyak perintah yang mendukung JSON inline juga mendukung input berupa path file, yang dapat membantu Anda menghindari persyaratan teks khusus shell.

Langkah berikutnya

Jelajahi CLI dan serangkaian perintah lengkapnya melalui dokumen referensi:

  • Last updated on