az iot central diagnostics

  • Önizleme
  • Başvuru

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ı, az iot central diagnostics komutunu ilk kez çalıştırdığınızda otomatik olarak yüklenir. Uzantılar hakkında daha fazla bilgi edinin.

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

Uygulama ve cihaz düzeyinde tanılama gerçekleştirin.

Komutlar

Name Description Tür Status
az iot central diagnostics monitor-events

IoT Central uygulamasına gönderilen cihaz telemetri iletilerini görüntüleyin.

 Dahili Önizleme
az iot central diagnostics monitor-properties

IoT Central uygulamasına/uygulamasından gönderilen istenen ve bildirilen özellikleri görüntüleyin.

 Dahili Önizleme
az iot central diagnostics registration-summary

Bir uygulamadaki tüm cihazların kayıt özetini görüntüleyin.

 Dahili Önizleme
az iot central diagnostics validate-messages

IoT Central uygulaması için IoT Hub'a gönderilen iletileri doğrulayın.

 Dahili Önizleme
az iot central diagnostics validate-properties

IoT Central uygulamasına gönderilen bildirilen özellikleri doğrulayın.

 Dahili Önizleme

az iot central diagnostics monitor-events

Önizleme

'iot central diagnostics' komut grubu önizleme aşamasında ve geliştirme aşamasındadır. Başvuru ve destek düzeyleri: https://aka.ms/CLI_refstatus

IoT Central uygulamasına gönderilen cihaz telemetri iletilerini görüntüleyin.

IoT Central uygulamasına gönderilen telemetri verilerini gösterir. Varsayılan olarak, tüm cihazlar tarafından gönderilen tüm verileri gösterir. Belirli bir cihazı filtrelemek için --device-id parametresini kullanın.

az iot central diagnostics monitor-events --app-id
                                          [--central-api-uri]
                                          [--cg]
                                          [--device-id]
                                          [--enqueued-time]
                                          [--module-id]
                                          [--properties {all, anno, app, sys}]
                                          [--repair {false, true}]
                                          [--timeout]
                                          [--token]
                                          [--yes {false, true}]

Örnekler

Temel kullanım

az iot central diagnostics monitor-events --app-id {app_id}

Hedef cihazda filtreleme yaparken temel kullanım

az iot central diagnostics monitor-events --app-id {app_id} -d {device_id}

Kimliğinde joker karakter bulunan hedeflenen cihazları filtrelerken temel kullanım

az iot central diagnostics monitor-events --app-id {app_id} -d Device*d

Modülde filtreleme yaparken temel kullanım.

az iot central diagnostics monitor-events --app-id {app_id} -m {module_id}

Hedeflenen modülleri kimlikte joker karakterle filtrelerken temel kullanım

az iot central diagnostics monitor-events --app-id {app_id} -m Module*

Cihazı filtreleyin ve bağlanılacak bir Event Hub tüketici grubu belirtin.

az iot central diagnostics monitor-events --app-id {app_id} -d {device_id} --cg {consumer_group_name}

İleti ek açıklamalarını alma (ileti üst bilgileri)

az iot central diagnostics monitor-events --app-id {app_id} -d {device_id} --properties anno

İleti ek açıklamalarını + sistem özelliklerini alma. Asla zaman aşımına uğradım.

az iot central diagnostics monitor-events --app-id {app_id} -d {device_id} --properties anno sys --timeout 0

Tüm cihaz iletilerinden tüm ileti özniteliklerini alma

az iot central diagnostics monitor-events --app-id {app_id} --props all

Tüm iletileri alma ve ileti yükünü JSON olarak ayrıştırma

az iot central diagnostics monitor-events --app-id {app_id} --output json

Gerekli Parametreler

--app-id -n

Yönetmek istediğiniz IoT Central uygulamasının Uygulama Kimliği. Uygulama Kimliğini, yardım menüsünün altında uygulamanızın "Hakkında" sayfasında bulabilirsiniz.

İsteğe Bağlı Parametreler

--central-api-uri --central-dns-suffix

Uygulamanızla ilişkili IoT Central DNS soneki.

varsayılan değer: azureiotcentral.com
--cg --consumer-group -c

Olay hub'ı uç noktasına bağlanırken kullanılacak tüketici grubunu belirtin.

varsayılan değer: $Default
--device-id -d

