Dela via

az iot device c2d-message

Note

This reference is part of the azure-iot extension for the Azure CLI (version 2.59.0 or higher). Tillägget installeras automatiskt första gången du kör ett kommandot az iot device c2d-message. Learn more about extensions.

Meddelandekommandon från moln till enhet.

Kommandon

Name Description Typ Status
az iot device c2d-message abandon

Överge ett meddelande från moln till enhet.

 Extension GA
az iot device c2d-message complete

Slutför ett meddelande från moln till enhet.

 Extension GA
az iot device c2d-message purge

Rensa meddelandekön från moln till enhet för en målenhet.

 Extension GA
az iot device c2d-message receive

Ta emot ett meddelande från moln till enhet.

 Extension GA
az iot device c2d-message reject

Avvisa eller deadletter ett meddelande från molnet till enheten.

 Extension GA
az iot device c2d-message send

Skicka ett meddelande från moln till enhet.

 Extension GA

az iot device c2d-message abandon

Överge ett meddelande från moln till enhet.

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

Obligatoriska parametrar

--device-id -d

Målenhets-ID.

Valfria parametrar

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--etag -e

Etag eller entitetstagg som motsvarar resursens sista tillstånd. Om ingen etag anges används värdet *.

--hub-name -n

IoT Hub-namn eller värdnamn. Krävs om --login inte har angetts.

Egenskap Värde
Parameter group: IoT Hub Identifier Arguments
--login -l

Det här kommandot stöder en entitet anslutningssträng med behörighet att utföra åtgärder. Använd för att undvika sessionsinloggning via "az login". Om både en entitet anslutningssträng och namn anges prioriteras anslutningssträng. Krävs om --hub-name inte anges.

Egenskap Värde
Parameter group: IoT Hub Identifier Arguments
--resource-group -g

Namn på resursgrupp. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

Egenskap Värde
Standardvärde: False
--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

Egenskap Värde
Standardvärde: False
--output -o

Output format.

Egenskap Värde
Standardvärde: json
Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

Egenskap Värde
Standardvärde: False

az iot device c2d-message complete

Slutför ett meddelande från moln till enhet.

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

Obligatoriska parametrar

--device-id -d

Målenhets-ID.

Valfria parametrar

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--etag -e

Etag eller entitetstagg som motsvarar resursens sista tillstånd. Om ingen etag anges används värdet *.

--hub-name -n

IoT Hub-namn eller värdnamn. Krävs om --login inte har angetts.

Egenskap Värde
Parameter group: IoT Hub Identifier Arguments
--login -l

Det här kommandot stöder en entitet anslutningssträng med behörighet att utföra åtgärder. Använd för att undvika sessionsinloggning via "az login". Om både en entitet anslutningssträng och namn anges prioriteras anslutningssträng. Krävs om --hub-name inte anges.

Egenskap Värde
Parameter group: IoT Hub Identifier Arguments
--resource-group -g

Namn på resursgrupp. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

Egenskap Värde
Standardvärde: False
--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

Egenskap Värde
Standardvärde: False
--output -o

Output format.

Egenskap Värde
Standardvärde: json
Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

Egenskap Värde
Standardvärde: False

az iot device c2d-message purge

Rensa meddelandekön från moln till enhet för en målenhet.

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

Obligatoriska parametrar

--device-id -d

Målenhets-ID.

Valfria parametrar

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--hub-name -n

IoT Hub-namn eller värdnamn. Krävs om --login inte har angetts.

Egenskap Värde
Parameter group: IoT Hub Identifier Arguments
--login -l

Det här kommandot stöder en entitet anslutningssträng med behörighet att utföra åtgärder. Använd för att undvika sessionsinloggning via "az login". Om både en entitet anslutningssträng och namn anges prioriteras anslutningssträng. Krävs om --hub-name inte anges.

Egenskap Värde
Parameter group: IoT Hub Identifier Arguments
--resource-group -g

Namn på resursgrupp. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

Egenskap Värde
Standardvärde: False
--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

Egenskap Värde
Standardvärde: False
--output -o

Output format.

Egenskap Värde
Standardvärde: json
Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

Egenskap Värde
Standardvärde: False

az iot device c2d-message receive

Ta emot ett meddelande från moln till enhet.

