az iot hub digital-twin

Megjegyzés:

Ez a hivatkozás az Azure CLI azure-iot bővítményének része (2.37.0-s vagy újabb verzió). A bővítmény automatikusan telepíti az az iot hub digital-twin parancsának első futtatásakor. További információ a bővítményekről.

IoT Hub-eszköz digitális ikerpéldányának kezelése és kezelése.

Parancsok

Name	Description	Típus	Állapot
az iot hub digital-twin invoke-command	Egy digitális ikereszköz gyökér- vagy összetevőszintű parancsának meghívása.	Extension	FE
az iot hub digital-twin show	IoT Hub-eszköz digitális ikerpéldányának megjelenítése.	Extension	FE
az iot hub digital-twin update	Egy digitális ikereszköz írási-olvasási tulajdonságainak frissítése JSON-javítás specifikáción keresztül.	Extension	FE

az iot hub digital-twin invoke-command

Egy digitális ikereszköz gyökér- vagy összetevőszintű parancsának meghívása.

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

Példák

Általában olyan parancsot hívhat meg, amely egy olyan hasznos adattal rendelkezik, amely bizonyos tulajdonságot tartalmaz beágyazott JSON használatával.

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

A gyökérszintű parancs "újraindítása" meghívása, amely a DTDL-modellnek megfelelő hasznos adattartalmat vesz igénybe "delay" néven 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

Meghívja a "getMaxMinReport" parancsot a "termosztát1" összetevőre, amely nem vesz fel bemenetet.

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

Kötelező paraméterek

--cn --command-name

Digitális ikerparancs neve.

--device-id -d

Céleszköz-azonosító.

Opcionális paraméterek

--component-path

Digitális ikerösszetevő elérési útja. Például: termosztát1.

--connect-timeout --cto

Az IoT Hub által az eszközhöz való csatlakozáshoz használt idő maximális időtartama másodpercben.

--hub-name -n

IoT Hub neve vagy állomásneve. Kötelező, ha a --login nincs megadva.

--login -l

Ez a parancs egy művelet végrehajtására jogosult entitást kapcsolati sztring támogat. Az "az login" használatával elkerülheti a munkamenet-bejelentkezést. Ha egy entitás kapcsolati sztring és név is meg van adva, a kapcsolati sztring elsőbbséget élvez. Ha a --hub-name nincs megadva, kötelező megadni.

--payload

JSON hasznos adatbevitel a parancshoz. Adja meg a fájl elérési útját vagy a beágyazott JSON-t.

alapértelmezett érték: {}

--resource-group -g

Az erőforráscsoport neve. Az alapértelmezett csoportot konfigurálhatja a következővel az configure --defaults group=<name>: .

--response-timeout --rto

A digitális ikerpéldány-parancs által az eredményre váró idő maximális időtartama másodpercben.

Globális paraméterek

--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

--output -o

Kimeneti formátum.

elfogadott értékek: json, jsonc, none, table, tsv, yaml, yamlc

alapértelmezett érték: json

--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést konfigurálhatja a következővel az account set -s NAME_OR_ID: .

--verbose

A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

az iot hub digital-twin show

IoT Hub-eszköz digitális ikerpéldányának megjelenítése.

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

Példák

A céleszköz digitális ikereszközének megjelenítése.

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

Kötelező paraméterek

--device-id -d

Céleszköz-azonosító.

Opcionális paraméterek

--hub-name -n

IoT Hub neve vagy állomásneve. Kötelező, ha a --login nincs megadva.

--login -l

Ez a parancs egy művelet végrehajtására jogosult entitást kapcsolati sztring támogat. Az "az login" használatával elkerülheti a munkamenet-bejelentkezést. Ha egy entitás kapcsolati sztring és név is meg van adva, a kapcsolati sztring elsőbbséget élvez. Ha a --hub-name nincs megadva, kötelező megadni.

--resource-group -g

Az erőforráscsoport neve. Az alapértelmezett csoportot konfigurálhatja a következővel az configure --defaults group=<name>: .

Globális paraméterek

--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

--output -o

Kimeneti formátum.

elfogadott értékek: json, jsonc, none, table, tsv, yaml, yamlc

alapértelmezett érték: json

--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést konfigurálhatja a következővel az account set -s NAME_OR_ID: .

--verbose

A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

az iot hub digital-twin update

Egy digitális ikereszköz írási-olvasási tulajdonságainak frissítése JSON-javítás specifikáción keresztül.

A műveletek jelenleg a hozzáadásra, a cserere és az eltávolításra korlátozódnak.

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

Példák

Frissítsen egy digitális ikerpéldányt JSON-javítás specifikáción keresztül.

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

Frissítsen egy digitális ikerpéldányt JSON-javítás specifikáción keresztül.

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}
]'

Digitális ikertulajdonság frissítése egy fájlban definiált JSON-javítás-specifikációval.

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

Kötelező paraméterek

--device-id -d

Céleszköz-azonosító.

--json-patch --patch

A JSON-patch által leírt frissítési specifikáció. A műveletek csak a hozzáadásra, a csere és az eltávolításra korlátozódnak. Adja meg a fájl elérési útját vagy a beágyazott JSON-t.

Opcionális paraméterek

--etag -e

Az erőforrás utolsó állapotának megfelelő etag vagy entitáscímke. Ha nincs megadva etag, a rendszer a "*" értéket használja.

--hub-name -n

IoT Hub neve vagy állomásneve. Kötelező, ha a --login nincs megadva.

--login -l

Ez a parancs egy művelet végrehajtására jogosult entitást kapcsolati sztring támogat. Az "az login" használatával elkerülheti a munkamenet-bejelentkezést. Ha egy entitás kapcsolati sztring és név is meg van adva, a kapcsolati sztring elsőbbséget élvez. Ha a --hub-name nincs megadva, kötelező megadni.

--resource-group -g

Az erőforráscsoport neve. Az alapértelmezett csoportot konfigurálhatja a következővel az configure --defaults group=<name>: .

Globális paraméterek

--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

--output -o

Kimeneti formátum.

elfogadott értékek: json, jsonc, none, table, tsv, yaml, yamlc

alapértelmezett érték: json

--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést konfigurálhatja a következővel az account set -s NAME_OR_ID: .

--verbose

A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.