az iot device c2d-message

Not

Bu başvuru, Azure CLI (sürüm 2.30.0 veya üzeri) için azure-iot uzantısının bir parçasıdır. Az iot device c2d-message komutunu ilk kez çalıştırdığınızda uzantı otomatik olarak yüklenir. Uzantılar hakkında daha fazla bilgi edinin.

Buluttan cihaza mesajlaşma komutları.

Komutlar

az iot device c2d-message abandon	Buluttan cihaza iletisinden vazgeçin.
az iot device c2d-message complete	Buluttan cihaza iletisini tamamlayın.
az iot device c2d-message purge	Hedef cihaz için buluttan cihaza ileti kuyruğu temizleme.
az iot device c2d-message receive	Buluttan cihaza bir ileti alın.
az iot device c2d-message reject	Buluttan cihaza iletiyi reddetme veya geçersiz hale getirin.
az iot device c2d-message send	Buluttan cihaza ileti gönderme.

az iot device c2d-message abandon

Buluttan cihaza iletisinden vazgeçin.

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

Gerekli Parametreler

--device-id -d

Hedef Cihaz.

İsteğe Bağlı Parametreler

--etag -e

Kaynağın son durumuna karşılık gelen Etag veya varlık etiketi. Etag sağlanmazsa '*' değeri kullanılır.

--hub-name -n

IoT Hub adı. --login sağlanmadıysa gereklidir.

--login -l

Bu komut, eylem gerçekleştirme haklarına sahip bir varlık bağlantı dizesini destekler. "az login" aracılığıyla oturum açmaktan kaçınmak için kullanın. Hem varlık bağlantı dizesi hem de ad sağlanmışsa, bağlantı dizesi öncelik alır. --hub-name sağlanmadıysa gereklidir.

--resource-group -g

Kaynak grubunun adı. kullanarak varsayılan grubu az configure --defaults group=<name>yapılandırabilirsiniz.

Global Parametreler

--debug

Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.

--help -h

Bu yardım iletisini göster ve çık.

--only-show-errors

Yalnızca hataları göster, uyarıları gizle.

--output -o

Çıkış biçimi.

--query

JMESPath sorgu dizesi. Daha fazla bilgi ve örnekler için bkz http://jmespath.org/ .

--subscription

Aboneliğin adı veya kimliği. kullanarak varsayılan aboneliği az account set -s NAME_OR_IDyapılandırabilirsiniz.

--verbose

Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.

az iot device c2d-message complete

Buluttan cihaza iletisini tamamlayın.

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

Gerekli Parametreler

--device-id -d

Hedef Cihaz.

İsteğe Bağlı Parametreler

--etag -e

Kaynağın son durumuna karşılık gelen Etag veya varlık etiketi. Etag sağlanmazsa '*' değeri kullanılır.

--hub-name -n

IoT Hub adı. --login sağlanmadıysa gereklidir.

--login -l

Bu komut, eylem gerçekleştirme haklarına sahip bir varlık bağlantı dizesini destekler. "az login" aracılığıyla oturum açmaktan kaçınmak için kullanın. Hem varlık bağlantı dizesi hem de ad sağlanmışsa, bağlantı dizesi öncelik alır. --hub-name sağlanmadıysa gereklidir.

--resource-group -g

Kaynak grubunun adı. kullanarak varsayılan grubu az configure --defaults group=<name>yapılandırabilirsiniz.

Global Parametreler

--debug

Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.

--help -h

Bu yardım iletisini göster ve çık.

--only-show-errors

Yalnızca hataları göster, uyarıları gizle.

--output -o

Çıkış biçimi.

--query

JMESPath sorgu dizesi. Daha fazla bilgi ve örnekler için bkz http://jmespath.org/ .

--subscription

Aboneliğin adı veya kimliği. kullanarak varsayılan aboneliği az account set -s NAME_OR_IDyapılandırabilirsiniz.

--verbose

Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.

az iot device c2d-message purge

Hedef cihaz için buluttan cihaza ileti kuyruğu temizleme.

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

Gerekli Parametreler

--device-id -d

Hedef Cihaz.

İsteğe Bağlı Parametreler

--hub-name -n

IoT Hub adı. --login sağlanmadıysa gereklidir.

--login -l

