az iot central device command

Catatan

Referensi ini adalah bagian dari ekstensi azure-iot untuk Azure CLI (versi 2.37.0 atau yang lebih tinggi). Ekstensi akan secara otomatis menginstal pertama kali Anda menjalankan perintah az iot central device command . Pelajari lebih lanjut tentang ekstensi.

Jalankan perintah perangkat.

Perintah

Nama Deskripsi Jenis Status
az iot central device command history

Dapatkan detail untuk permintaan perintah terbaru dan respons yang dikirim ke perangkat.

Ekstensi GA
az iot central device command run

Jalankan perintah pada perangkat dan lihat respons terkait. TIDAK memantau pembaruan properti yang mungkin dilakukan perintah.

Ekstensi GA

az iot central device command history

Dapatkan detail untuk permintaan perintah terbaru dan respons yang dikirim ke perangkat.

Mencantumkan permintaan perintah dan respons terbaru yang dikirim ke perangkat dari IoT Central. Pembaruan apa pun yang dilakukan perangkat ke properti perangkat sebagai akibat dari eksekusi perintah tidak disertakan dalam respons.

az iot central device command history --app-id
                                      --cn
                                      --device-id
                                      [--api-version {2022-06-30-preview, 2022-07-31}]
                                      [--central-api-uri]
                                      [--co]
                                      [--interface-id]
                                      [--mn]
                                      [--token]

Contoh

Perlihatkan respons perintah

az iot central device command history --app-id {appid} --device-id {deviceid} --interface-id {interfaceid} --command-name {commandname}

Perlihatkan respons perintah komponen

az iot central device command history --app-id {appid} --device-id {deviceid} --component-name {componentname} --command-name {commandname}

Tampilkan respons perintah komponen modul

az iot central device command history --app-id {appid} --device-id {deviceid} --module-name {modulename} --component-name {componentname} --command-name {commandname}

Parameter yang Diperlukan

--app-id -n

ID Aplikasi aplikasi IoT Central yang ingin Anda kelola. Anda dapat menemukan ID Aplikasi di halaman "Tentang" untuk aplikasi Anda di bawah menu bantuan.

--cn --command-name

Nama perintah seperti yang ditentukan dalam templat perangkat. Nama perintah bisa berbeda dari Nama Tampilan perintah.

--device-id -d

ID perangkat perangkat target. Anda dapat menemukan ID perangkat dengan, mengklik tombol Koneksi di halaman Detail Perangkat.

Parameter Opsional

--api-version --av
Tidak digunakan lagi

Argumen 'api_version' telah tidak digunakan lagi dan akan dihapus dalam rilis mendatang.

Parameter perintah ini tidak digunakan lagi dan akan diabaikan. Dalam rilis mendatang, kami hanya akan mendukung API IoT Central dari versi GA terbaru. Jika ada API yang belum GA, kami akan memanggil versi pratinjau terbaru.

nilai yang diterima: 2022-06-30-preview, 2022-07-31
nilai default: 2022-07-31
--central-api-uri --central-dns-suffix

Akhiran DNS IoT Central yang terkait dengan aplikasi Anda.

nilai default: azureiotcentral.com
--co --component-name

Nama komponen perangkat.

--interface-id -i

Nama antarmuka/komponen seperti yang ditentukan dalam templat perangkat. Anda dapat menemukannya dengan menavigasi ke Templat Perangkat dan melihat identitas antarmuka/komponen di bawah kemampuan perangkat yang sesuai.

--mn --module-name

Nama modul perangkat.

--token

Jika Anda lebih suka mengirimkan permintaan tanpa mengautentikasi terhadap Azure CLI, Anda dapat menentukan token pengguna yang valid untuk mengautentikasi permintaan Anda. Anda harus menentukan jenis kunci sebagai bagian dari permintaan. Pelajari lebih lanjut di https://aka.ms/iotcentraldocsapi.

Parameter Global
--debug

Meningkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Menampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya menampilkan kesalahan, menyembunyikan peringatan.

--output -o

Format output.

