az iot hub digital-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ı, bir az iot hub digital-twin komutunu ilk kez çalıştırdığınızda otomatik olarak yüklenir. Uzantılar hakkında daha fazla bilgi edinin.

IoT Hub cihazının dijital ikizini işleme ve bunlarla etkileşim kurma.

Komutlar

Name	Description	Tür	Durum
az iot hub digital-twin invoke-command	Dijital ikiz cihazının kök veya bileşen düzeyi komutunu çağırın.	Dahili	GA
az iot hub digital-twin show	IoT Hub cihazının dijital ikizini gösterme.	Dahili	GA
az iot hub digital-twin update	JSON düzeltme eki belirtimi aracılığıyla dijital ikiz cihazının okuma-yazma özelliklerini güncelleştirin.	Dahili	GA

az iot hub digital-twin invoke-command

Dijital ikiz cihazının kök veya bileşen düzeyi komutunu çağırın.

az iot hub digital-twin invoke-command --cn
                                       --device-id
                                       [--component-path]
                                       [--connect-timeout]
                                       [--hub-name]
                                       [--login]
                                       [--payload]
                                       [--resource-group]
                                       [--response-timeout]

Örnekler

Genel olarak, satır içi JSON kullanarak belirli özelliği içeren bir yük alan komutu çağırabilirsiniz.

az iot hub digital-twin invoke-command --command-name {command_name} -n {iothub_name} -d {device_id} --payload '{"property_name": "property_value"}'

DTDL modeline uygun "delay" adlı bir yük alan "reboot" kök düzeyi komutunu çağır https://github.com/Azure/opendigitaltwins-dtdl/blob/master/DTDL/v2/samples/TemperatureController.json.

az iot hub digital-twin invoke-command --command-name reboot -n {iothub_name} -d {device_id} --payload 5

Giriş almayan "thermostat1" bileşeninde "getMaxMinReport" komutunu çağır.

az iot hub digital-twin invoke-command --cn getMaxMinReport -n {iothub_name} -d {device_id} --component-path thermostat1

Gerekli Parametreler

--cn --command-name

Dijital ikiz komut adı.

--device-id -d

Hedef Cihaz Kimliği.

İsteğe Bağlı Parametreler

--component-path

Dijital ikiz bileşen yolu. Örneğin: termostat1.

--connect-timeout --cto

IoT Hub'ın cihaza bağlanmaya çalışacağı en uzun süre (saniye cinsinden).

--hub-name -n

IoT Hub adı veya ana bilgisayar adı. --login sağlanmadıysa gereklidir.

--login -l

Bu komut, eylem gerçekleştirme haklarına sahip bir varlık bağlantı dizesi destekler. "az login" aracılığıyla oturum açmaktan kaçınmak için kullanın. Hem varlık bağlantı dizesi hem de ad sağlanırsa, bağlantı dizesi öncelik alır. --hub-name sağlanmadıysa gereklidir.

--payload

Komut için JSON yük girişi. Dosya yolu veya satır içi JSON sağlayın.

Default value: {}

--resource-group -g

Kaynak grubunun adı. kullanarak varsayılan grubu az configure --defaults group=<name>yapılandırabilirsiniz.

--response-timeout --rto

Dijital ikiz komutunun sonucu bekleyeceği en uzun süre (saniye cinsinden).

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.

--help -h

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

--only-show-errors

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

--output -o

Çıkış biçimi.

Kabul edilen değerler: json, jsonc, none, table, tsv, yaml, yamlc

Default value: json

--query

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

--subscription

Aboneliğin adı veya kimliği. kullanarak az account set -s NAME_OR_IDvarsayı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.

az iot hub digital-twin show

IoT Hub cihazının dijital ikizini gösterme.

az iot hub digital-twin show --device-id
                             [--hub-name]
                             [--login]
                             [--resource-group]

Örnekler

Hedef cihaz dijital ikizini gösterin.

az iot hub digital-twin show -n {iothub_name} -d {device_id}

Gerekli Parametreler

--device-id -d

Hedef Cihaz Kimliği.

İsteğe Bağlı Parametreler

--hub-name -n

IoT Hub adı veya ana bilgisayar adı. --login sağlanmadıysa gereklidir.

--login -l

Bu komut, eylem gerçekleştirme haklarına sahip bir varlık bağlantı dizesi destekler. "az login" aracılığıyla oturum açmaktan kaçınmak için kullanın. Hem varlık bağlantı dizesi hem de ad sağlanırsa, bağlantı dizesi öncelik alır. --hub-name sağlanmadıysa gereklidir.

--resource-group -g

Kaynak grubunun adı. kullanarak varsayılan grubu az configure --defaults group=<name>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.

--help -h

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

--only-show-errors

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

--output -o

Çıkış biçimi.

Kabul edilen değerler: json, jsonc, none, table, tsv, yaml, yamlc

Default value: json

--query

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

--subscription

Aboneliğin adı veya kimliği. kullanarak az account set -s NAME_OR_IDvarsayı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.

az iot hub digital-twin update

JSON düzeltme eki belirtimi aracılığıyla dijital ikiz cihazının okuma-yazma özelliklerini güncelleştirin.

Şu anda işlemler ekleme, değiştirme ve kaldırma işlemleriyle sınırlıdır.

az iot hub digital-twin update --device-id
                               --json-patch
                               [--etag]
                               [--hub-name]
                               [--login]
                               [--resource-group]

Örnekler

JSON düzeltme eki belirtimi aracılığıyla bir dijital ikizi güncelleştirin.

az iot hub digital-twin update --hub-name {iothub_name} --device-id {device_id} --json-patch '{"op":"add", "path":"/thermostat1/targetTemperature", "value": 54}'

JSON düzeltme eki belirtimi aracılığıyla bir dijital ikizi güncelleştirin.

az iot hub digital-twin update -n {iothub_name} -d {device_id} --json-patch '[
  {"op":"remove", "path":"/thermostat1/targetTemperature"},
  {"op":"add", "path":"/thermostat2/targetTemperature", "value": 22}
]'

Bir dosyada tanımlanan JSON düzeltme eki belirtimi aracılığıyla dijital ikiz özelliğini güncelleştirin.

az iot hub digital-twin update -n {iothub_name} -d {device_id} --json-patch ./my/patch/document.json

Gerekli Parametreler

--device-id -d

Hedef Cihaz Kimliği.

--json-patch --patch

JSON düzeltme eki tarafından açıklanan bir güncelleştirme belirtimi. İş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.

İsteğe Bağlı Parametreler

--etag -e

Kaynağın son durumuna karşılık gelen etag veya varlık etiketi. Etag sağlanmadıysa '*' değeri kullanılır.

--hub-name -n

IoT Hub adı veya ana bilgisayar adı. --login sağlanmadıysa gereklidir.

--login -l

Bu komut, eylem gerçekleştirme haklarına sahip bir varlık bağlantı dizesi destekler. "az login" aracılığıyla oturum açmaktan kaçınmak için kullanın. Hem varlık bağlantı dizesi hem de ad sağlanırsa, bağlantı dizesi öncelik alır. --hub-name sağlanmadıysa gereklidir.

--resource-group -g

Kaynak grubunun adı. kullanarak varsayılan grubu az configure --defaults group=<name>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.

--help -h

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

--only-show-errors

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

--output -o

Çıkış biçimi.

Kabul edilen değerler: json, jsonc, none, table, tsv, yaml, yamlc

Default value: json

--query

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

--subscription

Aboneliğin adı veya kimliği. kullanarak az account set -s NAME_OR_IDvarsayı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.