Bagikan melalui

az iot ops asset

  • Referensi

Catatan

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

Manajemen aset.

Untuk informasi selengkapnya tentang manajemen aset, silakan lihat aka.ms/asset-overview.

Perintah

Nama Deskripsi Jenis Status
az iot ops asset create

Buat aset.

 Ekstensi GA
az iot ops asset dataset

Mengelola himpunan data dalam aset.

 Ekstensi GA
az iot ops asset dataset list

Mencantumkan himpunan data dalam aset.

 Ekstensi GA
az iot ops asset dataset point

Mengelola titik data dalam himpunan data aset.

 Ekstensi GA
az iot ops asset dataset point add

Tambahkan titik data ke himpunan data aset.

 Ekstensi GA
az iot ops asset dataset point export

Ekspor titik data dalam himpunan data aset.

 Ekstensi GA
az iot ops asset dataset point import

Mengimpor titik data dalam himpunan data aset.

 Ekstensi GA
az iot ops asset dataset point list

Mencantumkan titik data dalam himpunan data aset.

 Ekstensi GA
az iot ops asset dataset point remove

Menghapus titik data dalam himpunan data aset.

 Ekstensi GA
az iot ops asset dataset show

Memperlihatkan himpunan data dalam aset.

 Ekstensi GA
az iot ops asset delete

Menghapus aset.

 Ekstensi GA
az iot ops asset endpoint

Mengelola profil titik akhir aset.

 Ekstensi GA
az iot ops asset endpoint create

Membuat profil titik akhir aset.

 Ekstensi GA
az iot ops asset endpoint create custom

Buat profil titik akhir aset untuk konektor kustom.

 Ekstensi Usang
az iot ops asset endpoint create onvif

Buat profil titik akhir aset untuk konektor Onvif.

 Ekstensi Usang
az iot ops asset endpoint create opcua

Buat profil titik akhir aset untuk konektor OPCUA.

 Ekstensi GA
az iot ops asset endpoint delete

Menghapus profil titik akhir aset.

 Ekstensi GA
az iot ops asset endpoint query

Kueri Resource Graph untuk profil titik akhir aset.

 Ekstensi GA
az iot ops asset endpoint show

Tampilkan profil titik akhir aset.

 Ekstensi GA
az iot ops asset endpoint update

Memperbarui profil titik akhir aset.

 Ekstensi GA
az iot ops asset event

Mengelola peristiwa dalam aset.

 Ekstensi GA
az iot ops asset event add

Tambahkan peristiwa ke aset.

 Ekstensi GA
az iot ops asset event export

Mengekspor peristiwa dalam aset.

 Ekstensi GA
az iot ops asset event import

Mengimpor peristiwa dalam aset.

 Ekstensi GA
az iot ops asset event list

Mencantumkan peristiwa dalam aset.

 Ekstensi GA
az iot ops asset event remove

Menghapus peristiwa dalam aset.

 Ekstensi GA
az iot ops asset query

Kueri Resource Graph untuk aset.

 Ekstensi GA
az iot ops asset show

Tampilkan aset.

 Ekstensi GA
az iot ops asset update

Memperbarui aset.

 Ekstensi GA

az iot ops asset create

Buat aset.

Untuk contoh format file, silakan lihat aka.ms/aziotops-assets.

az iot ops asset create --endpoint-profile
                        --instance
                        --name
                        --resource-group
                        [--attr]
                        [--dataset-publish-int]
                        [--dataset-queue-size]
                        [--dataset-sample-int]
                        [--description]
                        [--disable {false, true}]
                        [--display-name]
                        [--documentation-uri]
                        [--eai]
                        [--ef]
                        [--epi]
                        [--eqs]
                        [--esi]
                        [--event]
                        [--hardware-revision]
                        [--ig]
                        [--instance-subscription]
                        [--location]
                        [--manufacturer]
                        [--manufacturer-uri]
                        [--model]
                        [--pc]
                        [--serial-number]
                        [--software-revision]
                        [--tags]
                        [--topic-path]
                        [--topic-retain {Keep, Never}]

Contoh

Buat aset menggunakan instans yang diberikan dalam grup sumber daya yang sama.

az iot ops asset create --name myasset -g myresourcegroup --endpoint-profile myassetendpoint --instance myinstance

Buat aset menggunakan instans yang diberikan dalam grup sumber daya yang berbeda tetapi langganan yang sama. Perhatikan bahwa Pengalaman Operasi Digital mungkin tidak menampilkan aset jika berada dalam langganan yang berbeda dari instans.

az iot ops asset create --name myasset -g myresourcegroup --endpoint-profile myassetendpoint --instance myinstance --instance-resource-group myinstanceresourcegroup

Buat aset yang dinonaktifkan menggunakan file yang berisi peristiwa.

az iot ops asset create --name myasset -g myresourcegroup --endpoint-profile myassetendpoint --instance myinstance --event-file /path/to/myasset_events.csv --disable

Buat aset dengan nilai yang telah diisi sebelumnya.