Hedef cihazın cihaz kimliği. Cihaz kimliğini, Cihaz Ayrıntıları sayfasındaki Bağlan düğmesine tıklayarak bulabilirsiniz.

--enqueued-time --et -e

Bölümlerden gelen iletileri okumak için başlangıç noktası olarak kullanılması gereken zamanı gösterir. Unix dönemlerinden bu yana birimler milisaniyedir. Zaman belirtilmemişse "şimdi" kullanılır.

--module-id -m

Cihaz türü IoT Edge ise IoT Edge Modül Kimliği.

--properties --props -p

Çıkış için önemli ileti özelliklerini belirtin. sys = sistem özellikleri, uygulama = uygulama özellikleri, anno = ek açıklamalar.

kabul edilen değerler: all, anno, app, sys
--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
varsayılan değer: False
--timeout --to -t

İleti alınmadan bağlantının sürdürülmesi için en fazla saniye. Sonsuzluk için 0 kullanın.

varsayılan değer: 300
--token

Azure CLI'da kimlik doğrulaması yapmadan isteğinizi göndermeyi tercih ederseniz, isteğinizin kimliğini doğrulamak için geçerli bir kullanıcı belirteci belirtebilirsiniz. İsteğin bir parçası olarak anahtar türünü belirtmeniz gerekir. https://aka.ms/iotcentraldocsapi adresinden daha fazla bilgi edinin.

--yes -y

Kullanıcı istemlerini atlayın. Eylemin kabul edilmesini gösterir. Öncelikle otomasyon senaryoları için kullanılır. Varsayılan: false.

kabul edilen değerler: false, true
varsayılan değer: False
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 central diagnostics monitor-properties

Önizleme

'iot central diagnostics' komut grubu önizleme aşamasında ve geliştirme aşamasındadır. Başvuru ve destek düzeyleri: https://aka.ms/CLI_refstatus

IoT Central uygulamasına/uygulamasından gönderilen istenen ve bildirilen özellikleri görüntüleyin.

Merkezi cihaz ikizini yoklar ve bunu cihaz ikizinden son cihaz ikizi Ayrıştırma özellikleriyle karşılaştırır ve değişikliklerin yapılıp yapılmadığını algılar Yoklama aralığı içinde değiştirilen özelliklerin alt kümesini yazdırır.

az iot central diagnostics monitor-properties --app-id
                                              --device-id
                                              [--central-api-uri]
                                              [--token]

Örnekler

Temel kullanım

az iot central diagnostics monitor-properties --app-id {app_id} -d {device_id}

Gerekli Parametreler

--app-id -n

Yönetmek istediğiniz IoT Central uygulamasının Uygulama Kimliği. Uygulama Kimliğini, yardım menüsünün altında uygulamanızın "Hakkında" sayfasında bulabilirsiniz.

--device-id -d

Hedef cihazın cihaz kimliği. Cihaz kimliğini, Cihaz Ayrıntıları sayfasındaki Bağlan düğmesine tıklayarak bulabilirsiniz.

İsteğe Bağlı Parametreler

--central-api-uri --central-dns-suffix

Uygulamanızla ilişkili IoT Central DNS soneki.

varsayılan değer: azureiotcentral.com
--token

Azure CLI'da kimlik doğrulaması yapmadan isteğinizi göndermeyi tercih ederseniz, isteğinizin kimliğini doğrulamak için geçerli bir kullanıcı belirteci belirtebilirsiniz. İsteğin bir parçası olarak anahtar türünü belirtmeniz gerekir. https://aka.ms/iotcentraldocsapi adresinden daha fazla bilgi edinin.

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 central diagnostics registration-summary

Önizleme

'iot central diagnostics' komut grubu önizleme aşamasında ve geliştirme aşamasındadır. Başvuru ve destek düzeyleri: https://aka.ms/CLI_refstatus

Bir uygulamadaki tüm cihazların kayıt özetini görüntüleyin.

Not: Uygulamanız çok fazla cihaz içeriyorsa bu komutun döndürülmesi önemli ölçüde zaman alabilir.

az iot central diagnostics registration-summary --app-id
                                                [--api-version {2022-06-30-preview, 2022-07-31}]
                                                [--central-api-uri]
                                                [--token]

Örnekler

Kayıt özeti

az iot central diagnostics registration-summary --app-id {appid}

Gerekli Parametreler

--app-id -n

