az dt twin
Not
Bu başvuru, Azure CLI (sürüm 2.46.0 veya üzeri) için azure-iot uzantısının bir parçasıdır. Uzantı, az dt twin komutunu ilk kez çalıştırdığınızda otomatik olarak yüklenir. Uzantılar hakkında daha fazla bilgi edinin.
Digital Twins örneğinin dijital ikizlerini yönetin ve yapılandırın.
Komutlar
Name | Description | Tür | Durum |
---|---|---|---|
az dt twin component |
Digital Twins örneğinin dijital ikiz bileşenlerini gösterin ve güncelleştirin. |
Dahili | GA |
az dt twin component show |
Dijital ikiz bileşeninin ayrıntılarını gösterin. |
Dahili | GA |
az dt twin component update |
JSON düzeltme eki belirtimi aracılığıyla bir dijital ikiz bileşenini güncelleştirin. |
Dahili | GA |
az dt twin create |
Bir örnekte dijital ikiz oluşturma. |
Dahili | GA |
az dt twin delete |
Dijital ikiz kaldırma. Bu ikize başvuran tüm ilişkiler zaten silinmelidir. |
Dahili | GA |
az dt twin delete-all |
Bir Digital Twins örneğindeki tüm dijital ikizleri siler ve bu ikizler için tüm ilişkiler de dahil olmak üzere. |
Dahili | GA |
az dt twin query |
Örneğin dijital ikizlerini sorgulama. İlişkilerin geçiş yapmasına ve özellik değerlerine göre filtrelenmesine izin verir. |
Dahili | GA |
az dt twin relationship |
Digital Twins örneğinin dijital ikiz ilişkilerini yönetin ve yapılandırın. |
Dahili | GA |
az dt twin relationship create |
Kaynak ve hedef dijital ikizler arasında bir ilişki oluşturun. |
Dahili | GA |
az dt twin relationship delete |
Digital Twins örneğindeki dijital ikiz ilişkisini silme. |
Dahili | GA |
az dt twin relationship delete-all |
Gelen ilişkiler de dahil olmak üzere bir Digital Twins örneği içindeki tüm dijital ikiz ilişkilerini siler. |
Dahili | GA |
az dt twin relationship list |
Dijital ikizin ilişkilerini listeleme. |
Dahili | GA |
az dt twin relationship show |
Dijital ikiz ilişkisinin ayrıntılarını gösterir. |
Dahili | GA |
az dt twin relationship update |
JSON düzeltme eki belirtimi aracılığıyla iki dijital ikiz arasındaki ilişkinin özelliklerini güncelleştirir. |
Dahili | GA |
az dt twin show |
Dijital ikizin ayrıntılarını gösterin. |
Dahili | GA |
az dt twin telemetry |
Digital Twins örneğinin olay yollarını ve uç noktalarını test edin ve doğrulayın. |
Dahili | GA |
az dt twin telemetry send |
Bir dijital ikiz adına telemetri gönderir. Bileşen yolu sağlanmışsa, yayılan telemetri bileşen adınadır. |
Dahili | GA |
az dt twin update |
JSON düzeltme eki belirtimi aracılığıyla örnek dijital ikizini güncelleştirin. |
Dahili | GA |
az dt twin create
Bir örnekte dijital ikiz oluşturma.
--properties satır içi JSON veya dosya yolu olabilir. Not: Bileşenler içeren ikizler için --properties gereklidir.
az dt twin create --dt-name
--dtmi
--twin-id
[--if-none-match]
[--properties]
[--resource-group]
Örnekler
Mevcut (önceden oluşturulmuş) bir modelden dijital ikiz oluşturun.
az dt twin create -n {instance_or_hostname} --dtmi "dtmi:com:example:Room;1" --twin-id {twin_id}
If-none-match etiketiyle mevcut (önceden oluşturulmuş) bir modelden dijital ikiz oluşturun.
az dt twin create -n {instance_or_hostname} --dtmi "dtmi:com:example:Room;1" --twin-id {twin_id} --if-none-match
Mevcut (önceden oluşturulmuş) bir modelden dijital ikiz oluşturun. Özellik değerleriyle örnek oluşturma.
az dt twin create -n {instance_or_hostname} --dtmi "dtmi:com:example:DeviceInformation;1" --twin-id {twin_id} --properties '{"manufacturer": "Microsoft"}'
Mevcut (önceden oluşturulmuş) modellerden bileşen içeren bir dijital ikiz oluşturun. Minimum özelliklerle bileşenin örneğini oluşturma.
az dt twin create -n {instance_or_hostname} --dtmi "dtmi:com:example:TemperatureController;1" --twin-id {twin_id} --properties '{
"Thermostat": {
"$metadata": {},
}
}'
Mevcut (önceden oluşturulmuş) modellerden bileşen içeren bir dijital ikiz oluşturun. Özellik değerleriyle örnek oluşturma.
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
}
}'
Gerekli Parametreler
Digital Twins örneği adı veya konak adı. Bir örnek adı sağlanırsa, hedef örneğin konak adını alması için önce kullanıcı aboneliği sorgulanır. Bir konak adı sağlanırsa abonelik sorgusu atlanır ve sağlanan değer sonraki etkileşim için kullanılır.
Digital Twins model kimliği. Örnek: dtmi:com:example:Room;2.
Dijital ikiz kimliği.
İsteğe Bağlı Parametreler
Aynı kimlikte mevcut bir ikiz varsa oluşturma işleminin başarısız olması gerektiğini gösterir.
Dijital ikizin veya ilgili bileşenlerin örneğini oluşturmak için ilk özellik değerleri. Dosya yolu veya satır içi JSON sağlayın. Bileşenler içeren ikizler için özellikler gereklidir; en azından her bileşen için boş bir $metadata nesnesi sağlamanız gerekir.
Digital Twins örneği kaynak grubu. kullanarak varsayılan grubu az configure --defaults group=<name>
yapılandırabilirsiniz.
Global Parametreler
Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.
Bu yardım iletisini göster ve çık.
Yalnızca hataları gösterir ve uyarıları gizler.
Çıkış biçimi.
JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz http://jmespath.org/ .
Aboneliğin adı veya kimliği. kullanarak az account set -s NAME_OR_ID
varsayılan aboneliği yapılandırabilirsiniz.
Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.
az dt twin delete
Dijital ikiz kaldırma. Bu ikize başvuran tüm ilişkiler zaten silinmelidir.
az dt twin delete --dt-name
--twin-id
[--etag]
[--resource-group]
Örnekler
Kimliğine göre bir dijital ikizi kaldırın.
az dt twin delete -n {instance_or_hostname} --twin-id {twin_id}
Etag'i kullanarak kimliğine göre bir dijital ikizi kaldırın.
az dt twin delete -n {instance_or_hostname} --twin-id {twin_id} --etag {etag}
Gerekli Parametreler
Digital Twins örneği adı veya konak adı. Bir örnek adı sağlanırsa, hedef örneğin konak adını alması için önce kullanıcı aboneliği sorgulanır. Bir konak adı sağlanırsa abonelik sorgusu atlanır ve sağlanan değer sonraki etkileşim için kullanılır.
Dijital ikiz kimliği.
İsteğe Bağlı Parametreler
Varlık etiketi değeri. Etag kaynağın geçerli etag'iyle eşleşirse komut başarılı olur.
Digital Twins örneği kaynak grubu. kullanarak varsayılan grubu az configure --defaults group=<name>
yapılandırabilirsiniz.
Global Parametreler
Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.
Bu yardım iletisini göster ve çık.
Yalnızca hataları gösterir ve uyarıları gizler.
Çıkış biçimi.
JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz http://jmespath.org/ .
Aboneliğin adı veya kimliği. kullanarak az account set -s NAME_OR_ID
varsayılan aboneliği yapılandırabilirsiniz.
Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.
az dt twin delete-all
Bir Digital Twins örneğindeki tüm dijital ikizleri siler ve bu ikizler için tüm ilişkiler de dahil olmak üzere.
az dt twin delete-all --dt-name
[--resource-group]
[--yes]
Örnekler
Tüm dijital ikizleri silin. İkizlere başvuran tüm ilişkiler de silinir.
az dt twin delete-all -n {instance_or_hostname}
Gerekli Parametreler
Digital Twins örneği adı veya konak adı. Bir örnek adı sağlanırsa, hedef örneğin konak adını alması için önce kullanıcı aboneliği sorgulanır. Bir konak adı sağlanırsa abonelik sorgusu atlanır ve sağlanan değer sonraki etkileşim için kullanılır.
İsteğe Bağlı Parametreler
Digital Twins örneği kaynak grubu. kullanarak varsayılan grubu az configure --defaults group=<name>
yapılandırabilirsiniz.
Onay istemde bulunmayın.
Global Parametreler
Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.
Bu yardım iletisini göster ve çık.
Yalnızca hataları gösterir ve uyarıları gizler.
Çıkış biçimi.
JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz http://jmespath.org/ .
Aboneliğin adı veya kimliği. kullanarak az account set -s NAME_OR_ID
varsayılan aboneliği yapılandırabilirsiniz.
Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.
az dt twin query
Örneğin dijital ikizlerini sorgulama. İlişkilerin geçiş yapmasına ve özellik değerlerine göre filtrelenmesine izin verir.
Birçok ikiz sorgusunda $
karakter, ikizin özelliğine $dtId
başvurmak için kullanılır. Bash benzeri kabuklarda veya powershell'de karakterin $
işlevsel anlamı vardır ve sorgu girişinin bir parçası olarak kaçış karakteri kullanılmalıdır. Daha fazla bilgi için lütfen Digital Twins CLI kavramları belgesini https://docs.microsoft.com/en-us/azure/digital-twins/concepts-cli gözden geçirin.
az dt twin query --dt-name
--query-command
[--cost {false, true}]
[--resource-group]
Örnekler
Hedef örnekteki tüm dijital ikizleri sorgulayıp tüm öznitelikleri projeleyin. Ayrıca maliyeti sorgu birimlerinde de gösterir.
az dt twin query -n {instance_or_hostname} -q "select * from digitaltwins" --show-cost
Modele göre sorgulama ve tüm öznitelikleri yansıtma.
az dt twin query -n {instance_or_hostname} -q "select * from digitaltwins T where IS_OF_MODEL(T, 'dtmi:com:example:Room;2')"
Bash uyumlu söz dizimi ile '$dtId' yararlanan sorgu
az dt twin query -n {instance_or_hostname} --query-command "SELECT * FROM DigitalTwins T Where T.\$dtId = 'room0'"
PowerShell uyumlu söz dizimi ile '$dtId' yararlanan sorgu
az dt twin query -n {instance_or_hostname} --query-command "SELECT * FROM DigitalTwins T Where T.`$dtId = 'room0'"
Gerekli Parametreler
Digital Twins örneği adı veya konak adı. Bir örnek adı sağlanırsa, hedef örneğin konak adını alması için önce kullanıcı aboneliği sorgulanır. Bir konak adı sağlanırsa abonelik sorgusu atlanır ve sağlanan değer sonraki etkileşim için kullanılır.
Yürütülecek kullanıcı sorgusu.
İsteğe Bağlı Parametreler
Sorgu ücretini hesaplar ve gösterir.
Digital Twins örneği kaynak grubu. kullanarak varsayılan grubu az configure --defaults group=<name>
yapılandırabilirsiniz.
Global Parametreler
Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.
Bu yardım iletisini göster ve çık.
Yalnızca hataları gösterir ve uyarıları gizler.
Çıkış biçimi.
JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz http://jmespath.org/ .
Aboneliğin adı veya kimliği. kullanarak az account set -s NAME_OR_ID
varsayılan aboneliği yapılandırabilirsiniz.
Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.
az dt twin show
Dijital ikizin ayrıntılarını gösterin.
az dt twin show --dt-name
--twin-id
[--resource-group]
Örnekler
Dijital ikizin ayrıntılarını gösterin.
az dt twin show -n {instance_or_hostname} --twin-id {twin_id}
Gerekli Parametreler
Digital Twins örneği adı veya konak adı. Bir örnek adı sağlanırsa, hedef örneğin konak adını alması için önce kullanıcı aboneliği sorgulanır. Bir konak adı sağlanırsa abonelik sorgusu atlanır ve sağlanan değer sonraki etkileşim için kullanılır.
Dijital ikiz kimliği.
İsteğe Bağlı Parametreler
Digital Twins örneği kaynak grubu. kullanarak varsayılan grubu az configure --defaults group=<name>
yapılandırabilirsiniz.
Global Parametreler
Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.
Bu yardım iletisini göster ve çık.
Yalnızca hataları gösterir ve uyarıları gizler.
Çıkış biçimi.
JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz http://jmespath.org/ .
Aboneliğin adı veya kimliği. kullanarak az account set -s NAME_OR_ID
varsayılan aboneliği yapılandırabilirsiniz.
Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.
az dt twin update
JSON düzeltme eki belirtimi aracılığıyla örnek dijital ikizini güncelleştirin.
Özellik değerlerine ve $model öğelerine yönelik güncelleştirmeler aynı istekte gerçekleşebilir. İşlemler ekleme, değiştirme ve kaldırma işlemleriyle sınırlıdır.
az dt twin update --dt-name
--json-patch
--twin-id
[--etag]
[--resource-group]
Örnekler
JSON düzeltme eki belirtimi aracılığıyla bir dijital ikizi güncelleştirin.
az dt twin update -n {instance_or_hostname} --twin-id {twin_id} --json-patch '{"op":"replace", "path":"/Temperature", "value": 20.5}'
JSON düzeltme eki belirtimi ve etag kullanarak bir dijital ikiz güncelleştirin.
az dt twin update -n {instance_or_hostname} --twin-id {twin_id} --etag {etag} --json-patch '{"op":"replace", "path":"/Temperature", "value": 20.5}'
JSON düzeltme eki belirtimi aracılığıyla bir dijital ikizi güncelleştirin.
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"]}
]'
Bir dosyada tanımlanan JSON düzeltme eki belirtimi aracılığıyla bir dijital ikizi güncelleştirin.
az dt twin update -n {instance_or_hostname} --twin-id {twin_id} --json-patch ./my/patch/document.json
Gerekli Parametreler
Digital Twins örneği adı veya konak adı. Bir örnek adı sağlanırsa, hedef örneğin konak adını alması için önce kullanıcı aboneliği sorgulanır. Bir konak adı sağlanırsa abonelik sorgusu atlanır ve sağlanan değer sonraki etkileşim için kullanılır.
JSON düzeltme eki tarafından açıklanan bir güncelleştirme belirtimi. Özellik değerlerine ve $model öğelerine yönelik güncelleştirmeler aynı istekte gerçekleşebilir. İşlemler ekleme, değiştirme ve kaldırma işlemleriyle sınırlıdır. Dosya yolu veya satır içi JSON sağlayın.
Dijital ikiz kimliği.
İsteğe Bağlı Parametreler
Varlık etiketi değeri. Etag kaynağın geçerli etag'iyle eşleşirse komut başarılı olur.
Digital Twins örneği kaynak grubu. kullanarak varsayılan grubu az configure --defaults group=<name>
yapılandırabilirsiniz.
Global Parametreler
Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.
Bu yardım iletisini göster ve çık.
Yalnızca hataları gösterir ve uyarıları gizler.
Çıkış biçimi.
JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz http://jmespath.org/ .
Aboneliğin adı veya kimliği. kullanarak az account set -s NAME_OR_ID
varsayılan aboneliği yapılandırabilirsiniz.
Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.