Den mottagna meddelandetexten avkodas endast när dess innehållskodning är inställd på "utf-8", "utf-16" eller "utf-32". Meddelandets nyttolast visas som {{icke-avkodbar nyttolast}} när innehållskodning inte har angetts till något av ovanstående, eller misslyckas med att avkoda även när innehållskodning har angetts till något av ovanstående.

Obs! Endast ett meddelandes ack-argument [--complete, --reject, --abandon] accepteras.

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

Exempel

Basic usage

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

Ta emot ett meddelande och ange en tidsgräns på 30 sekunder för det meddelandet

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

Ta emot ett meddelande och ack det som "slutfört" när det har tagits emot

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

Ta emot ett meddelande och avvisa det när det har tagits emot

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

Obligatoriska parametrar

--device-id -d

Målenhets-ID.

Valfria parametrar

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--abandon

Överge meddelandet från moln till enhet efter mottagandet.

Egenskap Värde
Parameter group: Message Ack Arguments
Standardvärde: False
Godkända värden: false, true
--complete

Slutför meddelandet från moln till enhet efter mottagandet.

Egenskap Värde
Parameter group: Message Ack Arguments
Standardvärde: False
Godkända värden: false, true
--hub-name -n

IoT Hub-namn eller värdnamn. Krävs om --login inte har angetts.

Egenskap Värde
Parameter group: IoT Hub Identifier Arguments
--lock-timeout --lt

Anger hur lång tid ett meddelande ska vara osynligt för andra mottagningsanrop.

Egenskap Värde
Standardvärde: 60
--login -l

Det här kommandot stöder en entitet anslutningssträng med behörighet att utföra åtgärder. Använd för att undvika sessionsinloggning via "az login". Om både en entitet anslutningssträng och namn anges prioriteras anslutningssträng. Krävs om --hub-name inte anges.

Egenskap Värde
Parameter group: IoT Hub Identifier Arguments
--reject

Avvisa meddelandet från moln till enhet efter mottagandet.

Egenskap Värde
Parameter group: Message Ack Arguments
Standardvärde: False
Godkända värden: false, true
--resource-group -g

Namn på resursgrupp. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

Egenskap Värde
Standardvärde: False
--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

Egenskap Värde
Standardvärde: False
--output -o

Output format.

Egenskap Värde
Standardvärde: json
Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

Egenskap Värde
Standardvärde: False

az iot device c2d-message reject

Avvisa eller deadletter ett meddelande från molnet till enheten.

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

Obligatoriska parametrar

--device-id -d

Målenhets-ID.

Valfria parametrar

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--etag -e

Etag eller entitetstagg som motsvarar resursens sista tillstånd. Om ingen etag anges används värdet *.

--hub-name -n

IoT Hub-namn eller värdnamn. Krävs om --login inte har angetts.

Egenskap Värde
Parameter group: IoT Hub Identifier Arguments
--login -l

Det här kommandot stöder en entitet anslutningssträng med behörighet att utföra åtgärder. Använd för att undvika sessionsinloggning via "az login". Om både en entitet anslutningssträng och namn anges prioriteras anslutningssträng. Krävs om --hub-name inte anges.

Egenskap Värde
Parameter group: IoT Hub Identifier Arguments
--resource-group -g

Namn på resursgrupp. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

Egenskap Värde
Standardvärde: False
--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

Egenskap Värde
Standardvärde: False
--output -o

Output format.

Egenskap Värde
Standardvärde: json
Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

Egenskap Värde
Standardvärde: False

az iot device c2d-message send

Skicka ett meddelande från moln till enhet.

Det här kommandot förlitar sig på och kan installera beroende Cython-paket (uamqp) vid första körningen. https://github.com/Azure/azure-uamqp-python

Obs! Innehållskodning är som standard utf-8. Kommandot skickar meddelandetexten med kodningsåtgärden när egenskapen content-encoding antingen är utf-8, utf-16 eller utf-32. Om värdet för innehållskodning inte är något av dessa skickas egenskapen fortfarande utan att någon kodningsåtgärd vidtas.

När du skickar en binär meddelandetext måste innehållet anges från en fil (via --data-file-path) och innehållstypen måste vara inställd på application/octet-stream.

az iot device c2d-message send --device-id
                               [--ack {full, negative, positive}]
                               [--auth-type {key, login}]
                               [--ce --content-encoding]
                               [--cid --correlation-id]
                               [--content-type --ct]
                               [--da --data]
                               [--data-file-path --dfp]
                               [--expiry --expiry-time-utc]
                               [--hub-name]
                               [--login]
                               [--message-id --mid]
                               [--properties --props]
                               [--repair {false, true}]
                               [--resource-group]
                               [--uid --user-id]
                               [--wait {false, true}]
                               [--yes {false, true}]

