Share via

Apparaatgegevens weergeven

  • Artikel

Belangrijk

Dit is de Documentatie voor Azure Sphere (verouderd). Azure Sphere (verouderd) wordt op 27 september 2027 buiten gebruik gesteld en gebruikers moeten tegen deze tijd migreren naar Azure Sphere (geïntegreerd). Gebruik de versiekiezer boven de inhoudsweergave om de Documentatie van Azure Sphere (geïntegreerd) weer te geven.

Een Azure Sphere-tenant kan duizenden apparaten bevatten en het beheer van de apparaten vereist een methode 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 voor het weergeven van informatie over de apparaten, producten en apparaatgroepen in een tenant.

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 CLI'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 naar bestaande pagineringshulpprogramma's te gaan.

Voorbeeld:

  • 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

Notitie

Deze bewerking kan mogelijk traag zijn, afhankelijk van de hoeveelheid gegevens die wordt 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 om een pagina met records tegelijk te retourneren, waarbij het paginaformaat doorgaans is ingesteld op 100 records. Onder aan elke pagina met resultaten wordt een bericht weergegeven 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 uitgebreide controle door een pad en bestandsnaam voor --output de parameter op te geven 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 aan het einde van elke pagina hoeft door te gaan.

Informatie weergeven voor ondersteuning

De opdrachten die worden gebruikt om ondersteuningsinformatie te verkrijgen, zijn afhankelijk van of u klantondersteuningsgegevens verzamelt voor één Azure Sphere-apparaat wanneer u met Microsoft-ondersteuning werkt of gegevens over foutvoorwaarden retourneert 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 voor foutvoorwaarden op alle apparaten met behulp van de opdracht azsphere tenant download-error-report . Deze methode is afhankelijk van de Communicatie van de Azure Sphere-beveiligingsservice 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 gegevens 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 van het .zip-bestand op te geven 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 van het .csv-bestand op te geven waarin de ondersteuningsgegevens moeten worden opgeslagen. U kunt een relatief of absoluut pad opgeven.