az iot central diagnostics

Notitie

Deze referentie maakt deel uit van de azure-iot-extensie voor Azure CLI en vereist versie 2.17.1 of hoger. De extensie wordt automatisch geïnstalleerd wanneer u de eerste keer een az iot central diagnostics-opdracht uit te voeren. Meer informatie over extensies.

Diagnostische gegevens op toepassings- en apparaatniveau uitvoeren.

Opdracht

az iot central diagnostics monitor-events

Telemetrieberichten weergeven die naar de app IoT Central verzonden.

az iot central diagnostics monitor-properties

Gewenste en gerapporteerde eigenschappen weergeven die zijn verzonden naar/van IoT Central app.

az iot central diagnostics registration-summary

Bekijk het registratieoverzicht van alle apparaten in een app.

az iot central diagnostics validate-messages

Valideer berichten die naar de IoT Hub voor een IoT Central app.

az iot central diagnostics validate-properties

Valideer de gerapporteerde eigenschappen die naar de IoT Central zijn verzonden.

az iot central diagnostics monitor-events

Telemetrieberichten weergeven die naar de app IoT Central verzonden.

Toont de telemetriegegevens die naar de IoT Central verzonden. Standaard worden alle gegevens weergegeven die door alle apparaten zijn verzonden. Gebruik de parameter --device-id om te filteren op een specifiek apparaat.

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

Voorbeelden

Basisgebruik

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

Basisgebruik bij filteren op doelapparaat

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

Basisgebruik bij het filteren van doelapparaten met een jokerteken in de id

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

Basisgebruik bij het filteren op module.

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

Basisgebruik bij het filteren van doelmodules met een jokerteken in de id

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

Filter het apparaat en geef een Event Hub-consumentengroep op om aan te binden.

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

Berichtaantekeningen ontvangen (berichtheaders)

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

Berichtaantekeningen en systeemeigenschappen ontvangen. Nooit een time-out.

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

Alle berichtkenmerken van alle apparaatberichten ontvangen

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

Alle berichten ontvangen en nettolading van berichten parseren als JSON

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

Vereiste parameters

--app-id -n

De app-id van de IoT Central app die u wilt beheren. U vindt de app-id op de pagina Over voor uw toepassing onder het Help-menu.

Optionele parameters

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

Het IoT Central DNS-achtervoegsel dat is gekoppeld aan uw toepassing. De standaardwaarde is: azureiotcentral.com.

standaardwaarde: azureiotcentral.com
--cg --consumer-group -c

Geef de consumentengroep op die moet worden gebruikt bij het verbinden met het Event Hub-eindpunt.

standaardwaarde: $Default
--device-id -d

De id van het doelapparaat. U kunt de apparaat-id vinden door te klikken op de knop Verbinding maken apparaatdetails op de pagina Apparaatdetails.

--enqueued-time --et -e

Geeft de tijd aan die moet worden gebruikt als uitgangspunt voor het lezen van berichten uit de partities. Eenheden zijn milliseconden sinds unix-epoche. Als er geen tijd wordt aangegeven 'nu' wordt gebruikt.

--module-id -m

Geef IoT Edge module-id op als het apparaattype IoT Edge.

--properties --props -p

Geef de belangrijkste berichteigenschappen aan die moeten worden uitgevoerd. sys = systeemeigenschappen, app = toepassingseigenschappen, anno = aantekeningen.

geaccepteerde waarden: all, anno, app, sys
--repair -r

Uamqp-afhankelijkheid opnieuw installeren die compatibel is met de extensieversie. Standaard: onwaar.

geaccepteerde waarden: false, true
--timeout --to -t

Maximum aantal seconden om verbinding te houden zonder bericht te ontvangen. Gebruik 0 voor oneindig.

standaardwaarde: 300
--token

Als u uw aanvraag liever indient zonder verificatie bij de Azure CLI, kunt u een geldig gebruiker-token opgeven om uw aanvraag te verifiëren. U moet het type sleutel opgeven als onderdeel van de aanvraag. Meer informatie op https://aka.ms/iotcentraldocsapi .

--yes -y

