az iot central diagnostics

Feljegyzés

Ez a hivatkozás az Azure CLI azure-iot bővítményének része (2.46.0-s vagy újabb verzió). A bővítmény automatikusan telepíti az az iot central diagnostics parancs első futtatásakor. További információ a bővítményekről.

Ez a parancscsoport előzetes verzióban és fejlesztés alatt áll. Referencia- és támogatási szintek: https://aka.ms/CLI_refstatus

Alkalmazás- és eszközszintű diagnosztikát végezhet.

Parancsok

Name	Description	Típus	Állapot
az iot central diagnostics monitor-events	Az IoT Central alkalmazásnak küldött eszköztelemetriaüzenetek megtekintése.	Mellék	Előnézet
az iot central diagnostics monitor-properties	Megtekintheti az IoT Central alkalmazásba vagy onnan küldött kívánt és jelentett tulajdonságokat.	Mellék	Előnézet
az iot central diagnostics registration-summary	Tekintse meg az alkalmazás összes eszközének regisztrációs összegzését.	Mellék	Előnézet
az iot central diagnostics validate-messages	Ellenőrizze az IoT Hubnak egy IoT Central-alkalmazáshoz küldött üzeneteket.	Mellék	Előnézet
az iot central diagnostics validate-properties	Ellenőrizze az IoT Central-alkalmazásnak küldött jelentett tulajdonságokat.	Mellék	Előnézet

az iot central diagnostics monitor-events

Előnézet

Az "iot central diagnostics" parancscsoport előzetes verzióban és fejlesztés alatt áll. Referencia- és támogatási szintek: https://aka.ms/CLI_refstatus

Az IoT Central alkalmazásnak küldött eszköztelemetriaüzenetek megtekintése.

Megjeleníti az IoT Central-alkalmazásnak küldött telemetriai adatokat. Alapértelmezés szerint az összes eszköz által küldött összes adatot megjeleníti. A --device-id paraméterrel szűrhet egy adott eszközre.

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}]

Példák

Alapszintű használat

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

Alapszintű használat a céleszköz szűrésekor

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

Alapszintű használat a megcélzott eszközök szűréséhez helyettesítő karakterrel az azonosítóban

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

Alapszintű használat a modul szűrésekor.

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

Alapszintű használat a megcélzott modulok szűréséhez helyettesítő karakterrel az azonosítóban

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

Szűrje az eszközt, és adjon meg egy Event Hub fogyasztói csoportot, amelyhez kapcsolódni szeretne.

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

Üzenetjegyzetek fogadása (üzenetfejlécek)

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

Üzenetjegyzetek és rendszertulajdonságok fogadása. Soha ne időtúllépés.

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

Az összes üzenetattribútum fogadása az összes eszközüzenetből

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

Az összes üzenet fogadása és az üzenet hasznos adatainak elemzése JSON-ként

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

Kötelező paraméterek

--app-id -n

A kezelni kívánt IoT Central-alkalmazás alkalmazásazonosítója. Az alkalmazás azonosítóját az alkalmazás "Névjegy" lapján találja a súgómenüben.

Opcionális paraméterek

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

Az alkalmazáshoz társított IoT Central DNS-utótag.

Alapértelmezett érték: azureiotcentral.com

--cg --consumer-group -c

Adja meg az event hub végponthoz való csatlakozáskor használni kívánt fogyasztói csoportot.

Alapértelmezett érték: $Default

--device-id -d

A céleszköz eszközazonosítója. Az eszközazonosítót az Eszköz adatai lapon a Csatlakozás gombra kattintva találja meg.

--enqueued-time --et -e

Azt az időt jelzi, amelyet kiindulási pontként kell használni a partíciók üzeneteinek olvasásához. Az egységek a Unix-korszak óta ezredmásodpercek. Ha nincs idő jelzi, hogy "most" van használatban.

--module-id -m

Az IoT Edge-modul azonosítója, ha az eszköz típusa IoT Edge.

--properties --props -p

