Visa enhetsinformation

Viktigt!

Det här är dokumentationen om Azure Sphere (Legacy). Azure Sphere (Legacy) upphör den 27 september 2027 och användarna måste migrera till Azure Sphere (integrerad) vid den här tiden. Använd versionsväljaren ovanför TOC för att visa dokumentationen om Azure Sphere (integrerad).

En Azure Sphere-klientorganisation kan innehålla tusentals enheter, och för att hantera enheterna krävs en metod för att få detaljerad information om var och en av dem. Med HJÄLP av CLI-kommandon kan du visa information om enheter, produkter och enhetsgrupper i en klientorganisation. Du kan också omdirigera standardutdata för ett kommando till en fil för detaljerad granskning.

Du kan också använda CLI-kommandon för att ladda ned diagnostik- och konfigurationsinformation, data om felen och andra händelser som påverkar dina enheter.

Omdirigera eller sidnumrera resultat

Azure Sphere-kommandoradsgränssnittet (CLI) innehåller följande kommandon för att visa information om enheter, produkter och enhetsgrupper i en klientorganisation.

• azsphere device-group device list visar alla enheter i en specifik enhetsgrupp.
• azsphere-enhetslistan visar alla enheter i en klientorganisation.
• azsphere-produktenhetslistan visar alla enheter i en produkt.

Dessa kommandon kan returnera en stor lista över objekt som kan omdirigeras eller sidnumreras. I det här avsnittet beskrivs olika sätt att omdirigera eller sidnumrera utdata från båda CLI:erna.

Azure Sphere CLI

Azure Sphere CLI stöder inte interaktiv sidnumrering. Du kan dock paginate utdata på skärmen genom att skicka till befintliga sidnumreringsverktyg.

Till exempel:

• I PowerShell (Windows): azsphere device list | Out-Host –Paging
• I en kommandotolk (Windows): azsphere device list | more
• I Bash Shell (Linux): azsphere device list | less

Kommentar

Den här åtgärden kan vara långsam beroende på hur mycket data som returneras.

Du kan också omdirigera standardutdata för ett kommando till en fil. I följande exempel skickas standardutdata till output.txt och standardfelet skickas till logs.txt.

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

Klassiska CLI för Azure Sphere

Standardåtgärden för dessa kommandon är att returnera en sida med poster samtidigt, där sidstorleken vanligtvis är inställd på 100 poster. Längst ned på varje sida med resultat visas ett meddelande om att trycka på valfri tangent för att fortsätta visa med nästa sida med resultat. Sidstorleken justeras automatiskt baserat på faktorer som databasaktivitet och tillgänglig nätverksbandbredd.

Du kan omdirigera resultatet av ett listkommando till en CSV-fil (kommaavgränsade värden) för djupgående granskning genom att ange en sökväg och ett filnamn för --output parametern och lägga till parametern --noninteractive i kommandot. Parametern --noninteractive tar bort sidnumreringen från resultaten så att hela listan registreras i CSV-filen utan att behöva fortsätta manuellt i slutet av varje sida.

Visa information för support

Vilka kommandon som används för att hämta supportinformation beror på om du samlar in kundsupportdata för en enda Azure Sphere-enhet när du arbetar med Microsoft-supporten eller returnerar data om feltillstånd som involverar program som körs på enheter i en klientorganisation. I de flesta scenarier frågar du klientorganisationen om feltillstånd på alla enheter med kommandot azsphere tenant download-error-report . Den här metoden beror på Azure Sphere Security Service-kommunikationen med enheterna via en Internetanslutning för att samla in matchande händelser.

get-support-data

Kommandot azsphere get-support-data samlar in och genererar loggfiler som innehåller diagnostik- och konfigurationsinformation från datorn, molnet och den anslutna Azure Sphere-enheten. Informationen i dessa loggfiler kan användas för att hjälpa dig eller det tekniska supportteamet att analysera och felsöka problem. Använd parametern --destination för att ange sökvägen och filnamnet för den .zip fil där supportdata ska sparas. Du kan ange en relativ eller absolut sökväg.

download-error-report

Kommandot azsphere tenant download-error-report returnerar information om fel som rapporterats av enheter i en klientorganisation. Händelsedata hämtas från Azure Sphere Security Service-molnet och kräver ingen fysisk anslutning till en viss enhet. Kommandot fungerar i kontexten för den aktuella klientorganisationen och returnerar felrapporter för alla enheter i klientorganisationen.

Använd parametern --destination för att ange sökvägen och filnamnet för den .csv fil där supportdata ska sparas. Du kan ange en relativ eller absolut sökväg.