az iot device c2d-message

Note

Cette référence fait partie de l’extension azure-iot pour Azure CLI (version 2.67.0 ou ultérieure). L’extension installe automatiquement la première fois que vous exécutez une commande az iot device c2d-message. Apprenez-en davantage sur les extensions.

Commandes de messagerie cloud à appareil.

Commandes

Nom	Description	Type	État
az iot device c2d-message abandon	Abandonner un message cloud-à-appareil.	Extension	GA
az iot device c2d-message complete	Terminez un message cloud-à-appareil.	Extension	GA
az iot device c2d-message purge	Videz la file d’attente de messages cloud-à-appareil pour un appareil cible.	Extension	GA
az iot device c2d-message receive	Recevoir un message cloud-à-appareil.	Extension	GA
az iot device c2d-message reject	Rejeter ou deadletter un message cloud-à-appareil.	Extension	GA
az iot device c2d-message send	Envoyez un message cloud-à-appareil.	Extension	GA

az iot device c2d-message abandon

Abandonner un message cloud-à-appareil.

az iot device c2d-message abandon --device-id
                                  [--acquire-policy-token]
                                  [--change-reference]
                                  [--etag]
                                  [--hub-name]
                                  [--login]
                                  [--resource-group]

Paramètres obligatoires

--device-id -d

ID d’appareil cible.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--acquire-policy-token

Acquisition automatique d’un jeton Azure Policy pour cette opération de ressource.

Propriété	Valeur
Groupe de paramètres:	Global Policy Arguments

--change-reference

ID de référence de modification associé pour cette opération de ressource.

Propriété	Valeur
Groupe de paramètres:	Global Policy Arguments

--etag -e

Étiquette d’entité ou etag correspondant au dernier état de la ressource. Si aucun etag n’est fourni, la valeur '*' est utilisée.

--hub-name -n

IoT Hub nom ou nom d’hôte. Obligatoire si --login n’est pas fourni.

Propriété	Valeur
Groupe de paramètres:	IoT Hub Identifier Arguments

--login -l

Cette commande prend en charge une entité connection string avec les droits d’exécution d’une action. Permet d’éviter la connexion de session via « az login ». Si une entité connection string et un nom sont fournis, le connection string a la priorité. Obligatoire si --hub-name n’est pas fourni.

Propriété	Valeur
Groupe de paramètres:	IoT Hub Identifier Arguments

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Paramètres globaux

--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété	Valeur
Valeur par défaut:	False

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété	Valeur
Valeur par défaut:	False

--output -o

Format de sortie.

Propriété	Valeur
Valeur par défaut:	json
Valeurs acceptées:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété	Valeur
Valeur par défaut:	False

az iot device c2d-message complete

Terminez un message cloud-à-appareil.

az iot device c2d-message complete --device-id
                                   [--acquire-policy-token]
                                   [--change-reference]
                                   [--etag]
                                   [--hub-name]
                                   [--login]
                                   [--resource-group]

Paramètres obligatoires

--device-id -d

ID d’appareil cible.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--acquire-policy-token

Acquisition automatique d’un jeton Azure Policy pour cette opération de ressource.

Propriété	Valeur
Groupe de paramètres:	Global Policy Arguments

--change-reference

ID de référence de modification associé pour cette opération de ressource.

Propriété	Valeur
Groupe de paramètres:	Global Policy Arguments

--etag -e

Étiquette d’entité ou etag correspondant au dernier état de la ressource. Si aucun etag n’est fourni, la valeur '*' est utilisée.

--hub-name -n

IoT Hub nom ou nom d’hôte. Obligatoire si --login n’est pas fourni.

Propriété	Valeur
Groupe de paramètres:	IoT Hub Identifier Arguments

--login -l

Cette commande prend en charge une entité connection string avec les droits d’exécution d’une action. Permet d’éviter la connexion de session via « az login ». Si une entité connection string et un nom sont fournis, le connection string a la priorité. Obligatoire si --hub-name n’est pas fourni.

