az iot device

Megjegyzés

Ez a hivatkozás az Azure CLI Azure-iot bővítményének része (2.30.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ó üzenetküldési képességeket.

Parancsok

az iot device c2d-message	Felhőből eszközre irányuló üzenetkezelési parancsok.
az iot device c2d-message abandon	Felhőből eszközre irányuló üzenet megszakítása.
az iot device c2d-message complete	Fejezze be a felhőből az eszközre irányuló üzenetet.
az iot device c2d-message purge	A felhőből az eszközre irányuló üzenetsor végleges törlése a céleszközhöz.
az iot device c2d-message receive	Üzenet fogadása a felhőből az eszközre.
az iot device c2d-message reject	A felhőből az eszközre irányuló üzenetek elutasítása vagy letiltása.
az iot device c2d-message send	Küldjön egy felhőből az eszközre irányuló üzenetet.
az iot device registration	Az IoT Device Provisioning Service IoT-eszközregisztrációinak kezelése.
az iot device registration create	IoT-eszköz regisztrálása az IoT Device Provisioning Service-ben.
az iot device send-d2c-message	Mqtt-eszközről felhőbe irányuló üzenet küldése. A parancs támogatja az alkalmazás- és rendszertulajdonságokkal rendelkező üzenetek küldését. Megjegyzés: 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 simulate	Eszköz szimulálása egy Azure IoT Hub. Amíg az eszközszimuláció fut, az eszköz automatikusan fogadja és nyugtázza a felhőből az eszközre (c2d) irányuló üzeneteket. Mqtt-szimuláció esetén a rendszer az összes c2d-üzenetet nyugtázza a befejezéssel. A HTTP-szimulációhoz a c2d nyugtázás a felhasználó kiválasztásán alapul, amely befejezhető, elutasítható vagy megszakítható. Az mqtt-szimuláció támogatja a közvetlen metódushívást is, amely a válasz állapotkódja és a válasz hasznos adata alapján nyugtázható. Megjegyzés: A parancs alapértelmezés szerint az application/json értékre állítja a tartalomtípust, a tartalomkódolást pedig utf-8 értékre. Ez felülbírálható. Megjegyzés: 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 upload-file	Töltsön fel egy helyi fájlt eszközként egy előre konfigurált Blob Storage-tárolóba.

az iot device send-d2c-message

Mqtt-eszközről felhőbe irányuló üzenet küldése. A parancs támogatja az alkalmazás- és rendszertulajdonságokkal rendelkező üzenetek küldését. Megjegyzés: 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]
                               [--dtmi]
                               [--hub-name]
                               [--key]
                               [--key-file-path]
                               [--login]
                               [--mc]
                               [--pass]
                               [--properties]
                               [--resource-group]

Példák

Alapvető használat

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

Alapszintű használat a "dtmi:com:example:Thermostat;1" modellazonosítót regisztráló eszközhöz 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>'

Kötelező paraméterek

--device-id -d

Céleszköz.

Opcionális paraméterek

--certificate-file-path --cp

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

--da --data

Üzenettörzs.

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

--dtmi --model-id

A digitális ikerpéldány modellazonosí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 nevet. 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 élvez elsőbbséget.

--key-file-path --kp

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

--login -l

Ez a parancs olyan entitásokat támogat, kapcsolati sztring műveletek végrehajtásához szükséges jogosultságokkal. Az "az login" használatával történő munkamenet-bejelentkezés elkerülésére használható. Ha egy entitás kapcsolati sztring és név is meg van adva, a kapcsolati sztring prioritást élvez. Kötelező, ha a --hub-name nincs megadva.

--mc --msg-count

A IoT Hub küldendő eszközüzenetek száma.

alapértelmezett érték: 1

--pass --passphrase

Kulcsfájl jelszavának megadása.

--properties --props -p

Message property bag in key-value pairs with the következő format: a=b;c=d. Mqtt-üzenetküldés esetén a rendszertulajdonságokat $.=value 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 tartalomtípushoz tartozó $.ct, az üzenetazonosítóhoz a $.mid, a tartalomkódoláshoz pedig a $.ce.

--resource-group -g

Az erőforráscsoport neve. Az alapértelmezett csoportot a használatával az configure --defaults group=<name>konfigurálhatja.

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.

--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 a következővel az account set -s NAME_OR_IDkonfigurálhatja: .

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

