az iot device
Feljegyzés
Ez a hivatkozás az Azure CLI azure-iot bővítményének része (2.46.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. |
Mellék | FE |
az iot device c2d-message abandon |
Felhőből eszközre irányuló üzenet elhagyása. |
Mellék | FE |
az iot device c2d-message complete |
Töltsön ki egy felhőből eszközre irányuló üzenetet. |
Mellék | FE |
az iot device c2d-message purge |
Felhőből eszközre irányuló üzenetsor törlése egy céleszközhöz. |
Mellék | FE |
az iot device c2d-message receive |
Üzenet fogadása felhőről eszközre. |
Mellék | FE |
az iot device c2d-message reject |
Felhőből eszközre irányuló üzenet elvetése vagy letiltása. |
Mellék | FE |
az iot device c2d-message send |
Küldjön egy felhőből az eszközre irányuló üzenetet. |
Mellék | FE |
az iot device registration |
Az IoT Device Provisioning Service IoT-eszközregisztrációinak kezelése. |
Mellék | Előnézet |
az iot device registration create |
Regisztráljon egy IoT-eszközt az IoT Device Provisioning Service-ben. |
Mellék | Előnézet |
az iot device send-d2c-message |
Küldjön egy mqtt eszközről felhőbe irányuló üzenetet. |
Mellék | FE |
az iot device simulate |
Eszköz szimulálása egy Azure IoT Hubban. |
Mellék | 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. |
Mellék | 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-path
kell 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
Céleszköz-azonosító.
Opcionális paraméterek
A tanúsítványfájl elérési útja.
Üzenet törzse. Adjon meg szöveget vagy nyers json-t.
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.
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 .
IoT Hub neve vagy állomásneve. Kötelező, ha a --login nincs megadva.
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.
A kulcsfájl elérési útja.
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.
Az IoT Hubnak küldendő eszközüzenetek száma.
Jelszó a kulcsfájlhoz.
Ü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, $.mid az üzenetazonosítóhoz és a $.ce tartalomkódoláshoz.
Az erőforráscsoport neve. Az alapértelmezett csoportot konfigurálhatja a következővel az configure --defaults group=<name>
: .
Globális paraméterek
Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.
Jelenítse meg ezt a súgóüzenetet, és lépjen ki.
Csak a hibák megjelenítése, a figyelmeztetések mellőzése.
Kimeneti formátum.
JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .
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
: .
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
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
Céleszköz-azonosító.
Opcionális paraméterek
A tanúsítványfájl elérési útja.
Üzenet törzse. Adjon meg szöveget vagy nyers json-t.
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 .
IoT Hub neve vagy állomásneve. Kötelező, ha a --login nincs megadva.
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.
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.
A kulcsfájl elérési útja.
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.
Az IoT Hubnak küldendő eszközüzenetek száma.
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.
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.
Késleltetés másodpercben az eszközről a felhőbe irányuló üzenetek között.
Jelszó a kulcsfájlhoz.
Ü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, $.mid az üzenetazonosítóhoz és a $.ce tartalomkódoláshoz. 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.
Az eszközről a felhőbe irányuló üzenet protokollt jelzi.
Azt jelzi, hogyan rendezheti a fogadott felhőből az eszközre irányuló üzeneteket. Csak HTTP-vel támogatott.
Az erőforráscsoport neve. Az alapértelmezett csoportot konfigurálhatja a következővel az configure --defaults group=<name>
: .
Globális paraméterek
Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.
Jelenítse meg ezt a súgóüzenetet, és lépjen ki.
Csak a hibák megjelenítése, a figyelmeztetések mellőzése.
Kimeneti formátum.
JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .
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
: .
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
MIME fájltípus.
Céleszköz-azonosító.
A feltöltéshez szükséges fájl elérési útja.
Opcionális paraméterek
IoT Hub neve vagy állomásneve. Kötelező, ha a --login nincs megadva.
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.
Az erőforráscsoport neve. Az alapértelmezett csoportot konfigurálhatja a következővel az configure --defaults group=<name>
: .
Globális paraméterek
Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.
Jelenítse meg ezt a súgóüzenetet, és lépjen ki.
Csak a hibák megjelenítése, a figyelmeztetések mellőzése.
Kimeneti formátum.
JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .
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
: .
A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.