az dt twin

Note

Bu başvuru, Azure CLI (sürüm 2.67.0 veya üzeri) için azure-iot uzantısının bir parçasıdır. uzantı, bir 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.	Extension	GA
az dt twin component show	Dijital ikiz bileşeninin ayrıntılarını gösterin.	Extension	GA
az dt twin component update	JSON düzeltme eki belirtimi aracılığıyla bir dijital ikiz bileşenini güncelleştirin.	Extension	GA
az dt twin create	Bir örnekte dijital ikiz oluşturma.	Extension	GA
az dt twin delete	Dijital ikiz kaldırma. Bu ikize başvuran tüm ilişkiler zaten silinmelidir.	Extension	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.	Extension	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.	Extension	GA
az dt twin relationship	Digital Twins örneğinin dijital ikiz ilişkilerini yönetin ve yapılandırın.	Extension	GA
az dt twin relationship create	Kaynak ve hedef dijital ikizler arasında bir ilişki oluşturun.	Extension	GA
az dt twin relationship delete	Digital Twins örneğindeki dijital ikiz ilişkisini silme.	Extension	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.	Extension	GA
az dt twin relationship list	Dijital ikizin ilişkilerini listeleme.	Extension	GA
az dt twin relationship show	Dijital ikiz ilişkisinin ayrıntılarını gösterir.	Extension	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.	Extension	GA
az dt twin show	Dijital ikizin ayrıntılarını gösterin.	Extension	GA
az dt twin telemetry	Digital Twins örneğinin olay yollarını ve uç noktalarını test edin ve doğrulayın.	Extension	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.	Extension	GA
az dt twin update	JSON düzeltme eki belirtimi aracılığıyla örnek dijital ikizini güncelleştirin.	Extension	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 --dtn
                  --dtmi --model-id
                  --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

--dt-name --dtn -n

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.

--dtmi --model-id -m

Digital Twins model kimliği. Örnek: dtmi:com:example:Room;2.

--twin-id -t

Dijital ikiz kimliği.

İsteğe Bağlı Parametreler

Aşağıdaki parametreler isteğe bağlıdır, ancak bağlama bağlı olarak komutun başarıyla yürütülmesi için bir veya daha fazla parametre gerekli olabilir.

--if-none-match

Aynı kimlikte mevcut bir ikiz varsa oluşturma işleminin başarısız olması gerektiğini gösterir.

Özellik	Değer
Default value:	False

--properties -p

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.

--resource-group -g

Digital Twins örneği kaynak grubu. az configure --defaults group={name}kullanarak varsayılan grubu yapılandırabilirsiniz.

Global Parametreler

--debug

Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.

Özellik	Değer
Default value:	False

--help -h

Bu yardım iletisini göster ve çık.

--only-show-errors

Yalnızca hataları gösterir ve uyarıları gizler.

Özellik	Değer
Default value:	False

--output -o

Çıkış biçimi.

Özellik	Değer
Default value:	json
Kabul edilen değerler:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz. http://jmespath.org/.

--subscription

Aboneliğin adı veya kimliği. az account set -s NAME_OR_IDkullanarak varsayılan aboneliği yapılandırabilirsiniz.

--verbose

Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.

Özellik	Değer
Default value:	False

az dt twin delete

Dijital ikiz kaldırma. Bu ikize başvuran tüm ilişkiler zaten silinmelidir.

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

--dt-name --dtn -n

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.

--twin-id -t

Dijital ikiz kimliği.

İsteğe Bağlı Parametreler

Aşağıdaki parametreler isteğe bağlıdır, ancak bağlama bağlı olarak komutun başarıyla yürütülmesi için bir veya daha fazla parametre gerekli olabilir.

--etag -e

Varlık etiketi değeri. Etag kaynağın geçerli etag'iyle eşleşirse komut başarılı olur.

--resource-group -g

Digital Twins örneği kaynak grubu. az configure --defaults group={name}kullanarak varsayılan grubu yapılandırabilirsiniz.

Global Parametreler

--debug

Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.

Özellik	Değer
Default value:	False

--help -h

Bu yardım iletisini göster ve çık.

--only-show-errors

Yalnızca hataları gösterir ve uyarıları gizler.

Özellik	Değer
Default value:	False

--output -o

Çıkış biçimi.

Özellik	Değer
Default value:	json
Kabul edilen değerler:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz. http://jmespath.org/.

--subscription

Aboneliğin adı veya kimliği. az account set -s NAME_OR_IDkullanarak varsayılan aboneliği yapılandırabilirsiniz.

--verbose

Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.

Özellik	Değer
Default value:	False

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

--dt-name --dtn -n

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

Aşağıdaki parametreler isteğe bağlıdır, ancak bağlama bağlı olarak komutun başarıyla yürütülmesi için bir veya daha fazla parametre gerekli olabilir.

--resource-group -g