Eszköz szimulálása egy Azure IoT Hub. Amíg az eszközszimuláció fut, az eszköz automatikusan fogadja és nyugtázza a felhőből az eszközre (c2d) érkező üzeneteket. Mqtt-szimuláció esetén a rendszer az összes c2d üzenetet nyugtázza a befejezéssel. Http-szimuláció esetén 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 állapotkódja és a válasz hasznos adata nyugtázhat. Megjegyzés: A parancs alapértelmezés szerint az application/json értékre állítja a tartalomtípust, a tartalomkódolást pedig utf-8-ra. Ez felülbírálható. Megjegyzés: 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 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;1" modellazonosítót regisztráló eszközhöz 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) rendelkező eszközhöz, 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özvetlenmetódus-válasz állapotkód és közvetlenmetódus-válasz hasznos adatainak küldése nyers JSON-ként (csak mqtt esetén)

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

Közvetlenmetódus-válasz állapotkód és közvetlenmetódus-válasz hasznos adatainak küldése elérési útként a helyi fájlba (csak mqtt)

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

Küldje el az ikereszköz jelentett tulajdonságainak kezdeti állapotát nyers JSON-ké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 elérési útként a céleszköz helyi fájljához (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 az üzenetek közötti időköznek a 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 megszakítá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.

Opcionális paraméterek

--certificate-file-path --cp

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

--da --data

Üzenettörzs.

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

--dtmi --model-id

A digitális ikerpéldány modellazonosí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 nevet. Kötelező, ha a --login nincs megadva.

--init-reported-properties --irp

Az ikerpéldány jelentett tulajdonságainak kezdeti állapota a céleszközhöz a szimulátor futtatásakor. Választható paraméter, 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 élvez elsőbbséget.

--key-file-path --kp

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

--login -l

Ez a parancs támogatja a művelet végrehajtásához szükséges jogosultságokkal rendelkező entitásokat kapcsolati sztring. Az "az login" használatával elkerülheti a munkamenet-bejelentkezést. Ha egy entitás kapcsolati sztring és a név is meg van adva, a kapcsolati sztring elsőbbséget élvez. Akkor szükséges, ha a --hub-name nincs megadva.

--mc --msg-count

A IoT Hub küldendő eszközüzenetek száma.

alapértelmezett érték: 100

--method-response-code --mrc

Az eszköz közvetlen metódusának végrehajtásakor visszaadandó állapotkód. Választható paraméter, csak mqtt esetén támogatott.

--method-response-payload --mrp

Hasznos adat, amelyet a közvetlen metódus eszközre történő végrehajtásakor kell visszaadni. Adja meg a fájl elérési útját vagy a nyers json-t. Választható paraméter, csak mqtt esetén támogatott.

--mi --msg-interval

Késleltetés másodpercek alatt 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ípushoz, a $.mid az üzenetazonosítóhoz és a $.ce a tartalomkódoláshoz. Http-üzenetkezelés esetén az alkalmazástulajdonságokat az iothub-app-=value használatával küldi el a rendszer, például iothub-app-myprop=myvalue. A rendszertulajdonságok általában az iothubhoz hasonló iothub-correlationid előtaggal rendelkeznek, 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ó üzenetprotokollt jelzi.

elfogadott értékek: http, mqtt

alapértelmezett érték: mqtt

--receive-settle --rs

Azt jelzi, hogyan rendezheti a fogadott, felhőből 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 a következővel az configure --defaults group=<name>konfigurálhatja: .

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.

--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 a következővel az account set -s NAME_OR_IDkonfigurálhatja: .

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

Töltsön fel egy helyi fájlt 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

A MIME fájltípusa.

--device-id -d

Céleszköz.

--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 nevet. Kötelező, ha a --login nincs megadva.

--login -l

Ez a parancs támogatja a művelet végrehajtásához szükséges jogosultságokkal rendelkező entitásokat kapcsolati sztring. Az "az login" használatával elkerülheti a munkamenet-bejelentkezést. Ha egy entitás kapcsolati sztring és a név is meg van adva, a kapcsolati sztring elsőbbséget élvez. Akkor szükséges, ha a --hub-name nincs megadva.

--resource-group -g

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

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.

--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 a következővel az account set -s NAME_OR_IDkonfigurálhatja: .

--verbose

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