az iot device

Dekont

Bu başvuru, Azure CLI (sürüm 2.37.0 veya üzeri) için azure-iot uzantısının bir parçasıdır. Uzantı, bir 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ı.	Dahili	GA
az iot device c2d-message abandon	Buluttan cihaza ileti bırakma.	Dahili	GA
az iot device c2d-message complete	Buluttan cihaza bir ileti tamamlayın.	Dahili	GA
az iot device c2d-message purge	Hedef cihaz için buluttan cihaza ileti kuyruğu temizleme.	Dahili	GA
az iot device c2d-message receive	Buluttan cihaza bir ileti alın.	Dahili	GA
az iot device c2d-message reject	Buluttan cihaza ileti reddetme veya yeniden oluşturma.	Dahili	GA
az iot device c2d-message send	Buluttan cihaza ileti gönderme.	Dahili	GA
az iot device registration	IoT Cihazı Sağlama Hizmeti için IoT cihaz kayıtlarını yönetin.	Dahili	Önizleme
az iot device registration create	IoT Cihazı Sağlama Hizmeti'ne bir IoT cihazı kaydedin.	Dahili	Önizleme
az iot device send-d2c-message	Bir mqtt cihazdan buluta ileti gönderin.	Dahili	GA
az iot device simulate	Azure IoT Hub'da bir cihazın benzetimini yapın.	Dahili	Deneysel
az iot device upload-file	Yerel dosyayı önceden yapılandırılmış bir blob depolama kapsayıcısına cihaz olarak yükleyin.	Dahili	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 contentType sistem özelliğinin application/JSON olması ve contentEncoding sistem özelliğinin bu sistem özelliği (UTF-8, UTF-16 veya UTF-32) tarafından desteklenen UTF kodlama değerlerinden biri olması gerekir. Azure Depolama yönlendirme uç noktası olarak kullanıldığında içerik kodlaması ayarlanmazsa 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]
                               [--da]
                               [--data-file-path]
                               [--dtmi]
                               [--hub-name]
                               [--key]
                               [--key-file-path]
                               [--login]
                               [--mc]
                               [--pass]
                               [--properties]
                               [--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

--certificate-file-path --cp

Sertifika dosyasının yolu.

--da --data

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

varsayılan değer: 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. Diğer ayrıntılar için bkz https://docs.microsoft.com/en-us/azure/iot-develop/overview-iot-plug-and-play .

--hub-name -n

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

--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.

--key-file-path --kp

Anahtar dosyasının yolu.

--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.

--mc --msg-count

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

varsayılan değer: 1

--pass --passphrase

Anahtar dosyası için parola.

--properties --props -p

Anahtar-değer çiftlerinde şu biçime sahip ileti özelliği paketi: a=b; c=d. mqtt mesajlaşması için - $.=value kullanarak sistem özelliklerini gönderebilirsiniz. Ö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ı. 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österir ve uyarıları gizler.

--output -o

Çıkış biçimi.

kabul edilen değerler: json, jsonc, none, table, tsv, yaml, yamlc

varsayılan değer: json

--query

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

--subscription

Aboneliğin adı veya kimliği. kullanarak az account set -s NAME_OR_IDvarsayı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.

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]
                       [--da]
                       [--dtmi]
                       [--hub-name]
                       [--init-reported-properties]
                       [--key]
                       [--key-file-path]
                       [--login]
                       [--mc]
                       [--method-response-code]
                       [--method-response-payload]
                       [--mi]
                       [--pass]
                       [--properties]
                       [--proto {http, mqtt}]
                       [--receive-settle {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

--certificate-file-path --cp

Sertifika dosyasının yolu.

--da --data

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

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

--dtmi --model-id

Hub'a bağlanırken cihazın bildireceği Dijital İkiz Modeli Kimliği. Diğer ayrıntılar için bkz https://docs.microsoft.com/en-us/azure/iot-develop/overview-iot-plug-and-play .

--hub-name -n

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

--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.

--key-file-path --kp

Anahtar dosyasının yolu.

--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.

--mc --msg-count

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

varsayılan değer: 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.

varsayılan değer: 3

--pass --passphrase

Anahtar dosyası için parola.

--properties --props -p

Anahtar-değer çiftlerinde şu biçime sahip ileti özelliği paketi: a=b; c=d. mqtt mesajlaşması için - $.=value kullanarak sistem özelliklerini gönderebilirsiniz. Ö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-=value kullanılarak gönderilir; örneğin, iothub-app-myprop=myvalue. Sistem özellikleri genellikle iothub-correlationid gibi iothub ön eklerine sahiptir, ancak içerik türü ve içerik kodlama gibi özel durumlar vardır.

--proto --protocol

Cihazdan buluta ileti protokollerini gösterir.

kabul edilen değerler: http, mqtt

varsayılan değer: mqtt

--receive-settle --rs

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

kabul edilen değerler: abandon, complete, reject

varsayılan değer: complete

--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österir ve uyarıları gizler.

--output -o

Çıkış biçimi.

kabul edilen değerler: json, jsonc, none, table, tsv, yaml, yamlc

varsayılan değer: json

--query

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

--subscription

Aboneliğin adı veya kimliği. kullanarak az account set -s NAME_OR_IDvarsayı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.

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
                          --device-id
                          --file-path
                          [--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

--hub-name -n

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

--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.

--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österir ve uyarıları gizler.

--output -o

Çıkış biçimi.

kabul edilen değerler: json, jsonc, none, table, tsv, yaml, yamlc

varsayılan değer: json

--query

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

--subscription

Aboneliğin adı veya kimliği. kullanarak az account set -s NAME_OR_IDvarsayı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.