Propriété	Valeur
Groupe de paramètres:	IoT Hub Identifier Arguments

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Paramètres globaux

--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété	Valeur
Valeur par défaut:	False

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété	Valeur
Valeur par défaut:	False

--output -o

Format de sortie.

Propriété	Valeur
Valeur par défaut:	json
Valeurs acceptées:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété	Valeur
Valeur par défaut:	False

az iot device c2d-message purge

Videz la file d’attente de messages cloud-à-appareil pour un appareil cible.

az iot device c2d-message purge --device-id
                                [--acquire-policy-token]
                                [--change-reference]
                                [--hub-name]
                                [--login]
                                [--resource-group]

Paramètres obligatoires

--device-id -d

ID d’appareil cible.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--acquire-policy-token

Acquisition automatique d’un jeton Azure Policy pour cette opération de ressource.

Propriété	Valeur
Groupe de paramètres:	Global Policy Arguments

--change-reference

ID de référence de modification associé pour cette opération de ressource.

Propriété	Valeur
Groupe de paramètres:	Global Policy Arguments

--hub-name -n

IoT Hub nom ou nom d’hôte. Obligatoire si --login n’est pas fourni.

Propriété	Valeur
Groupe de paramètres:	IoT Hub Identifier Arguments

--login -l

Cette commande prend en charge une entité connection string avec les droits d’exécution d’une action. Permet d’éviter la connexion de session via « az login ». Si une entité connection string et un nom sont fournis, le connection string a la priorité. Obligatoire si --hub-name n’est pas fourni.

Propriété	Valeur
Groupe de paramètres:	IoT Hub Identifier Arguments

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Paramètres globaux

--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété	Valeur
Valeur par défaut:	False

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété	Valeur
Valeur par défaut:	False

--output -o

Format de sortie.

Propriété	Valeur
Valeur par défaut:	json
Valeurs acceptées:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété	Valeur
Valeur par défaut:	False

az iot device c2d-message receive

Recevoir un message cloud-à-appareil.

Le corps du message reçu est décodé uniquement lorsque son encodage de contenu est défini sur « utf-8 », « utf-16 » ou « utf-32 ». La charge utile du message s’affiche en tant que {{charge utile non décodable}} lorsque l’encodage du contenu n’est pas défini sur l’un des éléments ci-dessus ou ne parvient pas à décoder même lorsque l’encodage du contenu est défini sur l’un des éléments ci-dessus.

Remarque : un seul argument de message [--complete, --reject, --abandon] est accepté.

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

Exemples

Utilisation de base

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

Recevoir un message et définir un délai d’expiration de verrouillage de 30 secondes pour ce message

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

Recevoir un message et l’envoyer comme « terminé » une fois qu’il a été reçu

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

Recevoir un message et le rejeter une fois qu’il a été reçu

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

Paramètres obligatoires

--device-id -d

ID d’appareil cible.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--abandon

Abandonnez le message cloud-à-appareil après réception.

Propriété	Valeur
Groupe de paramètres:	Message Ack Arguments
Valeur par défaut:	False
Valeurs acceptées:	false, true

--acquire-policy-token

Acquisition automatique d’un jeton Azure Policy pour cette opération de ressource.

Propriété	Valeur
Groupe de paramètres:	Global Policy Arguments

--change-reference

ID de référence de modification associé pour cette opération de ressource.

Propriété	Valeur
Groupe de paramètres:	Global Policy Arguments

--complete

Terminez le message cloud-à-appareil après réception.

Propriété	Valeur
Groupe de paramètres:	Message Ack Arguments
Valeur par défaut:	False
Valeurs acceptées:	false, true

--hub-name -n

IoT Hub nom ou nom d’hôte. Obligatoire si --login n’est pas fourni.