Yönetmek istediğiniz IoT Central uygulamasının Uygulama Kimliği. Uygulama Kimliğini, yardım menüsünün altında uygulamanızın "Hakkında" sayfasında bulabilirsiniz.

İsteğe Bağlı Parametreler

--api-version --av
Kullanım Dışı

'api_version' bağımsız değişkeni kullanım dışı bırakıldı ve gelecek bir sürümde kaldırılacak.

Bu komut parametresi kullanım dışı bırakıldı ve yoksayılacak. Gelecek sürümde ioT Central API'lerini yalnızca en son GA sürümünden destekleyeceğiz. Herhangi bir API henüz GA değilse en son önizleme sürümünü çağıracağız.

kabul edilen değerler: 2022-06-30-preview, 2022-07-31
varsayılan değer: 2022-07-31
--central-api-uri --central-dns-suffix

Uygulamanızla ilişkili IoT Central DNS soneki.

varsayılan değer: azureiotcentral.com
--token

Azure CLI'da kimlik doğrulaması yapmadan isteğinizi göndermeyi tercih ederseniz, isteğinizin kimliğini doğrulamak için geçerli bir kullanıcı belirteci belirtebilirsiniz. İsteğin bir parçası olarak anahtar türünü belirtmeniz gerekir. https://aka.ms/iotcentraldocsapi adresinden daha fazla bilgi edinin.

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 central diagnostics validate-messages

Önizleme

'iot central diagnostics' komut grubu önizleme aşamasında ve geliştirme aşamasındadır. Başvuru ve destek düzeyleri: https://aka.ms/CLI_refstatus

IoT Central uygulaması için IoT Hub'a gönderilen iletileri doğrulayın.

Telemetri iletilerinde doğrulamalar gerçekleştirir ve cihaz şablonunda modellenmemiş verileri veya veri türünün cihaz şablonunda tanımlanan verilerle eşleşmediği verileri raporlar.

az iot central diagnostics validate-messages --app-id
                                             [--central-api-uri]
                                             [--cg]
                                             [--device-id]
                                             [--dr]
                                             [--enqueued-time]
                                             [--max-messages]
                                             [--minimum-severity {error, info, warning}]
                                             [--module-id]
                                             [--properties {all, anno, app, sys}]
                                             [--repair {false, true}]
                                             [--style {csv, json, scroll}]
                                             [--timeout]
                                             [--token]
                                             [--yes {false, true}]

Örnekler

Temel kullanım

az iot central diagnostics validate-messages --app-id {app_id}

Algılanan çıkış hataları

az iot central diagnostics validate-messages --app-id {app_id} --style scroll

Hedef cihazda filtreleme yaparken temel kullanım

az iot central diagnostics validate-messages --app-id {app_id} -d {device_id}

Kimliğinde joker karakter bulunan hedeflenen cihazları filtrelerken temel kullanım

az iot central diagnostics validate-messages --app-id {app_id} -d Device*

Modülde filtreleme yaparken temel kullanım.

az iot central diagnostics validate-messages --app-id {app_id} -m {module_id}

Hedeflenen modülleri kimlikte joker karakterle filtrelerken temel kullanım

az iot central diagnostics validate-messages --app-id {app_id} -m Module*

Cihazı filtreleyin ve bağlanılacak bir Event Hub tüketici grubu belirtin.

az iot central diagnostics validate-messages --app-id {app_id} -d {device_id} --cg {consumer_group_name}

Gerekli Parametreler

--app-id -n

Yönetmek istediğiniz IoT Central uygulamasının Uygulama Kimliği. Uygulama Kimliğini, yardım menüsünün altında uygulamanızın "Hakkında" sayfasında bulabilirsiniz.

İsteğe Bağlı Parametreler

--central-api-uri --central-dns-suffix

Uygulamanızla ilişkili IoT Central DNS soneki.

varsayılan değer: azureiotcentral.com
--cg --consumer-group -c

Olay hub'ı uç noktasına bağlanırken kullanılacak tüketici grubunu belirtin.

varsayılan değer: $Default
--device-id -d

Hedef cihazın cihaz kimliği. Cihaz kimliğini, Cihaz Ayrıntıları sayfasındaki Bağlan düğmesine tıklayarak bulabilirsiniz.

--dr --duration

Bağlantıyı sonlandırmadan önce hedef cihazdan ileti alma süresi üst sınırı. Sonsuzluk için 0 kullanın.