Adja meg a kimenet legfontosabb üzenettulajdonságát. sys = rendszertulajdonságok, alkalmazás = alkalmazástulajdonságok, anno = széljegyzetek.

Elfogadott értékek: all, anno, app, sys

--repair -r

Telepítse újra a bővítményverzióval kompatibilis uamqp-függőséget. Alapértelmezett érték: false (hamis).

Elfogadott értékek: false, true

Alapértelmezett érték: False

--timeout --to -t

A kapcsolat üzenet fogadása nélküli fenntartásához szükséges maximális másodperc. Használja a 0-t a végtelenhöz.

Alapértelmezett érték: 300

--token

Ha a kérést az Azure CLI hitelesítése nélkül szeretné elküldeni, megadhat egy érvényes felhasználói jogkivonatot a kérés hitelesítéséhez. A kérés részeként meg kell adnia a kulcs típusát. További információ: https://aka.ms/iotcentraldocsapi.

--yes -y

Felhasználói kérések kihagyása. A művelet elfogadását jelzi. Elsősorban automatizálási forgatókönyvekhez használatos. Alapértelmezett érték: false (hamis).

Elfogadott értékek: false, true

Alapértelmezett érték: False

Globális paraméterek

--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

--output -o

Kimeneti formátum.

Elfogadott értékek: json, jsonc, none, table, tsv, yaml, yamlc

Alapértelmezett érték: json

--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést konfigurálhatja a következővel az account set -s NAME_OR_ID: .

--verbose

A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

az iot central diagnostics monitor-properties

Előnézet

Az "iot central diagnostics" parancscsoport előzetes verzióban és fejlesztés alatt áll. Referencia- és támogatási szintek: https://aka.ms/CLI_refstatus

Megtekintheti az IoT Central alkalmazásba vagy onnan küldött kívánt és jelentett tulajdonságokat.

Lekérdezi az ikereszközt a központiról, és összehasonlítja az utolsó ikereszköz-elemzési tulajdonsággal, és észleli, hogy történtek-e módosítások a lekérdezési időközön belül módosított tulajdonságok részhalmazában.

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

Példák

Alapszintű használat

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

Kötelező paraméterek

--app-id -n

A kezelni kívánt IoT Central-alkalmazás alkalmazásazonosítója. Az alkalmazás azonosítóját az alkalmazás "Névjegy" lapján találja a súgómenüben.

--device-id -d

A céleszköz eszközazonosítója. Az eszközazonosítót az Eszköz adatai lapon a Csatlakozás gombra kattintva találja meg.

Opcionális paraméterek

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

Az alkalmazáshoz társított IoT Central DNS-utótag.

Alapértelmezett érték: azureiotcentral.com

--token

Ha a kérést az Azure CLI hitelesítése nélkül szeretné elküldeni, megadhat egy érvényes felhasználói jogkivonatot a kérés hitelesítéséhez. A kérés részeként meg kell adnia a kulcs típusát. További információ: https://aka.ms/iotcentraldocsapi.

Globális paraméterek

--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

--output -o

Kimeneti formátum.

Elfogadott értékek: json, jsonc, none, table, tsv, yaml, yamlc

Alapértelmezett érték: json

--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést konfigurálhatja a következővel az account set -s NAME_OR_ID: .

--verbose

A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

az iot central diagnostics registration-summary

Előnézet

Az "iot central diagnostics" parancscsoport előzetes verzióban és fejlesztés alatt áll. Referencia- és támogatási szintek: https://aka.ms/CLI_refstatus

Tekintse meg az alkalmazás összes eszközének regisztrációs összegzését.

Megjegyzés: Ez a parancs jelentős időt vehet igénybe, ha az alkalmazás sok eszközt tartalmaz.

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

Példák

Regisztráció összegzése

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

Kötelező paraméterek

--app-id -n

A kezelni kívánt IoT Central-alkalmazás alkalmazásazonosítója. Az alkalmazás azonosítóját az alkalmazás "Névjegy" lapján találja a súgómenüben.

Opcionális paraméterek

--api-version --av

