az iot device

Note

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

Cihaz benzetimi ve cihazdan buluta veya buluttan cihaza mesajlaşma özellikleri gibi diğer cihaz odaklı işlemlerden yararlanın.

Komutlar

Name	Description	Tür	Durum
az iot device c2d-message	Buluttan cihaza mesajlaşma komutları.	Extension	GA
az iot device c2d-message abandon	Buluttan cihaza ileti bırakma.	Extension	GA
az iot device c2d-message complete	Buluttan cihaza bir ileti tamamlayın.	Extension	GA
az iot device c2d-message purge	Hedef cihaz için buluttan cihaza ileti kuyruğu temizleme.	Extension	GA
az iot device c2d-message receive	Buluttan cihaza bir ileti alın.	Extension	GA
az iot device c2d-message reject	Buluttan cihaza ileti reddetme veya yeniden oluşturma.	Extension	GA
az iot device c2d-message send	Buluttan cihaza ileti gönderme.	Extension	GA
az iot device registration	IoT Cihazı Sağlama Hizmeti için IoT cihaz kayıtlarını yönetin.	Extension	Preview
az iot device registration create	IoT Cihazı Sağlama Hizmeti'ne bir IoT cihazı kaydedin.	Extension	Preview
az iot device send-d2c-message	Bir mqtt cihazdan buluta ileti gönderin.	Extension	GA
az iot device simulate	Azure IoT Hub'da bir cihazın benzetimini yapın.	Extension	Experimental
az iot device upload-file	Yerel dosyayı önceden yapılandırılmış bir blob depolama kapsayıcısına cihaz olarak yükleyin.	Extension	GA

az iot device send-d2c-message

Bir mqtt cihazdan buluta ileti gönderin.

komutu, unicode dize veya ikili biçimde özel yüke sahip iletilerin gönderilmesini destekler. İkili dosya göndermeyi amaçlarken, veriler bir dosyadan (aracılığıyla --data-file-path) gelmeli ve içerik türü olarak application/octet-streamayarlanmalıdır.

Not: Komut yalnızca simetrik anahtar kimlik doğrulaması (SAS) tabanlı cihazlarda çalışır. İleti yönlendirmede ileti gövdesinde sorgulamayı etkinleştirmek için, içerik türü sistem özelliği application/JSON olmalı ve içerik kodlama sistemi özelliği bu sistem özelliği (UTF-8, UTF-16 veya UTF-32) tarafından desteklenen UTF kodlama değerlerinden biri olmalıdır. Azure Depolama yönlendirme uç noktası olarak kullanıldığında içerik kodlaması ayarlanmadıysa IoT Hub iletileri 64 tabanında kodlanmış biçimde yazar. x509 kimlik doğrulama yöntemleri kullanılıyorsa, sertifika ve anahtar dosyaları (ve gerekirse parola) sağlanmalıdır.

az iot device send-d2c-message --device-id
                               [--certificate-file-path --cp]
                               [--da --data]
                               [--data-file-path --dfp]
                               [--dtmi --model-id]
                               [--hub-name]
                               [--key --symmetric-key]
                               [--key-file-path --kp]
                               [--login]
                               [--mc --msg-count]
                               [--pass --passphrase]
                               [--properties --props]
                               [--resource-group]

Örnekler

Temel kullanım

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

'dtmi:com:example:Thermostat' model kimliğini kaydeden cihaz için temel kullanım; Bağlantı üzerine 1'

az iot device send-d2c-message -n {iothub_name} -d {device_id} --model-id 'dtmi:com:example:Thermostat;1'

x509 kimlik doğrulaması ile cihaz için temel kullanım

az iot device send-d2c-message -n {iothub_name} -d {device_id} --cp {certificate_file_path} --kp {key_file_path}

Anahtar dosyasının parolaya sahip olduğu x509 kimlik doğrulamasına sahip cihaz için temel kullanım

