az iot device

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 eszközparancs első futtatásakor. További információ a bővítményekről.

Használja ki az eszközszimulációt és más eszközközpontú műveleteket, például az eszközről a felhőbe vagy a felhőből az eszközre irányuló üzenetkezelési képességeket.

Parancsok

Name	Description	Típus	Állapot
az iot device c2d-message	Felhőalapú üzenetkezelési parancsok.	Extension	FE
az iot device c2d-message abandon	Felhőből eszközre irányuló üzenet elhagyása.	Extension	FE
az iot device c2d-message complete	Töltsön ki egy felhőből eszközre irányuló üzenetet.	Extension	FE
az iot device c2d-message purge	Felhőből eszközre irányuló üzenetsor törlése egy céleszközhöz.	Extension	FE
az iot device c2d-message receive	Üzenet fogadása felhőről eszközre.	Extension	FE
az iot device c2d-message reject	Felhőből eszközre irányuló üzenet elvetése vagy letiltása.	Extension	FE
az iot device c2d-message send	Küldjön egy felhőből az eszközre irányuló üzenetet.	Extension	FE
az iot device registration	Az IoT Device Provisioning Service IoT-eszközregisztrációinak kezelése.	Extension	Előnézet megtekintése
az iot device registration create	Regisztráljon egy IoT-eszközt az IoT Device Provisioning Service-ben.	Extension	Előnézet megtekintése
az iot device send-d2c-message	Küldjön egy mqtt eszközről felhőbe irányuló üzenetet.	Extension	FE
az iot device simulate	Eszköz szimulálása egy Azure IoT Hubban.	Extension	Kísérleti
az iot device upload-file	Helyi fájl feltöltése eszközként egy előre konfigurált blobtárolóba.	Extension	FE

az iot device send-d2c-message

Küldjön egy mqtt eszközről felhőbe irányuló üzenetet.

A parancs támogatja az egyéni hasznos adatok unicode-sztringben vagy bináris formátumban történő küldését. Bináris küldéskor az adatoknak fájlból (via) --data-file-pathkell származnia, és a tartalomtípusnak a következőre kell állítania: application/octet-stream.

Megjegyzés: A parancs csak szimmetrikus kulcs-hitelesítésen (SAS) alapuló eszközökön működik. Az üzenettörzs lekérdezésének engedélyezéséhez a contentType rendszertulajdonságnak application/JSON-nak kell lennie, a contentEncoding rendszertulajdonságnak pedig az adott rendszertulajdonság által támogatott UTF kódolási értékek egyikének kell lennie (UTF-8, UTF-16 vagy UTF-32). Ha a tartalomkódolás nincs beállítva az Azure Storage útválasztási végpontként való használatakor, akkor az IoT Hub a 64-es alapformátumban írja az üzeneteket. X509 hitelesítési módszerek használata esetén meg kell adni a tanúsítványt és a kulcsfájlokat (és szükség esetén a jelszót).

az iot device send-d2c-message --device-id
                               [--certificate-file-path]
                               [--da]
                               [--data-file-path]
                               [--dtmi]
                               [--hub-name]
                               [--key]
                               [--key-file-path]
                               [--login]
                               [--mc]
                               [--pass]
                               [--properties]
                               [--resource-group]

Példák

Alapszintű használat

az iot device send-d2c-message -n {iothub_name} -d {device_id}

Alapszintű használat a "dtmi:com:example:Thermostat; modellazonosítóját regisztráló eszközhöz; 1' csatlakozáskor

az iot device send-d2c-message -n {iothub_name} -d {device_id} --model-id 'dtmi:com:example:Thermostat;1'

Alapszintű használat x509-hitelesítéssel rendelkező eszközhöz

az iot device send-d2c-message -n {iothub_name} -d {device_id} --cp {certificate_file_path} --kp {key_file_path}