Propriété	Valeur
Groupe de paramètres:	IoT Hub Identifier Arguments

--lock-timeout --lt

Spécifie la durée pendant laquelle un message sera invisible pour d’autres appels de réception.

Propriété	Valeur
Valeur par défaut:	60

--login -l

Cette commande prend en charge une entité connection string avec les droits d’exécution d’une action. Permet d’éviter la connexion de session via « az login ». Si une entité connection string et un nom sont fournis, le connection string a la priorité. Obligatoire si --hub-name n’est pas fourni.

Propriété	Valeur
Groupe de paramètres:	IoT Hub Identifier Arguments

--reject

Rejeter le message cloud-à-appareil après réception.

Propriété	Valeur
Groupe de paramètres:	Message Ack Arguments
Valeur par défaut:	False
Valeurs acceptées:	false, true

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Paramètres globaux

--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété	Valeur
Valeur par défaut:	False

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété	Valeur
Valeur par défaut:	False

--output -o

Format de sortie.

Propriété	Valeur
Valeur par défaut:	json
Valeurs acceptées:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété	Valeur
Valeur par défaut:	False

az iot device c2d-message reject

Rejeter ou deadletter un message cloud-à-appareil.

az iot device c2d-message reject --device-id
                                 [--acquire-policy-token]
                                 [--change-reference]
                                 [--etag]
                                 [--hub-name]
                                 [--login]
                                 [--resource-group]

Paramètres obligatoires

--device-id -d

ID d’appareil cible.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--acquire-policy-token

Acquisition automatique d’un jeton Azure Policy pour cette opération de ressource.

Propriété	Valeur
Groupe de paramètres:	Global Policy Arguments

--change-reference

ID de référence de modification associé pour cette opération de ressource.

Propriété	Valeur
Groupe de paramètres:	Global Policy Arguments

--etag -e

Étiquette d’entité ou etag correspondant au dernier état de la ressource. Si aucun etag n’est fourni, la valeur '*' est utilisée.

--hub-name -n

IoT Hub nom ou nom d’hôte. Obligatoire si --login n’est pas fourni.

Propriété	Valeur
Groupe de paramètres:	IoT Hub Identifier Arguments

--login -l

Cette commande prend en charge une entité connection string avec les droits d’exécution d’une action. Permet d’éviter la connexion de session via « az login ». Si une entité connection string et un nom sont fournis, le connection string a la priorité. Obligatoire si --hub-name n’est pas fourni.

Propriété	Valeur
Groupe de paramètres:	IoT Hub Identifier Arguments

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Paramètres globaux

--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété	Valeur
Valeur par défaut:	False

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété	Valeur
Valeur par défaut:	False

--output -o

Format de sortie.

Propriété	Valeur
Valeur par défaut:	json
Valeurs acceptées:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété	Valeur
Valeur par défaut:	False

az iot device c2d-message send

Envoyez un message cloud-à-appareil.

Envoyez un message cloud-à-appareil via AMQP à un appareil cible.

Remarque : l’encodage du contenu est défini par défaut sur utf-8. La commande envoie le corps du message avec une action d’encodage lorsque la propriété d’encodage de contenu est utf-8, utf-16 ou utf-32. Si la valeur d’encodage de contenu n’est pas l’une de ces valeurs, la propriété est toujours envoyée sans aucune action d’encodage effectuée.

Lors de l’envoi d’un corps de message binaire, le contenu doit être fourni à partir d’un fichier (via --data-file-path) et le type de contenu doit être défini sur application/octet-stream.

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

Exemples

Utilisation de base avec le corps du message par défaut

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

Envoyez un message cloud-à-appareil avec des données et des propriétés personnalisées.

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

Envoyer un message C2D et attendre l’accusé de réception de l’appareil

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

Envoyez un message C2D au format binaire à partir d’un fichier.

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

Envoyez un message C2D au format JSON à partir d’un fichier.

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

Paramètres obligatoires