az iot device send-d2c-message -n {iothub_name} -d {device_id} --cp {certificate_file_path} --kp {key_file_path} --pass {passphrase}

Özel verilerle temel kullanım

az iot device send-d2c-message -n {iothub_name} -d {device_id} --data {message_body}

Uygulama özelliklerini gönderme

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

Sistem özelliklerini gönderme (İleti Kimliği ve Bağıntı Kimliği)

az iot device send-d2c-message -n {iothub_name} -d {device_id} --props '$.mid={id};$.cid={id}'

Sistem özelliklerinde içerik türünü ve içerik kodlamayı belirterek özel veri gönderme

az iot device send-d2c-message -n {iothub_name} -d {device_id} --props '$.ct={content-type};$.ce={content-encoding}' --data {message_body}

Sistem özelliklerinde içerik kodlama belirterek özel verileri ikili biçimde gönderme

az iot device send-d2c-message -n {iothub_name} -d {device_id} --props '$.ct=application/octet-stream' --data-file-path {file_path}

Sistem özelliklerinde içerik türü ve içerik kodlama belirterek özel verileri JSON biçiminde gönderme

az iot device send-d2c-message -n {iothub_name} -d {device_id} --props '$.ct=application/json;$.ce=utf-8' --data-file-path {file_path}

Gerekli Parametreler

--device-id -d

Hedef Cihaz Kimliği.

İsteğe Bağlı Parametreler

Aşağıdaki parametreler isteğe bağlıdır, ancak bağlama bağlı olarak komutun başarıyla yürütülmesi için bir veya daha fazla parametre gerekli olabilir.

--certificate-file-path --cp

Sertifika dosyasının yolu.

Özellik	Değer
Parametre grubu:	Device Authentication Arguments

--da --data

İleti gövdesi. Metin veya ham json sağlayın.

Özellik	Değer
Default value:	Ping from Az CLI IoT Extension

--data-file-path --dfp

Önizleme

İleti gövdesi yükü için dosyanın yolunu belirtin. Yükün ikili biçimde gönderilmesi gerektiğinde içerik türünü application/octet-stream olarak ayarlayın.

--dtmi --model-id

Hub'a bağlanırken cihazın bildireceği Dijital İkiz Modeli Kimliği. Daha fazla bilgi için bkz. https://learn.microsoft.com/en-us/azure/iot-develop/overview-iot-plug-and-play.

Özellik	Değer
Parametre grubu:	Digital Twin Arguments

--hub-name -n

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

Özellik	Değer
Parametre grubu:	IoT Hub Identifier Arguments

--key --symmetric-key

Cihaz için kullanılacak simetrik anahtar. Simetrik anahtar ve diğer cihaz kimlik doğrulama bağımsız değişkenleri sağlanırsa, simetrik anahtar öncelik alır.

Özellik	Değer
Parametre grubu:	Device Authentication Arguments

--key-file-path --kp

Anahtar dosyasının yolu.

Özellik	Değer
Parametre grubu:	Device Authentication Arguments

--login -l

Bu komut, eylem gerçekleştirme haklarına sahip bir varlık bağlantı dizesi 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ğlanırsa, bağlantı dizesi öncelik alır. --hub-name sağlanmadıysa gereklidir.

Özellik	Değer
Parametre grubu:	IoT Hub Identifier Arguments

--mc --msg-count

IoT Hub'a gönderilecek cihaz iletilerinin sayısı.

Özellik	Değer
Default value:	1

--pass --passphrase

Anahtar dosyası için parola.

Özellik	Değer
Parametre grubu:	Device Authentication Arguments

--properties --props -p

Anahtar-değer çiftlerinde şu biçime sahip ileti özelliği paketi: a=b; c=d. Mqtt mesajlaşması için - sistem özelliklerini $kullanarak gönderebilirsiniz. {name}=value. Örneğin $.cid=12345 sistem bağıntı kimliği özelliğini ayarlar. Diğer sistem özelliği tanımlayıcı örnekleri arasında içerik türü için $.ct, ileti kimliği için $.mid ve içerik kodlaması için $.ce yer alır.

