az dt twin relationship

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 relationship. Pelajari selengkapnya tentang ekstensi.

Mengelola dan mengonfigurasi hubungan kembar digital instans Digital Twins.

Perintah

Nama	Deskripsi	Jenis	Status
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 relationship create

Buat hubungan antara kembar digital sumber dan target.

--properties dapat berupa JSON sebaris atau jalur file.

az dt twin relationship create --dt-name --dtn
                               --kind --relationship
                               --relationship-id
                               --source --twin-id
                               --target --target-twin-id
                               [--acquire-policy-token]
                               [--change-reference]
                               [--if-none-match]
                               [--properties]
                               [--resource-group]

Contoh

Buat hubungan antara dua kembar digital.

az dt twin relationship create -n {instance_or_hostname} --relationship-id {relationship_id} --relationship contains --twin-id {source_twin_id} --target {target_twin_id}

Membuat hubungan antara dua kembar digital dengan tag if-none-match

az dt twin relationship create -n {instance_or_hostname} --relationship-id {relationship_id} --relationship contains --twin-id {source_twin_id} --target {target_twin_id} --if-none-match

Buat hubungan dengan properti yang diinisialisasi antara dua kembar digital.

az dt twin relationship create -n {instance_or_hostname} --relationship-id {relationship_id} --relationship contains --twin-id {source_twin_id} --target {target_twin_id} --properties '{"ownershipUser": "me", "ownershipDepartment": "Computer Science"}'

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.

--kind --relationship

Nama atau jenis hubungan. Misalnya: 'contains'.

--relationship-id -r

Id Hubungan.

--source --twin-id -t

Id kembar sumber untuk hubungan.

--target --target-twin-id

Id kembar target untuk hubungan.

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 hubungan kembar digital. Sediakan jalur file atau JSON sebaris.

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

Menghapus hubungan kembar digital pada instans Digital Twins.

az dt twin relationship delete --dt-name --dtn
                               --relationship-id
                               --source --twin-id
                               [--acquire-policy-token]
                               [--change-reference]
                               [--etag]
                               [--resource-group]

Contoh

Menghapus hubungan kembar digital.

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

Menghapus hubungan kembar digital menggunakan etag.

az dt twin relationship delete -n {instance_or_hostname} --twin-id {twin_id} --relationship-id {relationship_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.

--relationship-id -r

Id Hubungan.

--source --twin-id -t

Id kembar sumber untuk hubungan.

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 relationship delete-all

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

az dt twin relationship delete-all --dt-name --dtn
                                   [--acquire-policy-token]
                                   [--change-reference]
                                   [--resource-group]
                                   [--source --twin-id]
                                   [--yes]

Contoh

Hapus semua hubungan kembar digital yang terkait dengan kembar.

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

Hapus semua hubungan kembar digital dalam instace Digital Twins.

az dt twin relationship 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}.

--source --twin-id -t

Id kembar sumber untuk hubungan.

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

Mencantumkan hubungan kembar digital.

az dt twin relationship list --dt-name --dtn
                             --source --twin-id
                             [--incoming {false, true}]
                             [--kind --relationship]
                             [--resource-group]

Contoh

Mencantumkan hubungan keluar dari kembar digital.

az dt twin relationship list -n {instance_or_hostname} --twin-id {twin_id}

Mencantumkan hubungan keluar dari kembar digital dan filter pada hubungan 'contains'

az dt twin relationship list -n {instance_or_hostname} --twin-id {twin_id} --relationship contains

Mencantumkan hubungan masuk dari kembar digital.

az dt twin relationship list -n {instance_or_hostname} --twin-id {twin_id} --incoming

Cantumkan hubungan masuk kembar digital dan filter pada hubungan 'contains'.

az dt twin relationship list -n {instance_or_hostname} --twin-id {twin_id} --relationship contains --incoming

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.

--source --twin-id -t

Id kembar sumber untuk hubungan.

Parameter Opsional

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

--incoming

Mengambil semua hubungan masuk untuk kembar digital.

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

--kind --relationship

Memfilter hasil berdasarkan jenis hubungan.

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

Memperlihatkan detail hubungan kembar digital.

az dt twin relationship show --dt-name --dtn
                             --relationship-id
                             --source --twin-id
                             [--resource-group]

Contoh

Memperlihatkan detail hubungan kembar digital.

az dt twin relationship show -n {instance_or_hostname} --twin-id {twin_id} --relationship-id {relationship_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.

--relationship-id -r

Id Hubungan.

--source --twin-id -t

Id kembar sumber untuk hubungan.

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

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

Operasi dibatasi untuk menambahkan, mengganti, dan menghapus.

az dt twin relationship update --dt-name --dtn
                               --json-patch --patch
                               --relationship-id
                               --source --twin-id
                               [--acquire-policy-token]
                               [--change-reference]
                               [--etag]
                               [--resource-group]

Contoh

Perbarui hubungan kembar digital melalui spesifikasi patch JSON.

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

Perbarui hubungan kembar digital melalui spesifikasi patch JSON dan menggunakan etag.

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

Perbarui hubungan kembar digital melalui spesifikasi patch JSON.

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

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

az dt twin relationship update -n {instance_or_hostname} --twin-id {twin_id} --relationship-id {relationship_id} --relationship contains --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.

--relationship-id -r

Id Hubungan.

--source --twin-id -t

Id kembar sumber untuk hubungan.

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