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

--device-id -d

Doelapparaat.

Optionele parameters

--da --data

Bericht.

standaardwaarde: Ping from Az CLI IoT Extension
--hub-name -n

IoT Hub naam.

--login -l

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.

--mc --msg-count

Het aantal apparaatberichten dat naar de IoT Hub.

standaardwaarde: 1
--properties --props -p

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.

--qos

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.

geaccepteerde waarden: 0, 1
standaardwaarde: 1
--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met az configure --defaults group=<name> behulp van .

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

--device-id -d

Doelapparaat.

Optionele parameters

--da --data

Bericht.

standaardwaarde: Ping from Az CLI IoT Extension
--hub-name -n

IoT Hub naam.

--login -l

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.

--mc --msg-count

Het aantal apparaatberichten dat naar de IoT Hub.

standaardwaarde: 100
--mi --msg-interval

Vertraging in seconden tussen apparaat-naar-cloud-berichten.

standaardwaarde: 3
--properties --props -p

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.

--proto --protocol

Geeft het apparaat-naar-cloud-berichtprotocol aan.

geaccepteerde waarden: http, mqtt
standaardwaarde: mqtt
--receive-settle --rs

Geeft aan hoe ontvangen cloud-naar-apparaat-berichten moeten worden vereffend. Alleen ondersteund met HTTP.

geaccepteerde waarden: abandon, complete, reject
standaardwaarde: complete
--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met az configure --defaults group=<name> behulp van .

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

--content-type --ct

MIME-type van bestand.

--device-id -d

Doelapparaat.

--file-path --fp

Pad naar bestand om te uploaden.

Optionele parameters

--hub-name -n

IoT Hub naam.

--login -l

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.

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met az configure --defaults group=<name> behulp van .