--resource-group -g

Kaynak grubunun adı. az configure --defaults group=<name>kullanarak varsayılan grubu 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.

Özellik	Değer
Default value:	False

--help -h

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

--only-show-errors

Yalnızca hataları gösterir ve uyarıları gizler.

Özellik	Değer
Default value:	False

--output -o

Çıkış biçimi.

Özellik	Değer
Default value:	json
Kabul edilen değerler:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

Aboneliğin adı veya kimliği. az account set -s NAME_OR_IDkullanarak varsayılan aboneliği yapı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.

Özellik	Değer
Default value:	False

az iot device simulate

Deneysel

Bu komut deneysel ve geliştirme aşamasındadır. Başvuru ve destek düzeyleri: https://aka.ms/CLI_refstatus

Azure IoT Hub'da bir cihazın benzetimini yapın.

Cihaz benzetimi çalışırken cihaz otomatik olarak buluttan cihaza (c2d) iletileri alır ve onaylar. mqtt benzetimi için tüm c2d iletileri tamamlandıktan sonra kabul edilir. http benzetimi için c2d onay, tamamlanabilen, reddedilebilen veya bırakılabilen kullanıcı seçimini temel alır. Mqtt benzetimi, yanıt durum kodu ve yanıt yükü tarafından kabul edilebilen doğrudan yöntem çağrısını da destekler. Not: Komut varsayılan olarak content-type değerini application/json ve content-encoding değerini utf-8 olarak ayarlar. Bu geçersiz kılınabilir. Not: x509 kimlik doğrulama yöntemleri kullanılıyorsa, sertifika ve anahtar dosyaları (ve gerekirse parola) sağlanmalıdır.

az iot device simulate --device-id
                       [--certificate-file-path --cp]
                       [--da --data]
                       [--dtmi --model-id]
                       [--hub-name]
                       [--init-reported-properties --irp]
                       [--key --symmetric-key]
                       [--key-file-path --kp]
                       [--login]
                       [--mc --msg-count]
                       [--method-response-code --mrc]
                       [--method-response-payload --mrp]
                       [--mi --msg-interval]
                       [--pass --passphrase]
                       [--properties --props]
                       [--proto --protocol {http, mqtt}]
                       [--receive-settle --rs {abandon, complete, reject}]
                       [--resource-group]

Örnekler

Temel kullanım (mqtt)

az iot device simulate -n {iothub_name} -d {device_id}

'dtmi:com:example:Thermostat' model kimliğini kaydeden cihaz için temel kullanım; 1' bağlantı üzerine (mqtt)

az iot device simulate -n {iothub_name} -d {device_id} --model-id 'dtmi:com:example:Thermostat;1'

x509 kimlik doğrulaması (mqtt) ile cihaz için temel kullanım

az iot device simulate -n {iothub_name} -d {device_id} --cp {certificate_file_path} --kp {key_file_path}

Anahtar dosyasının parolası olan x509 kimlik doğrulaması (mqtt) ile cihaz için temel kullanım

az iot device simulate -n {iothub_name} -d {device_id} --cp {certificate_file_path} --kp {key_file_path} --pass {passphrase}

Karma özellikleri gönderme (mqtt)

az iot device simulate -n {iothub_name} -d {device_id} --properties "myprop=myvalue;$.ct=application/json"

Doğrudan yöntem yanıt durum kodu ve doğrudan yöntem yanıt yükünü ham json olarak gönder (yalnızca mqtt)

az iot device simulate -n {iothub_name} -d {device_id} --method-response-code 201 --method-response-payload '{"result":"Direct method successful"}'

Doğrudan yöntem yanıt durum kodu ve doğrudan yöntem yanıt yükünü yerel dosyanın yolu olarak gönder (yalnızca mqtt)

