az dt twin

Catatan

Referensi ini adalah bagian dari ekstensi azure-iot untuk Azure CLI (versi 2.46.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.