Alapszintű használat x509-hitelesítéssel rendelkező eszközhöz, amelyben a kulcsfájl jelszóval rendelkezik

az iot device send-d2c-message -n {iothub_name} -d {device_id} --cp {certificate_file_path} --kp {key_file_path} --pass {passphrase}

Alapszintű használat egyéni adatokkal

az iot device send-d2c-message -n {iothub_name} -d {device_id} --data {message_body}

Alkalmazástulajdonságok küldése

az iot device send-d2c-message -n {iothub_name} -d {device_id} --props 'key0=value0;key1=value1'

Rendszertulajdonságok küldése (üzenetazonosító és korrelációs azonosító)

az iot device send-d2c-message -n {iothub_name} -d {device_id} --props '$.mid=<id>;$.cid=<id>'

Egyéni adatok küldése tartalomtípus és tartalomkódolás megadásával a rendszertulajdonságokban

az iot device send-d2c-message -n {iothub_name} -d {device_id} --props '$.ct=<content-type>;$.ce=<content-encoding>' --data {message_body}

Egyéni adatok küldése bináris formátumban tartalomkódolás megadásával a rendszertulajdonságokban

az iot device send-d2c-message -n {iothub_name} -d {device_id} --props '$.ct=application/octet-stream' --data-file-path {file_path}

Egyéni adatok küldése JSON formátumban tartalomtípus és tartalomkódolás megadásával a rendszertulajdonságokban

az iot device send-d2c-message -n {iothub_name} -d {device_id} --props '$.ct=application/json;$.ce=utf-8' --data-file-path {file_path}

Kötelező paraméterek

--device-id -d

Céleszköz-azonosító.

Opcionális paraméterek

--certificate-file-path --cp

A tanúsítványfájl elérési útja.

--da --data

Üzenet törzse. Adjon meg szöveget vagy nyers json-t.

alapértelmezett érték: Ping from Az CLI IoT Extension

--data-file-path --dfp

Előnézet

Adja meg az üzenettörzs hasznos adatfájljának elérési útját. Vegye figyelembe, hogy ha a hasznos adatokat bináris formátumban kell elküldeni, állítsa be a tartalom típusát alkalmazás/oktet-stream értékre.

--dtmi --model-id

A digitális ikermodell azonosítója, amelyről az eszköz jelentést küld a központhoz való csatlakozáskor. További részletekért lásd https://docs.microsoft.com/en-us/azure/iot-develop/overview-iot-plug-and-play .

--hub-name -n

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

--key --symmetric-key

Az eszközhöz használandó szimmetrikus kulcs. Ha a szimmetrikus kulcs és más eszközhitelesítési argumentumok meg vannak adva, a szimmetrikus kulcs elsőbbséget élvez.

--key-file-path --kp

A kulcsfájl elérési útja.

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

--mc --msg-count

Az IoT Hubnak küldendő eszközüzenetek száma.

alapértelmezett érték: 1

--pass --passphrase

Jelszó a kulcsfájlhoz.

--properties --props -p

Üzenettulajdonság-zsák kulcs-érték párokban a következő formátumban: a=b; c=d. Mqtt-üzenetküldés esetén a rendszertulajdonságokat $.=érték használatával küldheti el. A $.cid=12345 például beállítja a rendszer korrelációs azonosító tulajdonságát. Más rendszertulajdonság-azonosítók például a $.ct tartalomtípusra, a $.mid az üzenetazonosítóra és a $.ce a tartalomkódolásra.

--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 device simulate

Kísérleti

Ez a parancs kísérleti és fejlesztés alatt áll. Referencia- és támogatási szintek: https://aka.ms/CLI_refstatus

Eszköz szimulálása egy Azure IoT Hubban.