--device-id -d

ID d’appareil cible.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--ack

Demandez la remise de commentaires par message concernant l’état final de ce message. La description des valeurs ack est la suivante. Positif : si le message c2d atteint l’état Terminé, IoT Hub génère un message de commentaires. Négatif : si le message c2d atteint l’état lettre morte, IoT Hub génère un message de commentaires. Complet : IoT Hub génère un message de commentaires dans les deux cas. Par défaut, aucun ack n’est demandé.

Propriété	Valeur
Valeurs acceptées:	full, negative, positive

--acquire-policy-token

Acquisition automatique d’un jeton Azure Policy pour cette opération de ressource.

Propriété	Valeur
Groupe de paramètres:	Global Policy Arguments

--auth-type

Indique si l’opération doit dériver automatiquement une clé de stratégie ou utiliser la session active Azure AD. Si le type d’authentification est login et que le nom d’hôte de ressource est fourni, la recherche de ressources est ignorée, sauf si nécessaire. Vous pouvez configurer la valeur par défaut à l’aide az configure --defaults iothub-data-auth-type={auth-type-value}de .

Propriété	Valeur
Groupe de paramètres:	Access Control Arguments
Valeur par défaut:	key
Valeurs acceptées:	key, login

--ce --content-encoding

Encodage du corps du message C2D.

Propriété	Valeur
Valeur par défaut:	utf-8

--change-reference

ID de référence de modification associé pour cette opération de ressource.

Propriété	Valeur
Groupe de paramètres:	Global Policy Arguments

--cid --correlation-id

ID de corrélation associé au message C2D.

--content-type --ct

Type de contenu pour le corps du message C2D.

--da --data

Corps du message. Fournissez du texte ou du json brut.

Propriété	Valeur
Valeur par défaut:	Ping from Az CLI IoT Extension

--data-file-path --dfp

Préversion

Indiquez le chemin d’accès au fichier pour la charge utile du corps du message. Notez que la charge utile doit être envoyée au format binaire, définissez le type de contenu sur application/octet-stream.

--expiry --expiry-time-utc

Les unités sont des millisecondes depuis l’époque unix. Si aucune heure n’est indiquée, la durée de vie du message C2D IoT Hub par défaut est utilisée.

--hub-name -n

IoT Hub nom ou nom d’hôte. Obligatoire si --login n’est pas fourni.

Propriété	Valeur
Groupe de paramètres:	IoT Hub Identifier Arguments

--login -l

Cette commande prend en charge une entité connection string avec les droits d’exécution d’une action. Permet d’éviter la connexion de session via « az login ». Si une entité connection string et un nom sont fournis, le connection string a la priorité. Obligatoire si --hub-name n’est pas fourni.

Propriété	Valeur
Groupe de paramètres:	IoT Hub Identifier Arguments

--message-id --mid

ID du message C2D. Si aucun ID de message n’est fourni, un UUID est généré.

--properties --props -p

Conteneur de propriétés de message dans des paires clé-valeur au format suivant : a=b ; c=d.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

--uid --user-id

Message C2D, propriété ID utilisateur.

--wait -w

Si l’opération d’envoi c2d se bloque jusqu’à ce que les commentaires de l’appareil aient été reçus.

Propriété	Valeur
Valeur par défaut:	False
Valeurs acceptées:	false, true

--yes -y

Ignorez les invites de l’utilisateur. Indique l’acceptation de l’action. Utilisé principalement pour les scénarios d’automatisation. Valeur par défaut : false.

Propriété	Valeur
Valeur par défaut:	False
Valeurs acceptées:	false, true

Paramètres globaux

--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété	Valeur
Valeur par défaut:	False

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété	Valeur
Valeur par défaut:	False

--output -o

Format de sortie.

Propriété	Valeur
Valeur par défaut:	json
Valeurs acceptées:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété	Valeur
Valeur par défaut:	False