az iot device

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

az iot device c2d-message	Buluttan cihaza mesajlaşma 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 registration	IoT Cihaz Sağlama Hizmeti için IoT cihaz kayıtlarını yönetin.
az iot device registration create	IoT cihazını IoT Cihazı Sağlama Hizmeti'ne kaydedin.
az iot device send-d2c-message	Bir mqtt cihazdan buluta ileti gönderin. komutu, uygulama ve sistem özellikleriyle ileti göndermeyi destekler. 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	Azure IoT Hub bir cihazın benzetimini yapmak. Cihaz benzetimi çalışırken cihaz, buluttan cihaza (c2d) iletileri otomatik olarak 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, content-encoding değerini ise 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 upload-file	Yerel dosyayı önceden yapılandırılmış bir blob depolama kapsayıcısına cihaz olarak yükleyin.

az iot device send-d2c-message

Bir mqtt cihazdan buluta ileti gönderin. komutu, uygulama ve sistem özellikleriyle ileti göndermeyi destekler. Not: 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]
                               [--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}

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 özellikleri 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>'

Gerekli Parametreler

--device-id -d

Hedef Cihaz.

İsteğe Bağlı Parametreler

--certificate-file-path --cp

Sertifika dosyasının yolu.

--da --data

İleti gövdesi.

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

--hub-name -n

IoT Hub 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 önceliklidir.

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

--mc --msg-count

IoT Hub 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çimde ileti özelliği paketi: a=b;c=d. mqtt mesajlaşması için - $ kullanarak sistem özelliklerini gönderebilirsiniz. =değer. Ö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 kodlama 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, uyarıları gizler.

--output -o

Çıkış biçimi.

--query

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

--subscription

Aboneliğin adı veya kimliği. varsayılan aboneliğini kullanarak 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 simulate

Azure IoT Hub bir cihazın benzetimini yapmak. Cihaz benzetimi çalışırken cihaz, buluttan cihaza (c2d) iletileri otomatik olarak 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, content-encoding değerini ise 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]
                       [--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}

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önderme (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 kodunu ve doğrudan yöntem yanıt yükünü yerel dosyaya yol olarak gönderin (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önderin (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 dosyanın yolu 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"

İletiler arasındaki toplam ileti sayısını ve aralığını 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.

İsteğe Bağlı Parametreler

--certificate-file-path --cp

Sertifika dosyasının yolu.

--da --data

İleti gövdesi.

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

--hub-name -n

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

--init-reported-properties --irp

Simülatör çalıştırıldığında hedef cihaz için ikiz tarafından bildirilen özelliklerin 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 önceliklidir.

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

--mc --msg-count

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

varsayılan değer: 100

--method-response-code --mrc

Cihazda doğrudan yöntem yürütü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ü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 saniyeler içinde gecikme.

varsayılan değer: 3

--pass --passphrase

Anahtar dosyası için parola.

--properties --props -p

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

--output -o

Çıkış biçimi.

--query

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

--subscription

Aboneliğin adı veya kimliği. varsayılan aboneliğini kullanarak 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 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

DOSYANıN MIME Türü.

--device-id -d

Hedef Cihaz.

--file-path --fp

Karşıya yüklenecek dosyanın yolu.

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

--output -o

Çıkış biçimi.

--query

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

--subscription

Aboneliğin adı veya kimliği. varsayılan aboneliğini kullanarak 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.