Miközben az eszközszimuláció fut, az eszköz automatikusan fogadja és nyugtázza a felhőből az eszközre (c2d) vonatkozó üzeneteket. Az mqtt-szimuláció esetében a rendszer az összes c2d üzenetet befejezéssel nyugtázza. A http-szimuláció esetében a c2d nyugtázása a felhasználó kiválasztásán alapul, amely befejezhető, elutasítható vagy elhagyható. Az mqtt-szimuláció támogatja a közvetlen metódushívást is, amelyet a válaszállapot-kód és a válasz hasznos adatai is elismerhetnek. Megjegyzés: A parancs alapértelmezés szerint a tartalomtípust application/json értékre, a tartalomkódolást pedig utf-8 értékre állítja. Ez felülbírálható. Megjegyzés: Ha x509 hitelesítési módszereket használ, meg kell adnia a tanúsítványt és a kulcsfájlokat (és szükség esetén a jelszót).

az iot device simulate --device-id
                       [--certificate-file-path]
                       [--da]
                       [--dtmi]
                       [--hub-name]
                       [--init-reported-properties]
                       [--key]
                       [--key-file-path]
                       [--login]
                       [--mc]
                       [--method-response-code]
                       [--method-response-payload]
                       [--mi]
                       [--pass]
                       [--properties]
                       [--proto {http, mqtt}]
                       [--receive-settle {abandon, complete, reject}]
                       [--resource-group]

Példák

Alapszintű használat (mqtt)

az iot device simulate -n {iothub_name} -d {device_id}

Alapszintű használat a "dtmi:com:example:Thermostat; modellazonosítóját regisztráló eszközhöz; 1' csatlakozáskor (mqtt)

az iot device simulate -n {iothub_name} -d {device_id} --model-id 'dtmi:com:example:Thermostat;1'

Alapszintű használat x509-hitelesítéssel rendelkező eszközhöz (mqtt)

az iot device simulate -n {iothub_name} -d {device_id} --cp {certificate_file_path} --kp {key_file_path}

Alapszintű használat x509-hitelesítéssel (mqtt), amelyben a kulcsfájl jelszóval rendelkezik

az iot device simulate -n {iothub_name} -d {device_id} --cp {certificate_file_path} --kp {key_file_path} --pass {passphrase}

Vegyes tulajdonságok küldése (mqtt)

az iot device simulate -n {iothub_name} -d {device_id} --properties "myprop=myvalue;$.ct=application/json"

Közvetlen metódus válaszállapotkód és közvetlen metódus válasz hasznos adatainak küldése nyers jsonként (csak mqtt)

az iot device simulate -n {iothub_name} -d {device_id} --method-response-code 201 --method-response-payload '{"result":"Direct method successful"}'

Közvetlen metódus válaszállapotkód és közvetlen metódus válasz hasznos adatainak küldése a helyi fájl elérési útjaként (csak mqtt)

az iot device simulate -n {iothub_name} -d {device_id} --method-response-code 201 --method-response-payload '../my_direct_method_payload.json'

Az ikereszköz jelentett tulajdonságainak kezdeti állapotának elküldése nyers jsonként a céleszközhöz (csak mqtt)

az iot device simulate -n {iothub_name} -d {device_id} --init-reported-properties '{"reported_prop_1":"val_1", "reported_prop_2":val_2}'

Az ikereszköz jelentett tulajdonságainak kezdeti állapotának elküldése a céleszköz helyi fájljának elérési útjaként (csak mqtt)

az iot device simulate -n {iothub_name} -d {device_id} --init-reported-properties '../my_device_twin_reported_properties.json'

Alapszintű használat (http)

az iot device simulate -n {iothub_name} -d {device_id} --protocol http

Vegyes tulajdonságok küldése (http)

az iot device simulate -n {iothub_name} -d {device_id} --protocol http --properties "iothub-app-myprop=myvalue;content-type=application/json;iothub-correlationid=12345"

Az üzenetek teljes számának és intervallumának kiválasztása

az iot device simulate -n {iothub_name} -d {device_id} --msg-count 1000 --msg-interval 5

