az iot device c2d-message

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 device c2d-message parancs első futtatásakor. További információ a bővítményekről.

Felhőből eszközre irányuló üzenetkezelési parancsok.

Parancsok

az iot device c2d-message abandon	Felhőből eszközre irányuló üzenet elhagyá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 céleszközhöz tartozó üzenetsor törlése a felhőből az eszközre.
az iot device c2d-message receive	Üzenet fogadása a felhőből az eszközre.
az iot device c2d-message reject	Felhőből eszközre irányuló üzenetek elutasítása vagy letiltása.
az iot device c2d-message send	Küldjön egy felhőből eszközre irányuló üzenetet.

az iot device c2d-message abandon

Felhőből eszközre irányuló üzenet elhagyása.

az iot device c2d-message abandon --device-id
                                  [--etag]
                                  [--hub-name]
                                  [--login]
                                  [--resource-group]

Kötelező paraméterek

--device-id -d

Céleszköz.

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

az iot device c2d-message complete

Fejezze be a felhőből az eszközre irányuló üzenetet.

az iot device c2d-message complete --device-id
                                   [--etag]
                                   [--hub-name]
                                   [--login]
                                   [--resource-group]

Kötelező paraméterek

--device-id -d

Céleszköz.

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

az iot device c2d-message purge

A céleszközhöz tartozó üzenetsor törlése a felhőből az eszközre.

az iot device c2d-message purge --device-id
                                [--hub-name]
                                [--login]
                                [--resource-group]

Kötelező paraméterek

--device-id -d

Céleszköz.

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.

az iot device c2d-message receive

Üzenet fogadása a felhőből az eszközre.

Megjegyzés: A [--complete, --reject, --abandon] argumentum csak egy üzenetmegfelelési argumentumot fogad el.

az iot device c2d-message receive --device-id
                                  [--abandon {false, true}]
                                  [--complete {false, true}]
                                  [--hub-name]
                                  [--lock-timeout]
                                  [--login]
                                  [--reject {false, true}]
                                  [--resource-group]

Példák

Alapvető használat

az iot device c2d-message receive -d {device_id} -n {hub_name} -g {resource_group}

Üzenet fogadása és 30 másodperces zárolási időtúllépés beállítása az üzenethez

az iot device c2d-message receive -d {device_id} -n {hub_name} -g {resource_group} --lt {30}

Üzenet fogadása és "készként" való megjelölése a fogadás után

az iot device c2d-message receive -d {device_id} -n {hub_name} -g {resource_group} --complete

Üzenet fogadása és elutasítása a fogadás után

az iot device c2d-message receive -d {device_id} -n {hub_name} -g {resource_group} --reject

Kötelező paraméterek

--device-id -d

Céleszköz.

Opcionális paraméterek

--abandon

A beérkezés után hagyja abba a felhőből az eszközre irányuló üzenetet.

elfogadott értékek: false, true

--complete

A beérkezés után töltse ki a felhőből az eszközre irányuló üzenetet.

elfogadott értékek: false, true

--hub-name -n

IoT Hub nevet. Kötelező, ha a --login nincs megadva.

--lock-timeout --lt

Azt határozza meg, hogy az üzenetek mennyi ideig legyenek láthatatlanok a többi fogadási hívás számára.

alapértelmezett érték: 60

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

--reject

A beérkezés után utasítsa el a felhőből az eszközre irányuló üzenetet.

elfogadott értékek: false, true

--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 c2d-message reject

Felhőből eszközre irányuló üzenetek elutasítása vagy letiltása.

az iot device c2d-message reject --device-id
                                 [--etag]
                                 [--hub-name]
                                 [--login]
                                 [--resource-group]

Kötelező paraméterek

--device-id -d

Céleszköz.

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

az iot device c2d-message send

Küldjön egy felhőből eszközre irányuló üzenetet.

Ez a parancs az első végrehajtáskor függő Cython-csomagot (uamqp) használ és telepíthet. https://github.com/Azure/azure-uamqp-python.

az iot device c2d-message send --device-id
                               [--ack {full, negative, positive}]
                               [--auth-type {key, login}]
                               [--ce]
                               [--cid]
                               [--content-type]
                               [--da]
                               [--expiry]
                               [--hub-name]
                               [--login]
                               [--message-id]
                               [--properties]
                               [--repair {false, true}]
                               [--resource-group]
                               [--uid]
                               [--wait {false, true}]
                               [--yes {false, true}]

Példák

Alapszintű használat az alapértelmezett üzenettörzsgel

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

Felhőből eszközre irányuló üzenet küldése egyéni adatokkal és tulajdonságokkal.

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

C2D-üzenet küldése és az eszköz nyugtázása

az iot device c2d-message send -d {device_id} -n {iothub_name} --ack full --wait

Kötelező paraméterek

--device-id -d

Céleszköz.

Opcionális paraméterek

--ack

Kérje az üzenet végleges állapotával kapcsolatos üzenetenkénti visszajelzés kézbesítését. Az ack értékek leírása a következő. Pozitív: Ha a c2d üzenet eléri a Kész állapotot, IoT Hub visszajelzési üzenetet hoz létre. Negatív: Ha a c2d üzenet a Kézbesítetlen betűs állapotba ér, IoT Hub visszajelzési üzenetet hoz létre. Teljes: IoT Hub mindkét esetben visszajelzést küld. Alapértelmezés szerint a rendszer nem kér egy kérést sem.

elfogadott értékek: full, negative, positive

--auth-type

Azt jelzi, hogy a műveletnek automatikusan le kell-e származtatnia egy szabályzatkulcsot, vagy az aktuális Azure AD munkamenetet kell-e használnia. Az alapértelmezett beállításokat a következővel az configure --defaults iothub-data-auth-type=<auth-type-value>konfigurálhatja: .

elfogadott értékek: key, login

alapértelmezett érték: key

--ce --content-encoding

A C2D üzenettörzs kódolása.

alapértelmezett érték: utf-8

--cid --correlation-id

A C2D-üzenethez társított korrelációs azonosító.

--content-type --ct

A C2D üzenettörzs tartalomtípusa.

--da --data

Üzenettörzs.

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

--expiry --expiry-time-utc

Az egységek unix korszak óta ezredmásodpercek. Ha nincs idő jelezve, az alapértelmezett IoT Hub C2D-üzenet TTL-t használ.

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

--message-id --mid

A C2D üzenetazonosítója. Ha nincs megadva üzenetazonosító, létrejön egy UUID.

--properties --props -p

Üzenettulajdonság-zsák kulcs-érték párokban a következő formátumban: a=b;c=d.

--repair -r

Telepítse újra az uamqp függőséget, amely kompatibilis a bővítmény verziójával. Alapértelmezett érték: false (hamis).

elfogadott értékek: false, true

--resource-group -g

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

--uid --user-id

A C2D-üzenet, a felhasználói azonosító tulajdonság.

--wait -w

Ha be van állítva, a c2d küldési művelet le lesz tiltva, amíg az eszközre vonatkozó visszajelzés nem érkezik.

elfogadott értékek: false, true

--yes -y

Felhasználói kérések kihagyása. A függőség telepítésének elfogadását jelzi (ha szükséges). Elsősorban automatizálási forgatókönyvekhez használatos. Alapértelmezett érték: false (hamis).

elfogadott értékek: false, true

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.