Bu komut, eylem gerçekleştirme haklarına sahip bir varlık bağlantı dizesini destekler. "az login" aracılığıyla oturum açmaktan kaçınmak için kullanın. Hem varlık bağlantı dizesi hem de ad sağlanmışsa, bağlantı dizesi öncelik alır. --hub-name sağlanmadıysa gereklidir.

--resource-group -g

Kaynak grubunun adı. kullanarak varsayılan grubu az configure --defaults group=<name>yapılandırabilirsiniz.

Global Parametreler

--debug

Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.

--help -h

Bu yardım iletisini göster ve çık.

--only-show-errors

Yalnızca hataları göster, uyarıları gizle.

--output -o

Çıkış biçimi.

--query

JMESPath sorgu dizesi. Daha fazla bilgi ve örnekler için bkz http://jmespath.org/ .

--subscription

Aboneliğin adı veya kimliği. kullanarak varsayılan aboneliği az account set -s NAME_OR_IDyapılandırabilirsiniz.

--verbose

Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.

az iot device c2d-message receive

Buluttan cihaza bir ileti alın.

Not: [--complete, --reject, --abandon] tek bir ileti bağımsız değişkeni kabul edilir.

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

Örnekler

Temel kullanım

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

bir ileti alın ve bu ileti için 30 saniyelik bir kilit zaman aşımı ayarlayın

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

Bir ileti alın ve alındıktan sonra 'tamamlandı' olarak gönderin

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

İleti alma ve alındıktan sonra reddetme

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

Gerekli Parametreler

--device-id -d

Hedef Cihaz.

İsteğe Bağlı Parametreler

--abandon

Alındıktan sonra buluttan cihaza iletisini bırakın.

kabul edilen değerler: false, true

--complete

Alındıktan sonra buluttan cihaza iletisini tamamlayın.

kabul edilen değerler: false, true

--hub-name -n

IoT Hub adı. --login sağlanmadıysa gereklidir.

--lock-timeout --lt

İletinin diğer aramalar için görünmeyeceği süreyi belirtir.

varsayılan değer: 60

--login -l

Bu komut, eylem gerçekleştirme haklarına sahip bir varlık bağlantı dizesini destekler. "az login" aracılığıyla oturum açmaktan kaçınmak için kullanın. Hem varlık bağlantı dizesi hem de ad sağlanmışsa, bağlantı dizesi öncelik alır. --hub-name sağlanmadıysa gereklidir.

--reject

Alındıktan sonra buluttan cihaza iletisini reddedin.

kabul edilen değerler: false, true

--resource-group -g

Kaynak grubunun adı. kullanarak varsayılan grubu az configure --defaults group=<name>yapılandırabilirsiniz.

Global Parametreler

--debug

Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.

--help -h

Bu yardım iletisini göster ve çık.

--only-show-errors

Yalnızca hataları göster, uyarıları gizle.

--output -o

Çıkış biçimi.

--query

JMESPath sorgu dizesi. Daha fazla bilgi ve örnekler için bkz http://jmespath.org/ .

--subscription

Aboneliğin adı veya kimliği. kullanarak varsayılan aboneliği az account set -s NAME_OR_IDyapılandırabilirsiniz.

--verbose

Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.

az iot device c2d-message reject

Buluttan cihaza iletiyi reddetme veya geçersiz hale getirin.

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

Gerekli Parametreler

--device-id -d

Hedef Cihaz.

İsteğe Bağlı Parametreler

--etag -e

Kaynağın son durumuna karşılık gelen Etag veya varlık etiketi. Etag sağlanmazsa '*' değeri kullanılır.

--hub-name -n

IoT Hub adı. --login sağlanmadıysa gereklidir.

--login -l

Bu komut, eylem gerçekleştirme haklarına sahip bir varlık bağlantı dizesini destekler. "az login" aracılığıyla oturum açmaktan kaçınmak için kullanın. Hem varlık bağlantı dizesi hem de ad sağlanmışsa, bağlantı dizesi öncelik alır. --hub-name sağlanmadıysa gereklidir.

--resource-group -g

Kaynak grubunun adı. kullanarak varsayılan grubu az configure --defaults group=<name>yapılandırabilirsiniz.

Global Parametreler

--debug

Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.

--help -h

Bu yardım iletisini göster ve çık.

--only-show-errors

Yalnızca hataları göster, uyarıları gizle.

--output -o

Çıkış biçimi.

--query

JMESPath sorgu dizesi. Daha fazla bilgi ve örnekler için bkz http://jmespath.org/ .