Gebruikersprompts overslaan. Geeft aan dat de installatie van afhankelijkheden is geaccepteerd (indien nodig). Voornamelijk gebruikt voor automatiseringsscenario's. Standaard: onwaar.

geaccepteerde waarden: false, true

az iot central diagnostics monitor-properties

Gewenste en gerapporteerde eigenschappen weergeven die zijn verzonden naar/van IoT Central app.

Pollt apparaat-dubbel van centraal en vergelijkt deze met de laatste apparaat-dubbel parseert eigenschappen van apparaat-dubbel en detecteert of er wijzigingen zijn aangebracht Subset afdrukken van eigenschappen die zijn gewijzigd binnen het polling-interval.

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

Voorbeelden

Basisgebruik

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

Vereiste parameters

--app-id -n

De app-id van de IoT Central app die u wilt beheren. U vindt de app-id op de pagina Over voor uw toepassing onder het Help-menu.

--device-id -d

De id van het doelapparaat. U kunt de apparaat-id vinden door te klikken op de knop Verbinding maken apparaatdetails op de pagina Apparaatdetails.

Optionele parameters

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

Het IoT Central DNS-achtervoegsel dat is gekoppeld aan uw toepassing. De standaardwaarde is: azureiotcentral.com.

standaardwaarde: azureiotcentral.com
--token

Als u uw aanvraag liever indient zonder verificatie bij de Azure CLI, kunt u een geldig gebruiker-token opgeven om uw aanvraag te verifiëren. U moet het type sleutel opgeven als onderdeel van de aanvraag. Meer informatie op https://aka.ms/iotcentraldocsapi .

az iot central diagnostics registration-summary

Bekijk het registratieoverzicht van alle apparaten in een app.

Opmerking: Het kan een aanzienlijke tijd duren om deze opdracht te retourneren als uw app veel apparaten bevat.

az iot central diagnostics registration-summary --app-id
                                                [--central-api-uri]
                                                [--token]

Voorbeelden

Registratieoverzicht

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

Vereiste parameters

--app-id -n

De app-id van de IoT Central app die u wilt beheren. U vindt de app-id op de pagina Over voor uw toepassing onder het Help-menu.

Optionele parameters

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

Het IoT Central DNS-achtervoegsel dat is gekoppeld aan uw toepassing. De standaardwaarde is: azureiotcentral.com.

standaardwaarde: azureiotcentral.com
--token

Als u uw aanvraag liever indient zonder verificatie bij de Azure CLI, kunt u een geldig gebruiker-token opgeven om uw aanvraag te verifiëren. U moet het type sleutel opgeven als onderdeel van de aanvraag. Meer informatie op https://aka.ms/iotcentraldocsapi .

az iot central diagnostics validate-messages

Valideer berichten die naar de IoT Hub voor een IoT Central app.

Voert validaties uit op de telemetrieberichten en rapporteert gegevens die niet zijn gemodelleerd in de apparaatsjabloon of gegevens waarvoor het gegevenstype niet overeenkomen met wat is gedefinieerd in de apparaatsjabloon.

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

Voorbeelden

Basisgebruik

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

Uitvoerfouten wanneer ze worden gedetecteerd

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

Basisgebruik bij filteren op doelapparaat

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

Basisgebruik bij het filteren van doelapparaten met een jokerteken in de id

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

Basisgebruik bij het filteren op module.

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

Basisgebruik bij het filteren van doelmodules met een jokerteken in de id

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

Filter het apparaat en geef een Event Hub-consumentengroep op om aan te binden.

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

Vereiste parameters

--app-id -n

De app-id van de IoT Central app die u wilt beheren. U vindt de app-id op de pagina Over voor uw toepassing onder het Help-menu.

Optionele parameters

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

Het IoT Central DNS-achtervoegsel dat is gekoppeld aan uw toepassing. De standaardwaarde is: azureiotcentral.com.

standaardwaarde: azureiotcentral.com
--cg --consumer-group -c

Geef de consumentengroep op die moet worden gebruikt bij het verbinden met het Event Hub-eindpunt.

standaardwaarde: $Default
--device-id -d

De id van het doelapparaat. U kunt de apparaat-id vinden door te klikken op de knop Verbinding maken apparaatdetails op de pagina Apparaatdetails.

