Wyświetlanie informacji o urządzeniu

Ważne

Jest to dokumentacja usługi Azure Sphere (starsza wersja). Usługa Azure Sphere (starsza wersja) zostanie wycofana 27 września 2027 r., a użytkownicy muszą przeprowadzić migrację do usługi Azure Sphere (zintegrowanej) do tej pory. Użyj selektora wersji znajdującego się powyżej spisu treści, aby wyświetlić dokumentację usługi Azure Sphere (zintegrowaną).

Dzierżawa usługi Azure Sphere może zawierać tysiące urządzeń i zarządzanie urządzeniami wymaga metody uzyskania szczegółowych informacji na temat każdego z nich. Za pomocą poleceń interfejsu wiersza polecenia można wyświetlić listę informacji o urządzeniach, produktach i grupach urządzeń w dzierżawie. Możesz również przekierować standardowe dane wyjściowe polecenia do pliku w celu szczegółowego przeglądu.

Możesz również użyć poleceń interfejsu wiersza polecenia, aby pobrać informacje diagnostyczne i informacje o konfiguracji, dane o błędach i inne zdarzenia wpływające na urządzenia.

Przekieruj lub stronicowanie wyników

Interfejs wiersza polecenia usługi Azure Sphere udostępnia następujące polecenia umożliwiające wyświetlenie listy informacji o urządzeniach, produktach i grupach urządzeń w dzierżawie.

• na liście urządzeń azsphere device-group są wyświetlane wszystkie urządzenia w ramach określonej grupy urządzeń.
• na liście urządzeń azsphere są wyświetlane wszystkie urządzenia w dzierżawie.
• na liście urządzeń produktu azsphere są wyświetlane wszystkie urządzenia w produkcie.

Te polecenia mogą zwracać dużą listę elementów, które mogą być przekierowywane lub podzielone na strony. W tej sekcji opisano różne sposoby przekierowywania lub stronicowania danych wyjściowych z obu interfejsów API.

Azure Sphere CLI

Interfejs wiersza polecenia usługi Azure Sphere nie obsługuje interakcyjnej stronicowania. Możesz jednak stronicować dane wyjściowe na ekranie, przesyłając potoki do istniejących narzędzi do stronicowania.

Na przykład:

• W programie PowerShell (Windows): azsphere device list | Out-Host –Paging
• W wierszu polecenia (Windows): azsphere device list | more
• W powłoce Bash (Linux): azsphere device list | less

Uwaga

Ta operacja może być potencjalnie niska w zależności od ilości zwracanych danych.

Możesz również przekierować standardowe dane wyjściowe polecenia do pliku. W poniższym przykładzie standardowe dane wyjściowe są wysyłane do output.txt, a standardowy błąd jest wysyłany do logs.txt.

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

Wyświetlanie informacji o obsłudze

Polecenia używane do uzyskiwania informacji o pomocy technicznej będą zależeć od tego, czy zbierasz dane pomocy technicznej dla pojedynczego urządzenia usługi Azure Sphere podczas pracy z pomocą techniczną firmy Microsoft, czy zwracasz dane dotyczące warunków błędów dotyczących aplikacji działających na urządzeniach w dzierżawie. W większości scenariuszy będziesz wykonywać zapytania dotyczące dzierżawy pod kątem warunków błędów na wszystkich urządzeniach przy użyciu polecenia azsphere tenant download-error-report . Ta metoda będzie zależeć od komunikacji usługi zabezpieczeń Azure Sphere z urządzeniami za pośrednictwem połączenia internetowego w celu zebrania pasujących zdarzeń.

get-support-data

Polecenie azsphere get-support-data zbiera i generuje pliki dziennika zawierające informacje diagnostyczne i konfiguracyjne z komputera, chmury i dołączonego urządzenia usługi Azure Sphere. Informacje w tych plikach dziennika mogą pomóc Tobie lub zespołowi pomocy technicznej w analizowaniu i rozwiązywaniu problemów. Użyj parametru --destination , aby określić ścieżkę i nazwę pliku .zip, w którym mają być zapisywane dane pomocy technicznej. Możesz podać ścieżkę względną lub bezwzględną.

Uwaga

Zebrane dane mogą zawierać informacje, które chcesz zachować jako prywatne. Przejrzyj tabelę, aby określić, czy dane powinny pozostać prywatne przed udostępnieniem plików dziennika.

W poniższej tabeli przedstawiono szczegóły wygenerowanych plików oraz informacje, które próbuje zebrać polecenie azsphere get-support-data.

Plik dziennika	Opis
AzureSphere_ComputerSetup.log	Rejestruje działania związane z komputerem: — Ustawienia konfiguracji wewnętrznej usługi Azure Sphere. - Adresy IP wszystkich lokalnych adapterów sieciowych. — Wszystkie szczegóły adapterów sieciowych usługi Azure Sphere. — stan usługi Azure Sphere SLIP.
AzureSphere_Device_nnn.log	Rejestruje działania związane z dołączonym urządzeniem: - Szczegóły urządzenia. — Stan obrazów zainstalowanych na urządzeniu. — Składniki i możliwości urządzenia zainstalowane na urządzeniu. - Wi-Fi sieci zapisane na urządzeniu. — bieżący stan sieci i interfejsu urządzenia. - Wyniki skanowania z urządzenia Wi-Fi. — Stan bieżącej konfiguracji Wi-Fi na urządzeniu. - Stan produkcji urządzenia. - Reguły ustawione dla zapory.
AzureSphere_DeviceLog_nnn.bin	Zawiera informacje dotyczące dołączonego urządzenia.
AzureSphere_DeviceTechSupportData_nnn.bin	Zawiera informacje o stanie produkcji dołączonego urządzenia.
AzureSphere_SecurityService_nnn.log	Rejestruje informacje o usłudze zabezpieczeń Azure Sphere: — Bieżąca konfiguracja, w tym bieżący najemca usługi Azure Sphere. — Lista dzierżaw usługi Azure Sphere. — Konfiguracja wdrożenia w chmurze, w tym grupa urządzeń i produkt. — Stan konfiguracji chmury, w tym bieżąca wersja systemu operacyjnego urządzenia i bieżąca wersja systemu operacyjnego dostępna z chmury.
ActivityLogs_AzureSphere.txt	Plik dziennika zawierający informacje o wykonanych poleceniach.
InstallerLogs_AzureSphere	Wyświetla listę plików dziennika zawierających dane instalatora usługi Azure Sphere z ostatnich siedmiu dni.
InstallerLogs_VisualStudio	Wyświetla listę plików dziennika zawierających dane instalatora programu Visual Studio z ostatnich siedmiu dni.

download-error-report

Polecenie azsphere tenant download-error-report zwraca informacje o błędach zgłaszanych przez urządzenia w dzierżawie. Dane zdarzeń są pobierane z chmury usługi zabezpieczeń Azure Sphere i nie wymagają fizycznego połączenia z określonym urządzeniem. Polecenie działa w kontekście bieżącej dzierżawy i zwraca raporty o błędach dla wszystkich urządzeń w tej dzierżawie.

Użyj parametru --destination , aby określić ścieżkę i nazwę pliku .csv, w którym mają być zapisywane dane pomocy technicznej. Możesz podać ścieżkę względną lub bezwzględną.