장치
Azure Sphere 디바이스를 관리합니다.
| 작업 | 설명 |
|---|---|
| 앱 | 디바이스에서 애플리케이션의 상태 변경합니다. |
| 기능 | 디바이스 기능을 관리합니다. |
| 인증서 | 디바이스 인증서 저장소를 관리합니다. |
| 주장 | 이전에 클레임되지 않은 디바이스를 Azure Sphere 테넌트로 클레임합니다. |
| enable-cloud-test | 디버깅을 사용하지 않도록 설정하고 업데이트를 받도록 디바이스를 설정합니다. |
| enable-development | 로컬 디버깅을 위한 디바이스를 설정합니다. |
| 이미지 | 디바이스의 이미지를 관리합니다. |
| 목록 | 테넌트에서 모든 디바이스를 표시합니다. |
| list-attached | 연결된 디바이스를 Lists. |
| manufacturing-state | 연결된 디바이스의 제조 상태를 관리합니다. |
| 네트워크 | 디바이스에서 네트워크 인터페이스의 상태 대한 정보를 제공합니다. |
| 복구 | 특수 복구 모드를 사용하여 새 펌웨어를 디바이스에 로드합니다. |
| rescan-attached | 연결된 디바이스를 문제 해결 지원(Windows에만 해당)으로 다시 검사합니다. |
| 다시 시작할 | 연결된 디바이스를 다시 시작합니다. |
| 표시 | 디바이스의 업데이트 구성에 대한 세부 정보를 표시합니다. |
| show-attached | 디바이스 자체에서 연결된 디바이스에 대한 세부 정보를 표시합니다. |
| show-count | 테넌트에서 총 디바이스 수를 표시합니다. |
| show-deployment-상태 | 최신 배포 업데이트의 상태 표시합니다. |
| show-os-version | 로컬 디바이스 운영 체제 버전을 표시합니다. |
| sideload | 연결된 디바이스에 이미지를 로드합니다. |
| 업데이트 | 특정 디바이스 그룹에 배치하여 디바이스를 업데이트. |
| Wifi | 디바이스에 대한 Wi-Fi 구성을 관리합니다. |
앱
디바이스에서 애플리케이션을 관리합니다.
대부분의 앱 옵션에는 azsphere device enable-development를 사용하여 획득할 수 있는 appDevelopment 기능이 필요합니다. SDK 서명 애플리케이션 또는 프로덕션 서명 애플리케이션을 시작, 중지 또는 디버그하려면 디바이스에 appDevelopment 기능이 있어야 합니다.
azsphere device app stop을 사용하고 azsphere device app start를 사용하여 실행 중인 실시간 지원 애플리케이션을 다시 시작하여 실행 중인 실시간 코어를 확인할 수 있습니다.
| 작업 | 설명 |
|---|---|
| show-memory-stats | 연결된 디바이스의 애플리케이션에 대한 메모리 통계를 표시합니다. |
| show-quota | 디바이스의 현재 애플리케이션에서 사용하는 스토리지 양을 표시합니다. |
| show-상태 | 디바이스에서 현재 애플리케이션의 상태 반환합니다. |
| 시작 | 디바이스에 로드된 애플리케이션을 시작합니다. |
| 중지 | 디바이스에서 실행 중인 애플리케이션을 중지합니다. |
앱 show-memory-stats
연결된 디바이스의 애플리케이션에 대한 메모리 통계를 표시합니다. 이 명령은 appDevelopment 디바이스 기능이 구성된 경우에만 사용할 수 있습니다. 힙 메모리 할당 추적이 구성된 경우 추가 정보가 표시됩니다.
선택적 매개 변수
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| -d, --device | 문자열 | 여러 디바이스가 연결되면 명령을 실행할 디바이스를 지정합니다. 이 매개 변수는 여러 디바이스가 연결된 경우에 필요합니다. 현재 연결된 디바이스는 기본적으로 사용됩니다. 연결된 디바이스의 디바이스 ID, IP 주소 또는 로컬 연결 ID를 지정할 수 있습니다. Azure Sphere CLI는 Windows에서 여러 MT3620 디바이스를 지원하지만 Linux에서 한 번에 하나의 디바이스만 연결할 수 있습니다. 이러한 이유로 이 매개 변수는 Windows에서 지원되지만 Linux에서는 지원되지 않습니다. Linux의 명령과 함께 이 매개 변수를 사용하는 경우 오류가 반환됩니다. |
전역 매개 변수
Azure Sphere CLI에 사용할 수 있는 전역 매개 변수는 다음과 같습니다.
| 매개 변수 | 설명 |
|---|---|
| --디버그 | 모든 디버그 로그를 표시하도록 로깅 세부 정보를 늘립니다. 버그가 발견되면 버그 보고서를 제출할 때 플래그가 --debug 켜진 상태에서 생성된 출력을 제공합니다. |
| -h, --help | 명령 및 해당 인수에 대한 CLI 참조 정보를 인쇄하고 사용 가능한 하위 그룹 및 명령을 나열합니다. |
| --only-show-errors | 오류만 표시하고 경고를 표시하지 않습니다. |
| -o, --output | 출력 형식을 변경합니다. 사용 가능한 출력 형식은 json, jsonc(색이 지정된 JSON), tsv(탭으로 구분된 값), 테이블(사람이 읽을 수 있는 ASCII 테이블) 및 yaml입니다. 기본적으로 CLI는 를 출력합니다 table. 사용 가능한 출력 형식에 대한 자세한 내용은 Azure Sphere CLI 명령에 대한 출력 형식을 참조하세요. |
| --쿼리 | JMESPath 쿼리 언어를 사용하여 Azure Sphere Security Services에서 반환된 출력을 필터링합니다. 자세한 내용 및 예제 는 JMESPath 자습서 및 Azure CLI 명령 출력 쿼리 를 참조하세요. |
| --자세한 | 작업 중에 Azure Sphere에서 만든 리소스에 대한 정보 및 기타 유용한 정보를 출력합니다. 전체 디버그 로그에 사용합니다 --debug . |
참고
Azure Sphere 클래식 CLI를 사용하는 경우 사용 가능한 옵션에 대한 자세한 내용은 전역 매개 변수 를 참조하세요.
예제
azsphere device app show-memory-stats
-------------- -------------
Name Usage (bytes)
============================
Total 434176
User Mode 147456
Peak User Mode 147456
-------------- -------------
앱 show-quota
연결된 디바이스에서 할당되고 사용 중인 변경 가능한 스토리지의 양을 표시합니다.
애플리케이션 매니페스트에서 변경 가능한 스토리지 할당량을 설정하고 Azure Sphere OS는 파일에 대한 섹터를 할당할 때 할당량을 적용합니다. 따라서 값을 줄 MutableStorage 이면 사용 중인 스토리지 양이 변경되지 않지만 보고된 할당된 값은 다릅니다. 예를 들어 애플리케이션이 이미 16KB를 사용하고 값을 8KB로 변경하는 MutableStorage 경우 명령은 애플리케이션이 할당된 8KB 중 16KB를 사용한다고 보고합니다. 데이터는 디바이스에 남아 있습니다.
선택적 매개 변수
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| -i, --component-id | Guid | 할당량 정보를 가져올 구성 요소의 ID를 지정합니다. 생략하면 모든 구성 요소에 대한 할당량 정보가 표시됩니다. |
| -d, --device | 문자열 | 여러 디바이스가 연결되면 명령을 실행할 디바이스를 지정합니다. 이 매개 변수는 여러 디바이스가 연결된 경우에 필요합니다. 현재 연결된 디바이스는 기본적으로 사용됩니다. 연결된 디바이스의 디바이스 ID, IP 주소 또는 로컬 연결 ID를 지정할 수 있습니다. Azure Sphere CLI는 Windows에서 여러 MT3620 디바이스를 지원하지만 Linux에서 한 번에 하나의 디바이스만 연결할 수 있습니다. 이러한 이유로 이 매개 변수는 Windows에서 지원되지만 Linux에서는 지원되지 않습니다. Linux의 명령과 함께 이 매개 변수를 사용하는 경우 오류가 반환됩니다. |
전역 매개 변수
Azure Sphere CLI에 사용할 수 있는 전역 매개 변수는 다음과 같습니다.
| 매개 변수 | 설명 |
|---|---|
| --디버그 | 모든 디버그 로그를 표시하도록 로깅 세부 정보를 늘립니다. 버그가 발견되면 버그 보고서를 제출할 때 플래그가 --debug 켜진 상태에서 생성된 출력을 제공합니다. |
| -h, --help | 명령 및 해당 인수에 대한 CLI 참조 정보를 인쇄하고 사용 가능한 하위 그룹 및 명령을 나열합니다. |
| --only-show-errors | 오류만 표시하고 경고를 표시하지 않습니다. |
| -o, --output | 출력 형식을 변경합니다. 사용 가능한 출력 형식은 json, jsonc(색이 지정된 JSON), tsv(탭으로 구분된 값), 테이블(사람이 읽을 수 있는 ASCII 테이블) 및 yaml입니다. 기본적으로 CLI는 를 출력합니다 table. 사용 가능한 출력 형식에 대한 자세한 내용은 Azure Sphere CLI 명령에 대한 출력 형식을 참조하세요. |
| --쿼리 | JMESPath 쿼리 언어를 사용하여 Azure Sphere Security Services에서 반환된 출력을 필터링합니다. 자세한 내용 및 예제 는 JMESPath 자습서 및 Azure CLI 명령 출력 쿼리 를 참조하세요. |
| --자세한 | 작업 중에 Azure Sphere에서 만든 리소스에 대한 정보 및 기타 유용한 정보를 출력합니다. 전체 디버그 로그에 사용합니다 --debug . |
참고
Azure Sphere 클래식 CLI를 사용하는 경우 사용 가능한 옵션에 대한 자세한 내용은 전역 매개 변수 를 참조하세요.
예제
azsphere device app show-quota
ae4714aa-03aa-492b-9663-962f966a9cc3: 0KB out of 8KB of mutable storage used.
앱 show-상태
디바이스에서 애플리케이션의 현재 상태 표시합니다.
선택적 매개 변수
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| -i, --component-id | Guid | 상태 표시할 구성 요소의 ID를 지정합니다. 생략하면 모든 구성 요소의 상태 표시됩니다. |
| -d, --device | 문자열 | 여러 디바이스가 연결되면 명령을 실행할 디바이스를 지정합니다. 이 매개 변수는 여러 디바이스가 연결된 경우에 필요합니다. 현재 연결된 디바이스는 기본적으로 사용됩니다. 연결된 디바이스의 디바이스 ID, IP 주소 또는 로컬 연결 ID를 지정할 수 있습니다. Azure Sphere CLI는 Windows에서 여러 MT3620 디바이스를 지원하지만 Linux에서 한 번에 하나의 디바이스만 연결할 수 있습니다. 이러한 이유로 이 매개 변수는 Windows에서 지원되지만 Linux에서는 지원되지 않습니다. Linux의 명령과 함께 이 매개 변수를 사용하는 경우 오류가 반환됩니다. |
전역 매개 변수
Azure Sphere CLI에 사용할 수 있는 전역 매개 변수는 다음과 같습니다.
| 매개 변수 | 설명 |
|---|---|
| --디버그 | 모든 디버그 로그를 표시하도록 로깅 세부 정보를 늘립니다. 버그가 발견되면 버그 보고서를 제출할 때 플래그가 --debug 켜진 상태에서 생성된 출력을 제공합니다. |
| -h, --help | 명령 및 해당 인수에 대한 CLI 참조 정보를 인쇄하고 사용 가능한 하위 그룹 및 명령을 나열합니다. |
| --only-show-errors | 오류만 표시하고 경고를 표시하지 않습니다. |
| -o, --output | 출력 형식을 변경합니다. 사용 가능한 출력 형식은 json, jsonc(색이 지정된 JSON), tsv(탭으로 구분된 값), 테이블(사람이 읽을 수 있는 ASCII 테이블) 및 yaml입니다. 기본적으로 CLI는 를 출력합니다 table. 사용 가능한 출력 형식에 대한 자세한 내용은 Azure Sphere CLI 명령에 대한 출력 형식을 참조하세요. |
| --쿼리 | JMESPath 쿼리 언어를 사용하여 Azure Sphere Security Services에서 반환된 출력을 필터링합니다. 자세한 내용 및 예제 는 JMESPath 자습서 및 Azure CLI 명령 출력 쿼리 를 참조하세요. |
| --자세한 | 작업 중에 Azure Sphere에서 만든 리소스에 대한 정보 및 기타 유용한 정보를 출력합니다. 전체 디버그 로그에 사용합니다 --debug . |
참고
Azure Sphere 클래식 CLI를 사용하는 경우 사용 가능한 옵션에 대한 자세한 내용은 전역 매개 변수 를 참조하세요.
예제
azsphere device app show-status
9ce57001-90eb-45e1-bd0a-4fc07b0c85c9
App state: running
앱 시작
디바이스에서 애플리케이션을 시작합니다.
선택적 매개 변수
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| --debug-mode | 부울 | 디버깅을 위해 애플리케이션을 시작합니다. 를 --component-id 제공해야 합니다. |
| -d, --device | 문자열 | 여러 디바이스가 연결되면 명령을 실행할 디바이스를 지정합니다. 이 매개 변수는 여러 디바이스가 연결된 경우에 필요합니다. 현재 연결된 디바이스는 기본적으로 사용됩니다. 연결된 디바이스의 디바이스 ID, IP 주소 또는 로컬 연결 ID를 지정할 수 있습니다. Azure Sphere CLI는 Windows에서 여러 MT3620 디바이스를 지원하지만 Linux에서 한 번에 하나의 디바이스만 연결할 수 있습니다. 이러한 이유로 이 매개 변수는 Windows에서 지원되지만 Linux에서는 지원되지 않습니다. Linux의 명령과 함께 이 매개 변수를 사용하는 경우 오류가 반환됩니다. |
| -i, --component-id | Guid | 시작할 구성 요소의 ID를 지정합니다. 생략하면 모든 애플리케이션이 시작됩니다. |
전역 매개 변수
Azure Sphere CLI에 사용할 수 있는 전역 매개 변수는 다음과 같습니다.
| 매개 변수 | 설명 |
|---|---|
| --디버그 | 모든 디버그 로그를 표시하도록 로깅 세부 정보를 늘립니다. 버그가 발견되면 버그 보고서를 제출할 때 플래그가 --debug 켜진 상태에서 생성된 출력을 제공합니다. |
| -h, --help | 명령 및 해당 인수에 대한 CLI 참조 정보를 인쇄하고 사용 가능한 하위 그룹 및 명령을 나열합니다. |
| --only-show-errors | 오류만 표시하고 경고를 표시하지 않습니다. |
| -o, --output | 출력 형식을 변경합니다. 사용 가능한 출력 형식은 json, jsonc(색이 지정된 JSON), tsv(탭으로 구분된 값), 테이블(사람이 읽을 수 있는 ASCII 테이블) 및 yaml입니다. 기본적으로 CLI는 를 출력합니다 table. 사용 가능한 출력 형식에 대한 자세한 내용은 Azure Sphere CLI 명령에 대한 출력 형식을 참조하세요. |
| --쿼리 | JMESPath 쿼리 언어를 사용하여 Azure Sphere Security Services에서 반환된 출력을 필터링합니다. 자세한 내용 및 예제 는 JMESPath 자습서 및 Azure CLI 명령 출력 쿼리 를 참조하세요. |
| --자세한 | 작업 중에 Azure Sphere에서 만든 리소스에 대한 정보 및 기타 유용한 정보를 출력합니다. 전체 디버그 로그에 사용합니다 --debug . |
참고
Azure Sphere 클래식 CLI를 사용하는 경우 사용 가능한 옵션에 대한 자세한 내용은 전역 매개 변수 를 참조하세요.
예제
azsphere device app start
836cbcf1-0b4d-45ab-963a-eadcd5017b6a
App state: running
Core : High-level
앱 중지
디바이스에서 애플리케이션을 중지합니다.
선택적 매개 변수
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| -i, --component-id | Guid | 중지할 구성 요소의 ID를 지정합니다. 생략하면 모든 애플리케이션이 중지됩니다. |
| -d, --device | 문자열 | 여러 디바이스가 연결되면 명령을 실행할 디바이스를 지정합니다. 이 매개 변수는 여러 디바이스가 연결된 경우에 필요합니다. 현재 연결된 디바이스는 기본적으로 사용됩니다. 연결된 디바이스의 디바이스 ID, IP 주소 또는 로컬 연결 ID를 지정할 수 있습니다. Azure Sphere CLI는 Windows에서 여러 MT3620 디바이스를 지원하지만 Linux에서 한 번에 하나의 디바이스만 연결할 수 있습니다. 이러한 이유로 이 매개 변수는 Windows에서 지원되지만 Linux에서는 지원되지 않습니다. Linux의 명령과 함께 이 매개 변수를 사용하는 경우 오류가 반환됩니다. |
전역 매개 변수
Azure Sphere CLI에 사용할 수 있는 전역 매개 변수는 다음과 같습니다.
| 매개 변수 | 설명 |
|---|---|
| --디버그 | 모든 디버그 로그를 표시하도록 로깅 세부 정보를 늘립니다. 버그가 발견되면 버그 보고서를 제출할 때 플래그가 --debug 켜진 상태에서 생성된 출력을 제공합니다. |
| -h, --help | 명령 및 해당 인수에 대한 CLI 참조 정보를 인쇄하고 사용 가능한 하위 그룹 및 명령을 나열합니다. |
| --only-show-errors | 오류만 표시하고 경고를 표시하지 않습니다. |
| -o, --output | 출력 형식을 변경합니다. 사용 가능한 출력 형식은 json, jsonc(색이 지정된 JSON), tsv(탭으로 구분된 값), 테이블(사람이 읽을 수 있는 ASCII 테이블) 및 yaml입니다. 기본적으로 CLI는 를 출력합니다 table. 사용 가능한 출력 형식에 대한 자세한 내용은 Azure Sphere CLI 명령에 대한 출력 형식을 참조하세요. |
| --쿼리 | JMESPath 쿼리 언어를 사용하여 Azure Sphere Security Services에서 반환된 출력을 필터링합니다. 자세한 내용 및 예제 는 JMESPath 자습서 및 Azure CLI 명령 출력 쿼리 를 참조하세요. |
| --자세한 | 작업 중에 Azure Sphere에서 만든 리소스에 대한 정보 및 기타 유용한 정보를 출력합니다. 전체 디버그 로그에 사용합니다 --debug . |
참고
Azure Sphere 클래식 CLI를 사용하는 경우 사용 가능한 옵션에 대한 자세한 내용은 전역 매개 변수 를 참조하세요.
예제
azsphere device app stop
836cbcf1-0b4d-45ab-963a-eadcd5017b6a
App state: stopped
기능
디바이스 기능을 관리합니다. 디바이스 기능은 개별 Azure Sphere 디바이스에서 수행할 수 있는 작업을 결정합니다.
디바이스 기능은 azsphere device capability download 명령을 사용하여 Azure Sphere Security Service에서 파일로 다운로드됩니다. azsphere device capability update 명령을 사용하여 연결된 Azure Sphere 디바이스에 디바이스 기능 구성을 적용할 수 있으며 azsphere device capability select 명령을 사용하여 서비스 세션을 만들 수 있습니다. 디바이스 기능에 대한 자세한 내용은 디바이스 기능 및 통신을 참조하세요.
| 작업 | 설명 |
|---|---|
| 다운로드 | Azure Sphere Security Service에서 디바이스 기능 구성을 다운로드합니다. |
| 선택 | 서비스 세션에 사용할 다운로드한 기능 파일을 선택합니다. |
| show-attached | 연결된 디바이스에 대한 기능 구성을 표시합니다. |
| 업데이트 | 연결된 디바이스에 디바이스 기능 구성을 적용합니다. |
기능 다운로드
Azure Sphere Security Service에서 디바이스 기능을 다운로드합니다.
appDevelopment 기능을 사용하면 SDK 서명된 애플리케이션을 테스트용으로 로드하고 디바이스에서 애플리케이션을 시작, 중지, 디버그 또는 삭제할 수 있습니다. appDevelopment 기능이 없으면 클라우드로 로드된 애플리케이션만 로드하고 시작, 중지, 디버그 및 삭제할 수 없습니다. appDevelopment 기능은 azsphere device enable-development 명령의 일부로 적용됩니다.
fieldServicing 기능을 다운로드하면 단일 Azure Sphere 디바이스에 대한 기능이 포함된 파일이 생성됩니다. fieldServicing 기능 파일은 로컬 컴퓨터에 다운로드되며 azsphere device capability select 명령과 함께 사용할 수 있습니다.
필수 매개 변수
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| --형식 | 기능 유형 | 다운로드할 디바이스 기능의 유형을 지정합니다. 값은 appDevelopment, fieldServicing 또는 none입니다. none을 사용하여 appDevelopment 기능 또는 fieldServicing 기능을 제거합니다. |
선택적 매개 변수
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| -d, --device | 문자열 | 명령을 실행할 디바이스를 지정합니다. 이 매개 변수는 여러 디바이스가 연결되거나 디바이스가 연결되지 않은 경우에 필요합니다. 현재 연결된 디바이스는 기본적으로 사용됩니다. 연결되지 않은 디바이스에 대한 디바이스 ID를 제공하거나 연결된 디바이스의 IP 주소 또는 로컬 연결 ID를 지정할 수 있습니다. Azure Sphere CLI는 Windows에서 여러 MT3620 디바이스를 지원하지만 Linux에서 한 번에 하나의 디바이스만 연결할 수 있습니다. 이러한 이유로 이 매개 변수는 Windows에서 지원되지만 Linux에서는 지원되지 않습니다. Linux의 명령과 함께 이 매개 변수를 사용하는 경우 오류가 반환됩니다. |
| --대상 | 문자열 | 기능 구성을 저장할 경로 및 파일 이름을 지정합니다. 절대 경로 또는 상대 경로를 포함합니다. 경로를 제공하지 않으면 명령은 명명 규칙 <기능 유형-<device ID.cap>의 처음 8자 문자를> 사용하여 로컬 디렉터리에 파일을 저장합니다. |
| -t, --tenant | GUID 또는 이름 | 이 작업을 수행할 테넌트 를 지정합니다. 선택한 기본 테넌트 를 재정의합니다. 테넌트 ID 또는 테넌트 이름을 지정할 수 있습니다. |
전역 매개 변수
Azure Sphere CLI에 사용할 수 있는 전역 매개 변수는 다음과 같습니다.
| 매개 변수 | 설명 |
|---|---|
| --디버그 | 모든 디버그 로그를 표시하도록 로깅 세부 정보를 늘립니다. 버그가 발견되면 버그 보고서를 제출할 때 플래그가 --debug 켜진 상태에서 생성된 출력을 제공합니다. |
| -h, --help | 명령 및 해당 인수에 대한 CLI 참조 정보를 인쇄하고 사용 가능한 하위 그룹 및 명령을 나열합니다. |
| --only-show-errors | 오류만 표시하고 경고를 표시하지 않습니다. |
| -o, --output | 출력 형식을 변경합니다. 사용 가능한 출력 형식은 json, jsonc(색이 지정된 JSON), tsv(탭으로 구분된 값), 테이블(사람이 읽을 수 있는 ASCII 테이블) 및 yaml입니다. 기본적으로 CLI는 를 출력합니다 table. 사용 가능한 출력 형식에 대한 자세한 내용은 Azure Sphere CLI 명령에 대한 출력 형식을 참조하세요. |
| --쿼리 | JMESPath 쿼리 언어를 사용하여 Azure Sphere Security Services에서 반환된 출력을 필터링합니다. 자세한 내용 및 예제 는 JMESPath 자습서 및 Azure CLI 명령 출력 쿼리 를 참조하세요. |
| --자세한 | 작업 중에 Azure Sphere에서 만든 리소스에 대한 정보 및 기타 유용한 정보를 출력합니다. 전체 디버그 로그에 사용합니다 --debug . |
참고
Azure Sphere 클래식 CLI를 사용하는 경우 사용 가능한 옵션에 대한 자세한 내용은 전역 매개 변수 를 참조하세요.
예제
azsphere device capability download --type appDevelopment
The appdevelopment capability was saved as:
--------------------------------------------
Result
============================================
C:\capability-file\appdevelopment-<first eight characters of device ID>.cap
--------------------------------------------
기능 선택
연결된 Azure Sphere 디바이스와 함께 사용할 기능 파일을 선택합니다.
azsphere device capability select 명령은 모든 기능과 함께 사용할 수 있지만 서비스 세션을 사용하도록 설정하기 위해 fieldServicing 기능과 함께 가장 자주 사용됩니다. 모든 사용자 역할은 azsphere device capability select 명령에 액세스할 수 있습니다.
fieldServicing 기능을 사용하면 Azure Sphere 디바이스와 기능 파일이 포함된 로컬 컴퓨터 간에 통신이 활성화됩니다. fieldServicing 기능 파일은 로컬 컴퓨터와 Azure Sphere 디바이스 간의 세션에 사용되며 세션의 각 명령에는 사용 중인 기능 파일을 나타내는 메시지가 앞에 추가됩니다.
서비스 세션을 종료하려면 azsphere device capability select --none을 사용합니다.
선택적 매개 변수
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| --capability-file | 문자열 | 선택할 디바이스 기능 구성 파일의 경로 및 파일 이름을 지정합니다. 상대 경로 또는 절대 경로를 제공할 수 있습니다. |
| -n, --none | - | 이전에 선택한 디바이스 기능 구성을 지웁니다. |
전역 매개 변수
Azure Sphere CLI에 사용할 수 있는 전역 매개 변수는 다음과 같습니다.
| 매개 변수 | 설명 |
|---|---|
| --디버그 | 모든 디버그 로그를 표시하도록 로깅 세부 정보를 늘립니다. 버그가 발견되면 버그 보고서를 제출할 때 플래그가 --debug 켜진 상태에서 생성된 출력을 제공합니다. |
| -h, --help | 명령 및 해당 인수에 대한 CLI 참조 정보를 인쇄하고 사용 가능한 하위 그룹 및 명령을 나열합니다. |
| --only-show-errors | 오류만 표시하고 경고를 표시하지 않습니다. |
| -o, --output | 출력 형식을 변경합니다. 사용 가능한 출력 형식은 json, jsonc(색이 지정된 JSON), tsv(탭으로 구분된 값), 테이블(사람이 읽을 수 있는 ASCII 테이블) 및 yaml입니다. 기본적으로 CLI는 를 출력합니다 table. 사용 가능한 출력 형식에 대한 자세한 내용은 Azure Sphere CLI 명령에 대한 출력 형식을 참조하세요. |
| --쿼리 | JMESPath 쿼리 언어를 사용하여 Azure Sphere Security Services에서 반환된 출력을 필터링합니다. 자세한 내용 및 예제 는 JMESPath 자습서 및 Azure CLI 명령 출력 쿼리 를 참조하세요. |
| --자세한 | 작업 중에 Azure Sphere에서 만든 리소스에 대한 정보 및 기타 유용한 정보를 출력합니다. 전체 디버그 로그에 사용합니다 --debug . |
참고
Azure Sphere 클래식 CLI를 사용하는 경우 사용 가능한 옵션에 대한 자세한 내용은 전역 매개 변수 를 참조하세요.
예제
azsphere device capability select --capability-file appdevcap
The capability session uses C:\capability-file\appdevcap.
capability show-attached
연결된 디바이스에 저장된 기능 구성을 표시합니다.
참고
이 명령은 기능 파일을 사용하여 구성된 기능과 보드에 기본적으로 존재하는 일부 기능(전부는 아님)을 표시합니다.
선택적 매개 변수
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| -d, --device | 문자열 | 여러 디바이스가 연결되면 명령을 실행할 디바이스를 지정합니다. 이 매개 변수는 여러 디바이스가 연결된 경우에 필요합니다. 현재 연결된 디바이스는 기본적으로 사용됩니다. 연결된 디바이스의 디바이스 ID, IP 주소 또는 로컬 연결 ID를 지정할 수 있습니다. Azure Sphere CLI는 Windows에서 여러 MT3620 디바이스를 지원하지만 Linux에서 한 번에 하나의 디바이스만 연결할 수 있습니다. 이러한 이유로 이 매개 변수는 Windows에서 지원되지만 Linux에서는 지원되지 않습니다. Linux의 명령과 함께 이 매개 변수를 사용하는 경우 오류가 반환됩니다. |
전역 매개 변수
Azure Sphere CLI에 사용할 수 있는 전역 매개 변수는 다음과 같습니다.
| 매개 변수 | 설명 |
|---|---|
| --디버그 | 모든 디버그 로그를 표시하도록 로깅 세부 정보를 늘립니다. 버그가 발견되면 버그 보고서를 제출할 때 플래그가 --debug 켜진 상태에서 생성된 출력을 제공합니다. |
| -h, --help | 명령 및 해당 인수에 대한 CLI 참조 정보를 인쇄하고 사용 가능한 하위 그룹 및 명령을 나열합니다. |
| --only-show-errors | 오류만 표시하고 경고를 표시하지 않습니다. |
| -o, --output | 출력 형식을 변경합니다. 사용 가능한 출력 형식은 json, jsonc(색이 지정된 JSON), tsv(탭으로 구분된 값), 테이블(사람이 읽을 수 있는 ASCII 테이블) 및 yaml입니다. 기본적으로 CLI는 를 출력합니다 table. 사용 가능한 출력 형식에 대한 자세한 내용은 Azure Sphere CLI 명령에 대한 출력 형식을 참조하세요. |
| --쿼리 | JMESPath 쿼리 언어를 사용하여 Azure Sphere Security Services에서 반환된 출력을 필터링합니다. 자세한 내용 및 예제 는 JMESPath 자습서 및 Azure CLI 명령 출력 쿼리 를 참조하세요. |
| --자세한 | 작업 중에 Azure Sphere에서 만든 리소스에 대한 정보 및 기타 유용한 정보를 출력합니다. 전체 디버그 로그에 사용합니다 --debug . |
참고
Azure Sphere 클래식 CLI를 사용하는 경우 사용 가능한 옵션에 대한 자세한 내용은 전역 매개 변수 를 참조하세요.
예제
azsphere device capability show-attached
--------------------
DeviceCapabilities
====================
EnableFieldServicing
--------------------
azsphere device capability show-attached
--------------------
DeviceCapabilities
====================
EnableAppDevelopment
--------------------
기능 업데이트
연결된 디바이스에 디바이스 기능 구성을 적용합니다.
필수 매개 변수
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| --capability-file | 문자열 | 적용할 디바이스 기능 파일의 경로와 파일 이름을 지정합니다. 상대 경로 또는 절대 경로를 제공할 수 있습니다. |
선택적 매개 변수
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| -d, --device | 문자열 | 명령을 실행할 디바이스를 지정합니다. 이 매개 변수는 여러 디바이스가 연결되거나 디바이스가 연결되지 않은 경우에 필요합니다. 현재 연결된 디바이스는 기본적으로 사용됩니다. 연결되지 않은 디바이스에 대한 디바이스 ID를 제공하거나 연결된 디바이스의 IP 주소 또는 로컬 연결 ID를 지정할 수 있습니다. Azure Sphere CLI는 Windows에서 여러 MT3620 디바이스를 지원하지만 Linux에서 한 번에 하나의 디바이스만 연결할 수 있습니다. 이러한 이유로 이 매개 변수는 Windows에서 지원되지만 Linux에서는 지원되지 않습니다. Linux의 명령과 함께 이 매개 변수를 사용하는 경우 오류가 반환됩니다. |
전역 매개 변수
Azure Sphere CLI에 사용할 수 있는 전역 매개 변수는 다음과 같습니다.
| 매개 변수 | 설명 |
|---|---|
| --디버그 | 모든 디버그 로그를 표시하도록 로깅 세부 정보를 늘립니다. 버그가 발견되면 버그 보고서를 제출할 때 플래그가 --debug 켜진 상태에서 생성된 출력을 제공합니다. |
| -h, --help | 명령 및 해당 인수에 대한 CLI 참조 정보를 인쇄하고 사용 가능한 하위 그룹 및 명령을 나열합니다. |
| --only-show-errors | 오류만 표시하고 경고를 표시하지 않습니다. |
| -o, --output | 출력 형식을 변경합니다. 사용 가능한 출력 형식은 json, jsonc(색이 지정된 JSON), tsv(탭으로 구분된 값), 테이블(사람이 읽을 수 있는 ASCII 테이블) 및 yaml입니다. 기본적으로 CLI는 를 출력합니다 table. 사용 가능한 출력 형식에 대한 자세한 내용은 Azure Sphere CLI 명령에 대한 출력 형식을 참조하세요. |
| --쿼리 | JMESPath 쿼리 언어를 사용하여 Azure Sphere Security Services에서 반환된 출력을 필터링합니다. 자세한 내용 및 예제 는 JMESPath 자습서 및 Azure CLI 명령 출력 쿼리 를 참조하세요. |
| --자세한 | 작업 중에 Azure Sphere에서 만든 리소스에 대한 정보 및 기타 유용한 정보를 출력합니다. 전체 디버그 로그에 사용합니다 --debug . |
참고
Azure Sphere 클래식 CLI를 사용하는 경우 사용 가능한 옵션에 대한 자세한 내용은 전역 매개 변수 를 참조하세요.
예제
azsphere device capability update --capability-file appdevcap.bin
Using selected capability file: C:\capability-file\appdevcap.bin
The capability file C:\capability-file\appdevcap.bin was added on the device. The device will restart.
인증서
연결된 디바이스에서 인증서를 관리합니다.
| 작업 | 설명 |
|---|---|
| 추가 | 연결된 디바이스의 인증서 저장소에 인증서를 추가합니다. |
| 삭제 | 연결된 디바이스의 인증서 저장소에서 인증서를 삭제합니다. |
| 목록 | 연결된 디바이스의 인증서 저장소에서 사용할 수 있는 인증서 ID를 Lists. |
| 표시 | 연결된 디바이스의 인증서 저장소에 인증서의 세부 정보를 표시합니다. |
| show-quota | 연결된 디바이스의 인증서 저장소에서 사용 가능한 공간을 표시합니다. |
인증서 추가
연결된 디바이스의 인증서 저장소에 인증서를 추가합니다.
Azure Sphere 디바이스에 로드하려면 루트 CA 및 클라이언트 인증서가 .pem 형식이어야 합니다. 디바이스에 대한 클라이언트 인증서 및 프라이빗 키(선택적으로 프라이빗 키의 암호)와 함께 적절한 서버에서 루트 CA 인증서를 획득해야 합니다. 각 인증서는 EAP-TLS 네트워크의 적절한 서버에서 생성 및 서명해야 합니다. 네트워크 관리자 또는 보안 팀은 인증서를 가져오는 데 필요한 세부 정보를 제공할 수 있습니다. 루트 CA 인증서를 획득하는 방법에 대한 자세한 내용은 EAP-TLS 네트워크에 대한 인증서 획득 및 배포를 참조하세요.
주의
인증서 ID는 클라이언트 및 루트 CA 인증서 모두에 대해 시스템 전체이므로 azsphere 명령 또는 새 인증서를 추가하는 함수 호출은 이전 명령 또는 함수 호출에 의해 추가된 인증서를 덮어쓸 수 있으므로 네트워크 연결 오류가 발생할 수 있습니다. 명확한 인증서 업데이트 절차를 개발하고 인증서 ID를 신중하게 선택하는 것이 좋습니다.
자세한 내용은 인증서 ID를 참조하세요.
필수 매개 변수
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| -i, --cert-id | 문자열 | 추가할 인증서의 식별자를 지정합니다. 문자열 식별자(최대 16자)입니다. 유효한 문자에는 대문자(A-Z), 소문자(a-z), 숫자(0-9), 밑줄(_), 마침표(.) 및 하이픈(-)이 포함됩니다. 이 식별자는 EAP-TLS 네트워크에 대한 Wi-Fi 구성에도 사용됩니다. |
| --cert-type | 문자열 | 추가할 인증서 유형(클라이언트 또는 rootca)을 지정합니다. |
| -p, --public-key-file | 문자열 | 공개 키 인증서 .pem 파일의 경로를 지정합니다. 상대 경로 또는 절대 경로를 제공할 수 있습니다. |
선택적 매개 변수
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| -d, --device | 문자열 | 여러 디바이스가 연결되면 명령을 실행할 디바이스를 지정합니다. 이 매개 변수는 여러 디바이스가 연결된 경우에 필요합니다. 현재 연결된 디바이스는 기본적으로 사용됩니다. 연결된 디바이스의 디바이스 ID, IP 주소 또는 로컬 연결 ID를 지정할 수 있습니다. Azure Sphere CLI는 Windows에서 여러 MT3620 디바이스를 지원하지만 Linux에서 한 번에 하나의 디바이스만 연결할 수 있습니다. 이러한 이유로 이 매개 변수는 Windows에서 지원되지만 Linux에서는 지원되지 않습니다. Linux의 명령과 함께 이 매개 변수를 사용하는 경우 오류가 반환됩니다. |
| --private-key-file | 문자열 | 클라이언트 프라이빗 키 인증서 .pem 파일의 경로를 지정합니다. 형식 클라이언트의 인증서를 추가할 때 필요합니다. 상대 경로 또는 절대 경로를 제공할 수 있습니다. |
| -w, --private-key-password | 문자열 | 클라이언트 프라이빗 키에 대한 선택적 암호를 지정합니다. 암호는 암호화된 클라이언트 인증서 프라이빗 키를 추가할 때 필요합니다. |
전역 매개 변수
Azure Sphere CLI에 사용할 수 있는 전역 매개 변수는 다음과 같습니다.
| 매개 변수 | 설명 |
|---|---|
| --디버그 | 모든 디버그 로그를 표시하도록 로깅 세부 정보를 늘립니다. 버그가 발견되면 버그 보고서를 제출할 때 플래그가 --debug 켜진 상태에서 생성된 출력을 제공합니다. |
| -h, --help | 명령 및 해당 인수에 대한 CLI 참조 정보를 인쇄하고 사용 가능한 하위 그룹 및 명령을 나열합니다. |
| --only-show-errors | 오류만 표시하고 경고를 표시하지 않습니다. |
| -o, --output | 출력 형식을 변경합니다. 사용 가능한 출력 형식은 json, jsonc(색이 지정된 JSON), tsv(탭으로 구분된 값), 테이블(사람이 읽을 수 있는 ASCII 테이블) 및 yaml입니다. 기본적으로 CLI는 를 출력합니다 table. 사용 가능한 출력 형식에 대한 자세한 내용은 Azure Sphere CLI 명령에 대한 출력 형식을 참조하세요. |
| --쿼리 | JMESPath 쿼리 언어를 사용하여 Azure Sphere Security Services에서 반환된 출력을 필터링합니다. 자세한 내용 및 예제 는 JMESPath 자습서 및 Azure CLI 명령 출력 쿼리 를 참조하세요. |
| --자세한 | 작업 중에 Azure Sphere에서 만든 리소스에 대한 정보 및 기타 유용한 정보를 출력합니다. 전체 디버그 로그에 사용합니다 --debug . |
참고
Azure Sphere 클래식 CLI를 사용하는 경우 사용 가능한 옵션에 대한 자세한 내용은 전역 매개 변수 를 참조하세요.
예제
azsphere device certificate add --cert-id certroot --cert-type rootca --public-key-file publiccert.pem
Certificate 'certroot' successfully added.
azsphere device certificate add --cert-id certclient --cert-type client --private-key-file privatekey.pem --private-key-password 1234 --public-key-file publiccert.pem
Certificate 'certclient' successfully added.
인증서 삭제
연결된 디바이스의 인증서 저장소에서 인증서를 삭제합니다.
필수 매개 변수
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| -c, --certificate 또는 --cert-id [사용 중지] |
문자열 | 삭제할 인증서의 식별자를 지정합니다. 인수는 --cert-id 사용 중지되며 이후 릴리스에서 제거됩니다. 자세한 내용은 Azure Sphere CLI의 중요한 변경 내용(사용 중지 기능)을 참조하세요. |
선택적 매개 변수
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| -d, --device | 문자열 | 여러 디바이스가 연결되면 명령을 실행할 디바이스를 지정합니다. 이 매개 변수는 여러 디바이스가 연결된 경우에 필요합니다. 현재 연결된 디바이스는 기본적으로 사용됩니다. 연결된 디바이스의 디바이스 ID, IP 주소 또는 로컬 연결 ID를 지정할 수 있습니다. Azure Sphere CLI는 Windows에서 여러 MT3620 디바이스를 지원하지만 Linux에서 한 번에 하나의 디바이스만 연결할 수 있습니다. 이러한 이유로 이 매개 변수는 Windows에서 지원되지만 Linux에서는 지원되지 않습니다. Linux의 명령과 함께 이 매개 변수를 사용하는 경우 오류가 반환됩니다. |
전역 매개 변수
Azure Sphere CLI에 사용할 수 있는 전역 매개 변수는 다음과 같습니다.
| 매개 변수 | 설명 |
|---|---|
| --디버그 | 모든 디버그 로그를 표시하도록 로깅 세부 정보를 늘립니다. 버그가 발견되면 버그 보고서를 제출할 때 플래그가 --debug 켜진 상태에서 생성된 출력을 제공합니다. |
| -h, --help | 명령 및 해당 인수에 대한 CLI 참조 정보를 인쇄하고 사용 가능한 하위 그룹 및 명령을 나열합니다. |
| --only-show-errors | 오류만 표시하고 경고를 표시하지 않습니다. |
| -o, --output | 출력 형식을 변경합니다. 사용 가능한 출력 형식은 json, jsonc(색이 지정된 JSON), tsv(탭으로 구분된 값), 테이블(사람이 읽을 수 있는 ASCII 테이블) 및 yaml입니다. 기본적으로 CLI는 를 출력합니다 table. 사용 가능한 출력 형식에 대한 자세한 내용은 Azure Sphere CLI 명령에 대한 출력 형식을 참조하세요. |
| --쿼리 | JMESPath 쿼리 언어를 사용하여 Azure Sphere Security Services에서 반환된 출력을 필터링합니다. 자세한 내용 및 예제 는 JMESPath 자습서 및 Azure CLI 명령 출력 쿼리 를 참조하세요. |
| --자세한 | 작업 중에 Azure Sphere에서 만든 리소스에 대한 정보 및 기타 유용한 정보를 출력합니다. 전체 디버그 로그에 사용합니다 --debug . |
참고
Azure Sphere 클래식 CLI를 사용하는 경우 사용 가능한 옵션에 대한 자세한 내용은 전역 매개 변수 를 참조하세요.
예제
azsphere device certificate delete --certificate certclient
인증서 목록
디바이스의 인증서 저장소에서 사용할 수 있는 인증서를 Lists.
선택적 매개 변수
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| -d, --device | 문자열 | 여러 디바이스가 연결되면 명령을 실행할 디바이스를 지정합니다. 이 매개 변수는 여러 디바이스가 연결된 경우에 필요합니다. 현재 연결된 디바이스는 기본적으로 사용됩니다. 연결된 디바이스의 디바이스 ID, IP 주소 또는 로컬 연결 ID를 지정할 수 있습니다. Azure Sphere CLI는 Windows에서 여러 MT3620 디바이스를 지원하지만 Linux에서 한 번에 하나의 디바이스만 연결할 수 있습니다. 이러한 이유로 이 매개 변수는 Windows에서 지원되지만 Linux에서는 지원되지 않습니다. Linux의 명령과 함께 이 매개 변수를 사용하는 경우 오류가 반환됩니다. |
전역 매개 변수
Azure Sphere CLI에 사용할 수 있는 전역 매개 변수는 다음과 같습니다.
| 매개 변수 | 설명 |
|---|---|
| --디버그 | 모든 디버그 로그를 표시하도록 로깅 세부 정보를 늘립니다. 버그가 발견되면 버그 보고서를 제출할 때 플래그가 --debug 켜진 상태에서 생성된 출력을 제공합니다. |
| -h, --help | 명령 및 해당 인수에 대한 CLI 참조 정보를 인쇄하고 사용 가능한 하위 그룹 및 명령을 나열합니다. |
| --only-show-errors | 오류만 표시하고 경고를 표시하지 않습니다. |
| -o, --output | 출력 형식을 변경합니다. 사용 가능한 출력 형식은 json, jsonc(색이 지정된 JSON), tsv(탭으로 구분된 값), 테이블(사람이 읽을 수 있는 ASCII 테이블) 및 yaml입니다. 기본적으로 CLI는 를 출력합니다 table. 사용 가능한 출력 형식에 대한 자세한 내용은 Azure Sphere CLI 명령에 대한 출력 형식을 참조하세요. |
| --쿼리 | JMESPath 쿼리 언어를 사용하여 Azure Sphere Security Services에서 반환된 출력을 필터링합니다. 자세한 내용 및 예제 는 JMESPath 자습서 및 Azure CLI 명령 출력 쿼리 를 참조하세요. |
| --자세한 | 작업 중에 Azure Sphere에서 만든 리소스에 대한 정보 및 기타 유용한 정보를 출력합니다. 전체 디버그 로그에 사용합니다 --debug . |
참고
Azure Sphere 클래식 CLI를 사용하는 경우 사용 가능한 옵션에 대한 자세한 내용은 전역 매개 변수 를 참조하세요.
예제
azsphere device certificate list
-----------
Identifiers
===========
rootCert
-----------
인증서 쇼
디바이스의 인증서 저장소에 있는 개별 인증서의 세부 정보를 표시합니다.
필수 매개 변수
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| -c, --certificate 또는 --cert-id [사용 중지] |
문자열 | 세부 정보를 표시할 인증서의 식별자를 지정합니다. 인수는 --cert-id 사용 중지되며 이후 릴리스에서 제거됩니다. 자세한 내용은 Azure Sphere CLI의 중요한 변경 내용(사용 중지 기능)을 참조하세요. |
선택적 매개 변수
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| -d, --device | 문자열 | 여러 디바이스가 연결되면 명령을 실행할 디바이스를 지정합니다. 이 매개 변수는 여러 디바이스가 연결된 경우에 필요합니다. 현재 연결된 디바이스는 기본적으로 사용됩니다. 연결된 디바이스의 디바이스 ID, IP 주소 또는 로컬 연결 ID를 지정할 수 있습니다. Azure Sphere CLI는 Windows에서 여러 MT3620 디바이스를 지원하지만 Linux에서 한 번에 하나의 디바이스만 연결할 수 있습니다. 이러한 이유로 이 매개 변수는 Windows에서 지원되지만 Linux에서는 지원되지 않습니다. Linux의 명령과 함께 이 매개 변수를 사용하는 경우 오류가 반환됩니다. |
전역 매개 변수
Azure Sphere CLI에 사용할 수 있는 전역 매개 변수는 다음과 같습니다.
| 매개 변수 | 설명 |
|---|---|
| --디버그 | 모든 디버그 로그를 표시하도록 로깅 세부 정보를 늘립니다. 버그가 발견되면 버그 보고서를 제출할 때 플래그가 --debug 켜진 상태에서 생성된 출력을 제공합니다. |
| -h, --help | 명령 및 해당 인수에 대한 CLI 참조 정보를 인쇄하고 사용 가능한 하위 그룹 및 명령을 나열합니다. |
| --only-show-errors | 오류만 표시하고 경고를 표시하지 않습니다. |
| -o, --output | 출력 형식을 변경합니다. 사용 가능한 출력 형식은 json, jsonc(색이 지정된 JSON), tsv(탭으로 구분된 값), 테이블(사람이 읽을 수 있는 ASCII 테이블) 및 yaml입니다. 기본적으로 CLI는 를 출력합니다 table. 사용 가능한 출력 형식에 대한 자세한 내용은 Azure Sphere CLI 명령에 대한 출력 형식을 참조하세요. |
| --쿼리 | JMESPath 쿼리 언어를 사용하여 Azure Sphere Security Services에서 반환된 출력을 필터링합니다. 자세한 내용 및 예제 는 JMESPath 자습서 및 Azure CLI 명령 출력 쿼리 를 참조하세요. |
| --자세한 | 작업 중에 Azure Sphere에서 만든 리소스에 대한 정보 및 기타 유용한 정보를 출력합니다. 전체 디버그 로그에 사용합니다 --debug . |
참고
Azure Sphere 클래식 CLI를 사용하는 경우 사용 가능한 옵션에 대한 자세한 내용은 전역 매개 변수 를 참조하세요.
예제
azsphere device certificate show --certificate certclient
---------- ------------------- ------------------- ----------------------------------- -----------------------------------
Id StartDate EndDate SubjectName IssuerName
==========================================================================================================================
certclient 06/08/2019 19:15:48 06/08/2069 19:25:44 /DC=local/DC=azsphere/CN=azsphereca /DC=local/DC=azsphere/CN=azsphereca
---------- ------------------- ------------------- ----------------------------------- -----------------------------------
인증서 show-quota
연결된 디바이스의 인증서 저장소에서 사용 가능한 공간을 표시합니다.
선택적 매개 변수
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| -d, --device | 문자열 | 여러 디바이스가 연결되면 명령을 실행할 디바이스를 지정합니다. 이 매개 변수는 여러 디바이스가 연결된 경우에 필요합니다. 현재 연결된 디바이스는 기본적으로 사용됩니다. 연결된 디바이스의 디바이스 ID, IP 주소 또는 로컬 연결 ID를 지정할 수 있습니다. Azure Sphere CLI는 Windows에서 여러 MT3620 디바이스를 지원하지만 Linux에서 한 번에 하나의 디바이스만 연결할 수 있습니다. 이러한 이유로 이 매개 변수는 Windows에서 지원되지만 Linux에서는 지원되지 않습니다. Linux의 명령과 함께 이 매개 변수를 사용하는 경우 오류가 반환됩니다. |
전역 매개 변수
Azure Sphere CLI에 사용할 수 있는 전역 매개 변수는 다음과 같습니다.
| 매개 변수 | 설명 |
|---|---|
| --디버그 | 모든 디버그 로그를 표시하도록 로깅 세부 정보를 늘립니다. 버그가 발견되면 버그 보고서를 제출할 때 플래그가 --debug 켜진 상태에서 생성된 출력을 제공합니다. |
| -h, --help | 명령 및 해당 인수에 대한 CLI 참조 정보를 인쇄하고 사용 가능한 하위 그룹 및 명령을 나열합니다. |
| --only-show-errors | 오류만 표시하고 경고를 표시하지 않습니다. |
| -o, --output | 출력 형식을 변경합니다. 사용 가능한 출력 형식은 json, jsonc(색이 지정된 JSON), tsv(탭으로 구분된 값), 테이블(사람이 읽을 수 있는 ASCII 테이블) 및 yaml입니다. 기본적으로 CLI는 를 출력합니다 table. 사용 가능한 출력 형식에 대한 자세한 내용은 Azure Sphere CLI 명령에 대한 출력 형식을 참조하세요. |
| --쿼리 | JMESPath 쿼리 언어를 사용하여 Azure Sphere Security Services에서 반환된 출력을 필터링합니다. 자세한 내용 및 예제 는 JMESPath 자습서 및 Azure CLI 명령 출력 쿼리 를 참조하세요. |
| --자세한 | 작업 중에 Azure Sphere에서 만든 리소스에 대한 정보 및 기타 유용한 정보를 출력합니다. 전체 디버그 로그에 사용합니다 --debug . |
참고
Azure Sphere 클래식 CLI를 사용하는 경우 사용 가능한 옵션에 대한 자세한 내용은 전역 매개 변수 를 참조하세요.
예제
azsphere device certificate show-quota
--------------
Available space (bytes)
==============
24514
--------------
주장
현재 Azure Sphere 테넌트에서 이전에 클레임되지 않은 디바이스를 클레임합니다.
중요
디바이스를 클레임하기 전에 올바른 Azure Sphere 테넌트에서 로그인했는지 확인합니다. 디바이스는 한 번만 클레임할 수 있습니다. 일단 클레임되면 디바이스를 다른 테넌트로 이동할 수 없습니다.
선택적 매개 변수
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| -d, --device | 문자열 | 명령을 실행할 디바이스를 지정합니다. 이 매개 변수는 여러 디바이스가 연결되거나 디바이스가 연결되지 않은 경우에 필요합니다. 현재 연결된 디바이스는 기본적으로 사용됩니다. 연결되지 않은 디바이스에 대한 디바이스 ID를 제공하거나 연결된 디바이스의 IP 주소 또는 로컬 연결 ID를 지정할 수 있습니다. Azure Sphere CLI는 Windows에서 여러 MT3620 디바이스를 지원하지만 Linux에서 한 번에 하나의 디바이스만 연결할 수 있습니다. 이러한 이유로 이 매개 변수는 Windows에서 지원되지만 Linux에서는 지원되지 않습니다. Linux의 명령과 함께 이 매개 변수를 사용하는 경우 오류가 반환됩니다. |
| -t, --tenant | GUID 또는 이름 | 이 작업을 수행할 테넌트 를 지정합니다. 선택한 기본 테넌트 를 재정의합니다. 테넌트 ID 또는 테넌트 이름을 지정할 수 있습니다. |
| --강제로 | 부울 | 현재 사용자가 선택한 Azure Sphere 테넌트에서 디바이스를 강제로 클레임합니다. |
전역 매개 변수
Azure Sphere CLI에 사용할 수 있는 전역 매개 변수는 다음과 같습니다.
| 매개 변수 | 설명 |
|---|---|
| --디버그 | 모든 디버그 로그를 표시하도록 로깅 세부 정보를 늘립니다. 버그가 발견되면 버그 보고서를 제출할 때 플래그가 --debug 켜진 상태에서 생성된 출력을 제공합니다. |
| -h, --help | 명령 및 해당 인수에 대한 CLI 참조 정보를 인쇄하고 사용 가능한 하위 그룹 및 명령을 나열합니다. |
| --only-show-errors | 오류만 표시하고 경고를 표시하지 않습니다. |
| -o, --output | 출력 형식을 변경합니다. 사용 가능한 출력 형식은 json, jsonc(색이 지정된 JSON), tsv(탭으로 구분된 값), 테이블(사람이 읽을 수 있는 ASCII 테이블) 및 yaml입니다. 기본적으로 CLI는 를 출력합니다 table. 사용 가능한 출력 형식에 대한 자세한 내용은 Azure Sphere CLI 명령에 대한 출력 형식을 참조하세요. |
| --쿼리 | JMESPath 쿼리 언어를 사용하여 Azure Sphere Security Services에서 반환된 출력을 필터링합니다. 자세한 내용 및 예제 는 JMESPath 자습서 및 Azure CLI 명령 출력 쿼리 를 참조하세요. |
| --자세한 | 작업 중에 Azure Sphere에서 만든 리소스에 대한 정보 및 기타 유용한 정보를 출력합니다. 전체 디버그 로그에 사용합니다 --debug . |
참고
Azure Sphere 클래식 CLI를 사용하는 경우 사용 가능한 옵션에 대한 자세한 내용은 전역 매개 변수 를 참조하세요.
예제
azsphere device claim
warn: You are claiming a device to the following tenant:
warn: a323c263-2aa3-2559-aabb-a3fc32631900 (Tenant1)
warn: Do you want to claim the device ID 352fe1f59e40ef8a9266415e81af32b5b07d8f2bbd6b5650cef4a70b86c7fcbc70b129a41fbc6d02f8bb4aaabc52cd5740c85427d205e46a166b7e41135eb968 to this tenant?
warn: You cannot change the Azure Sphere tenant this device is claimed to once this action has completed.
Enter 'yes' to continue. Enter anything else to exit.
> yes
Claiming device.
Successfully claimed device ID '352fe1f59e40ef8a9266415e81af32b5b07d8f2bbd6b5650cef4a70b86c7fcbc70b129a41fbc6d02f8bb4aaabc52cd5740c85427d205e46a166b7e41135eb968' into tenant 'Tenant1' with ID 'a323c263-2aa3-2559-aabb-a3fc32631900'.
enable-cloud-test
애플리케이션 개발을 사용하지 않도록 설정하고, 기존 애플리케이션을 삭제하고, 클라우드로 로드된 애플리케이션 업데이트를 사용하도록 설정하여 클라우드 로드를 테스트하기 위해 연결된 디바이스를 준비합니다.
디바이스를 PC에 연결해야 하며 연결된 디바이스에서만 작동합니다.
특히 enable-cloud-test:
- 연결된 디바이스에 대한 appDevelopment 기능을 제거합니다.
- 클라우드 로드 애플리케이션 업데이트를 사용하도록 설정하는 디바이스 그룹에 디바이스를 할당합니다.
- 디바이스를 다시 부팅합니다.
enable-cloud-test가 수행하는 특정 작업은 제품 및 디바이스 그룹이 이 디바이스에 이미 할당되었는지 여부에 따라 달라집니다.
azsphere device enable-cloud-test가 매개 변수 없이 실행되는 경우 디바이스는 디바이스의 현재 제품의 필드 테스트 디바이스 그룹에 배치됩니다. 이는 애플리케이션 업데이트를 사용하도록 설정하는 각 제품에 대해 자동으로 만들어진 기본 디바이스 그룹 중 하나입니다. 디바이스에 제품이 없거나 필드 테스트 디바이스 그룹이 없는 경우 오류가 반환됩니다.
제품이 지정된 경우 디바이스는 해당 제품의 필드 테스트 디바이스 그룹에 배치됩니다. 이 디바이스 그룹이 없으면 오류가 반환됩니다.
디바이스 그룹을 지정하면 디바이스가 디바이스에 배치됩니다. 대상 디바이스 그룹이 애플리케이션 업데이트를 사용하도록 설정하지 않으면 오류가 반환됩니다.
선택적 매개 변수
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| -d, --device | 문자열 | 여러 디바이스가 연결되면 명령을 실행할 디바이스를 지정합니다. 이 매개 변수는 여러 디바이스가 연결된 경우에 필요합니다. 현재 연결된 디바이스는 기본적으로 사용됩니다. 연결된 디바이스의 디바이스 ID, IP 주소 또는 로컬 연결 ID를 지정할 수 있습니다. Azure Sphere CLI는 Windows에서 여러 MT3620 디바이스를 지원하지만 Linux에서 한 번에 하나의 디바이스만 연결할 수 있습니다. 이러한 이유로 이 매개 변수는 Windows에서 지원되지만 Linux에서는 지원되지 않습니다. Linux의 명령과 함께 이 매개 변수를 사용하는 경우 오류가 반환됩니다. |
| -p, --product | GUID 또는 이름 | 대상 제품을 지정합니다. 이 옵션을 지정하면 지정하지 않는 한 --device-group 디바이스가 이 제품의 기본 필드 테스트 디바이스 그룹으로 이동됩니다. Azure Sphere 제품의 ID 또는 이름을 지정할 수 있습니다. |
| -t, --tenant | GUID 또는 이름 | 이 작업을 수행할 테넌트 를 지정합니다. 선택한 기본 테넌트 를 재정의합니다. 테넌트 ID 또는 테넌트 이름을 지정할 수 있습니다. |
| -g, --device-group | GUID 또는 이름 | 디바이스를 이동할 디바이스 그룹을 지정합니다. 디바이스 그룹 ID 또는 디바이스 그룹 이름을 지정할 수 있습니다. 디바이스 그룹 이름을 사용하려면 제품 이름과 디바이스 그룹 이름을 <product-name/device-group-name> 형식으로 모두 제공해야 합니다. 기본적으로 제품의 필드 테스트 디바이스 그룹입니다. |
전역 매개 변수
Azure Sphere CLI에 사용할 수 있는 전역 매개 변수는 다음과 같습니다.
| 매개 변수 | 설명 |
|---|---|
| --디버그 | 모든 디버그 로그를 표시하도록 로깅 세부 정보를 늘립니다. 버그가 발견되면 버그 보고서를 제출할 때 플래그가 --debug 켜진 상태에서 생성된 출력을 제공합니다. |
| -h, --help | 명령 및 해당 인수에 대한 CLI 참조 정보를 인쇄하고 사용 가능한 하위 그룹 및 명령을 나열합니다. |
| --only-show-errors | 오류만 표시하고 경고를 표시하지 않습니다. |
| -o, --output | 출력 형식을 변경합니다. 사용 가능한 출력 형식은 json, jsonc(색이 지정된 JSON), tsv(탭으로 구분된 값), 테이블(사람이 읽을 수 있는 ASCII 테이블) 및 yaml입니다. 기본적으로 CLI는 를 출력합니다 table. 사용 가능한 출력 형식에 대한 자세한 내용은 Azure Sphere CLI 명령에 대한 출력 형식을 참조하세요. |
| --쿼리 | JMESPath 쿼리 언어를 사용하여 Azure Sphere Security Services에서 반환된 출력을 필터링합니다. 자세한 내용 및 예제 는 JMESPath 자습서 및 Azure CLI 명령 출력 쿼리 를 참조하세요. |
| --자세한 | 작업 중에 Azure Sphere에서 만든 리소스에 대한 정보 및 기타 유용한 정보를 출력합니다. 전체 디버그 로그에 사용합니다 --debug . |
참고
Azure Sphere 클래식 CLI를 사용하는 경우 사용 가능한 옵션에 대한 자세한 내용은 전역 매개 변수 를 참조하세요.
예제
예제 1. ID로 기존 디바이스 그룹에 디바이스 할당
이 예제에서는 연결된 디바이스를 기존 제품 및 디바이스 그룹에 할당합니다.
azsphere device enable-cloud-test --device-group '3548b179-m16f-4f64-6dme-d3c643662e76'
Your internal capabilities will be retained, including the Enable App development capability. Sideloaded images may be removed by over-the-air application updates.
Getting device group by ID '3548b179-m16f-4f64-6dme-d3c643662e76'.
Leaving any existing applications on the device.
Setting device group to 'Field Test' with ID '3548b179-m16f-4f64-6dme-d3c643662e76')
Successfully updated device's device group.
Successfully set up device for application updates.
(Device ID: 'ABDFAC6466B573A0FF9ABA38BABCD40ABDFAC6466B573A0FF9ABA38BABCD40ABDFAC6466B573A0FF9ABA38BABCD40ABDFAC6466B573A0FF9ABA38BABCD40ABCD')
예제 2. 다른 디바이스 그룹에 디바이스 할당
이 예제는 앞의 예제와 비슷하지만 디바이스에 대한 기존 제품을 유지합니다. 여기서 enable-cloud-test 작업은 디바이스가 속한 디바이스 그룹을 변경하고 appDevelopment 기능을 제거합니다. 이 명령은 애플리케이션 업데이트를 사용하도록 설정하지 않는 개발 환경에서 프로덕션 환경으로 디바이스를 이동하는 데 유용합니다.
azsphere device enable-cloud-test --device-group "Marketing/Field Test"
예제 3. 제품 이름으로 디바이스 할당
이 예제에서는 클라우드 로드를 사용하도록 설정하고 이름으로 제품에 디바이스를 할당합니다.
azsphere device enable-cloud-test --product DW100
enable-development
디바이스에서 사이드로드 및 디버깅을 사용하도록 설정하고 클라우드에서 애플리케이션 업데이트를 사용하지 않도록 설정하는 디바이스 그룹에 할당하여 디바이스를 개발하도록 설정합니다. 기본적으로 디바이스 제품의 개발 디바이스 그룹이지만 다른 디바이스 그룹을 지정할 수 있습니다. 제조 시나리오에서는 사용하지 마세요. 자세한 내용은 연결된 디바이스 제조 를 참조하세요.
특히 enable-development:
- 연결된 디바이스에 대한 appDevelopment 기능을 다운로드하고 적용합니다.
- 클라우드 로드 애플리케이션 업데이트를 사용하도록 설정하지 않는 디바이스 그룹에 디바이스를 할당합니다.
- 디바이스를 다시 부팅합니다.
매개 변수 없이 azsphere device enable-development 명령을 실행하는 경우:
- 디바이스에 제품 또는 디바이스 그룹이 아직 없는 경우 명령은 연결된 디바이스에 대해 appDevelopment 기능을 다운로드하여 적용하고 디바이스를 다시 부팅합니다. 기존 앱은 디바이스에 남아 있으며 OS가 업데이트됩니다. 디바이스를 클레임하는 설치 프로세스와 상위 수준 애플리케이션을 빌드하기 위한 빠른 시작은 영향을 받지 않습니다.
- 디바이스에 이미 제품이 있는 경우 명령은 디바이스를 제품의 개발 디바이스 그룹으로 이동합니다. 기본적으로 이 그룹에 대해 애플리케이션 업데이트를 사용하지 않도록 설정하여 테스트용으로 로드된 앱을 덮어쓰지 않도록 합니다.
매개 변수를 사용하여 azsphere device enable-development 명령을 --product 실행하는 경우:
- 제품의 개발 디바이스 그룹에서 디바이스를 Places. 이 디바이스 그룹이 없으면 오류가 반환됩니다.
매개 변수를 사용하여 azsphere device enable-development 명령을 --device-group 실행하는 경우:
- Places 지정된 디바이스 그룹의 디바이스가 지정됩니다. 대상 디바이스 그룹은 애플리케이션 업데이트를 사용하도록 설정해서는 안 되며 오류가 반환됩니다.
경우에 따라 azsphere device enable-development 에서 오류를 보고하고 디바이스를 클레임하도록 제안합니다. 디바이스를 이미 클레임한 경우 azsphere tenant show-selected 를 사용하여 디바이스를 클레임한 테넌트에 로그인했는지 확인합니다. 그렇지 않은 경우 azsphere login 을 사용하여 올바른 테넌트로 로그인합니다. 적절한 테넌트에서 로그인했다고 확신하는 경우 azsphere device claim을 사용하여 디바이스 를 클레임합니다.
선택적 매개 변수
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| -d, --device | 문자열 | 여러 디바이스가 연결되면 명령을 실행할 디바이스를 지정합니다. 이 매개 변수는 여러 디바이스가 연결된 경우에 필요합니다. 현재 연결된 디바이스는 기본적으로 사용됩니다. 연결된 디바이스의 디바이스 ID, IP 주소 또는 로컬 연결 ID를 지정할 수 있습니다. Azure Sphere CLI는 Windows에서 여러 MT3620 디바이스를 지원하지만 Linux에서 한 번에 하나의 디바이스만 연결할 수 있습니다. 이러한 이유로 이 매개 변수는 Windows에서 지원되지만 Linux에서는 지원되지 않습니다. Linux의 명령과 함께 이 매개 변수를 사용하는 경우 오류가 반환됩니다. |
| -g, --device-group | GUID 또는 이름 | 디바이스를 이동할 디바이스 그룹을 지정합니다. 생략하면 디바이스를 기본 그룹에 할당합니다. 디바이스 그룹 ID 또는 디바이스 그룹 이름을 지정할 수 있습니다. 디바이스 그룹 이름을 사용하려면 제품 이름과 디바이스 그룹 이름을 <product-name/device-group-name> 형식으로 모두 제공해야 합니다. |
| -r, --enable-rt-core-debugging | 부울 | 실시간 코어에서 실행되는 애플리케이션을 디버그하는 데 필요한 드라이버를 설치합니다. 이 옵션을 사용하려면 관리자 권한이 필요합니다. |
| -p, --product | GUID 또는 이름 | 대상 제품을 지정합니다. 이 값을 지정하면 디바이스도 지정되지 않는 한 --device-group 이 제품의 기본 개발 디바이스 그룹으로 이동됩니다. Azure Sphere 제품의 ID 또는 이름을 지정할 수 있습니다. |
전역 매개 변수
Azure Sphere CLI에 사용할 수 있는 전역 매개 변수는 다음과 같습니다.
| 매개 변수 | 설명 |
|---|---|
| --디버그 | 모든 디버그 로그를 표시하도록 로깅 세부 정보를 늘립니다. 버그가 발견되면 버그 보고서를 제출할 때 플래그가 --debug 켜진 상태에서 생성된 출력을 제공합니다. |
| -h, --help | 명령 및 해당 인수에 대한 CLI 참조 정보를 인쇄하고 사용 가능한 하위 그룹 및 명령을 나열합니다. |
| --only-show-errors | 오류만 표시하고 경고를 표시하지 않습니다. |
| -o, --output | 출력 형식을 변경합니다. 사용 가능한 출력 형식은 json, jsonc(색이 지정된 JSON), tsv(탭으로 구분된 값), 테이블(사람이 읽을 수 있는 ASCII 테이블) 및 yaml입니다. 기본적으로 CLI는 를 출력합니다 table. 사용 가능한 출력 형식에 대한 자세한 내용은 Azure Sphere CLI 명령에 대한 출력 형식을 참조하세요. |
| --쿼리 | JMESPath 쿼리 언어를 사용하여 Azure Sphere Security Services에서 반환된 출력을 필터링합니다. 자세한 내용 및 예제 는 JMESPath 자습서 및 Azure CLI 명령 출력 쿼리 를 참조하세요. |
| --자세한 | 작업 중에 Azure Sphere에서 만든 리소스에 대한 정보 및 기타 유용한 정보를 출력합니다. 전체 디버그 로그에 사용합니다 --debug . |
참고
Azure Sphere 클래식 CLI를 사용하는 경우 사용 가능한 옵션에 대한 자세한 내용은 전역 매개 변수 를 참조하세요.
예제
azsphere device enable-development
Capability configuration has been successfully cleared.
PS C:\Users\v-shypr> azsphere device enable-development
Getting device group 'Development' for product 'DW100'.
The device already has the 'Enable App development' capability. No changes will be applied to its existing capabilities.
Setting device group to 'Development' with ID '7f860cc1-4949-4000-a541-9a988ba4c3cd'.
Successfully disabled application updates.
Installing debugging server to device.
Deploying 'C:\Program Files (x86)\Microsoft Azure Sphere SDK\DebugTools\gdbserver.imagepackage' to the attached device.
Image package 'C:\Program Files (x86)\Microsoft Azure Sphere SDK\DebugTools\gdbserver.imagepackage' has been deployed to the attached device.
Previous device capabilities retained. Ensure that you have the correct development capabilities installed before continuing.
Successfully set up device for application development, and disabled application updates.
(Device ID: '352fe1f59e40ef8a9266415e81af32b5b07d8f2bbd6b5650cef4a70b86c7fcbc70b129a41fbc6d02f8bb4aaabc52cd5740c85427d205e46a166b7e41135eb968')
이미지
연결된 디바이스에 설치되거나 대상인 이미지에 대한 정보를 반환합니다.
| 작업 | 설명 |
|---|---|
| list-installed | 연결된 디바이스에 현재 설치된 이미지에 대한 세부 정보를 제공합니다. |
| list-targeted | 연결된 디바이스를 대상으로 하는 이미지에 대한 세부 정보를 제공합니다. |
이미지 목록 설치됨
연결된 디바이스에 설치된 이미지를 Lists. 정보 목록에는 구성 요소 및 이미지 ID가 포함됩니다.
참고
긴 이미지 이름은 31자로 잘립니다.
선택적 매개 변수
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| -d, --device | 문자열 | 여러 디바이스가 연결되면 명령을 실행할 디바이스를 지정합니다. 이 매개 변수는 여러 디바이스가 연결된 경우에 필요합니다. 현재 연결된 디바이스는 기본적으로 사용됩니다. 연결된 디바이스의 디바이스 ID, IP 주소 또는 로컬 연결 ID를 지정할 수 있습니다. Azure Sphere CLI는 Windows에서 여러 MT3620 디바이스를 지원하지만 Linux에서 한 번에 하나의 디바이스만 연결할 수 있습니다. 이러한 이유로 이 매개 변수는 Windows에서 지원되지만 Linux에서는 지원되지 않습니다. Linux의 명령과 함께 이 매개 변수를 사용하는 경우 오류가 반환됩니다. |
| -f, --full | 부울 | 디바이스에 설치된 모든 소프트웨어 이미지를 Lists. 기본적으로 는 애플리케이션 이미지, 디버거 및 보드 구성 이미지만 나열합니다. |
전역 매개 변수
Azure Sphere CLI에 사용할 수 있는 전역 매개 변수는 다음과 같습니다.
| 매개 변수 | 설명 |
|---|---|
| --디버그 | 모든 디버그 로그를 표시하도록 로깅 세부 정보를 늘립니다. 버그가 발견되면 버그 보고서를 제출할 때 플래그가 --debug 켜진 상태에서 생성된 출력을 제공합니다. |
| -h, --help | 명령 및 해당 인수에 대한 CLI 참조 정보를 인쇄하고 사용 가능한 하위 그룹 및 명령을 나열합니다. |
| --only-show-errors | 오류만 표시하고 경고를 표시하지 않습니다. |
| -o, --output | 출력 형식을 변경합니다. 사용 가능한 출력 형식은 json, jsonc(색이 지정된 JSON), tsv(탭으로 구분된 값), 테이블(사람이 읽을 수 있는 ASCII 테이블) 및 yaml입니다. 기본적으로 CLI는 를 출력합니다 table. 사용 가능한 출력 형식에 대한 자세한 내용은 Azure Sphere CLI 명령에 대한 출력 형식을 참조하세요. |
| --쿼리 | JMESPath 쿼리 언어를 사용하여 Azure Sphere Security Services에서 반환된 출력을 필터링합니다. 자세한 내용 및 예제 는 JMESPath 자습서 및 Azure CLI 명령 출력 쿼리 를 참조하세요. |
| --자세한 | 작업 중에 Azure Sphere에서 만든 리소스에 대한 정보 및 기타 유용한 정보를 출력합니다. 전체 디버그 로그에 사용합니다 --debug . |
참고
Azure Sphere 클래식 CLI를 사용하는 경우 사용 가능한 옵션에 대한 자세한 내용은 전역 매개 변수 를 참조하세요.
예제
azsphere device image list-installed
Installed images:
--> gdbserver
--> Image type: Application
--> Component ID: 8548b129-b16f-4f84-8dbe-d2c847862e78
--> Image ID: dc6205bd-4478-4c9b-81ad-5e41ac23ed68
--> CrashApplicatio
--> Image type: Application
--> Component ID: 9ce57001-90eb-45e1-bd0a-4fc07b0c85c9
--> Image ID: cc77124e-6447-4c0f-9f99-fc0ad5ef46ef
이미지 목록 대상 지정
Azure Sphere Security Service에 업로드되고 디바이스가 업데이트될 때 설치될 이미지를 Lists. Azure Sphere 디바이스가 클라우드 기반 애플리케이션 업데이트를 수락할 준비가 되도록 하는 방법에 대한 자세한 내용은 디바이스에 클라우드 기반 배포 사용을 참조하세요.
선택적 매개 변수
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| -d, --device | 문자열 | 명령을 실행할 디바이스를 지정합니다. 이 매개 변수는 여러 디바이스가 연결되거나 디바이스가 연결되지 않은 경우에 필요합니다. 현재 연결된 디바이스는 기본적으로 사용됩니다. 연결되지 않은 디바이스에 대한 디바이스 ID를 제공하거나 연결된 디바이스의 IP 주소 또는 로컬 연결 ID를 지정할 수 있습니다. Azure Sphere CLI는 Windows에서 여러 MT3620 디바이스를 지원하지만 Linux에서 한 번에 하나의 디바이스만 연결할 수 있습니다. 이러한 이유로 이 매개 변수는 Windows에서 지원되지만 Linux에서는 지원되지 않습니다. Linux의 명령과 함께 이 매개 변수를 사용하는 경우 오류가 반환됩니다. |
| -t, --tenant | GUID 또는 이름 | 이 작업을 수행할 테넌트 를 지정합니다. 선택한 기본 테넌트 를 재정의합니다. 테넌트 ID 또는 테넌트 이름을 지정할 수 있습니다. |
| -f, --full | 부울 | Azure Sphere 테넌트에서 모든 이미지를 Lists. |
전역 매개 변수
Azure Sphere CLI에 사용할 수 있는 전역 매개 변수는 다음과 같습니다.
| 매개 변수 | 설명 |
|---|---|
| --디버그 | 모든 디버그 로그를 표시하도록 로깅 세부 정보를 늘립니다. 버그가 발견되면 버그 보고서를 제출할 때 플래그가 --debug 켜진 상태에서 생성된 출력을 제공합니다. |
| -h, --help | 명령 및 해당 인수에 대한 CLI 참조 정보를 인쇄하고 사용 가능한 하위 그룹 및 명령을 나열합니다. |
| --only-show-errors | 오류만 표시하고 경고를 표시하지 않습니다. |
| -o, --output | 출력 형식을 변경합니다. 사용 가능한 출력 형식은 json, jsonc(색이 지정된 JSON), tsv(탭으로 구분된 값), 테이블(사람이 읽을 수 있는 ASCII 테이블) 및 yaml입니다. 기본적으로 CLI는 를 출력합니다 table. 사용 가능한 출력 형식에 대한 자세한 내용은 Azure Sphere CLI 명령에 대한 출력 형식을 참조하세요. |
| --쿼리 | JMESPath 쿼리 언어를 사용하여 Azure Sphere Security Services에서 반환된 출력을 필터링합니다. 자세한 내용 및 예제 는 JMESPath 자습서 및 Azure CLI 명령 출력 쿼리 를 참조하세요. |
| --자세한 | 작업 중에 Azure Sphere에서 만든 리소스에 대한 정보 및 기타 유용한 정보를 출력합니다. 전체 디버그 로그에 사용합니다 --debug . |
참고
Azure Sphere 클래식 CLI를 사용하는 경우 사용 가능한 옵션에 대한 자세한 내용은 전역 매개 변수 를 참조하세요.
예제
azsphere device image list-targeted
----------------------- ------------------------------------ ------------------------------------ ---------------- --------------------
Name ComponentId ImageId ImageType RegionalDataBoundary
=======================================================================================================================================
HelloWorld_HighLevelApp 1689d8b2-c835-2e27-27ad-e894d6d15fa9 50419cb6-a33b-4cbe-8bd0-425048664b6f Applications None
----------------------- ------------------------------------ ------------------------------------ -------------------------------------
목록
테넌트에서 모든 디바이스를 Lists. 목록은 처음 500개의 디바이스 다음에 잘립니다.
선택적 매개 변수
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| -t, --tenant | GUID 또는 이름 | 이 작업을 수행할 테넌트 를 지정합니다. 선택한 기본 테넌트 를 재정의합니다. 테넌트 ID 또는 테넌트 이름을 지정할 수 있습니다. |
전역 매개 변수
Azure Sphere CLI에 사용할 수 있는 전역 매개 변수는 다음과 같습니다.
| 매개 변수 | 설명 |
|---|---|
| --디버그 | 모든 디버그 로그를 표시하도록 로깅 세부 정보를 늘립니다. 버그가 발견되면 버그 보고서를 제출할 때 플래그가 --debug 켜진 상태에서 생성된 출력을 제공합니다. |
| -h, --help | 명령 및 해당 인수에 대한 CLI 참조 정보를 인쇄하고 사용 가능한 하위 그룹 및 명령을 나열합니다. |
| --only-show-errors | 오류만 표시하고 경고를 표시하지 않습니다. |
| -o, --output | 출력 형식을 변경합니다. 사용 가능한 출력 형식은 json, jsonc(색이 지정된 JSON), tsv(탭으로 구분된 값), 테이블(사람이 읽을 수 있는 ASCII 테이블) 및 yaml입니다. 기본적으로 CLI는 를 출력합니다 table. 사용 가능한 출력 형식에 대한 자세한 내용은 Azure Sphere CLI 명령에 대한 출력 형식을 참조하세요. |
| --쿼리 | JMESPath 쿼리 언어를 사용하여 Azure Sphere Security Services에서 반환된 출력을 필터링합니다. 자세한 내용 및 예제 는 JMESPath 자습서 및 Azure CLI 명령 출력 쿼리 를 참조하세요. |
| --자세한 | 작업 중에 Azure Sphere에서 만든 리소스에 대한 정보 및 기타 유용한 정보를 출력합니다. 전체 디버그 로그에 사용합니다 --debug . |
참고
Azure Sphere 클래식 CLI를 사용하는 경우 사용 가능한 옵션에 대한 자세한 내용은 전역 매개 변수 를 참조하세요.
예제
azsphere device list
-------------------------------------------------------------------------------------------------------------------------------- ------------------------------------ -------- ------------------------------------ ------------------------------------
DeviceId TenantId ChipSku ProductId DeviceGroupId
========================================================================================================================================================================================================================================================
352FE1F59E40EF8A9266415E81AF32B5B07D8F2BBD6B5650CEF4A70B86C7FCBC70B129A41FBC6D02F8BB4AAABC52CD5740C85427D205E46A166B7E41135EB968 a323c263-2aa3-2559-aabb-a3fc32631900 MT3620AN 4f48d618-09f7-45dc-a5a4-1433cabbee91 6f52bead-700d-4289-bdc2-2f11f774270e
-------------------------------------------------------------------------------------------------------------------------------- ------------------------------------ -------- ------------------------------------ ------------------------------------
ABDFAC6466B573A0FF9ABA38BABCD40ABDFAC6466B573A0FF9ABA38BABCD40ABDFAC6466B573A0FF9ABA38BABCD40ABDFAC6466B573A0FF9ABA38BABCD40ABCD a323c263-2aa3-2559-aabb-a3fc32631900 MT3620AN 4f48d618-09f7-45dc-a5a4-1433cabbee91 6f52bead-700d-4289-bdc2-2f11f774270e
-------------------------------------------------------------------------------------------------------------------------------- ------------------------------------ -------- ------------------------------------ ------------------------------------
매개 변수를 --query 사용하여 이 명령에 대해 표시되는 출력을 사용자 지정할 수 있습니다. 자세한 내용은 쿼리 CLI 명령 출력을 참조하세요.
다음 예제에서는 디바이스 ID 및 제품 ID만 선택하는 방법을 보여줍니다.
azsphere device list --query '[].{DeviceId:deviceId, ProductId:productId}'
-------------------------------------------------------------------------------------------------------------------------------- ------------------------------------
DeviceId ProductId
=====================================================================================================================================================================
352FE1F59E40EF8A9266415E81AF32B5B07D8F2BBD6B5650CEF4A70B86C7FCBC70B129A41FBC6D02F8BB4AAABC52CD5740C85427D205E46A166B7E41135EB968 4f48d618-09f7-45dc-a5a4-1433cabbee91
-------------------------------------------------------------------------------------------------------------------------------- ------------------------------------
ABDFAC6466B573A0FF9ABA38BABCD40ABDFAC6466B573A0FF9ABA38BABCD40ABDFAC6466B573A0FF9ABA38BABCD40ABDFAC6466B573A0FF9ABA38BABCD40ABCD 4f48d618-09f7-45dc-a5a4-1433cabbee91
-------------------------------------------------------------------------------------------------------------------------------- ------------------------------------
팁
azsphere product show --product-ID <> 를 실행하여 제품 이름 또는 azsphere device-group show --device-group-ID>를 보고 디바이스 그룹 < 이름을 확인합니다.
list-attached
로컬 PC에 연결된 디바이스를 Lists.
전역 매개 변수
Azure Sphere CLI에 사용할 수 있는 전역 매개 변수는 다음과 같습니다.
| 매개 변수 | 설명 |
|---|---|
| --디버그 | 모든 디버그 로그를 표시하도록 로깅 세부 정보를 늘립니다. 버그가 발견되면 버그 보고서를 제출할 때 플래그가 --debug 켜진 상태에서 생성된 출력을 제공합니다. |
| -h, --help | 명령 및 해당 인수에 대한 CLI 참조 정보를 인쇄하고 사용 가능한 하위 그룹 및 명령을 나열합니다. |
| --only-show-errors | 오류만 표시하고 경고를 표시하지 않습니다. |
| -o, --output | 출력 형식을 변경합니다. 사용 가능한 출력 형식은 json, jsonc(색이 지정된 JSON), tsv(탭으로 구분된 값), 테이블(사람이 읽을 수 있는 ASCII 테이블) 및 yaml입니다. 기본적으로 CLI는 를 출력합니다 table. 사용 가능한 출력 형식에 대한 자세한 내용은 Azure Sphere CLI 명령에 대한 출력 형식을 참조하세요. |
| --쿼리 | JMESPath 쿼리 언어를 사용하여 Azure Sphere Security Services에서 반환된 출력을 필터링합니다. 자세한 내용 및 예제 는 JMESPath 자습서 및 Azure CLI 명령 출력 쿼리 를 참조하세요. |
| --자세한 | 작업 중에 Azure Sphere에서 만든 리소스에 대한 정보 및 기타 유용한 정보를 출력합니다. 전체 디버그 로그에 사용합니다 --debug . |
참고
Azure Sphere 클래식 CLI를 사용하는 경우 사용 가능한 옵션에 대한 자세한 내용은 전역 매개 변수 를 참조하세요.
예제
azsphere device list-attached
1 device attached:
--> Device ID: 352fe1f59e40ef8a9266415e81af32b5b07d8f2bbd6b5650cef4a70b86c7fcbc70b129a41fbc6d02f8bb4aaabc52cd5740c85427d205e46a166b7e41135eb968
--> Is responsive: yes
--> IP address: 192.128.48.1
--> Connection path: 21143
manufacturing-state
연결된 디바이스의 제조 상태를 관리합니다.
| 작업 | 설명 |
|---|---|
| 표시 | 연결된 디바이스의 제조 상태를 표시합니다. |
| 업데이트 | 연결된 디바이스의 제조 상태를 업데이트. |
주의
제조 상태 변경은 영구적이며 되돌릴 수 없습니다.
manufacturing-state show
연결된 디바이스의 제조 상태를 표시합니다.
선택적 매개 변수
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| -d, --device | 문자열 | 여러 디바이스가 연결되면 명령을 실행할 디바이스를 지정합니다. 이 매개 변수는 여러 디바이스가 연결된 경우에 필요합니다. 현재 연결된 디바이스는 기본적으로 사용됩니다. 연결된 디바이스의 디바이스 ID, IP 주소 또는 로컬 연결 ID를 지정할 수 있습니다. Azure Sphere CLI는 Windows에서 여러 MT3620 디바이스를 지원하지만 Linux에서 한 번에 하나의 디바이스만 연결할 수 있습니다. 이러한 이유로 이 매개 변수는 Windows에서 지원되지만 Linux에서는 지원되지 않습니다. Linux의 명령과 함께 이 매개 변수를 사용하는 경우 오류가 반환됩니다. |
전역 매개 변수
Azure Sphere CLI에 사용할 수 있는 전역 매개 변수는 다음과 같습니다.
| 매개 변수 | 설명 |
|---|---|
| --디버그 | 모든 디버그 로그를 표시하도록 로깅 세부 정보를 늘립니다. 버그가 발견되면 버그 보고서를 제출할 때 플래그가 --debug 켜진 상태에서 생성된 출력을 제공합니다. |
| -h, --help | 명령 및 해당 인수에 대한 CLI 참조 정보를 인쇄하고 사용 가능한 하위 그룹 및 명령을 나열합니다. |
| --only-show-errors | 오류만 표시하고 경고를 표시하지 않습니다. |
| -o, --output | 출력 형식을 변경합니다. 사용 가능한 출력 형식은 json, jsonc(색이 지정된 JSON), tsv(탭으로 구분된 값), 테이블(사람이 읽을 수 있는 ASCII 테이블) 및 yaml입니다. 기본적으로 CLI는 를 출력합니다 table. 사용 가능한 출력 형식에 대한 자세한 내용은 Azure Sphere CLI 명령에 대한 출력 형식을 참조하세요. |
| --쿼리 | JMESPath 쿼리 언어를 사용하여 Azure Sphere Security Services에서 반환된 출력을 필터링합니다. 자세한 내용 및 예제 는 JMESPath 자습서 및 Azure CLI 명령 출력 쿼리 를 참조하세요. |
| --자세한 | 작업 중에 Azure Sphere에서 만든 리소스에 대한 정보 및 기타 유용한 정보를 출력합니다. 전체 디버그 로그에 사용합니다 --debug . |
참고
Azure Sphere 클래식 CLI를 사용하는 경우 사용 가능한 옵션에 대한 자세한 내용은 전역 매개 변수 를 참조하세요.
예제
azsphere device manufacturing-state show
------------------
ManufacturingState
==================
Module1Complete
------------------
manufacturing-state update
연결된 디바이스의 제조 상태를 업데이트. 자세한 내용은 디바이스 제조 상태 설정을 참조하세요.
주의
제조 상태 변경은 영구적이며 되돌릴 수 없습니다.
필수 매개 변수
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| -s, --state | 제조 상태 | 디바이스에 대해 설정할 제조 상태를 지정합니다. 가능한 상태는 및 을 Module1Complete포함합니다DeviceComplete. |
선택적 매개 변수
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| -d, --device | 문자열 | 여러 디바이스가 연결되면 명령을 실행할 디바이스를 지정합니다. 이 매개 변수는 여러 디바이스가 연결된 경우에 필요합니다. 현재 연결된 디바이스는 기본적으로 사용됩니다. 연결된 디바이스의 디바이스 ID, IP 주소 또는 로컬 연결 ID를 지정할 수 있습니다. Azure Sphere CLI는 Windows에서 여러 MT3620 디바이스를 지원하지만 Linux에서 한 번에 하나의 디바이스만 연결할 수 있습니다. 이러한 이유로 이 매개 변수는 Windows에서 지원되지만 Linux에서는 지원되지 않습니다. Linux의 명령과 함께 이 매개 변수를 사용하는 경우 오류가 반환됩니다. |
전역 매개 변수
Azure Sphere CLI에 사용할 수 있는 전역 매개 변수는 다음과 같습니다.
| 매개 변수 | 설명 |
|---|---|
| --디버그 | 모든 디버그 로그를 표시하도록 로깅 세부 정보를 늘립니다. 버그가 발견되면 버그 보고서를 제출할 때 플래그가 --debug 켜진 상태에서 생성된 출력을 제공합니다. |
| -h, --help | 명령 및 해당 인수에 대한 CLI 참조 정보를 인쇄하고 사용 가능한 하위 그룹 및 명령을 나열합니다. |
| --only-show-errors | 오류만 표시하고 경고를 표시하지 않습니다. |
| -o, --output | 출력 형식을 변경합니다. 사용 가능한 출력 형식은 json, jsonc(색이 지정된 JSON), tsv(탭으로 구분된 값), 테이블(사람이 읽을 수 있는 ASCII 테이블) 및 yaml입니다. 기본적으로 CLI는 를 출력합니다 table. 사용 가능한 출력 형식에 대한 자세한 내용은 Azure Sphere CLI 명령에 대한 출력 형식을 참조하세요. |
| --쿼리 | JMESPath 쿼리 언어를 사용하여 Azure Sphere Security Services에서 반환된 출력을 필터링합니다. 자세한 내용 및 예제 는 JMESPath 자습서 및 Azure CLI 명령 출력 쿼리 를 참조하세요. |
| --자세한 | 작업 중에 Azure Sphere에서 만든 리소스에 대한 정보 및 기타 유용한 정보를 출력합니다. 전체 디버그 로그에 사용합니다 --debug . |
참고
Azure Sphere 클래식 CLI를 사용하는 경우 사용 가능한 옵션에 대한 자세한 내용은 전역 매개 변수 를 참조하세요.
예제
azsphere device manufacturing-state update --state Module1Complete
Updating manufacturing state to Module1Complete.
Restarting device for changes to take effect.
The device was successfully restarted.
네트워크
연결된 디바이스에서 네트워크 인터페이스의 상태 대한 정보를 제공합니다.
| 작업 | 설명 |
|---|---|
| 사용 | 연결된 디바이스에서 네트워크 인터페이스를 사용하도록 설정합니다. |
| 비활성화 | 연결된 디바이스에서 네트워크 인터페이스를 사용하지 않도록 설정합니다. |
| list-firewall-rules | 연결된 디바이스에 대한 방화벽 규칙을 Lists. |
| list-interfaces | 연결된 디바이스에 대한 네트워크 인터페이스를 Lists. |
| 프록시 | 네트워킹 프록시 설정을 관리합니다. |
| show-진단 | 연결된 디바이스의 하나 또는 모든 무선 네트워크에 대한 네트워크 진단 표시합니다. |
| show-상태 | 연결된 디바이스에 대한 네트워크 상태 표시합니다. |
| update-interface | 디바이스에 대한 네트워크 인터페이스 구성을 업데이트. |
네트워크 사용
연결된 디바이스에서 네트워크 인터페이스를 사용하도록 설정합니다.
참고
이 명령은 이더넷 eth0 및 wlan0 연결을 구성하는 데 지원됩니다. 또는 azspheresvc를 구성 lo 하면 오류가 반환됩니다.
필수 매개 변수
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| --인터페이스 | 문자열 | 사용하도록 설정할 인터페이스를 지정합니다. |
선택적 매개 변수
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| -d, --device | 문자열 | 여러 디바이스가 연결되면 명령을 실행할 디바이스를 지정합니다. 이 매개 변수는 여러 디바이스가 연결된 경우에 필요합니다. 현재 연결된 디바이스는 기본적으로 사용됩니다. 연결된 디바이스의 디바이스 ID, IP 주소 또는 로컬 연결 ID를 지정할 수 있습니다. Azure Sphere CLI는 Windows에서 여러 MT3620 디바이스를 지원하지만 Linux에서 한 번에 하나의 디바이스만 연결할 수 있습니다. 이러한 이유로 이 매개 변수는 Windows에서 지원되지만 Linux에서는 지원되지 않습니다. Linux의 명령과 함께 이 매개 변수를 사용하는 경우 오류가 반환됩니다. |
전역 매개 변수
Azure Sphere CLI에 사용할 수 있는 전역 매개 변수는 다음과 같습니다.
| 매개 변수 | 설명 |
|---|---|
| --디버그 | 모든 디버그 로그를 표시하도록 로깅 세부 정보를 늘립니다. 버그가 발견되면 버그 보고서를 제출할 때 플래그가 --debug 켜진 상태에서 생성된 출력을 제공합니다. |
| -h, --help | 명령 및 해당 인수에 대한 CLI 참조 정보를 인쇄하고 사용 가능한 하위 그룹 및 명령을 나열합니다. |
| --only-show-errors | 오류만 표시하고 경고를 표시하지 않습니다. |
| -o, --output | 출력 형식을 변경합니다. 사용 가능한 출력 형식은 json, jsonc(색이 지정된 JSON), tsv(탭으로 구분된 값), 테이블(사람이 읽을 수 있는 ASCII 테이블) 및 yaml입니다. 기본적으로 CLI는 를 출력합니다 table. 사용 가능한 출력 형식에 대한 자세한 내용은 Azure Sphere CLI 명령에 대한 출력 형식을 참조하세요. |
| --쿼리 | JMESPath 쿼리 언어를 사용하여 Azure Sphere Security Services에서 반환된 출력을 필터링합니다. 자세한 내용 및 예제 는 JMESPath 자습서 및 Azure CLI 명령 출력 쿼리 를 참조하세요. |
| --자세한 | 작업 중에 Azure Sphere에서 만든 리소스에 대한 정보 및 기타 유용한 정보를 출력합니다. 전체 디버그 로그에 사용합니다 --debug . |
참고
Azure Sphere 클래식 CLI를 사용하는 경우 사용 가능한 옵션에 대한 자세한 내용은 전역 매개 변수 를 참조하세요.
예제
azsphere device network enable --interface wlan0
Network interface configuration is successfully applied to the device.
Run the command 'azsphere device network list-interfaces' to view details of the network interfaces for the attached device.
네트워크 사용 안 함
연결된 디바이스에서 네트워크 인터페이스를 사용하지 않도록 설정합니다.
참고
이 명령은 이더넷 eth0 및 wlan0 연결을 구성하는 데 지원됩니다. 또는 azspheresvc를 구성 lo 하면 오류가 반환됩니다.
필수 매개 변수
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| --인터페이스 | 문자열 | 사용하도록 설정할 인터페이스를 지정합니다. |
선택적 매개 변수
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| -d, --device | 문자열 | 여러 디바이스가 연결되면 명령을 실행할 디바이스를 지정합니다. 이 매개 변수는 여러 디바이스가 연결된 경우에 필요합니다. 현재 연결된 디바이스는 기본적으로 사용됩니다. 연결된 디바이스의 디바이스 ID, IP 주소 또는 로컬 연결 ID를 지정할 수 있습니다. Azure Sphere CLI는 Windows에서 여러 MT3620 디바이스를 지원하지만 Linux에서 한 번에 하나의 디바이스만 연결할 수 있습니다. 이러한 이유로 이 매개 변수는 Windows에서 지원되지만 Linux에서는 지원되지 않습니다. Linux의 명령과 함께 이 매개 변수를 사용하는 경우 오류가 반환됩니다. |
전역 매개 변수
Azure Sphere CLI에 사용할 수 있는 전역 매개 변수는 다음과 같습니다.
| 매개 변수 | 설명 |
|---|---|
| --디버그 | 모든 디버그 로그를 표시하도록 로깅 세부 정보를 늘립니다. 버그가 발견되면 버그 보고서를 제출할 때 플래그가 --debug 켜진 상태에서 생성된 출력을 제공합니다. |
| -h, --help | 명령 및 해당 인수에 대한 CLI 참조 정보를 인쇄하고 사용 가능한 하위 그룹 및 명령을 나열합니다. |
| --only-show-errors | 오류만 표시하고 경고를 표시하지 않습니다. |
| -o, --output | 출력 형식을 변경합니다. 사용 가능한 출력 형식은 json, jsonc(색이 지정된 JSON), tsv(탭으로 구분된 값), 테이블(사람이 읽을 수 있는 ASCII 테이블) 및 yaml입니다. 기본적으로 CLI는 를 출력합니다 table. 사용 가능한 출력 형식에 대한 자세한 내용은 Azure Sphere CLI 명령에 대한 출력 형식을 참조하세요. |
| --쿼리 | JMESPath 쿼리 언어를 사용하여 Azure Sphere Security Services에서 반환된 출력을 필터링합니다. 자세한 내용 및 예제 는 JMESPath 자습서 및 Azure CLI 명령 출력 쿼리 를 참조하세요. |
| --자세한 | 작업 중에 Azure Sphere에서 만든 리소스에 대한 정보 및 기타 유용한 정보를 출력합니다. 전체 디버그 로그에 사용합니다 --debug . |
참고
Azure Sphere 클래식 CLI를 사용하는 경우 사용 가능한 옵션에 대한 자세한 내용은 전역 매개 변수 를 참조하세요.
예제
azsphere device network disable --interface wlan0
Network interface configuration is successfully applied to the device.
Run the command 'azsphere device network list-interfaces' to view details of the network interfaces for the attached device.
network list-firewall-rules
연결된 디바이스에 대한 방화벽 규칙을 Lists.
선택적 매개 변수
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| -d, --device | 문자열 | 여러 디바이스가 연결되면 명령을 실행할 디바이스를 지정합니다. 이 매개 변수는 여러 디바이스가 연결된 경우에 필요합니다. 현재 연결된 디바이스는 기본적으로 사용됩니다. 연결된 디바이스의 디바이스 ID, IP 주소 또는 로컬 연결 ID를 지정할 수 있습니다. Azure Sphere CLI는 Windows에서 여러 MT3620 디바이스를 지원하지만 Linux에서 한 번에 하나의 디바이스만 연결할 수 있습니다. 이러한 이유로 이 매개 변수는 Windows에서 지원되지만 Linux에서는 지원되지 않습니다. Linux의 명령과 함께 이 매개 변수를 사용하는 경우 오류가 반환됩니다. |
다음 규칙이 표시됩니다.
- 방화벽 규칙 집합 이름: 방화벽 규칙 집합 블록의 이름을 표시합니다.
- 값은 PREROUTING, POSTROUTING, INPUT, FORWARD 및 OUTPUT입니다.
- 규칙 집합 유효: 규칙 집합의 상태 표시합니다. 값은 True 또는 False입니다.
- 방화벽 규칙 집합 규칙: 다음 규칙에 대한 값을 표시합니다.
- 원본 IP: 보내는 컴퓨터의 IP 주소를 표시합니다.
- 원본 마스크: 보내는 컴퓨터의 네트워크 마스크를 표시합니다.
- 대상 IP: 대상 컴퓨터의 IP 주소를 표시합니다.
- 대상 마스크: 소멸 컴퓨터의 네트워크 마스크를 표시합니다.
- UID: 규칙에 적용된 사용자 ID를 표시합니다. 4294967295 (0xFFFFFFFF)는 UID가 적용되지 않았기 때문에 모든 사람에게 적용됨을 의미합니다.
- 작업: 수행할 작업을 표시합니다. 값을 수락 하거나 삭제할 수 있습니다.
- 인터페이스 IN 이름: 입력 인터페이스 이름을 표시합니다. 예를 들어 wlan0입니다.
- 인터페이스 OUT 이름: 출력 인터페이스 이름을 표시합니다. 예를 들어 wlan0입니다.
- 상태: 연결 상태를 표시합니다. 값은 none, established 또는 related입니다.
- TCP 마스크: TCP 마스크의 배열을 표시합니다. 값은 fin, syn, rst, psh, ack 및 urg입니다.
- TCP Cmp: TCP 플래그의 배열을 표시합니다. 값은 urg, ack, psh, rst, syb 및 fin입니다.
- TCP Inv: 부울은 TCP 플래그의 감각을 반전해야 했음을 나타냅니다. 값은 True 또는 False입니다.
- 프로토콜: 방화벽 규칙의 프로토콜을 표시합니다. 값은 icmp, igmp, tcp, udp입니다.
- 원본 포트 범위: 트래픽을 보내는 원본의 포트 범위를 표시합니다. 값은 0에서 65535 사이일 수 있습니다.
- 대상 포트 범위: 트래픽을 수신하는 대상의 포트 범위를 표시합니다. 값은 0에서 65535 사이일 수 있습니다.
- 패킷: 패킷 수를 표시합니다.
- 바이트: 바이트 수를 표시합니다.
플래그에 대한 간략한 요약은 다음과 같습니다.
- URG: 긴급 포인터 필드 중요
- ACK: 승인 필드 중요
- PSH: Push 함수
- RST: 연결 다시 설정
- SYN: 시퀀스 번호 동기화
- FIN: 보낸 사람으로부터 더 이상 데이터가 없습니다.
전역 매개 변수
Azure Sphere CLI에 사용할 수 있는 전역 매개 변수는 다음과 같습니다.
| 매개 변수 | 설명 |
|---|---|
| --디버그 | 모든 디버그 로그를 표시하도록 로깅 세부 정보를 늘립니다. 버그가 발견되면 버그 보고서를 제출할 때 플래그가 --debug 켜진 상태에서 생성된 출력을 제공합니다. |
| -h, --help | 명령 및 해당 인수에 대한 CLI 참조 정보를 인쇄하고 사용 가능한 하위 그룹 및 명령을 나열합니다. |
| --only-show-errors | 오류만 표시하고 경고를 표시하지 않습니다. |
| -o, --output | 출력 형식을 변경합니다. 사용 가능한 출력 형식은 json, jsonc(색이 지정된 JSON), tsv(탭으로 구분된 값), 테이블(사람이 읽을 수 있는 ASCII 테이블) 및 yaml입니다. 기본적으로 CLI는 를 출력합니다 table. 사용 가능한 출력 형식에 대한 자세한 내용은 Azure Sphere CLI 명령에 대한 출력 형식을 참조하세요. |
| --쿼리 | JMESPath 쿼리 언어를 사용하여 Azure Sphere Security Services에서 반환된 출력을 필터링합니다. 자세한 내용 및 예제 는 JMESPath 자습서 및 Azure CLI 명령 출력 쿼리 를 참조하세요. |
| --자세한 | 작업 중에 Azure Sphere에서 만든 리소스에 대한 정보 및 기타 유용한 정보를 출력합니다. 전체 디버그 로그에 사용합니다 --debug . |
참고
Azure Sphere 클래식 CLI를 사용하는 경우 사용 가능한 옵션에 대한 자세한 내용은 전역 매개 변수 를 참조하세요.
예제
azsphere device network list-firewall-rules
----------- ------- ------------ --------------- --------------- --------------- ---------- ------ --------------- ------ -------- --------------- -------------------- ------- ------ ------- ------
Ruleset IsValid SourceIp SourceMask DestinationIp DestinationMask UID Action InterfaceInName TcpInv Protocol SourcePortRange DestinationPortRange Packets Bytes TcpMask TcpCmp
=====================================================================================================================================================================================================
PREROUTING False None None None None None None None None None None None None None None None
----------- ------- ------------ --------------- --------------- --------------- ---------- ------ --------------- ------ -------- --------------- -------------------- ------- ------ ------- ------
INPUT True <value> <value> <value> <value> <value> accept False any 0-65535 0-65535 0 0 None None
----------- ------- ------------ --------------- --------------- --------------- ---------- ------ --------------- ------ -------- --------------- -------------------- ------- ------ ------- ------
INPUT True <value> <value> <value> <value> <value> accept True tcp 0-65535 0-65535 823 394754 syn,ack syn
----------- ------- ------------ --------------- --------------- --------------- ---------- ------ --------------- ------ -------- --------------- -------------------- ------- ------ ------- ------
INPUT True 192.168.35.1 <value> <value> <value> <value> accept azspheresvc False any 0-65535 0-65535 15 780 None None
----------- ------- ------------ --------------- --------------- --------------- ---------- ------ --------------- ------ -------- --------------- -------------------- ------- ------ ------- ------
INPUT True <value> <value> <value> <value> <value> accept False udp 53-53 0-65535 0 0 None None
----------- ------- ------------ --------------- --------------- --------------- ---------- ------ --------------- ------ -------- --------------- -------------------- ------- ------ ------- ------
INPUT True <value> <value> <value> <value> <value> accept False udp 53-53 0-65535 0 0 None None
----------- ------- ------------ --------------- --------------- --------------- ---------- ------ --------------- ------ -------- --------------- -------------------- ------- ------ ------- ------
INPUT True <value> <value> <value> <value> <value> accept False udp 53-53 0-65535 0 0 None None
----------- ------- ------------ --------------- --------------- --------------- ---------- ------ --------------- ------ -------- --------------- -------------------- ------- ------ ------- ------
network list-interfaces
연결된 디바이스에 대한 네트워크 인터페이스를 Lists.
선택적 매개 변수
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| -d, --device | 문자열 | 여러 디바이스가 연결되면 명령을 실행할 디바이스를 지정합니다. 이 매개 변수는 여러 디바이스가 연결된 경우에 필요합니다. 현재 연결된 디바이스는 기본적으로 사용됩니다. 연결된 디바이스의 디바이스 ID, IP 주소 또는 로컬 연결 ID를 지정할 수 있습니다. Azure Sphere CLI는 Windows에서 여러 MT3620 디바이스를 지원하지만 Linux에서 한 번에 하나의 디바이스만 연결할 수 있습니다. 이러한 이유로 이 매개 변수는 Windows에서 지원되지만 Linux에서는 지원되지 않습니다. Linux의 명령과 함께 이 매개 변수를 사용하는 경우 오류가 반환됩니다. |
전역 매개 변수
Azure Sphere CLI에 사용할 수 있는 전역 매개 변수는 다음과 같습니다.
| 매개 변수 | 설명 |
|---|---|
| --디버그 | 모든 디버그 로그를 표시하도록 로깅 세부 정보를 늘립니다. 버그가 발견되면 버그 보고서를 제출할 때 플래그가 --debug 켜진 상태에서 생성된 출력을 제공합니다. |
| -h, --help | 명령 및 해당 인수에 대한 CLI 참조 정보를 인쇄하고 사용 가능한 하위 그룹 및 명령을 나열합니다. |
| --only-show-errors | 오류만 표시하고 경고를 표시하지 않습니다. |
| -o, --output | 출력 형식을 변경합니다. 사용 가능한 출력 형식은 json, jsonc(색이 지정된 JSON), tsv(탭으로 구분된 값), 테이블(사람이 읽을 수 있는 ASCII 테이블) 및 yaml입니다. 기본적으로 CLI는 를 출력합니다 table. 사용 가능한 출력 형식에 대한 자세한 내용은 Azure Sphere CLI 명령에 대한 출력 형식을 참조하세요. |
| --쿼리 | JMESPath 쿼리 언어를 사용하여 Azure Sphere Security Services에서 반환된 출력을 필터링합니다. 자세한 내용 및 예제 는 JMESPath 자습서 및 Azure CLI 명령 출력 쿼리 를 참조하세요. |
| --자세한 | 작업 중에 Azure Sphere에서 만든 리소스에 대한 정보 및 기타 유용한 정보를 출력합니다. 전체 디버그 로그에 사용합니다 --debug . |
참고
Azure Sphere 클래식 CLI를 사용하는 경우 사용 가능한 옵션에 대한 자세한 내용은 전역 매개 변수 를 참조하세요.
예제
azsphere device network list-interfaces
------------- ----------- ------------------ ---------- ------------- ------------------- ------------ -----------------
InterfaceName InterfaceUp ConnectedToNetwork IpAcquired IpAddresses ConnectedToInternet IpAssignment HardwareAddress
========================================================================================================================
azspheresvc True False False <value> False None None
------------- ----------- ------------------ ---------- ------------- ------------------- ------------ -----------------
eth0 True True True <value> True dynamic <value>
------------- ----------- ------------------ ---------- ------------- ------------------- ------------ -----------------
lo True False False <value> False None None
------------- ----------- ------------------ ---------- ------------- ------------------- ------------ -----------------
wlan0 True True True <value> True dynamic <value>
------------- ----------- ------------------ ---------- ------------- ------------------- ------------ -----------------
네트워크 프록시
네트워크 연결에 대한 프록시 주소 사용을 관리합니다. 프록시 서버를 통해 인터넷에 연결하도록 Azure Sphere 디바이스를 구성하는 방법에 대한 자세한 내용은 프록시 서버를 통해 연결을 참조하세요.
참고
현재는 HTTP 프록시만 지원됩니다.
| 작업 | 설명 |
|---|---|
| 프록시 적용 | 연결된 디바이스에서 네트워크 프록시를 구성합니다. |
| 프록시 삭제 | 연결된 디바이스에서 프록시 연결을 삭제합니다. |
| proxy show | 연결된 디바이스에서 프록시 연결을 표시합니다. |
프록시 적용
연결된 디바이스에서 네트워크 프록시를 구성합니다.
필수 매개 변수
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| -a, --address | 문자열 | 사용할 프록시의 네트워크 주소를 지정합니다. |
| -t, --authentication | 문자열 | 사용할 인증 유형을 지정합니다. 허용되는 값: anonymous 또는 basic. 프록시에 사용자 이름 및 암호가 필요한 경우 를 로 설정하면 이고 basic, 그렇지 않으면 를 사용합니다 anonymous. |
| -r, --port | 정수 | 사용할 네트워크 주소의 포트를 지정합니다. 값은 65535보다 작거나 같아야 합니다. |
선택적 매개 변수
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| -d, --device | 문자열 | 여러 디바이스가 연결되면 명령을 실행할 디바이스를 지정합니다. 이 매개 변수는 여러 디바이스가 연결된 경우에 필요합니다. 현재 연결된 디바이스는 기본적으로 사용됩니다. 연결된 디바이스의 디바이스 ID, IP 주소 또는 로컬 연결 ID를 지정할 수 있습니다. Azure Sphere CLI는 Windows에서 여러 MT3620 디바이스를 지원하지만 Linux에서 한 번에 하나의 디바이스만 연결할 수 있습니다. 이러한 이유로 이 매개 변수는 Windows에서 지원되지만 Linux에서는 지원되지 않습니다. Linux의 명령과 함께 이 매개 변수를 사용하는 경우 오류가 반환됩니다. |
| --사용 | 문자열 | 프록시를 사용할지 여부를 지정합니다. 또는 --disable를 --enable 설정해야 합니다. |
| --비활성화 | 문자열 | 프록시를 사용하지 않도록 설정할지 여부를 지정합니다. 또는 --disable를 --enable 설정해야 합니다. |
| -n, --no-proxy-addresses | 문자열 | 프록시 연결을 위해 디바이스에서 피해야 하는 공간으로 구분된 네트워크 주소의 배열을 지정합니다. |
| -p, --password | 문자열 | 프록시 인증에 대한 암호를 지정합니다. 기본 인증에만 사용됩니다. 최대 길이: 64자. |
| -u, --username | 문자열 | 프록시 인증에 대한 사용자 이름을 지정합니다. 기본 인증에만 사용됩니다. 최대 길이: 64자. |
전역 매개 변수
Azure Sphere CLI에 사용할 수 있는 전역 매개 변수는 다음과 같습니다.
| 매개 변수 | 설명 |
|---|---|
| --디버그 | 모든 디버그 로그를 표시하도록 로깅 세부 정보를 늘립니다. 버그가 발견되면 버그 보고서를 제출할 때 플래그가 --debug 켜진 상태에서 생성된 출력을 제공합니다. |
| -h, --help | 명령 및 해당 인수에 대한 CLI 참조 정보를 인쇄하고 사용 가능한 하위 그룹 및 명령을 나열합니다. |
| --only-show-errors | 오류만 표시하고 경고를 표시하지 않습니다. |
| -o, --output | 출력 형식을 변경합니다. 사용 가능한 출력 형식은 json, jsonc(색이 지정된 JSON), tsv(탭으로 구분된 값), 테이블(사람이 읽을 수 있는 ASCII 테이블) 및 yaml입니다. 기본적으로 CLI는 를 출력합니다 table. 사용 가능한 출력 형식에 대한 자세한 내용은 Azure Sphere CLI 명령에 대한 출력 형식을 참조하세요. |
| --쿼리 | JMESPath 쿼리 언어를 사용하여 Azure Sphere Security Services에서 반환된 출력을 필터링합니다. 자세한 내용 및 예제 는 JMESPath 자습서 및 Azure CLI 명령 출력 쿼리 를 참조하세요. |
| --자세한 | 작업 중에 Azure Sphere에서 만든 리소스에 대한 정보 및 기타 유용한 정보를 출력합니다. 전체 디버그 로그에 사용합니다 --debug . |
참고
Azure Sphere 클래식 CLI를 사용하는 경우 사용 가능한 옵션에 대한 자세한 내용은 전역 매개 변수 를 참조하세요.
예제
azsphere device network proxy apply --address contoso.com --authentication anonymous --port 8080 --enable
----------- ------- ----- ------------------ ----------------
Address Enabled Port AuthenticationType NoProxyAddresses
=============================================================
contoso.com True 8080 anonymous
----------- ------- ----- ------------------ ----------------
프록시 삭제
연결된 디바이스에서 프록시 연결을 삭제합니다.
선택적 매개 변수
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| -d, --device | 문자열 | 여러 디바이스가 연결되면 명령을 실행할 디바이스를 지정합니다. 이 매개 변수는 여러 디바이스가 연결된 경우에 필요합니다. 현재 연결된 디바이스는 기본적으로 사용됩니다. 연결된 디바이스의 디바이스 ID, IP 주소 또는 로컬 연결 ID를 지정할 수 있습니다. Azure Sphere CLI는 Windows에서 여러 MT3620 디바이스를 지원하지만 Linux에서 한 번에 하나의 디바이스만 연결할 수 있습니다. 이러한 이유로 이 매개 변수는 Windows에서 지원되지만 Linux에서는 지원되지 않습니다. Linux의 명령과 함께 이 매개 변수를 사용하는 경우 오류가 반환됩니다. |
전역 매개 변수
Azure Sphere CLI에 사용할 수 있는 전역 매개 변수는 다음과 같습니다.
| 매개 변수 | 설명 |
|---|---|
| --디버그 | 모든 디버그 로그를 표시하도록 로깅 세부 정보를 늘립니다. 버그가 발견되면 버그 보고서를 제출할 때 플래그가 --debug 켜진 상태에서 생성된 출력을 제공합니다. |
| -h, --help | 명령 및 해당 인수에 대한 CLI 참조 정보를 인쇄하고 사용 가능한 하위 그룹 및 명령을 나열합니다. |
| --only-show-errors | 오류만 표시하고 경고를 표시하지 않습니다. |
| -o, --output | 출력 형식을 변경합니다. 사용 가능한 출력 형식은 json, jsonc(색이 지정된 JSON), tsv(탭으로 구분된 값), 테이블(사람이 읽을 수 있는 ASCII 테이블) 및 yaml입니다. 기본적으로 CLI는 를 출력합니다 table. 사용 가능한 출력 형식에 대한 자세한 내용은 Azure Sphere CLI 명령에 대한 출력 형식을 참조하세요. |
| --쿼리 | JMESPath 쿼리 언어를 사용하여 Azure Sphere Security Services에서 반환된 출력을 필터링합니다. 자세한 내용 및 예제 는 JMESPath 자습서 및 Azure CLI 명령 출력 쿼리 를 참조하세요. |
| --자세한 | 작업 중에 Azure Sphere에서 만든 리소스에 대한 정보 및 기타 유용한 정보를 출력합니다. 전체 디버그 로그에 사용합니다 --debug . |
참고
Azure Sphere 클래식 CLI를 사용하는 경우 사용 가능한 옵션에 대한 자세한 내용은 전역 매개 변수 를 참조하세요.
예제
azsphere device network proxy delete
proxy show
연결된 디바이스에서 프록시 연결을 표시합니다.
선택적 매개 변수
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| -d, --device | 문자열 | 여러 디바이스가 연결되면 명령을 실행할 디바이스를 지정합니다. 이 매개 변수는 여러 디바이스가 연결된 경우에 필요합니다. 현재 연결된 디바이스는 기본적으로 사용됩니다. 연결된 디바이스의 디바이스 ID, IP 주소 또는 로컬 연결 ID를 지정할 수 있습니다. Azure Sphere CLI는 Windows에서 여러 MT3620 디바이스를 지원하지만 Linux에서 한 번에 하나의 디바이스만 연결할 수 있습니다. 이러한 이유로 이 매개 변수는 Windows에서 지원되지만 Linux에서는 지원되지 않습니다. Linux의 명령과 함께 이 매개 변수를 사용하는 경우 오류가 반환됩니다. |
전역 매개 변수
Azure Sphere CLI에 사용할 수 있는 전역 매개 변수는 다음과 같습니다.
| 매개 변수 | 설명 |
|---|---|
| --디버그 | 모든 디버그 로그를 표시하도록 로깅 세부 정보를 늘립니다. 버그가 발견되면 버그 보고서를 제출할 때 플래그가 --debug 켜진 상태에서 생성된 출력을 제공합니다. |
| -h, --help | 명령 및 해당 인수에 대한 CLI 참조 정보를 인쇄하고 사용 가능한 하위 그룹 및 명령을 나열합니다. |
| --only-show-errors | 오류만 표시하고 경고를 표시하지 않습니다. |
| -o, --output | 출력 형식을 변경합니다. 사용 가능한 출력 형식은 json, jsonc(색이 지정된 JSON), tsv(탭으로 구분된 값), 테이블(사람이 읽을 수 있는 ASCII 테이블) 및 yaml입니다. 기본적으로 CLI는 를 출력합니다 table. 사용 가능한 출력 형식에 대한 자세한 내용은 Azure Sphere CLI 명령에 대한 출력 형식을 참조하세요. |
| --쿼리 | JMESPath 쿼리 언어를 사용하여 Azure Sphere Security Services에서 반환된 출력을 필터링합니다. 자세한 내용 및 예제 는 JMESPath 자습서 및 Azure CLI 명령 출력 쿼리 를 참조하세요. |
| --자세한 | 작업 중에 Azure Sphere에서 만든 리소스에 대한 정보 및 기타 유용한 정보를 출력합니다. 전체 디버그 로그에 사용합니다 --debug . |
참고
Azure Sphere 클래식 CLI를 사용하는 경우 사용 가능한 옵션에 대한 자세한 내용은 전역 매개 변수 를 참조하세요.
예제
azsphere device network proxy show
----------- ------- ----- ------------------ ----------------
Address Enabled Port AuthenticationType NoProxyAddresses
=============================================================
contoso.com True 8080 anonymous
----------- ------- ----- ------------------ ----------------
network show-진단
연결된 디바이스의 하나 또는 모든 Wi-Fi 네트워크에 대한 진단 표시합니다.
선택적 매개 변수
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| -d, --device | 문자열 | 여러 디바이스가 연결되면 명령을 실행할 디바이스를 지정합니다. 이 매개 변수는 여러 디바이스가 연결된 경우에 필요합니다. 현재 연결된 디바이스는 기본적으로 사용됩니다. 연결된 디바이스의 디바이스 ID, IP 주소 또는 로컬 연결 ID를 지정할 수 있습니다. Azure Sphere CLI는 Windows에서 여러 MT3620 디바이스를 지원하지만 Linux에서 한 번에 하나의 디바이스만 연결할 수 있습니다. 이러한 이유로 이 매개 변수는 Windows에서 지원되지만 Linux에서는 지원되지 않습니다. Linux의 명령과 함께 이 매개 변수를 사용하는 경우 오류가 반환됩니다. |
| -n, --network | 정수 | 진단 표시할 Wi-Fi 네트워크의 ID를 지정합니다. |
전역 매개 변수
Azure Sphere CLI에 사용할 수 있는 전역 매개 변수는 다음과 같습니다.
| 매개 변수 | 설명 |
|---|---|
| --디버그 | 모든 디버그 로그를 표시하도록 로깅 세부 정보를 늘립니다. 버그가 발견되면 버그 보고서를 제출할 때 플래그가 --debug 켜진 상태에서 생성된 출력을 제공합니다. |
| -h, --help | 명령 및 해당 인수에 대한 CLI 참조 정보를 인쇄하고 사용 가능한 하위 그룹 및 명령을 나열합니다. |
| --only-show-errors | 오류만 표시하고 경고를 표시하지 않습니다. |
| -o, --output | 출력 형식을 변경합니다. 사용 가능한 출력 형식은 json, jsonc(색이 지정된 JSON), tsv(탭으로 구분된 값), 테이블(사람이 읽을 수 있는 ASCII 테이블) 및 yaml입니다. 기본적으로 CLI는 를 출력합니다 table. 사용 가능한 출력 형식에 대한 자세한 내용은 Azure Sphere CLI 명령에 대한 출력 형식을 참조하세요. |
| --쿼리 | JMESPath 쿼리 언어를 사용하여 Azure Sphere Security Services에서 반환된 출력을 필터링합니다. 자세한 내용 및 예제 는 JMESPath 자습서 및 Azure CLI 명령 출력 쿼리 를 참조하세요. |
| --자세한 | 작업 중에 Azure Sphere에서 만든 리소스에 대한 정보 및 기타 유용한 정보를 출력합니다. 전체 디버그 로그에 사용합니다 --debug . |
참고
Azure Sphere 클래식 CLI를 사용하는 경우 사용 가능한 옵션에 대한 자세한 내용은 전역 매개 변수 를 참조하세요.
예제
azsphere device network show-diagnostics
------------------------- --------- ----- ------------- --------------- --------
Timestamp NetworkId Ssid ConfigState ConnectionState Error
================================================================================
2021-06-16T20:51:29+00:00 0 <value> temp-disabled disconnected WrongKey
------------------------- --------- ----- ------------- --------------- --------
network show-상태
연결된 디바이스에 대한 네트워크 상태 표시합니다.
선택적 매개 변수
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| -d, --device | 문자열 | 여러 디바이스가 연결되면 명령을 실행할 디바이스를 지정합니다. 이 매개 변수는 여러 디바이스가 연결된 경우에 필요합니다. 현재 연결된 디바이스는 기본적으로 사용됩니다. 연결된 디바이스의 디바이스 ID, IP 주소 또는 로컬 연결 ID를 지정할 수 있습니다. Azure Sphere CLI는 Windows에서 여러 MT3620 디바이스를 지원하지만 Linux에서 한 번에 하나의 디바이스만 연결할 수 있습니다. 이러한 이유로 이 매개 변수는 Windows에서 지원되지만 Linux에서는 지원되지 않습니다. Linux의 명령과 함께 이 매개 변수를 사용하는 경우 오류가 반환됩니다. |
전역 매개 변수
Azure Sphere CLI에 사용할 수 있는 전역 매개 변수는 다음과 같습니다.
| 매개 변수 | 설명 |
|---|---|
| --디버그 | 모든 디버그 로그를 표시하도록 로깅 세부 정보를 늘립니다. 버그가 발견되면 버그 보고서를 제출할 때 플래그가 --debug 켜진 상태에서 생성된 출력을 제공합니다. |
| -h, --help | 명령 및 해당 인수에 대한 CLI 참조 정보를 인쇄하고 사용 가능한 하위 그룹 및 명령을 나열합니다. |
| --only-show-errors | 오류만 표시하고 경고를 표시하지 않습니다. |
| -o, --output | 출력 형식을 변경합니다. 사용 가능한 출력 형식은 json, jsonc(색이 지정된 JSON), tsv(탭으로 구분된 값), 테이블(사람이 읽을 수 있는 ASCII 테이블) 및 yaml입니다. 기본적으로 CLI는 를 출력합니다 table. 사용 가능한 출력 형식에 대한 자세한 내용은 Azure Sphere CLI 명령에 대한 출력 형식을 참조하세요. |
| --쿼리 | JMESPath 쿼리 언어를 사용하여 Azure Sphere Security Services에서 반환된 출력을 필터링합니다. 자세한 내용 및 예제 는 JMESPath 자습서 및 Azure CLI 명령 출력 쿼리 를 참조하세요. |
| --자세한 | 작업 중에 Azure Sphere에서 만든 리소스에 대한 정보 및 기타 유용한 정보를 출력합니다. 전체 디버그 로그에 사용합니다 --debug . |
참고
Azure Sphere 클래식 CLI를 사용하는 경우 사용 가능한 옵션에 대한 자세한 내용은 전역 매개 변수 를 참조하세요.
예제
azsphere device network show-status
--------------------------- --------------- -----
DeviceAuthenticationIsReady NetworkTimeSync Proxy
=================================================
True complete ready
--------------------------- --------------- -----
network update-interface
디바이스에 대한 이더넷 네트워크 인터페이스를 업데이트. 디바이스의 MAC 주소를 설정하는 방법에 대한 자세한 내용은 이 더넷에 대한 디바이스 구성을 참조하세요.
참고
이 명령은 이더넷 eth0 연결을 구성하는 데 지원됩니다. 또는 wlan0를 azspheresvc 구성lo하면 오류가 반환됩니다.
필수 매개 변수
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| --hardware-address | 문자열 | 디바이스에 대해 설정할 하드웨어 주소를 또는 aa:bb:33:dd:ee:ff형식 중 하나로 지정합니다. AA:BB:33:DD:EE:FF |
| --인터페이스 또는 --interface-name [사용 중지] |
문자열 | 구성할 인터페이스의 이름을 지정합니다. azsphere device network list-interfaces를 실행하여 연결된 디바이스에 대한 네트워크 인터페이스의 세부 정보를 봅니다. 인수는 --interface-name 사용 중지되며 이후 릴리스에서 제거됩니다. 자세한 내용은 Azure Sphere CLI의 중요한 변경 내용(사용 중지 기능)을 참조하세요. |
선택적 매개 변수
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| -d, --device | 문자열 | 여러 디바이스가 연결되면 명령을 실행할 디바이스를 지정합니다. 이 매개 변수는 여러 디바이스가 연결된 경우에 필요합니다. 현재 연결된 디바이스는 기본적으로 사용됩니다. 연결된 디바이스의 디바이스 ID, IP 주소 또는 로컬 연결 ID를 지정할 수 있습니다. Azure Sphere CLI는 Windows에서 여러 MT3620 디바이스를 지원하지만 Linux에서 한 번에 하나의 디바이스만 연결할 수 있습니다. 이러한 이유로 이 매개 변수는 Windows에서 지원되지만 Linux에서는 지원되지 않습니다. Linux의 명령과 함께 이 매개 변수를 사용하는 경우 오류가 반환됩니다. |
전역 매개 변수
Azure Sphere CLI에 사용할 수 있는 전역 매개 변수는 다음과 같습니다.
| 매개 변수 | 설명 |
|---|---|
| --디버그 | 모든 디버그 로그를 표시하도록 로깅 세부 정보를 늘립니다. 버그가 발견되면 버그 보고서를 제출할 때 플래그가 --debug 켜진 상태에서 생성된 출력을 제공합니다. |
| -h, --help | 명령 및 해당 인수에 대한 CLI 참조 정보를 인쇄하고 사용 가능한 하위 그룹 및 명령을 나열합니다. |
| --only-show-errors | 오류만 표시하고 경고를 표시하지 않습니다. |
| -o, --output | 출력 형식을 변경합니다. 사용 가능한 출력 형식은 json, jsonc(색이 지정된 JSON), tsv(탭으로 구분된 값), 테이블(사람이 읽을 수 있는 ASCII 테이블) 및 yaml입니다. 기본적으로 CLI는 를 출력합니다 table. 사용 가능한 출력 형식에 대한 자세한 내용은 Azure Sphere CLI 명령에 대한 출력 형식을 참조하세요. |
| --쿼리 | JMESPath 쿼리 언어를 사용하여 Azure Sphere Security Services에서 반환된 출력을 필터링합니다. 자세한 내용 및 예제 는 JMESPath 자습서 및 Azure CLI 명령 출력 쿼리 를 참조하세요. |
| --자세한 | 작업 중에 Azure Sphere에서 만든 리소스에 대한 정보 및 기타 유용한 정보를 출력합니다. 전체 디버그 로그에 사용합니다 --debug . |
참고
Azure Sphere 클래식 CLI를 사용하는 경우 사용 가능한 옵션에 대한 자세한 내용은 전역 매개 변수 를 참조하세요.
예제
azsphere device network update-interface --interface eth0 --hardware-address ba:98:76:54:32:10
복구
디바이스의 시스템 소프트웨어를 대체합니다.
선택적 매개 변수
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| -d, --device | 문자열 | 여러 디바이스가 연결된 경우 명령을 실행할 디바이스를 지정합니다. 현재 연결된 디바이스는 기본적으로 사용됩니다. 디바이스의 ID, IP 주소 또는 로컬 연결 ID를 지정합니다. |
| -c, --capability | 문자열 | 복구하는 동안 디바이스에 적용할 디바이스 기능 이미지를 지정합니다. |
| -i, --images | 문자열 | 디바이스에 쓸 이미지 패키지가 포함된 폴더의 경로를 지정합니다. 기본적으로 복구는 이 플래그와 함께 대체 경로를 제공하지 않는 한 SDK의 이미지를 사용합니다. |
전역 매개 변수
Azure Sphere CLI에 사용할 수 있는 전역 매개 변수는 다음과 같습니다.
| 매개 변수 | 설명 |
|---|---|
| --디버그 | 모든 디버그 로그를 표시하도록 로깅 세부 정보를 늘립니다. 버그가 발견되면 버그 보고서를 제출할 때 플래그가 --debug 켜진 상태에서 생성된 출력을 제공합니다. |
| -h, --help | 명령 및 해당 인수에 대한 CLI 참조 정보를 인쇄하고 사용 가능한 하위 그룹 및 명령을 나열합니다. |
| --only-show-errors | 오류만 표시하고 경고를 표시하지 않습니다. |
| -o, --output | 출력 형식을 변경합니다. 사용 가능한 출력 형식은 json, jsonc(색이 지정된 JSON), tsv(탭으로 구분된 값), 테이블(사람이 읽을 수 있는 ASCII 테이블) 및 yaml입니다. 기본적으로 CLI는 를 출력합니다 table. 사용 가능한 출력 형식에 대한 자세한 내용은 Azure Sphere CLI 명령에 대한 출력 형식을 참조하세요. |
| --쿼리 | JMESPath 쿼리 언어를 사용하여 Azure Sphere Security Services에서 반환된 출력을 필터링합니다. 자세한 내용 및 예제 는 JMESPath 자습서 및 Azure CLI 명령 출력 쿼리 를 참조하세요. |
| --자세한 | 작업 중에 Azure Sphere에서 만든 리소스에 대한 정보 및 기타 유용한 정보를 출력합니다. 전체 디버그 로그에 사용합니다 --debug . |
참고
Azure Sphere 클래식 CLI를 사용하는 경우 사용 가능한 옵션에 대한 자세한 내용은 전역 매개 변수 를 참조하세요.
예제
예제 1:
azsphere device recover
Downloading recovery images...
Download complete.
Starting device recovery. Please note that this may take up to 10 minutes.
Board found. Sending recovery bootloader.
Erasing flash.
Sending 17 images. (5443272 bytes to send)
Sent 1 of 17 images. (5440896 of 5443272 bytes remaining)
Sent 2 of 17 images. (5414844 of 5443272 bytes remaining)
Sent 3 of 17 images. (5311892 of 5443272 bytes remaining)
Sent 4 of 17 images. (5311500 of 5443272 bytes remaining)
Sent 5 of 17 images. (5041520 of 5443272 bytes remaining)
Sent 6 of 17 images. (5024908 of 5443272 bytes remaining)
Sent 7 of 17 images. (4994856 of 5443272 bytes remaining)
Sent 8 of 17 images. (2397456 of 5443272 bytes remaining)
Sent 9 of 17 images. (885796 of 5443272 bytes remaining)
Sent 10 of 17 images. (861220 of 5443272 bytes remaining)
Sent 11 of 17 images. (758608 of 5443272 bytes remaining)
Sent 12 of 17 images. (135796 of 5443272 bytes remaining)
Sent 13 of 17 images. (70048 of 5443272 bytes remaining)
Sent 14 of 17 images. (41164 of 5443272 bytes remaining)
Sent 15 of 17 images. (32768 of 5443272 bytes remaining)
Sent 16 of 17 images. (16384 of 5443272 bytes remaining)
Sent 17 of 17 images. (0 of 5443272 bytes remaining)
Finished writing images; rebooting board.
Device ID: 352FE1F59E40EF8A9266415E81AF32B5B07D8F2BBD6B5650CEF4A70B86C7FCBC70B129A41FBC6D02F8BB4AAABC52CD5740C85427D205E46A166B7E41135EB968
Device recovered successfully.
예제 2:
azsphere device recover --capability "C:\Users\capability file\capability_352FE1F_5.bin"
Downloading recovery images...
Download complete.
Starting device recovery. Please note that this may take up to 10 minutes.
Board found. Sending recovery bootloader.
Erasing flash.
Sending 16 images. (5474668 bytes to send)
Sent 1 of 16 images. (5447384 of 5474668 bytes remaining)
Sent 2 of 16 images. (5343788 of 5474668 bytes remaining)
Sent 3 of 16 images. (5343396 of 5474668 bytes remaining)
Sent 4 of 16 images. (5073416 of 5474668 bytes remaining)
Sent 5 of 16 images. (5056612 of 5474668 bytes remaining)
Sent 6 of 16 images. (5026240 of 5474668 bytes remaining)
Sent 7 of 16 images. (2479376 of 5474668 bytes remaining)
Sent 8 of 16 images. (889892 of 5474668 bytes remaining)
Sent 9 of 16 images. (865316 of 5474668 bytes remaining)
Sent 10 of 16 images. (754512 of 5474668 bytes remaining)
Sent 11 of 16 images. (135796 of 5474668 bytes remaining)
Sent 12 of 16 images. (70048 of 5474668 bytes remaining)
Sent 13 of 16 images. (41164 of 5474668 bytes remaining)
Sent 14 of 16 images. (32768 of 5474668 bytes remaining)
Sent 15 of 16 images. (16384 of 5474668 bytes remaining)
Sent 16 of 16 images. (0 of 5474668 bytes remaining)
Finished writing images; rebooting board.
Device ID: 352FE1F59E40EF8A9266415E81AF32B5B07D8F2BBD6B5650CEF4A70B86C7FCBC70B129A41FBC6D02F8BB4AAABC52CD5740C85427D205E46A166B7E41135EB968
Device recovered successfully.
rescan-attached
모든 FTDI 포트를 전원 순환하여 연결된 디바이스를 다시 검사하고 연결된 디바이스의 총 수를 표시합니다. Windows에서 디바이스 연결 문제를 해결할 때 이 명령을 사용합니다. 이 명령은 Windows에서만 실행됩니다.
전역 매개 변수
Azure Sphere CLI에 사용할 수 있는 전역 매개 변수는 다음과 같습니다.
| 매개 변수 | 설명 |
|---|---|
| --디버그 | 모든 디버그 로그를 표시하도록 로깅 세부 정보를 늘립니다. 버그가 발견되면 버그 보고서를 제출할 때 플래그가 --debug 켜진 상태에서 생성된 출력을 제공합니다. |
| -h, --help | 명령 및 해당 인수에 대한 CLI 참조 정보를 인쇄하고 사용 가능한 하위 그룹 및 명령을 나열합니다. |
| --only-show-errors | 오류만 표시하고 경고를 표시하지 않습니다. |
| -o, --output | 출력 형식을 변경합니다. 사용 가능한 출력 형식은 json, jsonc(색이 지정된 JSON), tsv(탭으로 구분된 값), 테이블(사람이 읽을 수 있는 ASCII 테이블) 및 yaml입니다. 기본적으로 CLI는 를 출력합니다 table. 사용 가능한 출력 형식에 대한 자세한 내용은 Azure Sphere CLI 명령에 대한 출력 형식을 참조하세요. |
| --쿼리 | JMESPath 쿼리 언어를 사용하여 Azure Sphere Security Services에서 반환된 출력을 필터링합니다. 자세한 내용 및 예제 는 JMESPath 자습서 및 Azure CLI 명령 출력 쿼리 를 참조하세요. |
| --자세한 | 작업 중에 Azure Sphere에서 만든 리소스에 대한 정보 및 기타 유용한 정보를 출력합니다. 전체 디버그 로그에 사용합니다 --debug . |
참고
Azure Sphere 클래식 CLI를 사용하는 경우 사용 가능한 옵션에 대한 자세한 내용은 전역 매개 변수 를 참조하세요.
예제
azsphere device rescan-attached
-----------
Count
===========
2
-----------
다시 시작할
연결된 디바이스를 다시 시작합니다.
선택적 매개 변수
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| -d, --device | 문자열 | 여러 디바이스가 연결되면 명령을 실행할 디바이스를 지정합니다. 이 매개 변수는 여러 디바이스가 연결된 경우에 필요합니다. 현재 연결된 디바이스는 기본적으로 사용됩니다. 연결된 디바이스의 디바이스 ID, IP 주소 또는 로컬 연결 ID를 지정할 수 있습니다. Azure Sphere CLI는 Windows에서 여러 MT3620 디바이스를 지원하지만 Linux에서 한 번에 하나의 디바이스만 연결할 수 있습니다. 이러한 이유로 이 매개 변수는 Windows에서 지원되지만 Linux에서는 지원되지 않습니다. Linux의 명령과 함께 이 매개 변수를 사용하는 경우 오류가 반환됩니다. |
전역 매개 변수
Azure Sphere CLI에 사용할 수 있는 전역 매개 변수는 다음과 같습니다.
| 매개 변수 | 설명 |
|---|---|
| --디버그 | 모든 디버그 로그를 표시하도록 로깅 세부 정보를 늘립니다. 버그가 발견되면 버그 보고서를 제출할 때 플래그가 --debug 켜진 상태에서 생성된 출력을 제공합니다. |
| -h, --help | 명령 및 해당 인수에 대한 CLI 참조 정보를 인쇄하고 사용 가능한 하위 그룹 및 명령을 나열합니다. |
| --only-show-errors | 오류만 표시하고 경고를 표시하지 않습니다. |
| -o, --output | 출력 형식을 변경합니다. 사용 가능한 출력 형식은 json, jsonc(색이 지정된 JSON), tsv(탭으로 구분된 값), 테이블(사람이 읽을 수 있는 ASCII 테이블) 및 yaml입니다. 기본적으로 CLI는 를 출력합니다 table. 사용 가능한 출력 형식에 대한 자세한 내용은 Azure Sphere CLI 명령에 대한 출력 형식을 참조하세요. |
| --쿼리 | JMESPath 쿼리 언어를 사용하여 Azure Sphere Security Services에서 반환된 출력을 필터링합니다. 자세한 내용 및 예제 는 JMESPath 자습서 및 Azure CLI 명령 출력 쿼리 를 참조하세요. |
| --자세한 | 작업 중에 Azure Sphere에서 만든 리소스에 대한 정보 및 기타 유용한 정보를 출력합니다. 전체 디버그 로그에 사용합니다 --debug . |
참고
Azure Sphere 클래식 CLI를 사용하는 경우 사용 가능한 옵션에 대한 자세한 내용은 전역 매개 변수 를 참조하세요.
예제
azsphere device restart
Restarting device.
Device restarted successfully.
표시
Azure Sphere 테넌트에서 연결된 디바이스의 세부 정보를 표시합니다.
선택적 매개 변수
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| -d, --device | 문자열 | 명령을 실행할 디바이스를 지정합니다. 이 매개 변수는 여러 디바이스가 연결되거나 디바이스가 연결되지 않은 경우에 필요합니다. 현재 연결된 디바이스는 기본적으로 사용됩니다. 연결되지 않은 디바이스에 대한 디바이스 ID를 제공하거나 연결된 디바이스의 IP 주소 또는 로컬 연결 ID를 지정할 수 있습니다. Azure Sphere CLI는 Windows에서 여러 MT3620 디바이스를 지원하지만 Linux에서 한 번에 하나의 디바이스만 연결할 수 있습니다. 이러한 이유로 이 매개 변수는 Windows에서 지원되지만 Linux에서는 지원되지 않습니다. Linux의 명령과 함께 이 매개 변수를 사용하는 경우 오류가 반환됩니다. |
| -t, --tenant | GUID 또는 이름 | 이 작업을 수행할 테넌트 를 지정합니다. 선택한 기본 테넌트 를 재정의합니다. 테넌트 ID 또는 테넌트 이름을 지정할 수 있습니다. |
전역 매개 변수
Azure Sphere CLI에 사용할 수 있는 전역 매개 변수는 다음과 같습니다.
| 매개 변수 | 설명 |
|---|---|
| --디버그 | 모든 디버그 로그를 표시하도록 로깅 세부 정보를 늘립니다. 버그가 발견되면 버그 보고서를 제출할 때 플래그가 --debug 켜진 상태에서 생성된 출력을 제공합니다. |
| -h, --help | 명령 및 해당 인수에 대한 CLI 참조 정보를 인쇄하고 사용 가능한 하위 그룹 및 명령을 나열합니다. |
| --only-show-errors | 오류만 표시하고 경고를 표시하지 않습니다. |
| -o, --output | 출력 형식을 변경합니다. 사용 가능한 출력 형식은 json, jsonc(색이 지정된 JSON), tsv(탭으로 구분된 값), 테이블(사람이 읽을 수 있는 ASCII 테이블) 및 yaml입니다. 기본적으로 CLI는 를 출력합니다 table. 사용 가능한 출력 형식에 대한 자세한 내용은 Azure Sphere CLI 명령에 대한 출력 형식을 참조하세요. |
| --쿼리 | JMESPath 쿼리 언어를 사용하여 Azure Sphere Security Services에서 반환된 출력을 필터링합니다. 자세한 내용 및 예제 는 JMESPath 자습서 및 Azure CLI 명령 출력 쿼리 를 참조하세요. |
| --자세한 | 작업 중에 Azure Sphere에서 만든 리소스에 대한 정보 및 기타 유용한 정보를 출력합니다. 전체 디버그 로그에 사용합니다 --debug . |
참고
Azure Sphere 클래식 CLI를 사용하는 경우 사용 가능한 옵션에 대한 자세한 내용은 전역 매개 변수 를 참조하세요.
예제
azsphere device show
-------------------------------------------------------------------------------------------------------------------------------- ------------------------------------ -------- ------------------------------------ ------------------------------------
DeviceId TenantId ChipSku ProductId DeviceGroupId
========================================================================================================================================================================================================================================================
352FE1F59E40EF8A9266415E81AF32B5B07D8F2BBD6B5650CEF4A70B86C7FCBC70B129A41FBC6D02F8BB4AAABC52CD5740C85427D205E46A166B7E41135EB968 a323c263-2aa3-2559-aabb-a3fc32631900 MT3620AN 6f52bead-700d-4289-bdc2-2f11f774270e 7f860cc1-4949-4000-a541-9a988ba4c3cd
-------------------------------------------------------------------------------------------------------------------------------- ------------------------------------ -------- ------------------------------------ ------------------------------------
매개 변수를 --query 사용하여 이 명령에 대해 표시되는 출력을 사용자 지정할 수 있습니다. 자세한 내용은 쿼리 CLI 명령 출력을 참조하세요.
다음 예제에서는 디바이스 ID 및 제품 ID만 선택하는 방법을 보여줍니다.
azsphere device show --device 352FE1F59E40EF8A9266415E81AF32B5B07D8F2BBD6B5650CEF4A70B86C7FCBC70B129A41FBC6D02F8BB4AAABC52CD5740C85427D205E46A166B7E41135EB968 --query '{DeviceId:deviceId, ProductId:productId}'
-------------------------------------------------------------------------------------------------------------------------------- ------------------------------------
DeviceId ProductId
=====================================================================================================================================================================
352FE1F59E40EF8A9266415E81AF32B5B07D8F2BBD6B5650CEF4A70B86C7FCBC70B129A41FBC6D02F8BB4AAABC52CD5740C85427D205E46A166B7E41135EB968 6f52bead-700d-4289-bdc2-2f11f774270e
-------------------------------------------------------------------------------------------------------------------------------- ------------------------------------
show-attached
디바이스 자체에서 연결된 디바이스에 대한 정보를 표시합니다. 이러한 세부 정보는 Azure Sphere Security Service가 디바이스에 대해 저장하는 세부 정보와 다릅니다.
선택적 매개 변수
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| -d, --device | 문자열 | 여러 디바이스가 연결되면 명령을 실행할 디바이스를 지정합니다. 이 매개 변수는 여러 디바이스가 연결된 경우에 필요합니다. 현재 연결된 디바이스는 기본적으로 사용됩니다. 연결된 디바이스의 디바이스 ID, IP 주소 또는 로컬 연결 ID를 지정할 수 있습니다. Azure Sphere CLI는 Windows에서 여러 MT3620 디바이스를 지원하지만 Linux에서 한 번에 하나의 디바이스만 연결할 수 있습니다. 이러한 이유로 이 매개 변수는 Windows에서 지원되지만 Linux에서는 지원되지 않습니다. Linux의 명령과 함께 이 매개 변수를 사용하는 경우 오류가 반환됩니다. |
전역 매개 변수
Azure Sphere CLI에 사용할 수 있는 전역 매개 변수는 다음과 같습니다.
| 매개 변수 | 설명 |
|---|---|
| --디버그 | 모든 디버그 로그를 표시하도록 로깅 세부 정보를 늘립니다. 버그가 발견되면 버그 보고서를 제출할 때 플래그가 --debug 켜진 상태에서 생성된 출력을 제공합니다. |
| -h, --help | 명령 및 해당 인수에 대한 CLI 참조 정보를 인쇄하고 사용 가능한 하위 그룹 및 명령을 나열합니다. |
| --only-show-errors | 오류만 표시하고 경고를 표시하지 않습니다. |
| -o, --output | 출력 형식을 변경합니다. 사용 가능한 출력 형식은 json, jsonc(색이 지정된 JSON), tsv(탭으로 구분된 값), 테이블(사람이 읽을 수 있는 ASCII 테이블) 및 yaml입니다. 기본적으로 CLI는 를 출력합니다 table. 사용 가능한 출력 형식에 대한 자세한 내용은 Azure Sphere CLI 명령에 대한 출력 형식을 참조하세요. |
| --쿼리 | JMESPath 쿼리 언어를 사용하여 Azure Sphere Security Services에서 반환된 출력을 필터링합니다. 자세한 내용 및 예제 는 JMESPath 자습서 및 Azure CLI 명령 출력 쿼리 를 참조하세요. |
| --자세한 | 작업 중에 Azure Sphere에서 만든 리소스에 대한 정보 및 기타 유용한 정보를 출력합니다. 전체 디버그 로그에 사용합니다 --debug . |
참고
Azure Sphere 클래식 CLI를 사용하는 경우 사용 가능한 옵션에 대한 자세한 내용은 전역 매개 변수 를 참조하세요.
예제
azsphere device show-attached
Device ID: 352fe1f59e40ef8a9266415e81af32b5b07d8f2bbd6b5650cef4a70b86c7fcbc70b129a41fbc6d02f8bb4aaabc52cd5740c85427d205e46a166b7e41135eb968
IP address: 192.128.48.1
Connection path: 21143
show-deployment-상태
디바이스에 대한 애플리케이션 및 운영 체제 업데이트의 배포 상태 표시합니다.
이 명령을 사용하여 디바이스가 실행 중인 Azure Sphere OS 버전 또는 현재 배포 업데이트가 완료되었는지 확인합니다.
선택적 매개 변수
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| -d, --device | 문자열 | 여러 디바이스가 연결되면 명령을 실행할 디바이스를 지정합니다. 이 매개 변수는 여러 디바이스가 연결된 경우에 필요합니다. 현재 연결된 디바이스는 기본적으로 사용됩니다. 연결된 디바이스의 디바이스 ID, IP 주소 또는 로컬 연결 ID를 지정할 수 있습니다. Azure Sphere CLI는 Windows에서 여러 MT3620 디바이스를 지원하지만 Linux에서 한 번에 하나의 디바이스만 연결할 수 있습니다. 이러한 이유로 이 매개 변수는 Windows에서 지원되지만 Linux에서는 지원되지 않습니다. Linux의 명령과 함께 이 매개 변수를 사용하는 경우 오류가 반환됩니다. |
| -t, --tenant | GUID 또는 이름 | 이 작업을 수행할 테넌트 를 지정합니다. 선택한 기본 테넌트 를 재정의합니다. 테넌트 ID 또는 테넌트 이름을 지정할 수 있습니다. |
전역 매개 변수
Azure Sphere CLI에 사용할 수 있는 전역 매개 변수는 다음과 같습니다.
| 매개 변수 | 설명 |
|---|---|
| --디버그 | 모든 디버그 로그를 표시하도록 로깅 세부 정보를 늘립니다. 버그가 발견되면 버그 보고서를 제출할 때 플래그가 --debug 켜진 상태에서 생성된 출력을 제공합니다. |
| -h, --help | 명령 및 해당 인수에 대한 CLI 참조 정보를 인쇄하고 사용 가능한 하위 그룹 및 명령을 나열합니다. |
| --only-show-errors | 오류만 표시하고 경고를 표시하지 않습니다. |
| -o, --output | 출력 형식을 변경합니다. 사용 가능한 출력 형식은 json, jsonc(색이 지정된 JSON), tsv(탭으로 구분된 값), 테이블(사람이 읽을 수 있는 ASCII 테이블) 및 yaml입니다. 기본적으로 CLI는 를 출력합니다 table. 사용 가능한 출력 형식에 대한 자세한 내용은 Azure Sphere CLI 명령에 대한 출력 형식을 참조하세요. |
| --쿼리 | JMESPath 쿼리 언어를 사용하여 Azure Sphere Security Services에서 반환된 출력을 필터링합니다. 자세한 내용 및 예제 는 JMESPath 자습서 및 Azure CLI 명령 출력 쿼리 를 참조하세요. |
| --자세한 | 작업 중에 Azure Sphere에서 만든 리소스에 대한 정보 및 기타 유용한 정보를 출력합니다. 전체 디버그 로그에 사용합니다 --debug . |
참고
Azure Sphere 클래식 CLI를 사용하는 경우 사용 가능한 옵션에 대한 자세한 내용은 전역 매개 변수 를 참조하세요.
예제
azsphere device show-deployment-status
Your device is running Azure Sphere OS version <version-number>.
The Azure Sphere Security Service is targeting this device with Azure Sphere OS version <version-number>.
Your device has the expected version of the Azure Sphere OS: <version-number>.
이 예제 <에서 버전 번호> 는 현재 운영 체제 버전을 나타냅니다.
show-count
현재 테넌트에서 디바이스 수를 표시합니다.
선택적 매개 변수
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| -t, --tenant | GUID 또는 이름 | 이 작업을 수행할 테넌트 를 지정합니다. 선택한 기본 테넌트 를 재정의합니다. 테넌트 ID 또는 테넌트 이름을 지정할 수 있습니다. |
전역 매개 변수
Azure Sphere CLI에 사용할 수 있는 전역 매개 변수는 다음과 같습니다.
| 매개 변수 | 설명 |
|---|---|
| --디버그 | 모든 디버그 로그를 표시하도록 로깅 세부 정보를 늘립니다. 버그가 발견되면 버그 보고서를 제출할 때 플래그가 --debug 켜진 상태에서 생성된 출력을 제공합니다. |
| -h, --help | 명령 및 해당 인수에 대한 CLI 참조 정보를 인쇄하고 사용 가능한 하위 그룹 및 명령을 나열합니다. |
| --only-show-errors | 오류만 표시하고 경고를 표시하지 않습니다. |
| -o, --output | 출력 형식을 변경합니다. 사용 가능한 출력 형식은 json, jsonc(색이 지정된 JSON), tsv(탭으로 구분된 값), 테이블(사람이 읽을 수 있는 ASCII 테이블) 및 yaml입니다. 기본적으로 CLI는 를 출력합니다 table. 사용 가능한 출력 형식에 대한 자세한 내용은 Azure Sphere CLI 명령에 대한 출력 형식을 참조하세요. |
| --쿼리 | JMESPath 쿼리 언어를 사용하여 Azure Sphere Security Services에서 반환된 출력을 필터링합니다. 자세한 내용 및 예제 는 JMESPath 자습서 및 Azure CLI 명령 출력 쿼리 를 참조하세요. |
| --자세한 | 작업 중에 Azure Sphere에서 만든 리소스에 대한 정보 및 기타 유용한 정보를 출력합니다. 전체 디버그 로그에 사용합니다 --debug . |
참고
Azure Sphere 클래식 CLI를 사용하는 경우 사용 가능한 옵션에 대한 자세한 내용은 전역 매개 변수 를 참조하세요.
예제
azsphere device show-count
------
Result
======
2
------
show-os-version
연결된 디바이스에 현재 운영 체제 버전을 표시합니다.
선택적 매개 변수
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| -d, --device | 문자열 | 여러 디바이스가 연결되면 명령을 실행할 디바이스를 지정합니다. 이 매개 변수는 여러 디바이스가 연결된 경우에 필요합니다. 현재 연결된 디바이스는 기본적으로 사용됩니다. 연결된 디바이스의 디바이스 ID, IP 주소 또는 로컬 연결 ID를 지정할 수 있습니다. Azure Sphere CLI는 Windows에서 여러 MT3620 디바이스를 지원하지만 Linux에서 한 번에 하나의 디바이스만 연결할 수 있습니다. 이러한 이유로 이 매개 변수는 Windows에서 지원되지만 Linux에서는 지원되지 않습니다. Linux의 명령과 함께 이 매개 변수를 사용하는 경우 오류가 반환됩니다. |
전역 매개 변수
Azure Sphere CLI에 사용할 수 있는 전역 매개 변수는 다음과 같습니다.
| 매개 변수 | 설명 |
|---|---|
| --디버그 | 모든 디버그 로그를 표시하도록 로깅 세부 정보를 늘립니다. 버그가 발견되면 버그 보고서를 제출할 때 플래그가 --debug 켜진 상태에서 생성된 출력을 제공합니다. |
| -h, --help | 명령 및 해당 인수에 대한 CLI 참조 정보를 인쇄하고 사용 가능한 하위 그룹 및 명령을 나열합니다. |
| --only-show-errors | 오류만 표시하고 경고를 표시하지 않습니다. |
| -o, --output | 출력 형식을 변경합니다. 사용 가능한 출력 형식은 json, jsonc(색이 지정된 JSON), tsv(탭으로 구분된 값), 테이블(사람이 읽을 수 있는 ASCII 테이블) 및 yaml입니다. 기본적으로 CLI는 를 출력합니다 table. 사용 가능한 출력 형식에 대한 자세한 내용은 Azure Sphere CLI 명령에 대한 출력 형식을 참조하세요. |
| --쿼리 | JMESPath 쿼리 언어를 사용하여 Azure Sphere Security Services에서 반환된 출력을 필터링합니다. 자세한 내용 및 예제 는 JMESPath 자습서 및 Azure CLI 명령 출력 쿼리 를 참조하세요. |
| --자세한 | 작업 중에 Azure Sphere에서 만든 리소스에 대한 정보 및 기타 유용한 정보를 출력합니다. 전체 디버그 로그에 사용합니다 --debug . |
참고
Azure Sphere 클래식 CLI를 사용하는 경우 사용 가능한 옵션에 대한 자세한 내용은 전역 매개 변수 를 참조하세요.
예제
azsphere device show-os-version
Your device is running Azure Sphere OS version <version-number>
이 예제 <에서 버전 번호> 는 현재 운영 체제 버전을 나타냅니다.
sideload
디바이스에서 애플리케이션을 관리합니다.
일부 사이드로드 옵션은 디바이스가 제조 상태인 DeviceComplete에 있으면 추가 기능이 필요합니다. fieldServicing 기능을 사용하면 임시 프로덕션 서명 이미지를 배포 및 삭제하고 영구 프로덕션 서명 이미지를 배포할 수 있습니다. appDevelopment 기능을 사용하면 프로덕션 서명 이미지와 SDK 서명 이미지를 모두 배포하고 삭제할 수 있습니다.
| 작업 | 설명 |
|---|---|
| 삭제 | 디바이스에서 현재 애플리케이션을 삭제합니다. |
| 배포 | 애플리케이션을 디바이스에 로드합니다. |
| set-deployment-timeout | 배포 제한 시간을 초 단위로 설정합니다. |
| show-deployment-timeout | 배포 시간 제한 기간을 초 단위로 표시합니다. |
, , stop및 show-statusshow-quota 에 대한 start매개 변수가 azsphere device app 명령으로 이동되었습니다.
sideload delete
디바이스에서 애플리케이션을 삭제합니다.
이 명령은 appDevelopment 디바이스 기능이 구성된 경우에만 사용할 수 있습니다.
선택적 매개 변수
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| -i, --component-id | Guid | 디바이스에서 삭제할 애플리케이션의 ID를 지정합니다. 생략하면 모든 애플리케이션이 삭제됩니다. |
| -d, --device | 문자열 | 여러 디바이스가 연결되면 명령을 실행할 디바이스를 지정합니다. 이 매개 변수는 여러 디바이스가 연결된 경우에 필요합니다. 현재 연결된 디바이스는 기본적으로 사용됩니다. 연결된 디바이스의 디바이스 ID, IP 주소 또는 로컬 연결 ID를 지정할 수 있습니다. Azure Sphere CLI는 Windows에서 여러 MT3620 디바이스를 지원하지만 Linux에서 한 번에 하나의 디바이스만 연결할 수 있습니다. 이러한 이유로 이 매개 변수는 Windows에서 지원되지만 Linux에서는 지원되지 않습니다. Linux의 명령과 함께 이 매개 변수를 사용하는 경우 오류가 반환됩니다. |
전역 매개 변수
Azure Sphere CLI에 사용할 수 있는 전역 매개 변수는 다음과 같습니다.
| 매개 변수 | 설명 |
|---|---|
| --디버그 | 모든 디버그 로그를 표시하도록 로깅 세부 정보를 늘립니다. 버그가 발견되면 버그 보고서를 제출할 때 플래그가 --debug 켜진 상태에서 생성된 출력을 제공합니다. |
| -h, --help | 명령 및 해당 인수에 대한 CLI 참조 정보를 인쇄하고 사용 가능한 하위 그룹 및 명령을 나열합니다. |
| --only-show-errors | 오류만 표시하고 경고를 표시하지 않습니다. |
| -o, --output | 출력 형식을 변경합니다. 사용 가능한 출력 형식은 json, jsonc(색이 지정된 JSON), tsv(탭으로 구분된 값), 테이블(사람이 읽을 수 있는 ASCII 테이블) 및 yaml입니다. 기본적으로 CLI는 를 출력합니다 table. 사용 가능한 출력 형식에 대한 자세한 내용은 Azure Sphere CLI 명령에 대한 출력 형식을 참조하세요. |
| --쿼리 | JMESPath 쿼리 언어를 사용하여 Azure Sphere Security Services에서 반환된 출력을 필터링합니다. 자세한 내용 및 예제 는 JMESPath 자습서 및 Azure CLI 명령 출력 쿼리 를 참조하세요. |
| --자세한 | 작업 중에 Azure Sphere에서 만든 리소스에 대한 정보 및 기타 유용한 정보를 출력합니다. 전체 디버그 로그에 사용합니다 --debug . |
참고
Azure Sphere 클래식 CLI를 사용하는 경우 사용 가능한 옵션에 대한 자세한 내용은 전역 매개 변수 를 참조하세요.
예제
azsphere device sideload delete
Component '54acba7c-7719-461a-89db-49c807e0fa4d' deleted.
sideload deploy
연결된 디바이스에 애플리케이션을 로드하고 애플리케이션을 시작합니다.
애플리케이션 매니페스트가 이미 디바이스에 있는 애플리케이션에서 사용 중인 리소스를 요청하면 이 명령이 실패합니다. 이 경우 azsphere device sideload delete 를 사용하여 기존 애플리케이션을 삭제한 다음 사이드로드를 다시 시도합니다. azsphere device sideload delete 명령은 상위 수준 애플리케이션과 실시간 애플리케이션을 모두 삭제합니다. 한 애플리케이션을 삭제하고 다른 애플리케이션을 그대로 두려면 삭제할 애플리케이션의 구성 요소 ID를 지정합니다.
동일한 명령은 상위 수준 애플리케이션과 실시간 지원 애플리케이션을 모두 배포하는 데 사용됩니다.
참고
주변 장치를 사용하는 새 애플리케이션이 설치되고 다음 조건이 충족되면 디바이스 재부팅이 트리거됩니다.
- 디바이스의 제조 상태가 DeviceComplete로 설정됩니다.
- appDevelopment 기능은 디바이스에 없습니다. 자세한 내용은 주변 장치 구성 잠금을 참조하세요.
디바이스 다시 부팅이 시작되면 다시 부팅이 완료되고 디바이스가 응답할 때까지 기다립니다.
필수 매개 변수
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| -p, --image-package | 문자열 | 디바이스에 로드할 이미지 패키지의 경로와 파일 이름을 지정합니다. |
선택적 매개 변수
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| -d, --device | 문자열 | 여러 디바이스가 연결되면 명령을 실행할 디바이스를 지정합니다. 이 매개 변수는 여러 디바이스가 연결된 경우에 필요합니다. 현재 연결된 디바이스는 기본적으로 사용됩니다. 연결된 디바이스의 디바이스 ID, IP 주소 또는 로컬 연결 ID를 지정할 수 있습니다. Azure Sphere CLI는 Windows에서 여러 MT3620 디바이스를 지원하지만 Linux에서 한 번에 하나의 디바이스만 연결할 수 있습니다. 이러한 이유로 이 매개 변수는 Windows에서 지원되지만 Linux에서는 지원되지 않습니다. Linux의 명령과 함께 이 매개 변수를 사용하는 경우 오류가 반환됩니다. |
| -m, --manual-start | 부울 | 애플리케이션을 로드한 후 자동으로 시작하지 않도록 지정합니다. |
| --강제로 | 부울 | 더 이상 지원되지 않을 수 있는 베타 API를 사용하는 이미지의 배포를 강제합니다. |
전역 매개 변수
Azure Sphere CLI에 사용할 수 있는 전역 매개 변수는 다음과 같습니다.
| 매개 변수 | 설명 |
|---|---|
| --디버그 | 모든 디버그 로그를 표시하도록 로깅 세부 정보를 늘립니다. 버그가 발견되면 버그 보고서를 제출할 때 플래그가 --debug 켜진 상태에서 생성된 출력을 제공합니다. |
| -h, --help | 명령 및 해당 인수에 대한 CLI 참조 정보를 인쇄하고 사용 가능한 하위 그룹 및 명령을 나열합니다. |
| --only-show-errors | 오류만 표시하고 경고를 표시하지 않습니다. |
| -o, --output | 출력 형식을 변경합니다. 사용 가능한 출력 형식은 json, jsonc(색이 지정된 JSON), tsv(탭으로 구분된 값), 테이블(사람이 읽을 수 있는 ASCII 테이블) 및 yaml입니다. 기본적으로 CLI는 를 출력합니다 table. 사용 가능한 출력 형식에 대한 자세한 내용은 Azure Sphere CLI 명령에 대한 출력 형식을 참조하세요. |
| --쿼리 | JMESPath 쿼리 언어를 사용하여 Azure Sphere Security Services에서 반환된 출력을 필터링합니다. 자세한 내용 및 예제 는 JMESPath 자습서 및 Azure CLI 명령 출력 쿼리 를 참조하세요. |
| --자세한 | 작업 중에 Azure Sphere에서 만든 리소스에 대한 정보 및 기타 유용한 정보를 출력합니다. 전체 디버그 로그에 사용합니다 --debug . |
참고
Azure Sphere 클래식 CLI를 사용하는 경우 사용 가능한 옵션에 대한 자세한 내용은 전역 매개 변수 를 참조하세요.
예제
azsphere device sideload deploy --image-package C:\Users\LocalSamples\HelloWorld\HelloWorld_HighLevelApp\out\ARM-Debug\HelloWorld_HighLevelApp.imagepackage
Deploying 'C:\Users\LocalSamples\HelloWorld\HelloWorld_HighLevelApp\out\ARM-Debug\HelloWorld_HighLevelApp.imagepackage' to the attached device.
Image package 'C:\Users\LocalSamples\HelloWorld\HelloWorld_HighLevelApp\out\ARM-Debug\HelloWorld_HighLevelApp.imagepackage' has been deployed to the attached device.
sideload set-deployment-timeout
디바이스에서 이미지를 테스트용으로 로드하기 위한 배포 제한 시간 값을 초 단위로 설정합니다.
필수 매개 변수
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| -v, --value | 정수 | 사이드로드 명령 시간이 초과되기 전까지의 기간을 초 단위로 지정합니다. 값은 양의 정수여야 합니다. |
전역 매개 변수
Azure Sphere CLI에 사용할 수 있는 전역 매개 변수는 다음과 같습니다.
| 매개 변수 | 설명 |
|---|---|
| --디버그 | 모든 디버그 로그를 표시하도록 로깅 세부 정보를 늘립니다. 버그가 발견되면 버그 보고서를 제출할 때 플래그가 --debug 켜진 상태에서 생성된 출력을 제공합니다. |
| -h, --help | 명령 및 해당 인수에 대한 CLI 참조 정보를 인쇄하고 사용 가능한 하위 그룹 및 명령을 나열합니다. |
| --only-show-errors | 오류만 표시하고 경고를 표시하지 않습니다. |
| -o, --output | 출력 형식을 변경합니다. 사용 가능한 출력 형식은 json, jsonc(색이 지정된 JSON), tsv(탭으로 구분된 값), 테이블(사람이 읽을 수 있는 ASCII 테이블) 및 yaml입니다. 기본적으로 CLI는 를 출력합니다 table. 사용 가능한 출력 형식에 대한 자세한 내용은 Azure Sphere CLI 명령에 대한 출력 형식을 참조하세요. |
| --쿼리 | JMESPath 쿼리 언어를 사용하여 Azure Sphere Security Services에서 반환된 출력을 필터링합니다. 자세한 내용 및 예제 는 JMESPath 자습서 및 Azure CLI 명령 출력 쿼리 를 참조하세요. |
| --자세한 | 작업 중에 Azure Sphere에서 만든 리소스에 대한 정보 및 기타 유용한 정보를 출력합니다. 전체 디버그 로그에 사용합니다 --debug . |
참고
Azure Sphere 클래식 CLI를 사용하는 경우 사용 가능한 옵션에 대한 자세한 내용은 전역 매개 변수 를 참조하세요.
예제
azsphere device sideload set-deployment-timeout --value 60
------------------
Deployment timeout
==================
60
------------------
sideload show-deployment-timeout
디바이스에서 이미지를 테스트용으로 로드하기 위한 현재 배포 제한 시간 값을 초 단위로 표시합니다.
전역 매개 변수
Azure Sphere CLI에 사용할 수 있는 전역 매개 변수는 다음과 같습니다.
| 매개 변수 | 설명 |
|---|---|
| --디버그 | 모든 디버그 로그를 표시하도록 로깅 세부 정보를 늘립니다. 버그가 발견되면 버그 보고서를 제출할 때 플래그가 --debug 켜진 상태에서 생성된 출력을 제공합니다. |
| -h, --help | 명령 및 해당 인수에 대한 CLI 참조 정보를 인쇄하고 사용 가능한 하위 그룹 및 명령을 나열합니다. |
| --only-show-errors | 오류만 표시하고 경고를 표시하지 않습니다. |
| -o, --output | 출력 형식을 변경합니다. 사용 가능한 출력 형식은 json, jsonc(색이 지정된 JSON), tsv(탭으로 구분된 값), 테이블(사람이 읽을 수 있는 ASCII 테이블) 및 yaml입니다. 기본적으로 CLI는 를 출력합니다 table. 사용 가능한 출력 형식에 대한 자세한 내용은 Azure Sphere CLI 명령에 대한 출력 형식을 참조하세요. |
| --쿼리 | JMESPath 쿼리 언어를 사용하여 Azure Sphere Security Services에서 반환된 출력을 필터링합니다. 자세한 내용 및 예제 는 JMESPath 자습서 및 Azure CLI 명령 출력 쿼리 를 참조하세요. |
| --자세한 | 작업 중에 Azure Sphere에서 만든 리소스에 대한 정보 및 기타 유용한 정보를 출력합니다. 전체 디버그 로그에 사용합니다 --debug . |
참고
Azure Sphere 클래식 CLI를 사용하는 경우 사용 가능한 옵션에 대한 자세한 내용은 전역 매개 변수 를 참조하세요.
예제
azsphere device sideload show-deployment-timeout
------------------
Deployment timeout
==================
60
------------------
업데이트
디바이스를 Azure Sphere 테넌트에서 다른 디바이스 그룹으로 이동합니다.
제품에서 만드는 디바이스 그룹 외에도 제품을 만들 때 5개의 기본 디바이스 그룹이 추가됩니다.
- 개발: 시스템 소프트웨어 업데이트만 허용합니다. 애플리케이션 업데이트를 허용하지 않습니다.
- 필드 테스트: Azure Sphere Security Service의 모든 업데이트를 수락합니다.
- 프로덕션: Azure Sphere Security Service의 모든 업데이트를 허용합니다.
- 프로덕션 OS 평가: Azure Sphere Security Service의 모든 업데이트를 허용합니다.
- 필드 테스트 OS 평가: Azure Sphere Security Service의 모든 업데이트를 허용합니다.
배포와 관련된 기본 요소에 대한 자세한 내용은 배포 기본 사항을 참조하세요.
선택적 매개 변수
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| -g, --device-group | GUID 또는 이름 | 디바이스를 이동할 디바이스 그룹을 지정합니다. 디바이스 그룹 ID 또는 디바이스 그룹 이름을 지정할 수 있습니다. 디바이스 그룹 이름을 사용하려면 제품 이름과 디바이스 그룹 이름을 <product-name/device-group-name> 형식으로 모두 제공해야 합니다. |
| -d, --device | 문자열 | 명령을 실행할 디바이스를 지정합니다. 이 매개 변수는 여러 디바이스가 연결되거나 디바이스가 연결되지 않은 경우에 필요합니다. 현재 연결된 디바이스는 기본적으로 사용됩니다. 연결되지 않은 디바이스에 대한 디바이스 ID를 제공하거나 연결된 디바이스의 IP 주소 또는 로컬 연결 ID를 지정할 수 있습니다. Azure Sphere CLI는 Windows에서 여러 MT3620 디바이스를 지원하지만 Linux에서 한 번에 하나의 디바이스만 연결할 수 있습니다. 이러한 이유로 이 매개 변수는 Windows에서 지원되지만 Linux에서는 지원되지 않습니다. Linux의 명령과 함께 이 매개 변수를 사용하는 경우 오류가 반환됩니다. |
| -t, --tenant | GUID 또는 이름 | 이 작업을 수행할 테넌트 를 지정합니다. 선택한 기본 테넌트 를 재정의합니다. 테넌트 ID 또는 테넌트 이름을 지정할 수 있습니다. |
전역 매개 변수
Azure Sphere CLI에 사용할 수 있는 전역 매개 변수는 다음과 같습니다.
| 매개 변수 | 설명 |
|---|---|
| --디버그 | 모든 디버그 로그를 표시하도록 로깅 세부 정보를 늘립니다. 버그가 발견되면 버그 보고서를 제출할 때 플래그가 --debug 켜진 상태에서 생성된 출력을 제공합니다. |
| -h, --help | 명령 및 해당 인수에 대한 CLI 참조 정보를 인쇄하고 사용 가능한 하위 그룹 및 명령을 나열합니다. |
| --only-show-errors | 오류만 표시하고 경고를 표시하지 않습니다. |
| -o, --output | 출력 형식을 변경합니다. 사용 가능한 출력 형식은 json, jsonc(색이 지정된 JSON), tsv(탭으로 구분된 값), 테이블(사람이 읽을 수 있는 ASCII 테이블) 및 yaml입니다. 기본적으로 CLI는 를 출력합니다 table. 사용 가능한 출력 형식에 대한 자세한 내용은 Azure Sphere CLI 명령에 대한 출력 형식을 참조하세요. |
| --쿼리 | JMESPath 쿼리 언어를 사용하여 Azure Sphere Security Services에서 반환된 출력을 필터링합니다. 자세한 내용 및 예제 는 JMESPath 자습서 및 Azure CLI 명령 출력 쿼리 를 참조하세요. |
| --자세한 | 작업 중에 Azure Sphere에서 만든 리소스에 대한 정보 및 기타 유용한 정보를 출력합니다. 전체 디버그 로그에 사용합니다 --debug . |
참고
Azure Sphere 클래식 CLI를 사용하는 경우 사용 가능한 옵션에 대한 자세한 내용은 전역 매개 변수 를 참조하세요.
예제
azsphere device update --device-group AW100/Marketing
------------------------------------------------------------------------------------------------------ ------------------------------------ -------- ------------------------------------ ------------------------------------
DeviceId TenantId ChipSku ProductId DeviceGroupId
==============================================================================================================================================================================================================================
352FE1F59E40EF8A9266415E81AF32B5B07D8F2BBD6B5650CEF4A70B86C7FCBC70B129A41FBC6D02F8BB4AAABC52CD5740C85 a323c263-2aa3-2559-aabb-a3fc32631900 MT3620AN 6f52bead-700d-4289-bdc2-2f11f774270e 7f860cc1-4949-4000-a541-9a988ba4c3cd
427D205E46A166B7E41135EB968
------------------------------------------------------------------------------------------------------ ------------------------------------ -------- ------------------------------------ ------------------------------------
매개 변수를 --query 사용하여 이 명령에 대해 표시되는 출력을 사용자 지정할 수 있습니다. 자세한 내용은 쿼리 CLI 명령 출력을 참조하세요.
다음 예제에서는 디바이스 ID 및 제품 ID만 선택하는 방법을 보여줍니다.
azsphere device update --device-group AW100/Marketing --query '{DeviceId:deviceId, ProductId:productId}'
-------------------------------------------------------------------------------------------------------------------------------- ------------------------------------
DeviceId ProductId
=====================================================================================================================================================================
352FE1F59E40EF8A9266415E81AF32B5B07D8F2BBD6B5650CEF4A70B86C7FCBC70B129A41FBC6D02F8BB4AAABC52CD5740C85427D205E46A166B7E41135EB968 6f52bead-700d-4289-bdc2-2f11f774270e
-------------------------------------------------------------------------------------------------------------------------------- ------------------------------------
Wifi
연결된 디바이스에 대한 Wi-Fi 구성을 관리합니다.
Wi-Fi 네트워크에서 디바이스를 사용하려면 네트워크에 대한 정보를 추가하고 디바이스에서 네트워크를 사용하도록 설정해야 합니다. SSID에서 ASCII가 아닌 문자를 입력할 수 있지만 azsphere 는 해당 문자를 제대로 표시하지 않습니다.
애플리케이션에서 Wi-Fi 구성 API를 사용하는 경우 애플리케이션의 app_manifest.json 파일에 WifiConfig 기능도 포함해야 합니다.
| 작업 | 설명 |
|---|---|
| 추가 | 무선 네트워크의 세부 정보를 디바이스에 추가합니다. |
| 비활성화 | 디바이스에서 무선 네트워크를 사용하지 않도록 설정합니다. |
| 사용 | 디바이스에서 무선 네트워크를 사용하도록 설정합니다. |
| 잊지 | 디바이스에서 무선 네트워크의 세부 정보를 제거합니다. |
| 목록 | 디바이스에 대한 현재 Wi-Fi 구성을 Lists. |
| reload-config | 디바이스 Wi-Fi 구성을 다시 로드합니다. |
| 스캔 | 사용 가능한 네트워크를 검색합니다. |
| 표시 | Wi-Fi 구성의 세부 정보를 표시합니다. |
| show-상태 | 무선 인터페이스의 상태 표시합니다. |
wifi 추가
연결된 디바이스에 Wi-Fi 네트워크의 세부 정보를 추가합니다.
디바이스에는 여러 Wi-Fi 연결이 있을 수 있습니다. SSID에서 ASCII가 아닌 문자를 입력할 수 있지만 azsphere 는 해당 문자를 제대로 표시하지 않습니다.
숨겨진 SSID에 --targeted-scan 연결하는 매개 변수를 포함할 수 있습니다. 자세한 내용은 Azure Sphere를 Wi-Fi에 연결을 참조하세요.
필수 매개 변수
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| -s, --ssid | 문자열 | 네트워크의 SSID를 지정합니다. 네트워크 SSID는 대/소문자를 구분합니다. |
선택적 매개 변수
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| --client-cert-id | 문자열 | [EAP-TLS] 클라이언트 인증서를 식별하는 식별자(최대 16자)를 지정합니다(퍼블릭 키와 프라이빗 키를 모두 포함). EAP-TLS 네트워크를 설정하는 데 필요합니다. |
| --client-id <user@domain> | 문자열 | [EAP-TLS] 네트워크의 RADIUS 서버에서 인증을 위해 인식되는 ID를 지정합니다. 일부 EAP-TLS 네트워크에 필요합니다. |
| --config-name | 문자열 | 네트워크 구성의 이름을 지정하는 문자열(최대 16자)을 지정합니다. |
| -d, --device | 문자열 | 여러 디바이스가 연결되면 명령을 실행할 디바이스를 지정합니다. 이 매개 변수는 여러 디바이스가 연결된 경우에 필요합니다. 현재 연결된 디바이스는 기본적으로 사용됩니다. 연결된 디바이스의 디바이스 ID, IP 주소 또는 로컬 연결 ID를 지정할 수 있습니다. Azure Sphere CLI는 Windows에서 여러 MT3620 디바이스를 지원하지만 Linux에서 한 번에 하나의 디바이스만 연결할 수 있습니다. 이러한 이유로 이 매개 변수는 Windows에서 지원되지만 Linux에서는 지원되지 않습니다. Linux의 명령과 함께 이 매개 변수를 사용하는 경우 오류가 반환됩니다. |
| --root-ca-cert-id | 문자열 | [EAP-tLS] 디바이스가 서버를 인증하는 EAP-TLS 네트워크에 대한 서버의 루트 CA 인증서를 식별하는 식별자(최대 16자)를 지정합니다. |
| --targeted-scan | 부울 | 브로드캐스트하지 않거나 네트워크 정체로 인해 숨겨져 있는 경우에도 네트워크에 연결하려고 시도합니다. |
| -p, --psk | 문자열 | 새 네트워크에 대한 WPA/WPA2 키를 지정합니다. SSID를 열린 네트워크로 추가하려면 생략합니다. 키에 앰퍼샌드(&)가 포함된 경우 키를 따옴표로 묶습니다. |
전역 매개 변수
Azure Sphere CLI에 사용할 수 있는 전역 매개 변수는 다음과 같습니다.
| 매개 변수 | 설명 |
|---|---|
| --디버그 | 모든 디버그 로그를 표시하도록 로깅 세부 정보를 늘립니다. 버그가 발견되면 버그 보고서를 제출할 때 플래그가 --debug 켜진 상태에서 생성된 출력을 제공합니다. |
| -h, --help | 명령 및 해당 인수에 대한 CLI 참조 정보를 인쇄하고 사용 가능한 하위 그룹 및 명령을 나열합니다. |
| --only-show-errors | 오류만 표시하고 경고를 표시하지 않습니다. |
| -o, --output | 출력 형식을 변경합니다. 사용 가능한 출력 형식은 json, jsonc(색이 지정된 JSON), tsv(탭으로 구분된 값), 테이블(사람이 읽을 수 있는 ASCII 테이블) 및 yaml입니다. 기본적으로 CLI는 를 출력합니다 table. 사용 가능한 출력 형식에 대한 자세한 내용은 Azure Sphere CLI 명령에 대한 출력 형식을 참조하세요. |
| --쿼리 | JMESPath 쿼리 언어를 사용하여 Azure Sphere Security Services에서 반환된 출력을 필터링합니다. 자세한 내용 및 예제 는 JMESPath 자습서 및 Azure CLI 명령 출력 쿼리 를 참조하세요. |
| --자세한 | 작업 중에 Azure Sphere에서 만든 리소스에 대한 정보 및 기타 유용한 정보를 출력합니다. 전체 디버그 로그에 사용합니다 --debug . |
참고
Azure Sphere 클래식 CLI를 사용하는 경우 사용 가능한 옵션에 대한 자세한 내용은 전역 매개 변수 를 참조하세요.
예제
azsphere device wifi add --ssid MyNetwork --psk MyPassword
Successfully added network:
----- -------- ------------------ --------------- ------------- ------------
ID SSID ConfigurationState ConnectionState SecurityState TargetedScan
============================================================================
1 MyNetwork enabled unknown psk False
----- -------- ------------------ --------------- ------------- ------------
네트워크 SSID 또는 키에 포함된 공백 또는 앰퍼샌드가 있는 경우 SSID 또는 키를 작은따옴표로 묶습니다. SSID 또는 키에 따옴표가 포함된 경우 백슬래시를 사용하여 따옴표를 이스케이프합니다. 백슬라이쉬는 값의 일부인 경우 이스케이프할 필요가 없습니다. 자세한 내용은 따옴표 및 이스케이프 문자를 참조하세요. 예를 들어:
azsphere device wifi add --ssid "New SSID" --psk "key \'value\' with quotes"
wifi 사용 안 함
연결된 디바이스에서 Wi-Fi 네트워크를 사용하지 않도록 설정합니다.
필수 매개 변수
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| -i, --id | 정수 | 사용하지 않도록 설정할 네트워크의 ID를 지정합니다. |
선택적 매개 변수
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| -d, --device | 문자열 | 여러 디바이스가 연결되면 명령을 실행할 디바이스를 지정합니다. 이 매개 변수는 여러 디바이스가 연결된 경우에 필요합니다. 현재 연결된 디바이스는 기본적으로 사용됩니다. 연결된 디바이스의 디바이스 ID, IP 주소 또는 로컬 연결 ID를 지정할 수 있습니다. Azure Sphere CLI는 Windows에서 여러 MT3620 디바이스를 지원하지만 Linux에서 한 번에 하나의 디바이스만 연결할 수 있습니다. 이러한 이유로 이 매개 변수는 Windows에서 지원되지만 Linux에서는 지원되지 않습니다. Linux의 명령과 함께 이 매개 변수를 사용하는 경우 오류가 반환됩니다. |
전역 매개 변수
Azure Sphere CLI에 사용할 수 있는 전역 매개 변수는 다음과 같습니다.
| 매개 변수 | 설명 |
|---|---|
| --디버그 | 모든 디버그 로그를 표시하도록 로깅 세부 정보를 늘립니다. 버그가 발견되면 버그 보고서를 제출할 때 플래그가 --debug 켜진 상태에서 생성된 출력을 제공합니다. |
| -h, --help | 명령 및 해당 인수에 대한 CLI 참조 정보를 인쇄하고 사용 가능한 하위 그룹 및 명령을 나열합니다. |
| --only-show-errors | 오류만 표시하고 경고를 표시하지 않습니다. |
| -o, --output | 출력 형식을 변경합니다. 사용 가능한 출력 형식은 json, jsonc(색이 지정된 JSON), tsv(탭으로 구분된 값), 테이블(사람이 읽을 수 있는 ASCII 테이블) 및 yaml입니다. 기본적으로 CLI는 를 출력합니다 table. 사용 가능한 출력 형식에 대한 자세한 내용은 Azure Sphere CLI 명령에 대한 출력 형식을 참조하세요. |
| --쿼리 | JMESPath 쿼리 언어를 사용하여 Azure Sphere Security Services에서 반환된 출력을 필터링합니다. 자세한 내용 및 예제 는 JMESPath 자습서 및 Azure CLI 명령 출력 쿼리 를 참조하세요. |
| --자세한 | 작업 중에 Azure Sphere에서 만든 리소스에 대한 정보 및 기타 유용한 정보를 출력합니다. 전체 디버그 로그에 사용합니다 --debug . |
참고
Azure Sphere 클래식 CLI를 사용하는 경우 사용 가능한 옵션에 대한 자세한 내용은 전역 매개 변수 를 참조하세요.
예제
azsphere device wifi disable --id 0
Successfully disabled network:
----- -------- ------------------ --------------- ------------- ------------
ID SSID ConfigurationState ConnectionState SecurityState TargetedScan
============================================================================
0 MyNetwork disabled disconnected psk False
----- -------- ------------------ --------------- ------------- ------------
wifi 사용
연결된 디바이스에서 Wi-Fi 네트워크를 사용하도록 설정합니다.
둘 다 범위 내에 있는 경우 한 네트워크에서 다른 네트워크로 변경하려면 새 네트워크를 사용하도록 설정하기 전에 현재 연결된 네트워크를 사용하지 않도록 설정합니다.
필수 매개 변수
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| -i, --id | 정수 | 사용하도록 설정할 네트워크의 ID를 지정합니다. |
선택적 매개 변수
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| -d, --device | 문자열 | 여러 디바이스가 연결되면 명령을 실행할 디바이스를 지정합니다. 이 매개 변수는 여러 디바이스가 연결된 경우에 필요합니다. 현재 연결된 디바이스는 기본적으로 사용됩니다. 연결된 디바이스의 디바이스 ID, IP 주소 또는 로컬 연결 ID를 지정할 수 있습니다. Azure Sphere CLI는 Windows에서 여러 MT3620 디바이스를 지원하지만 Linux에서 한 번에 하나의 디바이스만 연결할 수 있습니다. 이러한 이유로 이 매개 변수는 Windows에서 지원되지만 Linux에서는 지원되지 않습니다. Linux의 명령과 함께 이 매개 변수를 사용하는 경우 오류가 반환됩니다. |
전역 매개 변수
Azure Sphere CLI에 사용할 수 있는 전역 매개 변수는 다음과 같습니다.
| 매개 변수 | 설명 |
|---|---|
| --디버그 | 모든 디버그 로그를 표시하도록 로깅 세부 정보를 늘립니다. 버그가 발견되면 버그 보고서를 제출할 때 플래그가 --debug 켜진 상태에서 생성된 출력을 제공합니다. |
| -h, --help | 명령 및 해당 인수에 대한 CLI 참조 정보를 인쇄하고 사용 가능한 하위 그룹 및 명령을 나열합니다. |
| --only-show-errors | 오류만 표시하고 경고를 표시하지 않습니다. |
| -o, --output | 출력 형식을 변경합니다. 사용 가능한 출력 형식은 json, jsonc(색이 지정된 JSON), tsv(탭으로 구분된 값), 테이블(사람이 읽을 수 있는 ASCII 테이블) 및 yaml입니다. 기본적으로 CLI는 를 출력합니다 table. 사용 가능한 출력 형식에 대한 자세한 내용은 Azure Sphere CLI 명령에 대한 출력 형식을 참조하세요. |
| --쿼리 | JMESPath 쿼리 언어를 사용하여 Azure Sphere Security Services에서 반환된 출력을 필터링합니다. 자세한 내용 및 예제 는 JMESPath 자습서 및 Azure CLI 명령 출력 쿼리 를 참조하세요. |
| --자세한 | 작업 중에 Azure Sphere에서 만든 리소스에 대한 정보 및 기타 유용한 정보를 출력합니다. 전체 디버그 로그에 사용합니다 --debug . |
참고
Azure Sphere 클래식 CLI를 사용하는 경우 사용 가능한 옵션에 대한 자세한 내용은 전역 매개 변수 를 참조하세요.
예제
azsphere device wifi enable --id 0
Successfully enabled network:
----- -------- ------------------ --------------- ------------- ------------
ID SSID ConfigurationState ConnectionState SecurityState TargetedScan
============================================================================
0 MyNetwork enabled disconnected psk False
----- -------- ------------------ --------------- ------------- ------------
wifi forget
연결된 디바이스에서 Wi-Fi 네트워크의 세부 정보를 제거합니다.
필수 매개 변수
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| -i, --id | 정수 | 삭제할 네트워크의 ID를 지정합니다. |
선택적 매개 변수
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| -d, --device | 문자열 | 여러 디바이스가 연결되면 명령을 실행할 디바이스를 지정합니다. 이 매개 변수는 여러 디바이스가 연결된 경우에 필요합니다. 현재 연결된 디바이스는 기본적으로 사용됩니다. 연결된 디바이스의 디바이스 ID, IP 주소 또는 로컬 연결 ID를 지정할 수 있습니다. Azure Sphere CLI는 Windows에서 여러 MT3620 디바이스를 지원하지만 Linux에서 한 번에 하나의 디바이스만 연결할 수 있습니다. 이러한 이유로 이 매개 변수는 Windows에서 지원되지만 Linux에서는 지원되지 않습니다. Linux의 명령과 함께 이 매개 변수를 사용하는 경우 오류가 반환됩니다. |
전역 매개 변수
Azure Sphere CLI에 사용할 수 있는 전역 매개 변수는 다음과 같습니다.
| 매개 변수 | 설명 |
|---|---|
| --디버그 | 모든 디버그 로그를 표시하도록 로깅 세부 정보를 늘립니다. 버그가 발견되면 버그 보고서를 제출할 때 플래그가 --debug 켜진 상태에서 생성된 출력을 제공합니다. |
| -h, --help | 명령 및 해당 인수에 대한 CLI 참조 정보를 인쇄하고 사용 가능한 하위 그룹 및 명령을 나열합니다. |
| --only-show-errors | 오류만 표시하고 경고를 표시하지 않습니다. |
| -o, --output | 출력 형식을 변경합니다. 사용 가능한 출력 형식은 json, jsonc(색이 지정된 JSON), tsv(탭으로 구분된 값), 테이블(사람이 읽을 수 있는 ASCII 테이블) 및 yaml입니다. 기본적으로 CLI는 를 출력합니다 table. 사용 가능한 출력 형식에 대한 자세한 내용은 Azure Sphere CLI 명령에 대한 출력 형식을 참조하세요. |
| --쿼리 | JMESPath 쿼리 언어를 사용하여 Azure Sphere Security Services에서 반환된 출력을 필터링합니다. 자세한 내용 및 예제 는 JMESPath 자습서 및 Azure CLI 명령 출력 쿼리 를 참조하세요. |
| --자세한 | 작업 중에 Azure Sphere에서 만든 리소스에 대한 정보 및 기타 유용한 정보를 출력합니다. 전체 디버그 로그에 사용합니다 --debug . |
참고
Azure Sphere 클래식 CLI를 사용하는 경우 사용 가능한 옵션에 대한 자세한 내용은 전역 매개 변수 를 참조하세요.
예제
azsphere device wifi forget --id 0
Successfully forgotten network.
wifi 목록
연결된 디바이스에 대한 현재 Wi-Fi 구성을 Lists.
선택적 매개 변수
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| -d, --device | 문자열 | 여러 디바이스가 연결되면 명령을 실행할 디바이스를 지정합니다. 이 매개 변수는 여러 디바이스가 연결된 경우에 필요합니다. 현재 연결된 디바이스는 기본적으로 사용됩니다. 연결된 디바이스의 디바이스 ID, IP 주소 또는 로컬 연결 ID를 지정할 수 있습니다. Azure Sphere CLI는 Windows에서 여러 MT3620 디바이스를 지원하지만 Linux에서 한 번에 하나의 디바이스만 연결할 수 있습니다. 이러한 이유로 이 매개 변수는 Windows에서 지원되지만 Linux에서는 지원되지 않습니다. Linux의 명령과 함께 이 매개 변수를 사용하는 경우 오류가 반환됩니다. |
전역 매개 변수
Azure Sphere CLI에 사용할 수 있는 전역 매개 변수는 다음과 같습니다.
| 매개 변수 | 설명 |
|---|---|
| --디버그 | 모든 디버그 로그를 표시하도록 로깅 세부 정보를 늘립니다. 버그가 발견되면 버그 보고서를 제출할 때 플래그가 --debug 켜진 상태에서 생성된 출력을 제공합니다. |
| -h, --help | 명령 및 해당 인수에 대한 CLI 참조 정보를 인쇄하고 사용 가능한 하위 그룹 및 명령을 나열합니다. |
| --only-show-errors | 오류만 표시하고 경고를 표시하지 않습니다. |
| -o, --output | 출력 형식을 변경합니다. 사용 가능한 출력 형식은 json, jsonc(색이 지정된 JSON), tsv(탭으로 구분된 값), 테이블(사람이 읽을 수 있는 ASCII 테이블) 및 yaml입니다. 기본적으로 CLI는 를 출력합니다 table. 사용 가능한 출력 형식에 대한 자세한 내용은 Azure Sphere CLI 명령에 대한 출력 형식을 참조하세요. |
| --쿼리 | JMESPath 쿼리 언어를 사용하여 Azure Sphere Security Services에서 반환된 출력을 필터링합니다. 자세한 내용 및 예제 는 JMESPath 자습서 및 Azure CLI 명령 출력 쿼리 를 참조하세요. |
| --자세한 | 작업 중에 Azure Sphere에서 만든 리소스에 대한 정보 및 기타 유용한 정보를 출력합니다. 전체 디버그 로그에 사용합니다 --debug . |
참고
Azure Sphere 클래식 CLI를 사용하는 경우 사용 가능한 옵션에 대한 자세한 내용은 전역 매개 변수 를 참조하세요.
예제
azsphere device wifi list
----- --------- ------------------ --------------- ------------- ------------
ID SSID ConfigurationState ConnectionState SecurityState TargetedScan
=============================================================================
0 MyNetwork1 enabled connected psk False
----- --------- ------------------ --------------- ------------- ------------
1 MyNetwork2 enabled disconnected psk False
----- --------- ------------------ --------------- ------------- ------------
2 MyNetwork3 enabled disconnected eaptls False
----- --------- ------------------ --------------- ------------- ------------
wifi reload-config
연결된 디바이스에서 Wi-Fi 네트워크 구성을 다시 로드합니다. 인증서(azsphere device certificate)를 추가하거나 제거한 후 이 명령을 사용하여 EAP-TLS 네트워크에서 인증서 저장소의 최신 콘텐츠를 사용하도록 합니다.
선택적 매개 변수
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| -d, --device | 문자열 | 여러 디바이스가 연결되면 명령을 실행할 디바이스를 지정합니다. 이 매개 변수는 여러 디바이스가 연결된 경우에 필요합니다. 현재 연결된 디바이스는 기본적으로 사용됩니다. 연결된 디바이스의 디바이스 ID, IP 주소 또는 로컬 연결 ID를 지정할 수 있습니다. Azure Sphere CLI는 Windows에서 여러 MT3620 디바이스를 지원하지만 Linux에서 한 번에 하나의 디바이스만 연결할 수 있습니다. 이러한 이유로 이 매개 변수는 Windows에서 지원되지만 Linux에서는 지원되지 않습니다. Linux의 명령과 함께 이 매개 변수를 사용하는 경우 오류가 반환됩니다. |
전역 매개 변수
Azure Sphere CLI에 사용할 수 있는 전역 매개 변수는 다음과 같습니다.
| 매개 변수 | 설명 |
|---|---|
| --디버그 | 모든 디버그 로그를 표시하도록 로깅 세부 정보를 늘립니다. 버그가 발견되면 버그 보고서를 제출할 때 플래그가 --debug 켜진 상태에서 생성된 출력을 제공합니다. |
| -h, --help | 명령 및 해당 인수에 대한 CLI 참조 정보를 인쇄하고 사용 가능한 하위 그룹 및 명령을 나열합니다. |
| --only-show-errors | 오류만 표시하고 경고를 표시하지 않습니다. |
| -o, --output | 출력 형식을 변경합니다. 사용 가능한 출력 형식은 json, jsonc(색이 지정된 JSON), tsv(탭으로 구분된 값), 테이블(사람이 읽을 수 있는 ASCII 테이블) 및 yaml입니다. 기본적으로 CLI는 를 출력합니다 table. 사용 가능한 출력 형식에 대한 자세한 내용은 Azure Sphere CLI 명령에 대한 출력 형식을 참조하세요. |
| --쿼리 | JMESPath 쿼리 언어를 사용하여 Azure Sphere Security Services에서 반환된 출력을 필터링합니다. 자세한 내용 및 예제 는 JMESPath 자습서 및 Azure CLI 명령 출력 쿼리 를 참조하세요. |
| --자세한 | 작업 중에 Azure Sphere에서 만든 리소스에 대한 정보 및 기타 유용한 정보를 출력합니다. 전체 디버그 로그에 사용합니다 --debug . |
참고
Azure Sphere 클래식 CLI를 사용하는 경우 사용 가능한 옵션에 대한 자세한 내용은 전역 매개 변수 를 참조하세요.
예제
azsphere device wifi reload-config
Wi-Fi configuration was successfully reloaded.
wifi 검사
연결된 디바이스에 표시되는 사용 가능한 Wi-Fi 네트워크를 검색합니다. 이 명령은 최대 64개의 Wi-Fi 네트워크를 반환하지만 표시되는 Wi-Fi 네트워크 수는 범위 내 액세스 지점의 밀도와 같은 환경 요인에 의해 제한될 수 있습니다.
선택적 매개 변수
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| -d, --device | 문자열 | 여러 디바이스가 연결되면 명령을 실행할 디바이스를 지정합니다. 이 매개 변수는 여러 디바이스가 연결된 경우에 필요합니다. 현재 연결된 디바이스는 기본적으로 사용됩니다. 연결된 디바이스의 디바이스 ID, IP 주소 또는 로컬 연결 ID를 지정할 수 있습니다. Azure Sphere CLI는 Windows에서 여러 MT3620 디바이스를 지원하지만 Linux에서 한 번에 하나의 디바이스만 연결할 수 있습니다. 이러한 이유로 이 매개 변수는 Windows에서 지원되지만 Linux에서는 지원되지 않습니다. Linux의 명령과 함께 이 매개 변수를 사용하는 경우 오류가 반환됩니다. |
전역 매개 변수
Azure Sphere CLI에 사용할 수 있는 전역 매개 변수는 다음과 같습니다.
| 매개 변수 | 설명 |
|---|---|
| --디버그 | 모든 디버그 로그를 표시하도록 로깅 세부 정보를 늘립니다. 버그가 발견되면 버그 보고서를 제출할 때 플래그가 --debug 켜진 상태에서 생성된 출력을 제공합니다. |
| -h, --help | 명령 및 해당 인수에 대한 CLI 참조 정보를 인쇄하고 사용 가능한 하위 그룹 및 명령을 나열합니다. |
| --only-show-errors | 오류만 표시하고 경고를 표시하지 않습니다. |
| -o, --output | 출력 형식을 변경합니다. 사용 가능한 출력 형식은 json, jsonc(색이 지정된 JSON), tsv(탭으로 구분된 값), 테이블(사람이 읽을 수 있는 ASCII 테이블) 및 yaml입니다. 기본적으로 CLI는 를 출력합니다 table. 사용 가능한 출력 형식에 대한 자세한 내용은 Azure Sphere CLI 명령에 대한 출력 형식을 참조하세요. |
| --쿼리 | JMESPath 쿼리 언어를 사용하여 Azure Sphere Security Services에서 반환된 출력을 필터링합니다. 자세한 내용 및 예제 는 JMESPath 자습서 및 Azure CLI 명령 출력 쿼리 를 참조하세요. |
| --자세한 | 작업 중에 Azure Sphere에서 만든 리소스에 대한 정보 및 기타 유용한 정보를 출력합니다. 전체 디버그 로그에 사용합니다 --debug . |
참고
Azure Sphere 클래식 CLI를 사용하는 경우 사용 가능한 옵션에 대한 자세한 내용은 전역 매개 변수 를 참조하세요.
예제
azsphere device wifi scan
----------------- ------------- ----------------- ----------- ---------
SSID SecurityState BSSID SignalLevel Frequency
=======================================================================
MyNetwork0 psk <value> -66 2442
----------------- ------------- ----------------- ----------- ---------
MyNetwork1 psk <value> -75 2442
----------------- ------------- ----------------- ----------- ---------
MyNetwork2 psk <value> -86 2412
----------------- ------------- ----------------- ----------- ---------
wifi show
연결된 디바이스에서 Wi-Fi 네트워크의 세부 정보를 표시합니다.
필수 매개 변수
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| -i, --id | 정수 | 표시할 네트워크 구성의 ID를 지정합니다. |
선택적 매개 변수
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| -d, --device | 문자열 | 여러 디바이스가 연결되면 명령을 실행할 디바이스를 지정합니다. 이 매개 변수는 여러 디바이스가 연결된 경우에 필요합니다. 현재 연결된 디바이스는 기본적으로 사용됩니다. 연결된 디바이스의 디바이스 ID, IP 주소 또는 로컬 연결 ID를 지정할 수 있습니다. Azure Sphere CLI는 Windows에서 여러 MT3620 디바이스를 지원하지만 Linux에서 한 번에 하나의 디바이스만 연결할 수 있습니다. 이러한 이유로 이 매개 변수는 Windows에서 지원되지만 Linux에서는 지원되지 않습니다. Linux의 명령과 함께 이 매개 변수를 사용하는 경우 오류가 반환됩니다. |
전역 매개 변수
Azure Sphere CLI에 사용할 수 있는 전역 매개 변수는 다음과 같습니다.
| 매개 변수 | 설명 |
|---|---|
| --디버그 | 모든 디버그 로그를 표시하도록 로깅 세부 정보를 늘립니다. 버그가 발견되면 버그 보고서를 제출할 때 플래그가 --debug 켜진 상태에서 생성된 출력을 제공합니다. |
| -h, --help | 명령 및 해당 인수에 대한 CLI 참조 정보를 인쇄하고 사용 가능한 하위 그룹 및 명령을 나열합니다. |
| --only-show-errors | 오류만 표시하고 경고를 표시하지 않습니다. |
| -o, --output | 출력 형식을 변경합니다. 사용 가능한 출력 형식은 json, jsonc(색이 지정된 JSON), tsv(탭으로 구분된 값), 테이블(사람이 읽을 수 있는 ASCII 테이블) 및 yaml입니다. 기본적으로 CLI는 를 출력합니다 table. 사용 가능한 출력 형식에 대한 자세한 내용은 Azure Sphere CLI 명령에 대한 출력 형식을 참조하세요. |
| --쿼리 | JMESPath 쿼리 언어를 사용하여 Azure Sphere Security Services에서 반환된 출력을 필터링합니다. 자세한 내용 및 예제 는 JMESPath 자습서 및 Azure CLI 명령 출력 쿼리 를 참조하세요. |
| --자세한 | 작업 중에 Azure Sphere에서 만든 리소스에 대한 정보 및 기타 유용한 정보를 출력합니다. 전체 디버그 로그에 사용합니다 --debug . |
참고
Azure Sphere 클래식 CLI를 사용하는 경우 사용 가능한 옵션에 대한 자세한 내용은 전역 매개 변수 를 참조하세요.
예제
azsphere device wifi show --id 0
----- --------- ------------------ --------------- ------------- ------------
ID SSID ConfigurationState ConnectionState SecurityState TargetedScan
=============================================================================
0 MyNetwork enabled disconnected psk False
----- --------- ------------------ --------------- ------------- ------------
wifi show-상태
연결된 디바이스에서 Wi-Fi 인터페이스의 상태 표시합니다.
선택적 매개 변수
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| -d, --device | 문자열 | 여러 디바이스가 연결되면 명령을 실행할 디바이스를 지정합니다. 이 매개 변수는 여러 디바이스가 연결된 경우에 필요합니다. 현재 연결된 디바이스는 기본적으로 사용됩니다. 연결된 디바이스의 디바이스 ID, IP 주소 또는 로컬 연결 ID를 지정할 수 있습니다. Azure Sphere CLI는 Windows에서 여러 MT3620 디바이스를 지원하지만 Linux에서 한 번에 하나의 디바이스만 연결할 수 있습니다. 이러한 이유로 이 매개 변수는 Windows에서 지원되지만 Linux에서는 지원되지 않습니다. Linux의 명령과 함께 이 매개 변수를 사용하는 경우 오류가 반환됩니다. |
전역 매개 변수
Azure Sphere CLI에 사용할 수 있는 전역 매개 변수는 다음과 같습니다.
| 매개 변수 | 설명 |
|---|---|
| --디버그 | 모든 디버그 로그를 표시하도록 로깅 세부 정보를 늘립니다. 버그가 발견되면 버그 보고서를 제출할 때 플래그가 --debug 켜진 상태에서 생성된 출력을 제공합니다. |
| -h, --help | 명령 및 해당 인수에 대한 CLI 참조 정보를 인쇄하고 사용 가능한 하위 그룹 및 명령을 나열합니다. |
| --only-show-errors | 오류만 표시하고 경고를 표시하지 않습니다. |
| -o, --output | 출력 형식을 변경합니다. 사용 가능한 출력 형식은 json, jsonc(색이 지정된 JSON), tsv(탭으로 구분된 값), 테이블(사람이 읽을 수 있는 ASCII 테이블) 및 yaml입니다. 기본적으로 CLI는 를 출력합니다 table. 사용 가능한 출력 형식에 대한 자세한 내용은 Azure Sphere CLI 명령에 대한 출력 형식을 참조하세요. |
| --쿼리 | JMESPath 쿼리 언어를 사용하여 Azure Sphere Security Services에서 반환된 출력을 필터링합니다. 자세한 내용 및 예제 는 JMESPath 자습서 및 Azure CLI 명령 출력 쿼리 를 참조하세요. |
| --자세한 | 작업 중에 Azure Sphere에서 만든 리소스에 대한 정보 및 기타 유용한 정보를 출력합니다. 전체 디버그 로그에 사용합니다 --debug . |
참고
Azure Sphere 클래식 CLI를 사용하는 경우 사용 가능한 옵션에 대한 자세한 내용은 전역 매개 변수 를 참조하세요.
예제
azsphere device wifi show-status
----- ------------------ --------------- ------------- --------- ------- ------------- --------- ------------- -----------------
SSID ConfigurationState ConnectionState SecurityState Frequency Mode KeyManagement WpaState IpAddress MacAddress
================================================================================================================================
<value> enabled connected psk 2412 station WPA2-PSK COMPLETED <value> <value>
----- ------------------ --------------- ------------- --------- ------- ------------- --------- ------------- -----------------