Apparaatgegevens weergeven

Een Azure Sphere-tenant kan duizenden apparaten bevatten en voor het beheren van de apparaten is een methode vereist om gedetailleerde informatie over elk van deze apparaten te verkrijgen. Met behulp van de CLI-opdrachten kunt u informatie weergeven over apparaten, producten en apparaatgroepen in een tenant. U kunt ook de standaarduitvoer van een opdracht omleiden naar een bestand voor gedetailleerde controle.

U kunt de CLI-opdrachten ook gebruiken om diagnostische en configuratiegegevens, gegevens over de fouten en andere gebeurtenissen die van invloed zijn op uw apparaten te downloaden.

Resultaten omleiden of pagineren

De Azure Sphere-opdrachtregelinterface (CLI) biedt de volgende opdrachten om informatie weer te geven over de apparaten, producten en apparaatgroepen in een tenant.

• azsphere device-group device list geeft alle apparaten binnen een specifieke apparaatgroep weer.
• azsphere device list geeft alle apparaten in een tenant weer.
• azsphere product device list geeft alle apparaten in een product weer.

Deze opdrachten kunnen een grote lijst met items retourneren die kunnen worden omgeleid of gepagineerd. In deze sectie worden de verschillende manieren beschreven om uitvoer van beide CDI's om te leiden of te pagineren.

Azure Sphere CLI

Azure Sphere CLI biedt geen ondersteuning voor interactieve paginering. U kunt echter de uitvoer op het scherm pagineren door door te gaan naar bestaande pagineringshulpmiddelen.

Bijvoorbeeld:

• In PowerShell (Windows): azsphere device list | Out-Host –Paging
• Bij een opdrachtprompt (Windows): azsphere device list | more
• In Bash-shell (Linux): azsphere device list | less

Opmerking

Deze bewerking kan mogelijk traag zijn, afhankelijk van hoeveel gegevens worden geretourneerd.

U kunt ook de standaarduitvoer van een opdracht omleiden naar een bestand. In het volgende voorbeeld wordt de standaarduitvoer verzonden naar output.txt en wordt de standaardfout verzonden naar logs.txt.

azsphere device list --verbose > output.txt 2> logs.txt

Klassieke Azure Sphere CLI

De standaardactie van deze opdrachten is het retourneren van een pagina met records in één keer, waarbij de paginagrootte doorgaans is ingesteld op 100 records. Onder aan elke pagina met resultaten ziet u een bericht om op een willekeurige toets te drukken om door te gaan met de volgende pagina met resultaten. Het paginaformaat wordt automatisch aangepast op basis van factoren zoals databaseactiviteit en beschikbare netwerkbandbreedte.

U kunt de resultaten van een lijstopdracht omleiden naar een csv-bestand (door komma's gescheiden waarden) voor diepgaande controle door een pad en bestandsnaam op te geven voor --output de parameter en de --noninteractive parameter toe te voegen aan de opdracht. De --noninteractive parameter verwijdert de paginering uit de resultaten, zodat de hele lijst wordt vastgelegd in het CSV-bestand zonder dat u handmatig verder hoeft te gaan aan het einde van elke pagina.

Informatie voor ondersteuning weergeven

De opdrachten die worden gebruikt voor het verkrijgen van ondersteuningsinformatie, zijn afhankelijk van of u klantondersteuningsgegevens verzamelt voor één Azure Sphere-apparaat wanneer u met Microsoft-ondersteuning werkt of gegevens retourneert over foutomstandigheden met betrekking tot de toepassingen die worden uitgevoerd op apparaten binnen een tenant. In de meeste scenario's voert u een query uit op de tenant op foutvoorwaarden op alle apparaten met behulp van de opdracht azsphere tenant download-error-report . Deze methode is afhankelijk van de azure Sphere Security Service-communicatie met de apparaten via een internetverbinding om de overeenkomende gebeurtenissen te verzamelen.

get-support-data

De opdracht azsphere get-support-data verzamelt en genereert logboekbestanden met diagnostische en configuratiegegevens van uw computer, de cloud en het gekoppelde Azure Sphere-apparaat. De informatie in deze logboekbestanden kan worden gebruikt om u of het technische ondersteuningsteam te helpen bij het analyseren en oplossen van problemen. Gebruik de --destination parameter om het pad en de bestandsnaam op te geven van het .zip-bestand waarin de ondersteuningsgegevens moeten worden opgeslagen. U kunt een relatief of absoluut pad opgeven.

download-error-report

De opdracht azsphere tenant download-error-report retourneert informatie over fouten die zijn gerapporteerd door apparaten binnen een tenant. Gebeurtenisgegevens worden opgehaald uit de Azure Sphere Security Service-cloud en vereisen geen fysieke verbinding met een bepaald apparaat. De opdracht werkt in de context van de huidige tenant en retourneert foutrapporten voor alle apparaten binnen die tenant.

Gebruik de --destination parameter om het pad en de bestandsnaam op te geven van het .csv-bestand waarin de ondersteuningsgegevens moeten worden opgeslagen. U kunt een relatief of absoluut pad opgeven.