az iot device
Notitie
Deze referentie maakt deel uit van de azure-iot-extensie voor Azure CLI en vereist versie 2.17.1 of hoger. De extensie wordt automatisch geïnstalleerd wanneer u de opdracht az iot device voor het eerst gebruikt. Meer informatie over extensies.
Maak gebruik van berichten van apparaat naar cloud en van cloud naar apparaat.
Opdracht
| az iot device c2d-message |
Berichtenopdrachten van cloud naar apparaat. |
| az iot device c2d-message abandon |
Een cloud-naar-apparaat-bericht verlaten. |
| az iot device c2d-message complete |
Voltooi een cloud-naar-apparaat-bericht. |
| az iot device c2d-message purge |
De berichtenwachtrij van de cloud naar het apparaat opseensen voor een doelapparaat. |
| az iot device c2d-message receive |
Een cloud-naar-apparaat-bericht ontvangen. |
| az iot device c2d-message reject |
Een cloud-naar-apparaat-bericht afwijzen of in een impasse schrijven. |
| az iot device c2d-message send |
Een cloud-naar-apparaat-bericht verzenden. |
| az iot device send-d2c-message |
Een mqttt-apparaat-naar-cloud-bericht verzenden. De opdracht ondersteunt het verzenden van berichten met toepassings- en systeemeigenschappen. Opmerking: de opdracht werkt alleen voor apparaten op basis van symmetrische sleutelversleuteling (SAS). |
| az iot device simulate |
Een apparaat in een Azure IoT Hub. Terwijl de apparaatsimulatie wordt uitgevoerd, ontvangt en bevestigt het apparaat automatisch cloud-naar-apparaat-berichten (c2d). Voor mqtt-simulatie worden alle c2d-berichten bevestigd met voltooiing. Voor http-simulatie is c2d-bevestiging gebaseerd op gebruikersselectie die volledig kan zijn, kan worden afgewezen of verlaten. Daarnaast wordt mqtt-simulatie alleen ondersteund voor apparaten op basis van symmetrische sleutelversleuteling (SAS) Opmerking: met de opdracht wordt standaard het inhoudstype ingesteld op application/json en content-encoding op utf-8. Dit kan worden overschrijven. |
| az iot device upload-file |
Upload lokaal bestand als een apparaat toevoegen aan een vooraf geconfigureerde blobopslagcontainer. |
az iot device send-d2c-message
Een mqttt-apparaat-naar-cloud-bericht verzenden. De opdracht ondersteunt het verzenden van berichten met toepassings- en systeemeigenschappen.
Opmerking: de opdracht werkt alleen voor apparaten op basis van symmetrische sleutelversleuteling (SAS).
az iot device send-d2c-message --device-id
[--da]
[--hub-name]
[--login]
[--mc]
[--properties]
[--qos {0, 1}]
[--resource-group]
Voorbeelden
Basisgebruik
az iot device send-d2c-message -n {iothub_name} -d {device_id}
Basisgebruik met aangepaste gegevens
az iot device send-d2c-message -n {iothub_name} -d {device_id} --data {message_body}
Toepassingseigenschappen verzenden
az iot device send-d2c-message -n {iothub_name} -d {device_id} --props 'key0=value0;key1=value1'
Systeemeigenschappen verzenden (bericht-id en correlatie-id)
az iot device send-d2c-message -n {iothub_name} -d {device_id} --props '$.mid=<id>;$.cid=<id>'
Vereiste parameters
Doelapparaat.
Optionele parameters
Bericht.
IoT Hub naam.
Deze opdracht ondersteunt een entiteitsgroep connection string rechten om actie uit te voeren. Gebruik om sessie-aanmelding via 'az login' te voorkomen. Als zowel een entiteits-connection string als de naam zijn opgegeven, heeft connection string prioriteit.
Het aantal apparaatberichten dat naar de IoT Hub.
Berichten in sleutel-waardeparen met de volgende indeling: a=b;c=d. Voor mqtt messaging: u kunt systeemeigenschappen verzenden met behulp van $. = waarde. Bijvoorbeeld$.cid=12345 stelt de eigenschap van de systeemcorrelatie-id in. Andere voorbeelden van systeem-eigenschaps-id's zijn $.ct als inhoudstype, $.mid voor bericht-id en $.ce voor inhoudscoderen.
Quality of Service. 0 = ten minste één keer, 1 = ten minste één keer. 2 (Exact één keer) wordt niet ondersteund. Deze opdrachtparameter is afgeschaft en wordt verwijderd in de volgende release.
De naam van de resourcegroep. U kunt de standaardgroep configureren met az configure --defaults group=<name> behulp van .
Vergroot de logboekbebossing om alle logboeken voor foutopsporing weer te geven.
Laat dit Help-bericht zien en sluit af.
Alleen fouten weergeven, waarschuwingen onderdrukken.
Uitvoerindeling.
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Vergroot de logboekverkenbaarheid. Gebruik --debug voor volledige logboeken voor foutopsporing.
az iot device simulate
Een apparaat in een Azure IoT Hub.
Terwijl de apparaatsimulatie wordt uitgevoerd, ontvangt en bevestigt het apparaat automatisch cloud-naar-apparaat-berichten (c2d). Voor mqtt-simulatie worden alle c2d-berichten bevestigd met voltooiing. Voor http-simulatie is c2d-bevestiging gebaseerd op gebruikersselectie die volledig kan zijn, kan worden afgewezen of verlaten. Daarnaast wordt mqtt-simulatie alleen ondersteund voor apparaten op basis van symmetrische sleutelversleuteling (SAS)
Opmerking: met de opdracht wordt standaard het inhoudstype ingesteld op application/json en content-encoding op utf-8. Dit kan worden overschrijven.
az iot device simulate --device-id
[--da]
[--hub-name]
[--login]
[--mc]
[--mi]
[--properties]
[--proto {http, mqtt}]
[--receive-settle {abandon, complete, reject}]
[--resource-group]
Voorbeelden
Basisgebruik (mqtt)
az iot device simulate -n {iothub_name} -d {device_id}
Basisgebruik (mqtt) met het verzenden van gemengde eigenschappen
az iot device simulate -n {iothub_name} -d {device_id} --properties "myprop=myvalue;$.ct=application/json"
Basisgebruik (http)
az iot device simulate -n {iothub_name} -d {device_id} --protocol http
Basisgebruik (http) met het verzenden van gemengde eigenschappen
az iot device simulate -n {iothub_name} -d {device_id} --protocol http --properties "iothub-app-myprop=myvalue;content-type=application/json;iothub-correlationid=12345"
Kies het totale aantal berichten en het interval tussen berichten
az iot device simulate -n {iothub_name} -d {device_id} --msg-count 1000 --msg-interval 5
C2D-berichten weigeren (alleen http)
az iot device simulate -n {iothub_name} -d {device_id} --rs reject --protocol http
C2D-berichten verlaten (alleen http)
az iot device simulate -n {iothub_name} -d {device_id} --rs abandon --protocol http
Vereiste parameters
Doelapparaat.
Optionele parameters
Bericht.
IoT Hub naam.
Deze opdracht ondersteunt een entiteitsgroep connection string rechten om actie uit te voeren. Gebruik om sessie-aanmelding via 'az login' te voorkomen. Als zowel een entiteits-connection string als de naam zijn opgegeven, heeft connection string prioriteit.
Het aantal apparaatberichten dat naar de IoT Hub.
Vertraging in seconden tussen apparaat-naar-cloud-berichten.
Berichten in sleutel-waardeparen met de volgende indeling: a=b;c=d. Voor mqtt messaging: u kunt systeemeigenschappen verzenden met behulp van $. = waarde. Bijvoorbeeld$.cid=12345 stelt de eigenschap van de systeemcorrelatie-id in. Andere voorbeelden van systeem-eigenschaps-id's zijn $.ct als inhoudstype, $.mid voor bericht-id en $.ce voor inhoudscoderen. Voor http-berichten worden toepassingseigenschappen verzonden met behulp van iothub-app- =value, bijvoorbeeld iothub-app-myprop=myvalue. Systeemeigenschappen worden over het algemeen vooraf laten gaan door iothub, zoals iothub-correlationid, maar er zijn uitzonderingen zoals inhoudstype en content-encoding.
Geeft het apparaat-naar-cloud-berichtprotocol aan.
Geeft aan hoe ontvangen cloud-naar-apparaat-berichten moeten worden vereffend. Alleen ondersteund met HTTP.
De naam van de resourcegroep. U kunt de standaardgroep configureren met az configure --defaults group=<name> behulp van .
Vergroot de logboekbebossing om alle logboeken voor foutopsporing weer te geven.
Laat dit Help-bericht zien en sluit af.
Alleen fouten weergeven, waarschuwingen onderdrukken.
Uitvoerindeling.
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Vergroot de logboekverkenbaarheid. Gebruik --debug voor volledige logboeken voor foutopsporing.
az iot device upload-file
Upload lokaal bestand als een apparaat toevoegen aan een vooraf geconfigureerde blobopslagcontainer.
az iot device upload-file --content-type
--device-id
--file-path
[--hub-name]
[--login]
[--resource-group]
Vereiste parameters
MIME-type van bestand.
Doelapparaat.
Pad naar bestand om te uploaden.
Optionele parameters
IoT Hub naam.
Deze opdracht ondersteunt een entiteitsgroep connection string rechten om actie uit te voeren. Gebruik om sessie-aanmelding via 'az login' te voorkomen. Als zowel een entiteits-connection string als de naam zijn opgegeven, heeft connection string prioriteit.
De naam van de resourcegroep. U kunt de standaardgroep configureren met az configure --defaults group=<name> behulp van .
Vergroot de logboekbebossing om alle logboeken voor foutopsporing weer te geven.
Laat dit Help-bericht zien en sluit af.
Alleen fouten weergeven, waarschuwingen onderdrukken.
Uitvoerindeling.
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Vergroot de logboekverkenbaarheid. Gebruik --debug voor volledige logboeken voor foutopsporing.