Zobrazení informací o zařízení
Důležité
Toto je dokumentace k Azure Sphere (starší verze). Azure Sphere (starší verze) se vyřazuje 27. září 2027 a uživatelé musí do této doby migrovat do Azure Sphere (integrované). K zobrazení dokumentace k Azure Sphere (integrované) použijte selektor verzí umístěný nad obsahem.
Tenant Azure Sphere může obsahovat tisíce zařízení a správa zařízení vyžaduje metodu pro získání podrobných informací o jednotlivých zařízeních. Pomocí příkazů rozhraní příkazového řádku můžete v tenantovi vypsat informace o zařízeních, produktech a skupinách zařízení. Standardní výstup příkazu můžete také přesměrovat na soubor pro podrobnou kontrolu.
Příkazy rozhraní příkazového řádku můžete použít také ke stažení diagnostických a konfiguračních informací, dat o chybách a dalších událostech, které ovlivňují vaše zařízení.
Přesměrování nebo stránkování výsledků
Rozhraní příkazového řádku Azure Sphere poskytuje následující příkazy pro výpis informací o zařízeních, produktech a skupinách zařízení v tenantovi.
- Azsphere device-group device list zobrazí všechna zařízení v rámci konkrétní skupiny zařízení.
- nástroj azsphere device list zobrazí všechna zařízení v rámci tenanta.
- nástroj azsphere product device list zobrazí všechna zařízení v rámci produktu.
Tyto příkazy můžou vrátit velký seznam položek, které je možné přesměrovat nebo stránkovat. Tato část popisuje různé způsoby přesměrování nebo stránkování výstupu z obou rozhraní CLI.
Azure Sphere CLI
Azure Sphere CLI nepodporuje interaktivní stránkování. Výstup na obrazovce ale můžete stránkovat propojením do existujících nástrojů stránkování.
Příklad:
- V PowerShellu (Windows):
azsphere device list | Out-Host –Paging
- Na příkazovém řádku (Windows):
azsphere device list | more
- V prostředí Bash (Linux):
azsphere device list | less
Poznámka:
Tato operace může být potenciálně pomalá v závislosti na tom, kolik dat se vrátí.
Standardní výstup příkazu můžete také přesměrovat na soubor. V následujícím příkladu se standardní výstup odešle do output.txt a standardní chyba se odešle do logs.txt.
azsphere device list --verbose > output.txt 2> logs.txt
Azure Sphere Classic CLI
Výchozí akcí těchto příkazů je vrátit stránku záznamů najednou, kde je velikost stránky obvykle nastavená na 100 záznamů. V dolní části každé stránky výsledků je zpráva, která stisknutím libovolné klávesy pokračuje v zobrazení s další stránkou výsledků. Velikost stránky se upraví automaticky na základě faktorů, jako je aktivita databáze a dostupná šířka pásma sítě.
Výsledky příkazu seznamu můžete přesměrovat do souboru hodnot oddělených čárkami (CSV) pro podrobnou kontrolu zadáním cesty a názvu souboru pro --output
parametr a přidáním --noninteractive
parametru do příkazu. Parametr --noninteractive
odebere stránkování z výsledků, takže se celý seznam zachytí v souboru CSV, aniž by bylo nutné pokračovat ručně na konci každé stránky.
Zobrazení informací o podpoře
Příkazy používané k získání informací o podpoře budou záviset na tom, jestli při práci s podporou Microsoftu shromažďujete data zákaznické podpory pro jedno zařízení Azure Sphere nebo vracíte data o chybových podmínkách, které zahrnují aplikace spuštěné na zařízeních v rámci tenanta. Ve většině scénářů budete dotazovat tenanta na chybové stavy na všech zařízeních pomocí příkazu azsphere tenant download-error-report . Tato metoda bude záviset na komunikaci služby zabezpečení Azure Sphere se zařízeními prostřednictvím připojení k internetu, aby se shromáždily odpovídající události.
get-support-data
Příkaz azsphere get-support-data shromažďuje a generuje soubory protokolu obsahující diagnostické a konfigurační informace z počítače, cloudu a připojeného zařízení Azure Sphere. Informace v těchto souborech protokolů můžete použít k tomu, abyste vám nebo týmu technické podpory pomohli analyzovat a řešit problémy.
Pomocí parametru --destination
zadejte cestu a název souboru .zip, do kterého chcete uložit data podpory. Můžete zadat relativní nebo absolutní cestu.
download-error-report
Příkaz azsphere tenant download-error-report vrátí informace o chybách hlášených zařízeními v rámci tenanta. Data událostí se natahou z cloudu azure Sphere Security Service a nevyžadují fyzické připojení k určitému zařízení. Příkaz funguje v kontextu aktuálního tenanta a vrací chybové zprávy pro všechna zařízení v rámci tohoto tenanta.
Pomocí parametru --destination
zadejte cestu a název souboru .csv, do kterého chcete uložit data podpory. Můžete zadat relativní nebo absolutní cestu.