az iot device
Not
Bu başvuru, Azure CLI (sürüm 2.46.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 | Önizle |
az iot device registration create |
IoT Cihazı Sağlama Hizmeti'ne bir IoT cihazı kaydedin. |
Dahili | Önizle |
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-stream
ayarlanmalı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ı 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]
[--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
Hedef Cihaz Kimliği.
İsteğe Bağlı Parametreler
Sertifika dosyasının yolu.
İleti gövdesi. Metin veya ham json sağlayın.
İ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.
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 .
IoT Hub adı veya ana bilgisayar adı. --login sağlanmadıysa gereklidir.
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.
Anahtar dosyasının yolu.
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.
IoT Hub'a gönderilecek cihaz iletilerinin sayısı.
Anahtar dosyası için parola.
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.
Kaynak grubunun adı. kullanarak varsayılan grubu az configure --defaults group=<name>
yapılandırabilirsiniz.
Global Parametreler
Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.
Bu yardım iletisini göster ve çık.
Yalnızca hataları gösterir ve uyarıları gizler.
Çıkış biçimi.
JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz http://jmespath.org/ .
Aboneliğin adı veya kimliği. kullanarak az account set -s NAME_OR_ID
varsayılan aboneliği yapılandırabilirsiniz.
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
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
Hedef Cihaz Kimliği.
İsteğe Bağlı Parametreler
Sertifika dosyasının yolu.
İleti gövdesi. Metin veya ham json sağlayın.
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 .
IoT Hub adı veya ana bilgisayar adı. --login sağlanmadıysa gereklidir.
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.
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.
Anahtar dosyasının yolu.
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.
IoT Hub'a gönderilecek cihaz iletilerinin sayısı.
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.
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.
Cihazdan buluta iletiler arasındaki saniye cinsinden gecikme.
Anahtar dosyası için parola.
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.
Cihazdan buluta ileti protokollerini gösterir.
Alınan buluttan cihaza iletilerin nasıl yerleştiğini gösterir. Yalnızca HTTP ile desteklenir.
Kaynak grubunun adı. kullanarak varsayılan grubu az configure --defaults group=<name>
yapılandırabilirsiniz.
Global Parametreler
Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.
Bu yardım iletisini göster ve çık.
Yalnızca hataları gösterir ve uyarıları gizler.
Çıkış biçimi.
JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz http://jmespath.org/ .
Aboneliğin adı veya kimliği. kullanarak az account set -s NAME_OR_ID
varsayılan aboneliği yapılandırabilirsiniz.
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
MIME Dosya türü.
Hedef Cihaz Kimliği.
Karşıya yükleme için dosyanın yolu.
İsteğe Bağlı Parametreler
IoT Hub adı veya ana bilgisayar adı. --login sağlanmadıysa gereklidir.
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.
Kaynak grubunun adı. kullanarak varsayılan grubu az configure --defaults group=<name>
yapılandırabilirsiniz.
Global Parametreler
Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.
Bu yardım iletisini göster ve çık.
Yalnızca hataları gösterir ve uyarıları gizler.
Çıkış biçimi.
JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz http://jmespath.org/ .
Aboneliğin adı veya kimliği. kullanarak az account set -s NAME_OR_ID
varsayılan aboneliği yapılandırabilirsiniz.
Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.