Elavult

Az "api_version" argumentum elavult, és egy későbbi kiadásban el lesz távolítva.

Ez a parancsparaméter elavult, és figyelmen kívül lesz hagyva. A jövőbeni kiadásban csak a legújabb GA-verziójú IoT Central API-kat támogatjuk. Ha egy API még nem érhető el, a legújabb előzetes verziót hívjuk meg.

Elfogadott értékek: 2022-06-30-preview, 2022-07-31

Alapértelmezett érték: 2022-07-31

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

Az alkalmazáshoz társított IoT Central DNS-utótag.

Alapértelmezett érték: azureiotcentral.com

--token

Ha a kérést az Azure CLI hitelesítése nélkül szeretné elküldeni, megadhat egy érvényes felhasználói jogkivonatot a kérés hitelesítéséhez. A kérés részeként meg kell adnia a kulcs típusát. További információ: https://aka.ms/iotcentraldocsapi.

Globális paraméterek

--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

--output -o

Kimeneti formátum.

Elfogadott értékek: json, jsonc, none, table, tsv, yaml, yamlc

Alapértelmezett érték: json

--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést konfigurálhatja a következővel az account set -s NAME_OR_ID: .

--verbose

A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

az iot central diagnostics validate-messages

Előnézet

Az "iot central diagnostics" parancscsoport előzetes verzióban és fejlesztés alatt áll. Referencia- és támogatási szintek: https://aka.ms/CLI_refstatus

Ellenőrizze az IoT Hubnak egy IoT Central-alkalmazáshoz küldött üzeneteket.

Érvényesíti azokat a telemetriai üzeneteket és jelentéseket, amelyek nem modellezhetők az eszközsablonban vagy olyan adatokban, amelyek adattípusa nem egyezik meg az eszközsablonban definiált adatokkal.

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}]

Példák

Alapszintű használat

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

Kimeneti hibák észlelésekor

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

Alapszintű használat a céleszköz szűrésekor

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

Alapszintű használat a megcélzott eszközök szűréséhez helyettesítő karakterrel az azonosítóban

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

Alapszintű használat a modul szűrésekor.

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

Alapszintű használat a megcélzott modulok szűréséhez helyettesítő karakterrel az azonosítóban

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

Szűrje az eszközt, és adjon meg egy Event Hub fogyasztói csoportot, amelyhez kapcsolódni szeretne.

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

Kötelező paraméterek

--app-id -n

A kezelni kívánt IoT Central-alkalmazás alkalmazásazonosítója. Az alkalmazás azonosítóját az alkalmazás "Névjegy" lapján találja a súgómenüben.

Opcionális paraméterek

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

Az alkalmazáshoz társított IoT Central DNS-utótag.

Alapértelmezett érték: azureiotcentral.com

--cg --consumer-group -c

Adja meg az event hub végponthoz való csatlakozáskor használni kívánt fogyasztói csoportot.

Alapértelmezett érték: $Default

--device-id -d

A céleszköz eszközazonosítója. Az eszközazonosítót az Eszköz adatai lapon a Csatlakozás gombra kattintva találja meg.

--dr --duration

A céleszközről érkező üzenetek fogadásának maximális időtartama a kapcsolat megszüntetése előtt. Használja a 0-t a végtelenhöz.

Alapértelmezett érték: 300

--enqueued-time --et -e

Azt az időt jelzi, amelyet kiindulási pontként kell használni a partíciók üzeneteinek olvasásához. Az egységek a Unix-korszak óta ezredmásodpercek. Ha nincs idő jelzi, hogy "most" van használatban.

--max-messages --mm

A céleszközről a kapcsolat megszüntetése előtt fogadandó üzenetek maximális száma. Használja a 0-t a végtelenhöz.

Alapértelmezett érték: 10

--minimum-severity

A jelentéskészítéshez szükséges probléma minimális súlyossága.

Elfogadott értékek: error, info, warning

Alapértelmezett érték: warning

--module-id -m

Az IoT Edge-modul azonosítója, ha az eszköz típusa IoT Edge.

