디바이스 정보 표시

아티클
11/05/2024

Important

Azure Sphere(레거시) 설명서입니다. Azure Sphere(레거시)는 2027년 9월 27일에 사용 중지되며 사용자는 이 시간까지 Azure Sphere(통합)로 마이그레이션해야 합니다. TOC 위에 있는 버전 선택기를 사용하여 Azure Sphere(통합) 설명서를 볼 수 있습니다.

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

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

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

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

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

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

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 파일의 경로와 파일 이름을 지정합니다. 상대 또는 절대 경로를 제공할 수 있습니다.

다음을 통해 공유