az iot device simulate -n {iothub_name} -d {device_id} --method-response-code 201 --method-response-payload '../my_direct_method_payload.json'

Cihaz ikizi bildirilen özelliklerin ilk durumunu hedef cihaz için ham json olarak gönderme (yalnızca mqtt)

az iot device simulate -n {iothub_name} -d {device_id} --init-reported-properties '{"reported_prop_1":"val_1", "reported_prop_2":val_2}'

Cihaz ikizi bildirilen özelliklerin ilk durumunu hedef cihaz için yerel dosyaya yol olarak gönderin (yalnızca mqtt)

az iot device simulate -n {iothub_name} -d {device_id} --init-reported-properties '../my_device_twin_reported_properties.json'

Temel kullanım (http)

az iot device simulate -n {iothub_name} -d {device_id} --protocol http

Karma özellikleri gönderme (http)

az iot device simulate -n {iothub_name} -d {device_id} --protocol http --properties "iothub-app-myprop=myvalue;content-type=application/json;iothub-correlationid=12345"

toplam ileti sayısını ve iletiler arasındaki aralığı seçme

az iot device simulate -n {iothub_name} -d {device_id} --msg-count 1000 --msg-interval 5

c2d iletilerini reddet (yalnızca http)

az iot device simulate -n {iothub_name} -d {device_id} --rs reject --protocol http

c2d iletilerini bırakma (yalnızca http)

az iot device simulate -n {iothub_name} -d {device_id} --rs abandon --protocol http

Gerekli Parametreler

--device-id -d

Hedef Cihaz Kimliği.

İsteğe Bağlı Parametreler

Aşağıdaki parametreler isteğe bağlıdır, ancak bağlama bağlı olarak komutun başarıyla yürütülmesi için bir veya daha fazla parametre gerekli olabilir.

--certificate-file-path --cp

Sertifika dosyasının yolu.

Özellik	Değer
Parametre grubu:	Device Authentication Arguments

--da --data

İleti gövdesi. Metin veya ham json sağlayın.

Özellik	Değer
Default value:	Ping from Az CLI IoT Extension

--dtmi --model-id

Hub'a bağlanırken cihazın bildireceği Dijital İkiz Modeli Kimliği. Daha fazla bilgi için bkz. https://learn.microsoft.com/en-us/azure/iot-develop/overview-iot-plug-and-play.

Özellik	Değer
Parametre grubu:	Digital Twin Arguments

--hub-name -n

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

Özellik	Değer
Parametre grubu:	IoT Hub Identifier Arguments

--init-reported-properties --irp

Simülatör çalıştırıldığında hedef cihaz için bildirilen ikiz özelliklerinin ilk durumu. İsteğe bağlı param, yalnızca mqtt için desteklenir.

--key --symmetric-key

Cihaz için kullanılacak simetrik anahtar. Simetrik anahtar ve diğer cihaz kimlik doğrulama bağımsız değişkenleri sağlanırsa, simetrik anahtar öncelik alır.

Özellik	Değer
Parametre grubu:	Device Authentication Arguments

--key-file-path --kp

Anahtar dosyasının yolu.

Özellik	Değer
Parametre grubu:	Device Authentication Arguments

--login -l

Bu komut, eylem gerçekleştirme haklarına sahip bir varlık bağlantı dizesi 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ğlanırsa, bağlantı dizesi öncelik alır. --hub-name sağlanmadıysa gereklidir.

Özellik	Değer
Parametre grubu:	IoT Hub Identifier Arguments

--mc --msg-count

IoT Hub'a gönderilecek cihaz iletilerinin sayısı.

Özellik	Değer
Default value:	100

--method-response-code --mrc

Cihazda doğrudan yöntem yürütülürken döndürülecek durum kodu. İsteğe bağlı param, yalnızca mqtt için desteklenir.

--method-response-payload --mrp

Cihazda doğrudan yöntem yürütülürken döndürülecek yük. Dosya yolu veya ham json sağlayın. İsteğe bağlı param, yalnızca mqtt için desteklenir.