varsayılan değer: 300
--enqueued-time --et -e

Bölümlerden gelen iletileri okumak için başlangıç noktası olarak kullanılması gereken zamanı gösterir. Unix dönemlerinden bu yana birimler milisaniyedir. Zaman belirtilmemişse "şimdi" kullanılır.

--max-messages --mm

Bağlantıyı sonlandırmadan önce hedef cihazdan alınacak ileti sayısı üst sınırı. Sonsuzluk için 0 kullanın.

varsayılan değer: 10
--minimum-severity

Raporlama için gereken sorunun en düşük önem derecesi.

kabul edilen değerler: error, info, warning
varsayılan değer: warning
--module-id -m

Cihaz türü IoT Edge ise IoT Edge Modül Kimliği.

--properties --props -p

Çıkış için önemli ileti özelliklerini belirtin. sys = sistem özellikleri, uygulama = uygulama özellikleri, anno = ek açıklamalar.

kabul edilen değerler: all, anno, app, sys
--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
varsayılan değer: False
--style

Çıktı stillerini belirtincroll = teslim hataları, json = sonuçları json olarak özetleme, csv = sonuçları csv olarak özetleme.

kabul edilen değerler: csv, json, scroll
varsayılan değer: scroll
--timeout --to -t

İleti alınmadan bağlantının sürdürülmesi için en fazla saniye. Sonsuzluk için 0 kullanın.

varsayılan değer: 300
--token

Azure CLI'da kimlik doğrulaması yapmadan isteğinizi göndermeyi tercih ederseniz, isteğinizin kimliğini doğrulamak için geçerli bir kullanıcı belirteci belirtebilirsiniz. İsteğin bir parçası olarak anahtar türünü belirtmeniz gerekir. https://aka.ms/iotcentraldocsapi adresinden daha fazla bilgi edinin.

--yes -y

Kullanıcı istemlerini atlayın. Eylemin kabul edilmesini gösterir. Öncelikle otomasyon senaryoları için kullanılır. Varsayılan: false.

kabul edilen değerler: false, true
varsayılan değer: False
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 central diagnostics validate-properties

Önizleme

'iot central diagnostics' komut grubu önizleme aşamasında ve geliştirme aşamasındadır. Başvuru ve destek düzeyleri: https://aka.ms/CLI_refstatus

IoT Central uygulamasına gönderilen bildirilen özellikleri doğrulayın.

Bildirilen özellik güncelleştirmelerinde doğrulamalar gerçekleştirir:

  1. Uyarı - Cihaz tarafından gönderilen ve merkezi olarak modellenmemiş özellikler.
  2. Uyarı - Birden çok arabirimde bildirilen aynı ada sahip özellikler, özellik güncelleştirmesinin bir parçası olarak arabirim adına sahip olmalıdır.
az iot central diagnostics validate-properties --app-id
                                               --device-id
                                               [--central-api-uri]
                                               [--minimum-severity {error, info, warning}]
                                               [--token]

Örnekler

Temel kullanım

az iot central diagnostics validate-properties --app-id {app_id} -d {device_id}

Gerekli Parametreler

--app-id -n

Yönetmek istediğiniz IoT Central uygulamasının Uygulama Kimliği. Uygulama Kimliğini, yardım menüsünün altında uygulamanızın "Hakkında" sayfasında bulabilirsiniz.

--device-id -d

Hedef cihazın cihaz kimliği. Cihaz kimliğini, Cihaz Ayrıntıları sayfasındaki Bağlan düğmesine tıklayarak bulabilirsiniz.

İsteğe Bağlı Parametreler

--central-api-uri --central-dns-suffix

Uygulamanızla ilişkili IoT Central DNS soneki.

varsayılan değer: azureiotcentral.com
--minimum-severity

Raporlama için gereken sorunun en düşük önem derecesi.

kabul edilen değerler: error, info, warning
varsayılan değer: warning
--token

Azure CLI'da kimlik doğrulaması yapmadan isteğinizi göndermeyi tercih ederseniz, isteğinizin kimliğini doğrulamak için geçerli bir kullanıcı belirteci belirtebilirsiniz. İsteğin bir parçası olarak anahtar türünü belirtmeniz gerekir. https://aka.ms/iotcentraldocsapi adresinden daha fazla bilgi edinin.

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.