--properties --props -p

Adja meg a kimenet legfontosabb üzenettulajdonságát. sys = rendszertulajdonságok, alkalmazás = alkalmazástulajdonságok, anno = széljegyzetek.

Elfogadott értékek: all, anno, app, sys

--repair -r

Telepítse újra a bővítményverzióval kompatibilis uamqp-függőséget. Alapértelmezett érték: false (hamis).

Elfogadott értékek: false, true

Alapértelmezett érték: False

--style

Output stylescroll = kézbesítési hibák megjelenítése érkezéskor, json = az eredmények összegzése jsonként, csv = az eredmények összegzése csv-ként.

Elfogadott értékek: csv, json, scroll

Alapértelmezett érték: scroll

--timeout --to -t

A kapcsolat üzenet fogadása nélküli fenntartásához szükséges maximális másodperc. Használja a 0-t a végtelenhöz.

Alapértelmezett érték: 300

--token

Ha a kérést az Azure CLI hitelesítése nélkül szeretné elküldeni, megadhat egy érvényes felhasználói jogkivonatot a kérés hitelesítéséhez. A kérés részeként meg kell adnia a kulcs típusát. További információ: https://aka.ms/iotcentraldocsapi.

--yes -y

Felhasználói kérések kihagyása. A művelet elfogadását jelzi. Elsősorban automatizálási forgatókönyvekhez használatos. Alapértelmezett érték: false (hamis).

Elfogadott értékek: false, true

Alapértelmezett érték: False

Globális paraméterek

--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

--output -o

Kimeneti formátum.

Elfogadott értékek: json, jsonc, none, table, tsv, yaml, yamlc

Alapértelmezett érték: json

--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést konfigurálhatja a következővel az account set -s NAME_OR_ID: .

--verbose

A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

az iot central diagnostics validate-properties

Előnézet

Az "iot central diagnostics" parancscsoport előzetes verzióban és fejlesztés alatt áll. Referencia- és támogatási szintek: https://aka.ms/CLI_refstatus

Ellenőrizze az IoT Central-alkalmazásnak küldött jelentett tulajdonságokat.

Érvényesíti a jelentett tulajdonságfrissítéseket:

1. Figyelmeztetés – A nem középen modellezett eszköz által küldött tulajdonságok.
2. Figyelmeztetés – A több felületen deklarált azonos nevű tulajdonságoknak tartalmazniuk kell a felület nevét a tulajdonságfrissítés részeként.

az iot central diagnostics validate-properties --app-id
                                               --device-id
                                               [--central-api-uri]
                                               [--minimum-severity {error, info, warning}]
                                               [--token]

Példák

Alapszintű használat

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

Kötelező paraméterek

--app-id -n

A kezelni kívánt IoT Central-alkalmazás alkalmazásazonosítója. Az alkalmazás azonosítóját az alkalmazás "Névjegy" lapján találja a súgómenüben.

--device-id -d

A céleszköz eszközazonosítója. Az eszközazonosítót az Eszköz adatai lapon a Csatlakozás gombra kattintva találja meg.

Opcionális paraméterek

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

Az alkalmazáshoz társított IoT Central DNS-utótag.

Alapértelmezett érték: azureiotcentral.com

--minimum-severity

A jelentéskészítéshez szükséges probléma minimális súlyossága.

Elfogadott értékek: error, info, warning

Alapértelmezett érték: warning

--token

Ha a kérést az Azure CLI hitelesítése nélkül szeretné elküldeni, megadhat egy érvényes felhasználói jogkivonatot a kérés hitelesítéséhez. A kérés részeként meg kell adnia a kulcs típusát. További információ: https://aka.ms/iotcentraldocsapi.

Globális paraméterek

--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

--output -o

Kimeneti formátum.

Elfogadott értékek: json, jsonc, none, table, tsv, yaml, yamlc

Alapértelmezett érték: json

--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést konfigurálhatja a következővel az account set -s NAME_OR_ID: .

--verbose

A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.