디바이스 정보 표시

아티클
08/09/2023

Azure Sphere 테넌트는 수천 개의 디바이스를 포함할 수 있으며 디바이스를 관리하려면 각 디바이스에 대한 자세한 정보를 가져오는 메서드가 필요합니다. CLI 명령을 사용하여 테넌트에서 디바이스, 제품 및 디바이스 그룹에 대한 정보를 나열할 수 있습니다. 자세한 검토를 위해 명령의 표준 출력을 파일로 리디렉션할 수도 있습니다.

CLI 명령을 사용하여 진단 및 구성 정보, 오류에 대한 데이터 및 디바이스에 영향을 주는 기타 이벤트를 다운로드할 수도 있습니다.

결과 리디렉션 또는 페이지 매김

Azure Sphere CLI(명령줄 인터페이스)는 테넌트에서 디바이스, 제품 및 디바이스 그룹에 대한 정보를 나열하는 다음 명령을 제공합니다.

azsphere device-group device list 는 특정 디바이스 그룹 내의 모든 디바이스를 표시합니다.
azsphere device list 는 테넌트 내의 모든 디바이스를 표시합니다.
azsphere product device list는 제품 내의 모든 디바이스를 표시합니다.

이러한 명령은 리디렉션되거나 페이지를 매길 수 있는 많은 항목 목록을 반환할 수 있습니다. 이 섹션에서는 두 URI에서 출력을 리디렉션하거나 페이지를 매는 다양한 방법을 설명합니다.

Azure Sphere CLI

Azure Sphere CLI는 대화형 페이지 매김을 지원하지 않습니다. 그러나 기존 페이지 매김 도구로 파이핑하여 화면의 출력을 페이지를 매길 수 있습니다.

예를 들어:

PowerShell(Windows): azsphere device list | Out-Host –Paging
명령 프롬프트에서(Windows): azsphere device list | more
Bash 셸(Linux): azsphere device list | less

참고

이 작업은 반환되는 데이터의 양에 따라 느려질 수 있습니다.

명령의 표준 출력을 파일로 리디렉션할 수도 있습니다. 다음 예제에서는 표준 출력이 output.txt 전송되고 표준 오류가 logs.txt 전송됩니다.

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

Azure Sphere 클래식 CLI

이러한 명령의 기본 동작은 한 번에 레코드 페이지를 반환하는 것입니다. 여기서 페이지 크기는 일반적으로 100개의 레코드로 설정됩니다. 결과의 각 페이지의 맨 아래에는 결과의 다음 페이지와 함께 표시를 계속하기 위해 키를 누르는 메시지가 있습니다. 페이지 크기는 데이터베이스 활동 및 사용 가능한 네트워크 대역폭과 같은 요인에 따라 자동으로 조정됩니다.

매개 변수의 경로 및 파일 이름을 --output 지정하고 매개 변수를 명령에 추가하여 심층 검토를 위해 목록 명령의 --noninteractive 결과를 CSV(쉼표로 구분된 값) 파일로 리디렉션할 수 있습니다. 매개 변수는 --noninteractive 결과에서 페이지 매김을 제거하므로 각 페이지의 끝에서 수동으로 계속할 필요 없이 전체 목록이 CSV 파일에 캡처됩니다.

지원 정보 표시

지원 정보를 가져오는 데 사용되는 명령은 Microsoft 지원으로 작업할 때 단일 Azure Sphere 디바이스에 대한 고객 지원 데이터를 수집하는지 또는 테넌트 내의 디바이스에서 실행되는 애플리케이션과 관련된 오류 조건에 대한 데이터를 반환하는지에 따라 달라집니다. 대부분의 시나리오에서는 azsphere tenant download-error-report 명령을 사용하여 모든 디바이스에서 테넌트에서 오류 조건을 쿼리합니다. 이 방법은 일치하는 이벤트를 수집하기 위해 인터넷 연결을 통해 디바이스와의 Azure Sphere Security Service 통신에 따라 달라집니다.

get-support-data

azsphere get-support-data 명령은 컴퓨터, 클라우드 및 연결된 Azure Sphere 디바이스의 진단 및 구성 정보가 포함된 로그 파일을 수집하고 생성합니다. 이러한 로그 파일의 정보는 사용자 또는 기술 지원 팀이 문제를 분석하고 해결하는 데 도움이 될 수 있습니다. 매개 변수를 --destination 사용하여 지원 데이터를 저장할 .zip 파일의 경로와 파일 이름을 지정합니다. 상대 경로 또는 절대 경로를 제공할 수 있습니다.

download-error-report

azsphere tenant download-error-report 명령은 테넌트 내의 디바이스에서 보고한 오류에 대한 정보를 반환합니다. 이벤트 데이터는 Azure Sphere Security Service 클라우드에서 가져오며 특정 디바이스에 대한 물리적 연결이 필요하지 않습니다. 명령은 현재 테넌트 컨텍스트에서 작동하며 해당 테넌트 내의 모든 디바이스에 대한 오류 보고서를 반환합니다.

매개 변수를 --destination 사용하여 지원 데이터를 저장할 .csv 파일의 경로와 파일 이름을 지정합니다. 상대 경로 또는 절대 경로를 제공할 수 있습니다.

다음을 통해 공유