az iot ops asset create --name myasset -g myresourcegroup --endpoint-profile myassetendpoint --instance myinstance --event event_notifier=EventNotifier1 name=myEvent1 observability_mode=log sampling_interval=10 queue_size=2 --event event_notifier=EventNotifier2 name=myEvent2 --dataset-publish-int 1250 --dataset-queue-size 2 --dataset-sample-int 30 --event-publish-int 750 --event-queue-size 3 --event-sample-int 50 --description 'Description for a test asset.' --documentation-uri www.contoso.com --external-asset-id 000-000-1234 --hardware-revision 10.0 --product-code XXX100 --software-revision 0.1 --manufacturer Contoso --manufacturer-uri constoso.com --model AssetModel --serial-number 000-000-ABC10 --custom-attribute work_location=factory

Parameter yang Diperlukan

--endpoint-profile --ep

Nama profil titik akhir aset.

--instance

Nama instans untuk mengaitkan aset yang dibuat.

--name -n

Nama aset.

--resource-group -g

Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>.

Parameter Opsional

--attr --custom-attribute

Pasangan key=value yang dipisahkan spasi yang sesuai dengan atribut kustom tambahan untuk aset. Parameter ini dapat digunakan lebih dari sekali.

--dataset-publish-int --dpi

Interval penerbitan default untuk himpunan data.

Nilai default: 1000
--dataset-queue-size --dqs

Ukuran antrean default untuk himpunan data.

Nilai default: 1
--dataset-sample-int --dsi

Interval pengambilan sampel default (dalam milidetik) untuk himpunan data.

Nilai default: 500
--description -d

Deskripsi.

--disable

Menonaktifkan aset.

Nilai yang diterima: false, true
Nilai default: False
--display-name --dn

Nama tampilan.

--documentation-uri --du

URI dokumentasi.

--eai --external-asset-id

Id aset eksternal.

--ef --event-file

Jalur file untuk file yang berisi peristiwa. Jenis file berikut didukung: json, csv, yaml.

--epi --event-publish-int

Interval penerbitan default untuk peristiwa.

Nilai default: 1000
--eqs --event-queue-size

Ukuran antrean default untuk peristiwa.

Nilai default: 1
--esi --event-sample-int

Interval pengambilan sampel default (dalam milidetik) untuk peristiwa.

Nilai default: 500
--event

Pasangan key=value yang dipisahkan spasi yang sesuai dengan properti peristiwa yang akan dibuat. Nilai kunci berikut didukung: event_notifier (wajib), name (diperlukan), observability_mode (tidak ada atau log), sampling_interval (int), queue_size (int). --event dapat digunakan 1 kali atau lebih. Tinjau contoh bantuan untuk penggunaan parameter lengkap.

--hardware-revision --hr

Revisi perangkat keras.

--ig --instance-resource-group

Grup sumber daya instans. Jika tidak disediakan, grup sumber daya aset akan digunakan.

--instance-subscription --is
Tidak digunakan lagi

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

Id langganan instans. Jika tidak disediakan, id langganan aset akan digunakan.

--location -l

Lokasi. Nilai dari: az account list-locations. Anda dapat mengonfigurasi lokasi default menggunakan az configure --defaults location=<location>.

--manufacturer

Produsen.

--manufacturer-uri --mu

Produsen URI.

--model

Pola.

--pc --product-code

Kode produk.

--serial-number --sn

Nomor seri.

--software-revision --sr

Revisi perangkat lunak.

--tags

Tag sumber daya aset. Tas properti dalam pasangan kunci-nilai dengan format berikut: a=b c=d.

--topic-path --tp

Jalur topik default.

--topic-retain --tr

Kebijakan pertahankan topik default.

Nilai yang diterima: Keep, Never
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 ops asset delete

Menghapus aset.

az iot ops asset delete --name
                        --resource-group

Contoh

Menghapus aset.

az iot ops asset delete --name myasset -g myresourcegroup

Parameter yang Diperlukan

--name -n

Nama aset.

--resource-group -g

Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>.

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 ops asset query

Kueri Resource Graph untuk aset.

az iot ops asset query [--cq]
                       [--description]
                       [--disabled {false, true}]
                       [--display-name]
                       [--documentation-uri]
                       [--eai]
                       [--endpoint-profile]
                       [--hardware-revision]
                       [--ig]
                       [--instance]
                       [--location]
                       [--manufacturer]
                       [--manufacturer-uri]
                       [--model]
                       [--name]
                       [--pc]
                       [--resource-group]
                       [--serial-number]
                       [--software-revision]
                       [--topic-path]
                       [--topic-retain {Keep, Never}]

Contoh

Kueri untuk aset yang dinonaktifkan dalam grup sumber daya tertentu.

az iot ops asset query -g myresourcegroup --disabled

Kueri untuk aset yang memiliki model, produsen, dan nomor seri yang diberikan.

az iot ops asset query --model model1 --manufacturer contoso --serial-number 000-000-ABC10

Parameter Opsional

--cq --custom-query

Kueri kustom yang akan digunakan. Semua argumen kueri lainnya akan diabaikan.

--description -d

Deskripsi.

--disabled

Status aset.

Nilai yang diterima: false, true
--display-name --dn

Nama tampilan.

--documentation-uri --du

URI dokumentasi.

--eai --external-asset-id

Id aset eksternal.

--endpoint-profile --ep

Nama profil titik akhir aset.

--hardware-revision --hr

Revisi perangkat keras.

--ig --instance-resource-group

Grup sumber daya instans. Jika tidak disediakan, grup sumber daya aset akan digunakan.

--instance

Nama instans untuk mengaitkan aset yang dibuat.

--location -l

Lokasi. Nilai dari: az account list-locations. Anda dapat mengonfigurasi lokasi default menggunakan az configure --defaults location=<location>.

--manufacturer

Produsen.

--manufacturer-uri --mu

Produsen URI.

--model

Pola.

--name -n

Nama aset.

--pc --product-code

Kode produk.

--resource-group -g

Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>.

--serial-number --sn

Nomor seri.

--software-revision --sr

Revisi perangkat lunak.

--topic-path --tp

Jalur topik default.

--topic-retain --tr

Kebijakan pertahankan topik default.

Nilai yang diterima: Keep, Never
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 ops asset show

Tampilkan aset.

az iot ops asset show --name
                      --resource-group

Contoh

Tampilkan detail aset.

az iot ops asset show --name myasset -g myresourcegroup

Parameter yang Diperlukan

--name -n

Nama aset.

--resource-group -g

Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>.

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 ops asset update

Memperbarui aset.

Untuk memperbarui himpunan data dan peristiwa, gunakan grup az iot ops asset dataset perintah dan az iot ops asset event masing-masing.

az iot ops asset update --name
                        --resource-group
                        [--attr]
                        [--dataset-publish-int]
                        [--dataset-queue-size]
                        [--dataset-sample-int]
                        [--description]
                        [--disable {false, true}]
                        [--display-name]
                        [--documentation-uri]
                        [--epi]
                        [--eqs]
                        [--esi]
                        [--hardware-revision]
                        [--manufacturer]
                        [--manufacturer-uri]
                        [--model]
                        [--pc]
                        [--serial-number]
                        [--software-revision]
                        [--tags]
                        [--topic-path]
                        [--topic-retain {Keep, Never}]

Contoh

Perbarui himpunan data aset dan default peristiwa.

az iot ops asset update --name myasset -g myresourcegroup --dataset-publish-int 1250 --dataset-queue-size 2 --dataset-sample-int 30 --event-publish-int 750 --event-queue-size 3 --event-sample-int 50

Perbarui deskripsi aset, uri dokumentasi, revisi perangkat keras, kode produk, dan revisi perangkat lunak.

az iot ops asset update --name myasset -g myresourcegroup --description "Updated test asset description." --documentation-uri www.contoso.com --hardware-revision 11.0 --product-code XXX102 --software-revision 0.2

Perbarui produsen aset, uri produsen, model, nomor seri, dan atribut kustom.

az iot ops asset update --name myasset -g myresourcegroup --manufacturer Contoso --manufacturer-uri constoso2.com --model NewAssetModel --serial-number 000-000-ABC11 --custom-attribute work_location=new_factory --custom-attribute secondary_work_location=factory

Nonaktifkan aset dan hapus atribut kustom yang disebut "work_site".

az iot ops asset update --name myasset -g myresourcegroup --disable --custom-attribute work_site=""

Parameter yang Diperlukan

--name -n

Nama aset.

--resource-group -g

Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>.

Parameter Opsional

--attr --custom-attribute

Pasangan key=value yang dipisahkan spasi yang sesuai dengan atribut kustom tambahan untuk aset. Parameter ini dapat digunakan lebih dari sekali. Untuk menghapus atribut kustom, atur nilai atribut ke "".

--dataset-publish-int --dpi

Interval penerbitan default untuk himpunan data.

--dataset-queue-size --dqs

Ukuran antrean default untuk himpunan data.

--dataset-sample-int --dsi

Interval pengambilan sampel default (dalam milidetik) untuk himpunan data.

--description -d

Deskripsi.

--disable

Menonaktifkan aset.

Nilai yang diterima: false, true
--display-name --dn

Nama tampilan.

--documentation-uri --du

URI dokumentasi.

--epi --event-publish-int

Interval penerbitan default untuk peristiwa.

--eqs --event-queue-size

Ukuran antrean default untuk peristiwa.

--esi --event-sample-int

Interval pengambilan sampel default (dalam milidetik) untuk peristiwa.

--hardware-revision --hr

Revisi perangkat keras.

--manufacturer

Produsen.

--manufacturer-uri --mu

Produsen URI.

--model

Pola.

--pc --product-code

Kode produk.

--serial-number --sn

Nomor seri.

--software-revision --sr

Revisi perangkat lunak.

--tags

Tag sumber daya aset. Tas properti dalam pasangan kunci-nilai dengan format berikut: a=b c=d.

--topic-path --tp

Jalur topik default.

--topic-retain --tr

Kebijakan pertahankan topik default.

Nilai yang diterima: Keep, Never
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.