Saran dan Komentar

az dt twin

  • Referensi

Catatan

Referensi ini adalah bagian dari ekstensi azure-iot untuk Azure CLI (versi 2.30.0 atau yang lebih tinggi). Ekstensi akan secara otomatis diinstal saat pertama kali Anda menjalankan perintah az dt twin . Pelajari lebih lanjut tentang ekstensi.

Mengelola dan mengonfigurasi kembar digital instans Digital Twins.

Perintah

az dt twin component

Menampilkan dan memperbarui komponen kembar digital dari instans Digital Twins.
az dt twin component show

Menampilkan detail komponen kembar digital.
az dt twin component update

Perbarui komponen kembar digital melalui spesifikasi patch JSON.
az dt twin create

Membuat kembar digital pada instans.
az dt twin delete

Menghapus kembar digital. Semua hubungan yang merujuk kembar ini harus sudah dihapus.
az dt twin delete-all

Menghapus semua kembar digital dalam instans Digital Twins, termasuk semua hubungan untuk kembar tersebut.
az dt twin query

Mengkueri kembar digital instans. Memungkinkan melintas hubungan dan pemfilteran menurut nilai properti.
az dt twin relationship

Mengelola dan mengonfigurasi hubungan kembar digital instans Digital Twins.
az dt twin relationship create

Buat hubungan antara kembar digital sumber dan target.
az dt twin relationship delete

Menghapus hubungan kembar digital pada instans Digital Twins.
az dt twin relationship delete-all

Menghapus semua hubungan kembar digital dalam instans Digital Twins, termasuk hubungan masuk.
az dt twin relationship list

Mencantumkan hubungan kembar digital.
az dt twin relationship show

Tampilkan detail hubungan kembar digital.
az dt twin relationship update

Updates properti hubungan antara dua kembar digital melalui spesifikasi patch JSON.
az dt twin show

Menampilkan detail kembar digital.
az dt twin telemetry

Uji dan validasi rute peristiwa dan titik akhir instans Digital Twins.
az dt twin telemetry send

Mengirim telemetri atas nama kembar digital. Jika jalur komponen disediakan, telemetri yang dipancarkan adalah atas nama komponen.
az dt twin update

Perbarui instans kembar digital melalui spesifikasi patch JSON.

az dt twin create

Membuat 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 ada (sebelumnya dibuat). 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 ada (sebelumnya dibuat). 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.

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

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

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

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

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 yang 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 yang 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
--resource-group -g

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

az dt twin show

Menampilkan detail kembar digital.

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

Contoh

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

az dt twin update

Perbarui instans kembar digital melalui spesifikasi patch JSON.

Updates ke nilai properti dan elemen $model mungkin terjadi dalam permintaan yang sama. Operasi terbatas pada penambahan, penggantian, dan penghapusan.

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. Updates ke nilai properti dan elemen $model mungkin terjadi dalam permintaan yang sama. Operasi terbatas pada penambahan, penggantian, dan penghapusan. 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>.