Bagikan melalui

Gunakan ekstensi IoT untuk Azure CLI untuk manajemen perangkat Azure IoT Hub

  • Artikel

Diagram ujung-ke-ujung

Di artikel ini, Anda akan mempelajari cara menggunakan ekstensi IoT untuk Azure CLI dengan berbagai opsi manajemen di komputer pengembangan Anda. Ekstensi IoT untuk Azure CLI adalah ekstensi IoT sumber terbuka yang menambah kemampuan Azure CLI. Azure CLI menyertakan perintah untuk berinteraksi dengan Azure Resource Manager dan titik akhir manajemen. Misalnya, Anda dapat menggunakan Azure CLI untuk membuat Azure VM atau IoT hub. Ekstensi CLI memungkinkan layanan Azure untuk menambah Azure CLI yang memberi Anda akses ke kemampuan khusus layanan tambahan. Ekstensi IoT memberi pengembang IoT akses baris perintah ke semua kemampuan IoT Hub, IoT Edge, dan IoT Hub Device Provisioning Service.

Opsi manajemen Tugas
Metode langsung Membuat perangkat bertindak seperti memulai atau menghentikan pengiriman pesan atau me-reboot perangkat.
Properti yang diinginkan Kembaran Memasukkan perangkat ke status tertentu, seperti mengatur warna LED menjadi hijau atau mengatur interval pengiriman telemetri ke 30 menit.
Properti yang dilaporkan dari Kembaran Dapatkan status perangkat yang dilaporkan. Misalnya, perangkat melaporkan LED berkedip sekarang.
Tag kembaran Simpan metadata khusus perangkat di cloud. Misalnya, lokasi penyebaran mesin penjual otomatis.
Kueri kembaran perangkat Buat kueri semua perangkat untuk mengambil kembaran tersebut dengan kondisi arbitrer, seperti mengidentifikasi perangkat yang tersedia untuk digunakan.

Untuk penjelasan lebih rinci mengenai perbedaan dan panduan dalam menggunakan opsi ini, lihat Panduan komunikasi perangkat ke cloud dan Panduan komunikasi cloud ke perangkat.

Kembaran perangkat adalah dokumen JSON yang menyimpan informasi status perangkat (metadata, konfigurasi, dan kondisi). IoT Hub mempertahankan kembaran perangkat untuk setiap perangkat yang tersambung dengannya. Untuk informasi selengkapnya tentang kembaran perangkat, lihat Mulai dengan kembaran perangkat.

Catatan

Artikel ini menggunakan versi terbaru ekstensi Azure IoT, yang disebut azure-iot. Versi warisan disebut azure-cli-iot-ext. Anda seharusnya hanya memiliki satu versi yang terinstal pada satu waktu. Anda bisa menggunakan perintah az extension list untuk memvalidasi ekstensi yang saat ini terinstal.

Gunakan az extension remove --name azure-cli-iot-ext untuk menghapus versi lama ekstensi.

Gunakan az extension add --name azure-iot untuk menambahkan versi baru ekstensi.

Untuk melihat ekstensi apa yang telah Anda instal, gunakan az extension list.

Catatan

Fitur yang dijelaskan dalam artikel ini hanya tersedia di tingkat standar IoT Hub. Untuk informasi selengkapnya tentang tingkat IoT Hub dasar dan standar/gratis, lihat Memilih tingkat IoT Hub yang tepat untuk solusi Anda.

Prasyarat

  • Selesaikan tutorial Simulator online Raspberry Pi atau salah satu tutorial perangkat. Contohnya, Anda dapat membuka Raspberry Pi dengan node.js atau salah satu mulai cepat Mengirim telemetri. Artikel-artikel ini mencakup persyaratan berikut:

    • Langganan Azure yang aktif.
    • Azure IoT Hub pada langganan Anda.
    • Aplikasi klien yang mengirim pesan ke Azure IoT hub Anda.

  • Pastikan perangkat Anda berjalan dengan aplikasi klien selama tutorial ini.

  • Python 2.7x atau Python 3.x

  • Azure CLI. Jika Anda perlu memasangnya, lihat Pasang Azure CLI. Minimal, versi Azure CLI Anda harus 2.0.70 atau lebih tinggi. Gunakan az –version untuk memvalidasi.

Catatan

Artikel ini menggunakan versi terbaru ekstensi Azure IoT, yang disebut azure-iot. Versi warisan disebut azure-cli-iot-ext. Anda seharusnya hanya memiliki satu versi yang terinstal pada satu waktu. Anda bisa menggunakan perintah az extension list untuk memvalidasi ekstensi yang saat ini terinstal.

Gunakan az extension remove --name azure-cli-iot-ext untuk menghapus versi lama ekstensi.

Gunakan az extension add --name azure-iot untuk menambahkan versi baru ekstensi.

Untuk melihat ekstensi apa yang telah Anda instal, gunakan az extension list.

  • Pasang ekstensi IoT. Cara paling sederhana adalah menjalankan az extension add --name azure-iot. Readme ekstensi IoT menjelaskan beberapa cara untuk memasang ekstensi.

Masuk ke akun Azure Anda

Masuk ke akun Azure Anda dengan menjalankan perintah berikut ini:

az login

Metode langsung

az iot hub invoke-device-method --device-id <your device id> \
  --hub-name <your hub name> \
  --method-name <the method name> \
  --method-payload <the method payload>

Properti kembaran perangkat yang diinginkan

Atur interval properti yang diinginkan = 3000 dengan menjalankan perintah berikut:

az iot hub device-twin update -n <your hub name> \
  -d <your device id> --set properties.desired.interval=3000

Properti ini bisa dibaca dari peranti Anda.

Properti kembaran perangkat yang dilaporkan

Dapatkan properti perangkat yang dilaporkan dengan menjalankan perintah berikut:

az iot hub device-twin show -n <your hub name> -d <your device id>

Salah satu properti kembaran yang dilaporkan adalah $metadata.$lastUpdated, yang menunjukkan terakhir kali aplikasi perangkat memperbarui set properti yang dilaporkan.

Tag kembaran perangkat

Tampilkan tag dan properti perangkat dengan menjalankan perintah berikut:

az iot hub device-twin show --hub-name <your hub name> --device-id <your device id>

Tambahkan peran bidang = temperature&humidity ke perangkat dengan menjalankan perintah berikut:

az iot hub device-twin update \
  --hub-name <your hub name> \
  --device-id <your device id> \
  --set tags='{"role":"temperature&humidity"}'

Kueri kembaran perangkat

Perangkat kueri dengan tag peran = 'temperature&humidity' dengan menjalankan perintah berikut:

az iot hub query --hub-name <your hub name> \
  --query-command "SELECT * FROM devices WHERE tags.role = 'temperature&humidity'"

Kueri semua perangkat kecuali yang memiliki tag peran = 'temperature&humidity' dengan menjalankan perintah berikut:

az iot hub query --hub-name <your hub name> \
  --query-command "SELECT * FROM devices WHERE tags.role != 'temperature&humidity'"

Langkah berikutnya

Anda telah mempelajari cara memantau pesan perangkat ke cloud dan mengirim pesan cloud ke perangkat antara perangkat IoT dan Azure IoT Hub Anda.

Untuk terus mulai menggunakan Azure IoT Hub dan menjelajahi semua skenario IoT yang diperluas, lihat berikut ini: