az dt twin

  • Referensi

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 dt twin . Pelajari lebih lanjut tentang ekstensi.

Mengelola dan mengonfigurasi kembar digital instans Digital Twins.

Perintah

Nama Deskripsi Jenis Status
az dt twin component

Tampilkan dan perbarui komponen kembar digital dari instans Digital Twins.

 Ekstensi GA
az dt twin component show

Tampilkan detail komponen kembar digital.

 Ekstensi GA
az dt twin component update

Perbarui komponen kembar digital melalui spesifikasi patch JSON.

 Ekstensi GA
az dt twin create

Buat kembar digital pada instans.

 Ekstensi GA
az dt twin delete

Menghapus kembar digital. Semua hubungan yang merujuk kembar ini harus sudah dihapus.

 Ekstensi GA
az dt twin delete-all

Menghapus semua kembar digital dalam instans Digital Twins, termasuk semua hubungan untuk kembar tersebut.

 Ekstensi GA
az dt twin query

Mengkueri kembar digital instans. Memungkinkan melintas hubungan dan pemfilteran menurut nilai properti.

 Ekstensi GA
az dt twin relationship

Mengelola dan mengonfigurasi hubungan kembar digital instans Digital Twins.

 Ekstensi GA
az dt twin relationship create

Buat hubungan antara kembar digital sumber dan target.

 Ekstensi GA
az dt twin relationship delete

Menghapus hubungan kembar digital pada instans Digital Twins.

 Ekstensi GA
az dt twin relationship delete-all

Menghapus semua hubungan kembar digital dalam instans Digital Twins, termasuk hubungan masuk.

 Ekstensi GA
az dt twin relationship list

Mencantumkan hubungan kembar digital.

 Ekstensi GA
az dt twin relationship show

Memperlihatkan detail hubungan kembar digital.

 Ekstensi GA
az dt twin relationship update

Memperbarui properti hubungan antara dua kembar digital melalui spesifikasi patch JSON.

 Ekstensi GA
az dt twin show

Tampilkan detail kembar digital.

 Ekstensi GA
az dt twin telemetry

Menguji dan memvalidasi rute peristiwa dan titik akhir instans Digital Twins.

 Ekstensi GA
az dt twin telemetry send

Mengirim telemetri atas nama kembar digital. Jika jalur komponen disediakan, telemetri yang dipancarkan adalah atas nama komponen.

 Ekstensi GA
az dt twin update

Perbarui instans digital twin melalui spesifikasi patch JSON.

 Ekstensi GA

az dt twin create

Buat kembar digital pada instans.

--properties dapat berupa JSON sebaris atau jalur file. Catatan: --properties diperlukan untuk kembar yang berisi komponen.

az dt twin create --dt-name
                  --dtmi
                  --twin-id
                  [--if-none-match]
                  [--properties]
                  [--resource-group]

Contoh

Buat digital twin dari model yang sudah ada (dibuat sebelumnya).

az dt twin create -n {instance_or_hostname} --dtmi "dtmi:com:example:Room;1" --twin-id {twin_id}

Buat kembar digital dari model yang sudah ada (dibuat sebelumnya) dengan tag if-none-match.

az dt twin create -n {instance_or_hostname} --dtmi "dtmi:com:example:Room;1" --twin-id {twin_id} --if-none-match

Buat digital twin dari model yang sudah ada (dibuat sebelumnya). Buat dengan nilai properti.

az dt twin create -n {instance_or_hostname} --dtmi "dtmi:com:example:DeviceInformation;1" --twin-id {twin_id} --properties '{"manufacturer": "Microsoft"}'

Buat kembar digital dengan komponen dari model yang sudah ada (dibuat sebelumnya). Buat instans komponen dengan properti minimum.

az dt twin create -n {instance_or_hostname} --dtmi "dtmi:com:example:TemperatureController;1" --twin-id {twin_id} --properties '{
    "Thermostat": {
        "$metadata": {},
    }
}'

Buat kembar digital dengan komponen dari model yang sudah ada (dibuat sebelumnya). Buat dengan nilai properti.

az dt twin create -n {instance_or_hostname} --dtmi "dtmi:com:example:TemperatureController;1" --twin-id {twin_id} --properties '{
    "Temperature": 10.2,
    "Thermostat": {
        "$metadata": {},
        "setPointTemp": 23.12
    }
}'

Parameter yang Diperlukan

--dt-name --dtn -n

Nama instans digital Twins atau nama host. Jika nama instans disediakan, langganan pengguna pertama kali dikueri agar instans target mengambil nama host. Jika nama host disediakan, kueri langganan dilewati dan nilai yang disediakan digunakan untuk interaksi berikutnya.

--dtmi --model-id -m

Id model Digital Twins. Contoh: dtmi:com:example:Room;2.

--twin-id -t

Id kembar digital.

Parameter Opsional

--if-none-match

Menunjukkan operasi buat harus gagal jika ada kembar dengan id yang sama.

nilai default: False
--properties -p

Nilai properti awal untuk membuat instans kembar digital atau komponen terkait. Sediakan jalur file atau JSON sebaris. Properti diperlukan untuk kembar yang berisi komponen, minimal Anda harus menyediakan objek $metadata kosong untuk setiap komponen.

--resource-group -g

Grup sumber daya instans Digital Twins. 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 dt twin delete

Menghapus kembar digital. Semua hubungan yang merujuk kembar ini harus sudah dihapus.

az dt twin delete --dt-name
                  --twin-id
                  [--etag]
                  [--resource-group]

Contoh

Hapus kembar digital menurut Id.

az dt twin delete -n {instance_or_hostname} --twin-id {twin_id}

Hapus kembar digital dengan Id menggunakan etag.

az dt twin delete -n {instance_or_hostname} --twin-id {twin_id} --etag {etag}

Parameter yang Diperlukan

--dt-name --dtn -n

Nama instans digital Twins atau nama host. Jika nama instans disediakan, langganan pengguna pertama kali dikueri agar instans target mengambil nama host. Jika nama host disediakan, kueri langganan dilewati dan nilai yang disediakan digunakan untuk interaksi berikutnya.

--twin-id -t

Id kembar digital.

Parameter Opsional

--etag -e

Nilai tag entitas. Perintah akan berhasil jika etag cocok dengan etag saat ini untuk sumber daya.

--resource-group -g

Grup sumber daya instans Digital Twins. 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 dt twin delete-all

Menghapus semua kembar digital dalam instans Digital Twins, termasuk semua hubungan untuk kembar tersebut.

az dt twin delete-all --dt-name
                      [--resource-group]
                      [--yes]

Contoh

Hapus semua kembar digital. Hubungan apa pun yang mereferensikan kembar juga akan dihapus.

az dt twin delete-all -n {instance_or_hostname}

Parameter yang Diperlukan

--dt-name --dtn -n

Nama instans digital Twins atau nama host. Jika nama instans disediakan, langganan pengguna pertama kali dikueri agar instans target mengambil nama host. Jika nama host disediakan, kueri langganan dilewati dan nilai yang disediakan digunakan untuk interaksi berikutnya.

Parameter Opsional

--resource-group -g

Grup sumber daya instans Digital Twins. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>.

--yes -y

Jangan meminta konfirmasi.

nilai default: False
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 dt twin query

Mengkueri kembar digital instans. Memungkinkan melintas hubungan dan pemfilteran menurut nilai properti.

Dalam banyak kueri kembar $ , karakter digunakan untuk mereferensikan properti kembar $dtId . Dalam shell seperti bash atau powershell $ , karakter memiliki arti fungsional dan harus diloloskan sebagai bagian dari input kueri. Harap tinjau dokumen https://docs.microsoft.com/en-us/azure/digital-twins/concepts-cli konsep Digital Twins CLI untuk informasi selengkapnya.

az dt twin query --dt-name
                 --query-command
                 [--cost {false, true}]
                 [--resource-group]

Contoh

Kueri semua digital twin dalam instans target dan proyeksikan semua atribut. Tampilkan juga biaya dalam unit kueri.

az dt twin query -n {instance_or_hostname} -q "select * from digitaltwins" --show-cost

Kueri berdasarkan model dan proyeksikan semua atribut.

az dt twin query -n {instance_or_hostname} -q "select * from digitaltwins T where IS_OF_MODEL(T, 'dtmi:com:example:Room;2')"