--subscription

Aboneliğin adı veya kimliği. kullanarak varsayılan aboneliği az account set -s NAME_OR_IDyapılandırabilirsiniz.

--verbose

Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.

az iot device c2d-message send

Buluttan cihaza ileti gönderme.

Bu komut bağımlı Cython paketini (uamqp) ilk yürütmede kullanır ve yükleyebilir. 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}]

Örnekler

Varsayılan ileti gövdesi ile temel kullanım

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

Özel veriler ve özelliklerle buluttan cihaza ileti gönderme.

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

C2D iletisi gönderin ve cihazın onaylanmasını bekleyin

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

Gerekli Parametreler

--device-id -d

Hedef Cihaz.

İsteğe Bağlı Parametreler

--ack

İletinin son durumuyla ilgili ileti başına geri bildirimin teslimini isteyin. ack değerlerinin açıklaması aşağıdaki gibidir. Pozitif: c2d iletisi Tamamlandı durumuna ulaşırsa IoT Hub bir geri bildirim iletisi oluşturur. Negatif: c2d iletisi Geçersiz harfli duruma ulaşırsa IoT Hub bir geri bildirim iletisi oluşturur. Tam: IoT Hub her iki durumda da bir geri bildirim iletisi oluşturur. Varsayılan olarak hiçbir istekte bulunmaz.

kabul edilen değerler: full, negative, positive

--auth-type

İşlemin bir ilke anahtarını otomatik olarak türetmesi mi yoksa geçerli Azure AD oturumunu mu kullanması gerektiğini gösterir. varsayılanı kullanarak az configure --defaults iothub-data-auth-type=<auth-type-value>yapılandırabilirsiniz.

kabul edilen değerler: key, login

varsayılan değer: key

--ce --content-encoding

C2D ileti gövdesi için kodlama.

varsayılan değer: utf-8

--cid --correlation-id

C2D iletisiyle ilişkili bağıntı kimliği.

--content-type --ct

C2D ileti gövdesi için içerik türü.

--da --data

İleti gövdesi.

varsayılan değer: Ping from Az CLI IoT Extension

--expiry --expiry-time-utc

Unix dönemlerinden bu yana birimler milisaniyedir. Zaman belirtilmemişse varsayılan IoT Hub C2D ileti TTL kullanılır.

--hub-name -n

IoT Hub adı. --login sağlanmadıysa gereklidir.

--login -l

Bu komut, eylem gerçekleştirme haklarına sahip bir varlık bağlantı dizesini destekler. "az login" aracılığıyla oturum açmaktan kaçınmak için kullanın. Hem varlık bağlantı dizesi hem de ad sağlanmışsa, bağlantı dizesi öncelik alır. --hub-name sağlanmadıysa gereklidir.

--message-id --mid

C2D ileti kimliği. İleti kimliği sağlanmazsa bir UUID oluşturulur.

--properties --props -p

Anahtar-değer çiftlerinde şu biçimde ileti özelliği paketi: a=b;c=d.

--repair -r

Uzantı sürümüyle uyumlu uamqp bağımlılığını yeniden yükleyin. Varsayılan: false.

kabul edilen değerler: false, true

--resource-group -g

Kaynak grubunun adı. varsayılan grubu kullanarak az configure --defaults group=<name>yapılandırabilirsiniz.

--uid --user-id

C2D iletisi, kullanıcı kimliği özelliği.

--wait -w

Ayarlanırsa cihaz geri bildirimi alınana kadar c2d gönderme işlemi engellenir.

kabul edilen değerler: false, true

--yes -y

Kullanıcı istemlerini atlayın. Bağımlılık yüklemesinin kabul edilmesini gösterir (gerekirse). Öncelikle otomasyon senaryoları için kullanılır. Varsayılan: false.

kabul edilen değerler: false, true

Global Parametreler

--debug

Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.

--help -h

Bu yardım iletisini göster ve çık.

--only-show-errors

Yalnızca hataları göster, uyarıları gizle.

--output -o

Çıkış biçimi.

--query

JMESPath sorgu dizesi. Daha fazla bilgi ve örnekler için bkz http://jmespath.org/ .

--subscription

Aboneliğin adı veya kimliği. kullanarak varsayılan aboneliği az account set -s NAME_OR_IDyapılandırabilirsiniz.

--verbose

Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.