C2D-üzenetek elutasítása (csak http esetén)

az iot device simulate -n {iothub_name} -d {device_id} --rs reject --protocol http

C2D-üzenetek elhagyása (csak http esetén)

az iot device simulate -n {iothub_name} -d {device_id} --rs abandon --protocol http

Kötelező paraméterek

--device-id -d

Céleszköz-azonosító.

Opcionális paraméterek

--certificate-file-path --cp

A tanúsítványfájl elérési útja.

--da --data

Üzenet törzse. Adjon meg szöveget vagy nyers json-t.

alapértelmezett érték: Ping from Az CLI IoT Extension

--dtmi --model-id

A digitális ikermodell azonosítója, amelyről az eszköz jelentést küld a központhoz való csatlakozáskor. További részletekért lásd https://docs.microsoft.com/en-us/azure/iot-develop/overview-iot-plug-and-play .

--hub-name -n

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

--init-reported-properties --irp

A szimulátor futtatásakor a céleszköz iker jelentett tulajdonságainak kezdeti állapota. Nem kötelező param, csak mqtt esetén támogatott.

--key --symmetric-key

Az eszközhöz használandó szimmetrikus kulcs. Ha a szimmetrikus kulcs és más eszközhitelesítési argumentumok meg vannak adva, a szimmetrikus kulcs elsőbbséget élvez.

--key-file-path --kp

A kulcsfájl elérési útja.

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

--mc --msg-count

Az IoT Hubnak küldendő eszközüzenetek száma.

alapértelmezett érték: 100

--method-response-code --mrc

A közvetlen metódus eszközre történő végrehajtásakor visszaadandó állapotkód. Nem kötelező param, csak mqtt esetén támogatott.

--method-response-payload --mrp

A közvetlen metódus eszközre történő végrehajtásakor visszaadandó hasznos adatok. Adja meg a fájl elérési útját vagy a nyers jsont. Nem kötelező param, csak mqtt esetén támogatott.

--mi --msg-interval

Késleltetés másodpercben az eszközről a felhőbe irányuló üzenetek között.

alapértelmezett érték: 3

--pass --passphrase

Jelszó a kulcsfájlhoz.

--properties --props -p

Üzenettulajdonság-zsák kulcs-érték párokban a következő formátumban: a=b; c=d. Mqtt-üzenetküldés esetén a rendszertulajdonságokat $.=érték használatával küldheti el. A $.cid=12345 például beállítja a rendszer korrelációs azonosító tulajdonságát. Más rendszertulajdonság-azonosítók például a $.ct tartalomtípusra, a $.mid az üzenetazonosítóra és a $.ce a tartalomkódolásra. Http-üzenetkezelés esetén az alkalmazás tulajdonságai az iothub-app-=value(például iothub-app-myprop=myvalue) használatával lesznek elküldve. A rendszertulajdonságok általában az iothubhoz hasonló iothub-korrelációs azonosítóval vannak előtagban, de vannak kivételek, például a tartalomtípus és a tartalomkódolás.

--proto --protocol

Az eszközről a felhőbe irányuló üzenet protokollt jelzi.

elfogadott értékek: http, mqtt

alapértelmezett érték: mqtt

--receive-settle --rs

Azt jelzi, hogyan rendezheti a fogadott felhőből az eszközre irányuló üzeneteket. Csak HTTP-vel támogatott.

elfogadott értékek: abandon, complete, reject

alapértelmezett érték: complete

--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 device upload-file

Helyi fájl feltöltése eszközként egy előre konfigurált blobtárolóba.

az iot device upload-file --content-type
                          --device-id
                          --file-path
                          [--hub-name]
                          [--login]
                          [--resource-group]

Kötelező paraméterek

--content-type --ct

MIME fájltípus.

--device-id -d

Céleszköz-azonosító.

--file-path --fp

A feltöltéshez szükséges fájl elérési útja.

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.