Kueri memanfaatkan '$dtId' dengan sintaks yang kompatibel dengan bash

az dt twin query -n {instance_or_hostname} --query-command "SELECT * FROM DigitalTwins T Where T.\$dtId = 'room0'"

Kueri memanfaatkan '$dtId' dengan sintaks yang kompatibel dengan powershell

az dt twin query -n {instance_or_hostname} --query-command "SELECT * FROM DigitalTwins T Where T.`$dtId = 'room0'"

Parameter yang Diperlukan

--dt-name --dtn -n

Nama instans digital Twins atau nama host. Jika nama instans disediakan, langganan pengguna pertama kali dikueri agar instans target mengambil nama host. Jika nama host disediakan, kueri langganan dilewati dan nilai yang disediakan digunakan untuk interaksi berikutnya.

--query-command -q

Kueri pengguna yang akan dijalankan.

Parameter Opsional

--cost --show-cost

Menghitung dan memperlihatkan biaya kueri.

nilai yang diterima: false, true
nilai default: False
--resource-group -g

Grup sumber daya instans Digital Twins. 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 dt twin show

Tampilkan detail kembar digital.

az dt twin show --dt-name
                --twin-id
                [--resource-group]

Contoh

Tampilkan detail kembar digital.

az dt twin show -n {instance_or_hostname} --twin-id {twin_id}

Parameter yang Diperlukan

--dt-name --dtn -n

Nama instans digital Twins atau nama host. Jika nama instans disediakan, langganan pengguna pertama kali dikueri agar instans target mengambil nama host. Jika nama host disediakan, kueri langganan dilewati dan nilai yang disediakan digunakan untuk interaksi berikutnya.

--twin-id -t

Id kembar digital.

Parameter Opsional

--resource-group -g

Grup sumber daya instans Digital Twins. 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 dt twin update

Perbarui instans digital twin melalui spesifikasi patch JSON.

Pembaruan pada nilai properti dan elemen $model mungkin terjadi dalam permintaan yang sama. Operasi dibatasi untuk menambahkan, mengganti, dan menghapus.

az dt twin update --dt-name
                  --json-patch
                  --twin-id
                  [--etag]
                  [--resource-group]

Contoh

Perbarui kembar digital melalui spesifikasi patch JSON.

az dt twin update -n {instance_or_hostname} --twin-id {twin_id} --json-patch '{"op":"replace", "path":"/Temperature", "value": 20.5}'

Perbarui kembar digital melalui spesifikasi patch JSON dan gunakan etag.

az dt twin update -n {instance_or_hostname} --twin-id {twin_id} --etag {etag} --json-patch '{"op":"replace", "path":"/Temperature", "value": 20.5}'

Perbarui kembar digital melalui spesifikasi patch JSON.

az dt twin update -n {instance_or_hostname} --twin-id {twin_id} --json-patch '[
  {"op":"replace", "path":"/Temperature", "value": 20.5},
  {"op":"add", "path":"/Areas", "value": ["ControlSystem"]}
]'

Perbarui kembar digital melalui spesifikasi patch JSON yang ditentukan dalam file.

az dt twin update -n {instance_or_hostname} --twin-id {twin_id} --json-patch ./my/patch/document.json

Parameter yang Diperlukan

--dt-name --dtn -n

Nama instans digital Twins atau nama host. Jika nama instans disediakan, langganan pengguna pertama kali dikueri agar instans target mengambil nama host. Jika nama host disediakan, kueri langganan dilewati dan nilai yang disediakan digunakan untuk interaksi berikutnya.

--json-patch --patch

Spesifikasi pembaruan yang dijelaskan oleh JSON-patch. Pembaruan pada nilai properti dan elemen $model mungkin terjadi dalam permintaan yang sama. Operasi dibatasi untuk menambahkan, mengganti, dan menghapus. Sediakan jalur file atau JSON sebaris.

--twin-id -t

Id kembar digital.

Parameter Opsional

--etag -e

Nilai tag entitas. Perintah akan berhasil jika etag cocok dengan etag saat ini untuk sumber daya.

--resource-group -g

Grup sumber daya instans Digital Twins. 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.