Digital Twins örneği kaynak grubu. az configure --defaults group={name}kullanarak varsayılan grubu yapılandırabilirsiniz.

--yes -y

Onay istemde bulunmayın.

Özellik	Değer
Default value:	False

Global Parametreler

--debug

Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.

Özellik	Değer
Default value:	False

--help -h

Bu yardım iletisini göster ve çık.

--only-show-errors

Yalnızca hataları gösterir ve uyarıları gizler.

Özellik	Değer
Default value:	False

--output -o

Çıkış biçimi.

Özellik	Değer
Default value:	json
Kabul edilen değerler:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz. http://jmespath.org/.

--subscription

Aboneliğin adı veya kimliği. az account set -s NAME_OR_IDkullanarak varsayılan aboneliği yapılandırabilirsiniz.

--verbose

Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.

Özellik	Değer
Default value:	False

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, ikizin $ özelliğine başvurmak için $dtId karakteri kullanılır. Bash benzeri kabuklarda veya PowerShell'de $ karakterinin 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ı belgesi https://learn.microsoft.com/en-us/azure/digital-twins/concepts-cli gözden geçirin.

az dt twin query --dt-name --dtn
                 --query-command
                 [--cost --show-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

--dt-name --dtn -n

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.

--query-command -q

Yürütülecek kullanıcı sorgusu.

İsteğe Bağlı Parametreler

Aşağıdaki parametreler isteğe bağlıdır, ancak bağlama bağlı olarak komutun başarıyla yürütülmesi için bir veya daha fazla parametre gerekli olabilir.

--cost --show-cost

Sorgu ücretini hesaplar ve gösterir.

Özellik	Değer
Default value:	False
Kabul edilen değerler:	false, true

--resource-group -g

Digital Twins örneği kaynak grubu. az configure --defaults group={name}kullanarak varsayılan grubu yapılandırabilirsiniz.

Global Parametreler

--debug

Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.

Özellik	Değer
Default value:	False

--help -h

Bu yardım iletisini göster ve çık.

--only-show-errors

Yalnızca hataları gösterir ve uyarıları gizler.

Özellik	Değer
Default value:	False

--output -o

Çıkış biçimi.

Özellik	Değer
Default value:	json
Kabul edilen değerler:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz. http://jmespath.org/.

--subscription

Aboneliğin adı veya kimliği. az account set -s NAME_OR_IDkullanarak varsayılan aboneliği yapılandırabilirsiniz.

--verbose

Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.

Özellik	Değer
Default value:	False

az dt twin show

Dijital ikizin ayrıntılarını gösterin.

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

--dt-name --dtn -n

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.

--twin-id -t

Dijital ikiz kimliği.

İsteğe Bağlı Parametreler

Aşağıdaki parametreler isteğe bağlıdır, ancak bağlama bağlı olarak komutun başarıyla yürütülmesi için bir veya daha fazla parametre gerekli olabilir.

--resource-group -g

Digital Twins örneği kaynak grubu. az configure --defaults group={name}kullanarak varsayılan grubu yapılandırabilirsiniz.

Global Parametreler

--debug

Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.

Özellik	Değer
Default value:	False

--help -h

Bu yardım iletisini göster ve çık.

--only-show-errors

Yalnızca hataları gösterir ve uyarıları gizler.

Özellik	Değer
Default value:	False

--output -o

Çıkış biçimi.

Özellik	Değer
Default value:	json
Kabul edilen değerler:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz. http://jmespath.org/.

--subscription

Aboneliğin adı veya kimliği. az account set -s NAME_OR_IDkullanarak varsayılan aboneliği yapılandırabilirsiniz.

--verbose

Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.

Özellik	Değer
Default value:	False

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 --dtn
                  --json-patch --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

--dt-name --dtn -n

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

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.

--twin-id -t

Dijital ikiz kimliği.

İsteğe Bağlı Parametreler

Aşağıdaki parametreler isteğe bağlıdır, ancak bağlama bağlı olarak komutun başarıyla yürütülmesi için bir veya daha fazla parametre gerekli olabilir.

--etag -e

Varlık etiketi değeri. Etag kaynağın geçerli etag'iyle eşleşirse komut başarılı olur.

--resource-group -g

Digital Twins örneği kaynak grubu. az configure --defaults group={name}kullanarak varsayılan grubu yapılandırabilirsiniz.

Global Parametreler

--debug

Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.

Özellik	Değer
Default value:	False

--help -h

Bu yardım iletisini göster ve çık.

--only-show-errors

Yalnızca hataları gösterir ve uyarıları gizler.

Özellik	Değer
Default value:	False

--output -o

Çıkış biçimi.

Özellik	Değer
Default value:	json
Kabul edilen değerler:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz. http://jmespath.org/.

--subscription

Aboneliğin adı veya kimliği. az account set -s NAME_OR_IDkullanarak varsayılan aboneliği yapılandırabilirsiniz.

--verbose

Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.

Özellik	Değer
Default value:	False