az dt twin

Note

Referensi ini adalah bagian dari ekstensi azure-iot untuk Azure CLI (versi 2.67.0 atau yang lebih tinggi). Ekstensi akan secara otomatis menginstal pertama kali Anda menjalankan perintah az dt twin. Pelajari selengkapnya 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.	Extension	GA
az dt twin component show	Tampilkan detail komponen kembar digital.	Extension	GA
az dt twin component update	Perbarui komponen kembar digital melalui spesifikasi patch JSON.	Extension	GA
az dt twin create	Buat kembar digital pada instans.	Extension	GA
az dt twin delete	Menghapus kembar digital. Semua hubungan yang merujuk kembar ini harus sudah dihapus.	Extension	GA
az dt twin delete-all	Menghapus semua kembar digital dalam instans Digital Twins, termasuk semua hubungan untuk kembar tersebut.	Extension	GA
az dt twin query	Mengkueri kembar digital instans. Memungkinkan melintas hubungan dan pemfilteran menurut nilai properti.	Extension	GA
az dt twin relationship	Mengelola dan mengonfigurasi hubungan kembar digital instans Digital Twins.	Extension	GA
az dt twin relationship create	Buat hubungan antara kembar digital sumber dan target.	Extension	GA
az dt twin relationship delete	Menghapus hubungan kembar digital pada instans Digital Twins.	Extension	GA
az dt twin relationship delete-all	Menghapus semua hubungan kembar digital dalam instans Digital Twins, termasuk hubungan masuk.	Extension	GA
az dt twin relationship list	Mencantumkan hubungan kembar digital.	Extension	GA
az dt twin relationship show	Memperlihatkan detail hubungan kembar digital.	Extension	GA
az dt twin relationship update	Memperbarui properti hubungan antara dua kembar digital melalui spesifikasi patch JSON.	Extension	GA
az dt twin show	Tampilkan detail kembar digital.	Extension	GA
az dt twin telemetry	Menguji dan memvalidasi rute peristiwa dan titik akhir instans Digital Twins.	Extension	GA
az dt twin telemetry send	Mengirim telemetri atas nama kembar digital. Jika jalur komponen disediakan, telemetri yang dipancarkan adalah atas nama komponen.	Extension	GA
az dt twin update	Perbarui instans digital twin melalui spesifikasi patch JSON.	Extension	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 --dtn
                  --dtmi --model-id
                  --twin-id
                  [--acquire-policy-token]
                  [--change-reference]
                  [--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

Parameter berikut bersifat opsional, tetapi tergantung pada konteksnya, satu atau beberapa mungkin menjadi diperlukan agar perintah berhasil dijalankan.

--acquire-policy-token

Memperoleh token Azure Policy secara otomatis untuk operasi sumber daya ini.

Properti	Nilai
Grup parameter:	Global Policy Arguments

--change-reference

ID referensi perubahan terkait untuk operasi sumber daya ini.

Properti	Nilai
Grup parameter:	Global Policy Arguments

--if-none-match

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

Properti	Nilai
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

Tingkatkan verbositas pengelogan untuk menampilkan semua log debug.

Properti	Nilai
Nilai default:	False

--help -h

Tampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya tampilkan kesalahan, menekan peringatan.

Properti	Nilai
Nilai default:	False

--output -o

Format output.

Properti	Nilai
Nilai default:	json
Nilai yang diterima:	json, jsonc, none, table, tsv, yaml, yamlc

--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi dan contoh selengkapnya.

--subscription

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

--verbose

Tingkatkan verbositas pengelogan. Gunakan --debug untuk log debug penuh.

Properti	Nilai
Nilai default:	False

az dt twin delete

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

az dt twin delete --dt-name --dtn
                  --twin-id
                  [--acquire-policy-token]
                  [--change-reference]
                  [--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

Parameter berikut bersifat opsional, tetapi tergantung pada konteksnya, satu atau beberapa mungkin menjadi diperlukan agar perintah berhasil dijalankan.

--acquire-policy-token

Memperoleh token Azure Policy secara otomatis untuk operasi sumber daya ini.

Properti	Nilai
Grup parameter:	Global Policy Arguments

--change-reference

ID referensi perubahan terkait untuk operasi sumber daya ini.

Properti	Nilai
Grup parameter:	Global Policy Arguments

--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

Tingkatkan verbositas pengelogan untuk menampilkan semua log debug.

Properti	Nilai
Nilai default:	False

--help -h

Tampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya tampilkan kesalahan, menekan peringatan.

Properti	Nilai
Nilai default:	False

--output -o

Format output.

Properti	Nilai
Nilai default:	json
Nilai yang diterima:	json, jsonc, none, table, tsv, yaml, yamlc

--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi dan contoh selengkapnya.

--subscription

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

--verbose

Tingkatkan verbositas pengelogan. Gunakan --debug untuk log debug penuh.

Properti	Nilai
Nilai default:	False

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 --dtn
                      [--acquire-policy-token]
                      [--change-reference]
                      [--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

Parameter berikut bersifat opsional, tetapi tergantung pada konteksnya, satu atau beberapa mungkin menjadi diperlukan agar perintah berhasil dijalankan.

--acquire-policy-token

Memperoleh token Azure Policy secara otomatis untuk operasi sumber daya ini.

Properti	Nilai
Grup parameter:	Global Policy Arguments

--change-reference

ID referensi perubahan terkait untuk operasi sumber daya ini.

Properti	Nilai
Grup parameter:	Global Policy Arguments

--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.

Properti	Nilai
Nilai default:	False

Parameter Global

--debug

Tingkatkan verbositas pengelogan untuk menampilkan semua log debug.

Properti	Nilai
Nilai default:	False

--help -h

Tampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya tampilkan kesalahan, menekan peringatan.

Properti	Nilai
Nilai default:	False

--output -o

Format output.

Properti	Nilai
Nilai default:	json
Nilai yang diterima:	json, jsonc, none, table, tsv, yaml, yamlc

--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi dan contoh selengkapnya.

--subscription

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

--verbose

Tingkatkan verbositas pengelogan. Gunakan --debug untuk log debug penuh.

Properti	Nilai
Nilai default:	False

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 $dtId kembar. Dalam shell seperti bash atau powershell, karakter $ memiliki arti fungsional dan harus diloloskan sebagai bagian dari input kueri. Harap tinjau dokumen konsep Digital Twins CLI https://learn.microsoft.com/en-us/azure/digital-twins/concepts-cli untuk informasi lebih lanjut.

az dt twin query --dt-name --dtn
                 --query-command
                 [--acquire-policy-token]
                 [--change-reference]
                 [--cost --show-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

Parameter berikut bersifat opsional, tetapi tergantung pada konteksnya, satu atau beberapa mungkin menjadi diperlukan agar perintah berhasil dijalankan.

--acquire-policy-token

Memperoleh token Azure Policy secara otomatis untuk operasi sumber daya ini.

Properti	Nilai
Grup parameter:	Global Policy Arguments

--change-reference

ID referensi perubahan terkait untuk operasi sumber daya ini.

Properti	Nilai
Grup parameter:	Global Policy Arguments

--cost --show-cost

Menghitung dan memperlihatkan biaya kueri.

Properti	Nilai
Nilai default:	False
Nilai yang diterima:	false, true

--resource-group -g

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

Parameter Global

--debug

Tingkatkan verbositas pengelogan untuk menampilkan semua log debug.

Properti	Nilai
Nilai default:	False

--help -h

Tampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya tampilkan kesalahan, menekan peringatan.

Properti	Nilai
Nilai default:	False

--output -o

Format output.

Properti	Nilai
Nilai default:	json
Nilai yang diterima:	json, jsonc, none, table, tsv, yaml, yamlc

--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi dan contoh selengkapnya.

--subscription

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

--verbose

Tingkatkan verbositas pengelogan. Gunakan --debug untuk log debug penuh.

Properti	Nilai
Nilai default:	False

az dt twin show

Tampilkan detail kembar digital.

az dt twin show --dt-name --dtn
                --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

Parameter berikut bersifat opsional, tetapi tergantung pada konteksnya, satu atau beberapa mungkin menjadi diperlukan agar perintah berhasil dijalankan.

--resource-group -g

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

Parameter Global

--debug

Tingkatkan verbositas pengelogan untuk menampilkan semua log debug.

Properti	Nilai
Nilai default:	False

--help -h

Tampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya tampilkan kesalahan, menekan peringatan.

Properti	Nilai
Nilai default:	False

--output -o

Format output.

Properti	Nilai
Nilai default:	json
Nilai yang diterima:	json, jsonc, none, table, tsv, yaml, yamlc

--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi dan contoh selengkapnya.

--subscription

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

--verbose

Tingkatkan verbositas pengelogan. Gunakan --debug untuk log debug penuh.

Properti	Nilai
Nilai default:	False

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 --dtn
                  --json-patch --patch
                  --twin-id
                  [--acquire-policy-token]
                  [--change-reference]
                  [--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

Parameter berikut bersifat opsional, tetapi tergantung pada konteksnya, satu atau beberapa mungkin menjadi diperlukan agar perintah berhasil dijalankan.

--acquire-policy-token

Memperoleh token Azure Policy secara otomatis untuk operasi sumber daya ini.

Properti	Nilai
Grup parameter:	Global Policy Arguments

--change-reference

ID referensi perubahan terkait untuk operasi sumber daya ini.

Properti	Nilai
Grup parameter:	Global Policy Arguments

--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

Tingkatkan verbositas pengelogan untuk menampilkan semua log debug.

Properti	Nilai
Nilai default:	False

--help -h

Tampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya tampilkan kesalahan, menekan peringatan.

Properti	Nilai
Nilai default:	False

--output -o

Format output.

Properti	Nilai
Nilai default:	json
Nilai yang diterima:	json, jsonc, none, table, tsv, yaml, yamlc

--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi dan contoh selengkapnya.

--subscription

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

--verbose

Tingkatkan verbositas pengelogan. Gunakan --debug untuk log debug penuh.

Properti	Nilai
Nilai default:	False