nilai yang diterima: json, jsonc, none, table, tsv, yaml, yamlc
nilai default: json
--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi selengkapnya beserta contohnya.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--verbose

Meningkatkan verbositas pengelogan. Gunakan --debug untuk log waktu lengkap.

az iot central device command run

Jalankan perintah pada perangkat dan lihat respons terkait. TIDAK memantau pembaruan properti yang mungkin dilakukan perintah.

--content dapat berupa json sebaris atau jalur file.

az iot central device command run --app-id
                                  --cn
                                  --content
                                  --device-id
                                  [--api-version {2022-06-30-preview, 2022-07-31}]
                                  [--central-api-uri]
                                  [--co]
                                  [--interface-id]
                                  [--mn]
                                  [--token]

Contoh

Jalankan perintah dengan payload sebaris. Payload harus berada di bawah "permintaan" dalam string json

az iot central device command run --app-id {appid} --device-id {deviceid} --interface-id {interfaceid} --command-name {commandname} --content '{"request": {payload}}'

Perintah eksekusi singkat dengan jalur payload json.

az iot central device command run -n {appid} -d {deviceid} -i {interfaceid} --cn {commandname} -k {payload_file_path}

Jalankan perintah komponen.

az iot central device command run -n {appid} -d {deviceid} --co {componentname} --cn {commandname} -k {payload}

Jalankan perintah komponen modul.

az iot central device command run -n {appid} -d {deviceid} --mn {modulename} --co {componentname} --cn {commandname} -k {payload}

Parameter yang Diperlukan

--app-id -n

ID Aplikasi aplikasi IoT Central yang ingin Anda kelola. Anda dapat menemukan ID Aplikasi di halaman "Tentang" untuk aplikasi Anda di bawah menu bantuan.

--cn --command-name

Nama perintah seperti yang ditentukan dalam templat perangkat. Nama perintah bisa berbeda dari Nama Tampilan perintah.

--content -k

Konfigurasi untuk permintaan. Berikan jalur ke file JSON atau JSON untai (karakter) mentah. [Contoh Jalur File: ./path/to/file.json] [Contoh JSON Stringified: {'a': 'b'}].

--device-id -d

ID perangkat perangkat target. Anda dapat menemukan ID perangkat dengan, mengklik tombol Koneksi di halaman Detail Perangkat.

Parameter Opsional

--api-version --av
Tidak digunakan lagi

Argumen 'api_version' telah tidak digunakan lagi dan akan dihapus dalam rilis mendatang.

Parameter perintah ini tidak digunakan lagi dan akan diabaikan. Dalam rilis mendatang, kami hanya akan mendukung API IoT Central dari versi GA terbaru. Jika ada API yang belum GA, kami akan memanggil versi pratinjau terbaru.

nilai yang diterima: 2022-06-30-preview, 2022-07-31
nilai default: 2022-07-31
--central-api-uri --central-dns-suffix

Akhiran DNS IoT Central yang terkait dengan aplikasi Anda.

nilai default: azureiotcentral.com
--co --component-name

Nama komponen perangkat.

--interface-id -i

Nama antarmuka/komponen seperti yang ditentukan dalam templat perangkat. Anda dapat menemukannya dengan menavigasi ke Templat Perangkat dan melihat identitas antarmuka/komponen di bawah kemampuan perangkat yang sesuai.

--mn --module-name

Nama modul perangkat.

--token

Jika Anda lebih suka mengirimkan permintaan tanpa mengautentikasi terhadap Azure CLI, Anda dapat menentukan token pengguna yang valid untuk mengautentikasi permintaan Anda. Anda harus menentukan jenis kunci sebagai bagian dari permintaan. Pelajari lebih lanjut di https://aka.ms/iotcentraldocsapi.

Parameter Global
--debug

Meningkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Menampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya menampilkan kesalahan, menyembunyikan peringatan.

--output -o

Format output.

nilai yang diterima: json, jsonc, none, table, tsv, yaml, yamlc
nilai default: json
--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi selengkapnya beserta contohnya.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--verbose

Meningkatkan verbositas pengelogan. Gunakan --debug untuk log waktu lengkap.