이미지

  • 아티클

디스크에서 Azure Sphere 이미지를 관리합니다.

작업 설명
추가 새 이미지를 업로드합니다.
다운로드 이미지를 다운로드합니다.
표시 지정된 이미지에 대한 정보를 표시합니다.

추가

Azure Sphere 테넌트에서 새 이미지를 업로드합니다.

필수 매개 변수

매개 변수 형식 설명
--이미지 문자열 업로드할 이미지의 경로를 지정합니다.

선택적 매개 변수

매개 변수 형식 설명
-t, --tenant GUID 또는 이름 이 작업을 수행할 테넌트 를 지정합니다. 선택한 기본 테넌트 를 재정의합니다. 테넌트 ID 또는 테넌트 이름을 지정할 수 있습니다.
--임시 부울 이미지 패키지를 임시로 표시합니다. 이 매개 변수는 제조 프로세스 중에 사용하기 위한 것입니다.
--강제로 부울 베타 API를 사용하여 이미지를 강제로 업로드합니다.
-r, --regional-data-boundary 문자열 이 이미지의 지역 데이터 경계입니다. 허용되는 값: EU, . None 기본값은 입니다 None. 값을 지정하지 않으면 기본값이 사용됩니다. 자세한 내용은 크래시 덤프 구성 - Pivacy 고려 사항을 참조하세요.
전역 매개 변수

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 image add --image C:\sample\quickstart_steps\QuickStart-AzureSphereBlink1\QuickStart-AzureSphereBlink1\out\ARM-Debug\QuickStart-AzureSphereBlink1.imagepackage --temporary
Uploading image from file 'C:\sample\quickstart_steps\QuickStart-AzureSphereBlink1\QuickStart-AzureSphereBlink1\out\ARM-Debug\QuickStart-AzureSphereBlink1.imagepackage':
 --> Image ID:       d788fdd1-28eb-4477-9818-a4734289f2f1
 --> Component ID:   99d419ef-296d-43b0-ade1-809efe3a7aba
 --> Component name: 'QuickStart-AzureSphereBlink1'
Retaining temporary state for uploaded image.
Successfully uploaded image with ID 'd788fdd1-28eb-4477-9818-a4734289f2f1' and name 'QuickStart-AzureSphereBlink1' to component with ID '99d419ef-296d-43b0-ade1-809efe3a7aba'.

다운로드

Azure Sphere 테넌트에서 기존 이미지를 다운로드합니다.

필수 매개 변수

매개 변수 형식 설명
-i, --image 문자열 다운로드할 이미지의 ID를 지정합니다. azsphere image add 명령을 실행하여 이미지 ID를 가져옵니다.
--대상 문자열 이미지를 저장할 경로 및 파일 이름을 지정합니다. 파일 경로는 절대 경로 또는 상대 경로일 수 있습니다.

선택적 매개 변수

매개 변수 형식 설명
-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 image download --image d788fdd1-28eb-4477-9818-a4734289f2f1 --destination AzureSphereBlink1.image
Getting the image with ID 'd788fdd1-28eb-4477-9818-a4734289f2f1'.
 ---------
 Result
 =========
 Succeeded
 ---------

표시

Azure Sphere 테넌트에서 기존 이미지의 세부 정보를 표시합니다.

필수 매개 변수

매개 변수 형식 설명
-i, --image Guid 세부 정보를 가져올 이미지의 ID를 지정합니다. azsphere image add 명령을 실행하여 이미지 ID를 가져옵니다.

선택적 매개 변수

매개 변수 형식 설명
-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 image show --image d788fdd1-28eb-4477-9818-a4734289f2f1
------------------------------------ ------------------------------------ ---------------------------- ------------- ------------  ---------------------
ImageId                              ComponentId                          Name                         SigningStatus ImageType     RegionalDataBoundary
========================================================================================================================================================
d788fdd1-28eb-4477-9818-a4734289f2f1 99d419ef-296d-43b0-ade1-809efe3a7aba QuickStart-AzureSphereBlink1 Succeeded     Applications  None
------------------------------------ ------------------------------------ ---------------------------- ------------- ------------  ---------------------