--dr --duration

Maximale duur voor het ontvangen van berichten van het doelapparaat vóór het beëindigen van de verbinding. Gebruik 0 voor oneindig.

standaardwaarde: 300
--enqueued-time --et -e

Geeft de tijd aan die moet worden gebruikt als uitgangspunt voor het lezen van berichten uit de partities. Eenheden zijn milliseconden sinds unix-epoche. Als er geen tijd wordt aangegeven 'nu' wordt gebruikt.

--max-messages --mm

Maximum aantal berichten dat moet worden ontvangen van het doelapparaat vóór het beëindigen van de verbinding. Gebruik 0 voor oneindig.

standaardwaarde: 10
--minimum-severity

Minimale ernst van het probleem dat is vereist voor rapportage.

geaccepteerde waarden: error, info, warning
standaardwaarde: warning
--module-id -m

Geef IoT Edge module-id op als het apparaattype IoT Edge.

--properties --props -p

Geef de belangrijkste berichteigenschappen aan die moeten worden uitgevoerd. sys = systeemeigenschappen, app = toepassingseigenschappen, anno = aantekeningen.

geaccepteerde waarden: all, anno, app, sys
--repair -r

Uamqp-afhankelijkheid opnieuw installeren die compatibel is met de extensieversie. Standaard: onwaar.

geaccepteerde waarden: false, true
--style

Geef uitvoerstijlen aancroll = lever fouten wanneer ze binnenkomen, json = resultaten samenvatten als json, csv = resultaten samenvatten als csv.

geaccepteerde waarden: csv, json, scroll
standaardwaarde: scroll
--timeout --to -t

Maximum aantal seconden om verbinding te houden zonder bericht te ontvangen. Gebruik 0 voor oneindig.

standaardwaarde: 300
--token

Als u uw aanvraag liever indient zonder verificatie bij de Azure CLI, kunt u een geldig gebruiker-token opgeven om uw aanvraag te verifiëren. U moet het type sleutel opgeven als onderdeel van de aanvraag. Meer informatie op https://aka.ms/iotcentraldocsapi .

--yes -y

Gebruikersprompts overslaan. Geeft aan dat de installatie van afhankelijkheden is geaccepteerd (indien nodig). Voornamelijk gebruikt voor automatiseringsscenario's. Standaard: onwaar.

geaccepteerde waarden: false, true

az iot central diagnostics validate-properties

Valideer de gerapporteerde eigenschappen die naar de IoT Central zijn verzonden.

Voert validaties uit voor gerapporteerde updates van eigenschappen:

  1. Waarschuwing: eigenschappen die worden verzonden per apparaat die niet centraal zijn gemodelleerd.
  2. Waarschuwing: voor eigenschappen met dezelfde naam die in meerdere interfaces zijn gedeclareerd, moet de interfacenaam zijn opgenomen als onderdeel van de eigenschapsupdate.
az iot central diagnostics validate-properties --app-id
                                               --device-id
                                               [--central-api-uri]
                                               [--minimum-severity {error, info, warning}]
                                               [--token]

Voorbeelden

Basisgebruik

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

Vereiste parameters

--app-id -n

De app-id van IoT Central app die u wilt beheren. U vindt de app-id op de pagina Over voor uw toepassing onder het Help-menu.

--device-id -d

De id van het doelapparaat. U kunt de apparaat-id vinden door te klikken op Verbinding maken knop Apparaatdetails.

Optionele parameters

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

Het IoT Central DNS-achtervoegsel dat is gekoppeld aan uw toepassing. De standaardwaarde is: azureiotcentral.com.

standaardwaarde: azureiotcentral.com
--minimum-severity

Minimale ernst van het probleem dat is vereist voor rapportage.

geaccepteerde waarden: error, info, warning
standaardwaarde: warning
--token

Als u uw aanvraag liever indient zonder verificatie met de Azure CLI, kunt u een geldig gebruiker-token opgeven om uw aanvraag te verifiëren. U moet het type sleutel opgeven als onderdeel van de aanvraag. Meer informatie op https://aka.ms/iotcentraldocsapi .