Exempel

Grundläggande användning med standardmeddelandetext

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

Skicka meddelande från moln till enhet med anpassade data och egenskaper.

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

Skicka ett C2D-meddelande och vänta på att enheten bekräftas

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

Skicka ett C2D-meddelande i binärt format från en fil.

az iot device c2d-message send -d {device_id} -n {iothub_name} --data-file-path {file_path} --content-type 'application/octet-stream'

Skicka ett C2D-meddelande i JSON-format från en fil.

az iot device c2d-message send -d {device_id} -n {iothub_name} --data-file-path {file_path} --content-type 'application/json'

Obligatoriska parametrar

--device-id -d

Målenhets-ID.

Valfria parametrar

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--ack

Begär leverans av feedback per meddelande om meddelandets slutliga tillstånd. Beskrivningen av ack-värden är följande. Positivt: Om c2d-meddelandet når tillståndet Slutfört genererar IoT Hub ett feedbackmeddelande. Negativ: Om c2d-meddelandet når tillståndet Död bokstav genererar IoT Hub ett feedbackmeddelande. Fullständig: IoT Hub genererar ett feedbackmeddelande i båda fallen. Som standard begärs inget ack.

Egenskap Värde
Godkända värden: full, negative, positive
--auth-type

Anger om åtgärden ska automatiskt härleda en principnyckel eller använda den aktuella Azure AD-sessionen. Om autentiseringstypen är inloggning och resursens värdnamn anges hoppas resurssökningen över om det inte behövs. Du kan konfigurera standardinställningen med .az configure --defaults iothub-data-auth-type={auth-type-value}

Egenskap Värde
Parameter group: Access Control Arguments
Standardvärde: key
Godkända värden: key, login
--ce --content-encoding

Kodningen för C2D-meddelandetexten.

Egenskap Värde
Standardvärde: utf-8
--cid --correlation-id

Korrelations-ID:t som är associerat med C2D-meddelandet.

--content-type --ct

Innehållstypen för C2D-meddelandetexten.

--da --data

Message body. Ange text eller rå json.

Egenskap Värde
Standardvärde: Ping from Az CLI IoT Extension
--data-file-path --dfp
Förhandsgranskning

Ange sökvägen till filen för meddelandetextnyttolasten. Observera att när nyttolasten måste skickas i binärt format anger du innehållstypen till program/oktettström.

--expiry --expiry-time-utc

Enheterna är millisekunder sedan unix-epoken. Om ingen tid anges används standard-IoT Hub C2D-meddelandet TTL.

--hub-name -n

IoT Hub-namn eller värdnamn. Krävs om --login inte har angetts.

Egenskap Värde
Parameter group: IoT Hub Identifier Arguments
--login -l

Det här kommandot stöder en entitet anslutningssträng med behörighet att utföra åtgärder. Använd för att undvika sessionsinloggning via "az login". Om både en entitet anslutningssträng och namn anges prioriteras anslutningssträng. Krävs om --hub-name inte anges.

Egenskap Värde
Parameter group: IoT Hub Identifier Arguments
--message-id --mid

C2D-meddelande-ID:t. Om inget meddelande-ID anges genereras ett UUID.

--properties --props -p

Meddelandeegenskapspåse i nyckel/värde-par med följande format: a=b; c=d.

--repair -r

Installera om uamqp-beroende som är kompatibelt med tilläggsversionen. Default: false.

Egenskap Värde
Standardvärde: False
Godkända värden: false, true
--resource-group -g

Namn på resursgrupp. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>.

--uid --user-id

C2D-meddelandet, användar-ID-egenskapen.

--wait -w

Om du anger c2d-sändningsåtgärden blockeras tills enhetens feedback har tagits emot.

Egenskap Värde
Standardvärde: False
Godkända värden: false, true
--yes -y

Hoppa över användarprompter. Anger godkännande av åtgärd. Används främst för automatiseringsscenarier. Default: false.

Egenskap Värde
Standardvärde: False
Godkända värden: false, true
Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

Egenskap Värde
Standardvärde: False
--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

Egenskap Värde
Standardvärde: False
--output -o

Output format.

Egenskap Värde
Standardvärde: json
Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

Egenskap Värde
Standardvärde: False