--mi --msg-interval

Cihazdan buluta iletiler arasındaki saniye cinsinden gecikme.

Özellik	Değer
Default value:	3

--pass --passphrase

Anahtar dosyası için parola.

Özellik	Değer
Parametre grubu:	Device Authentication Arguments

--properties --props -p

Anahtar-değer çiftlerinde şu biçime sahip ileti özelliği paketi: a=b; c=d. Mqtt mesajlaşması için - sistem özelliklerini $kullanarak gönderebilirsiniz. {name}=value. Örneğin $.cid=12345 sistem bağıntı kimliği özelliğini ayarlar. Diğer sistem özelliği tanımlayıcı örnekleri arasında içerik türü için $.ct, ileti kimliği için $.mid ve içerik kodlaması için $.ce yer alır. Http mesajlaşması için - uygulama özellikleri iothub-app-{name}=value kullanılarak gönderilir; örneğin, iothub-app-myprop=myvalue. Sistem özelliklerine genellikle iothub-correlationid gibi iothub-{name} ön eki eklenir, ancak içerik türü ve içerik kodlama gibi özel durumlar vardır.

--proto --protocol

Cihazdan buluta ileti protokollerini gösterir.

Özellik	Değer
Default value:	mqtt
Kabul edilen değerler:	http, mqtt

--receive-settle --rs

Alınan buluttan cihaza iletilerin nasıl yerleştiğini gösterir. Yalnızca HTTP ile desteklenir.

Özellik	Değer
Default value:	complete
Kabul edilen değerler:	abandon, complete, reject

--resource-group -g

Kaynak grubunun adı. az configure --defaults group=<name>kullanarak varsayılan grubu 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.

Özellik	Değer
Default value:	False

--help -h

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

--only-show-errors

Yalnızca hataları gösterir ve uyarıları gizler.

Özellik	Değer
Default value:	False

--output -o

Çıkış biçimi.

Özellik	Değer
Default value:	json
Kabul edilen değerler:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

Aboneliğin adı veya kimliği. az account set -s NAME_OR_IDkullanarak varsayılan aboneliği yapı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.

Özellik	Değer
Default value:	False

az iot device upload-file

Yerel dosyayı önceden yapılandırılmış bir blob depolama kapsayıcısına cihaz olarak yükleyin.

az iot device upload-file --content-type --ct
                          --device-id
                          --file-path --fp
                          [--hub-name]
                          [--login]
                          [--resource-group]

Gerekli Parametreler

--content-type --ct

MIME Dosya türü.

--device-id -d

Hedef Cihaz Kimliği.

--file-path --fp

Karşıya yükleme için dosyanın yolu.

İsteğe Bağlı Parametreler

Aşağıdaki parametreler isteğe bağlıdır, ancak bağlama bağlı olarak komutun başarıyla yürütülmesi için bir veya daha fazla parametre gerekli olabilir.

--hub-name -n

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

Özellik	Değer
Parametre grubu:	IoT Hub Identifier Arguments

--login -l

Bu komut, eylem gerçekleştirme haklarına sahip bir varlık bağlantı dizesi 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ğlanırsa, bağlantı dizesi öncelik alır. --hub-name sağlanmadıysa gereklidir.

Özellik	Değer
Parametre grubu:	IoT Hub Identifier Arguments

--resource-group -g

Kaynak grubunun adı. az configure --defaults group=<name>kullanarak varsayılan grubu 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.

Özellik	Değer
Default value:	False

--help -h

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

--only-show-errors

Yalnızca hataları gösterir ve uyarıları gizler.

Özellik	Değer
Default value:	False

--output -o

Çıkış biçimi.

Özellik	Değer
Default value:	json
Kabul edilen değerler:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

Aboneliğin adı veya kimliği. az account set -s NAME_OR_IDkullanarak varsayılan aboneliği yapı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.

Özellik	Değer
Default value:	False