product

아티클
11/05/2024

Important

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

제품을 관리합니다.

연산	설명
create	새 제품을 만듭니다.
delete	기존 제품을 삭제합니다.
device	이 제품의 디바이스를 표시합니다.
device-group	제품 디바이스 그룹을 관리합니다.
목록	Azure Sphere 테넌트에 있는 모든 제품을 나열합니다.
show	제품의 세부 정보를 표시합니다.
업데이트	지정된 메타데이터를 업데이트합니다.

만들기

새 제품을 만듭니다.

azsphere product create 명령은 생성된 제품에 5개의 기본 디바이스 그룹을 자동으로 추가합니다.

개발 디바이스 그룹은 클라우드 애플리케이션 업데이트를 사용하지 않도록 설정하고 소매 OS를 제공합니다.
필드 테스트 디바이스 그룹은 클라우드 애플리케이션 업데이트를 사용하도록 설정하고 소매 OS를 제공합니다.
프로덕션 디바이스 그룹은 클라우드 애플리케이션 업데이트를 사용하도록 설정하고 소매 OS를 제공합니다.
프로덕션 OS 평가 디바이스 그룹은 클라우드 애플리케이션 업데이트를 사용하도록 설정하고 소매 평가 OS를 제공합니다.
필드 테스트 OS 평가 디바이스 그룹은 클라우드 애플리케이션 업데이트를 사용하도록 설정하고 소매 평가 OS를 제공합니다.

필수 매개 변수

매개 변수	형식	설명
-n, --name	문자열	제품의 이름을 지정합니다. 이름은 영숫자 문자만 포함할 수 있습니다. 이름에 공백이 포함된 경우 따옴표로 묶습니다. 제품 이름은 50자를 초과할 수 없으며 대/소문자를 구분하지 않으며 테넌트 내에서 고유해야 합니다.

선택적 매개 변수

매개 변수	형식	설명
-g, --no-default-device-groups	Boolean	기본 디바이스 그룹을 만들지 못하게 하는 선택적 플래그를 지정합니다.
-t, --tenant	GUID 또는 이름	이 작업을 수행할 테넌트 지정 선택한 기본 테넌트 재정의 테넌트 ID 또는 테넌트 이름을 지정할 수 있습니다.
-d, --description	문자열	제품을 설명하는 선택적 텍스트를 지정합니다. 최대 길이는 100자입니다. 설명에 공백이 포함된 경우 따옴표로 묶습니다.

전역 매개 변수

Azure Sphere CLI에 사용할 수 있는 전역 매개 변수는 다음과 같습니다.

매개 변수	설명
--debug	로깅 세부 정보를 늘려 모든 디버그 로그를 표시합니다. 버그가 발견된 경우, 버그 보고서를 제출할 때 `--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 쿼리 명령 출력을 참조하세요.
--verbose	작업 중에 Azure Sphere에서 만든 리소스에 대한 정보 및 기타 유용한 정보를 출력합니다. 전체 디버그 로그를 보려면 `--debug`를 사용합니다.

참고 항목

Azure Sphere 클래식 CLI를 사용하는 경우 사용 가능한 옵션에 대한 자세한 내용은 전역 매개 변수를 참조하세요.

예시

azsphere product create --name DW100 --description "Contoso DW100 models"
Default device groups will been created for this product, use the 'azsphere product device-group list' command to see them.
 ------------------------------------ -------------------- ----- ------------------------------------
 TenantId                             Description          Name  Id
 ====================================================================================================
 143adbc9-1bf0-4be2-84a2-084a331d81cb Contoso DW100 models DW100 6f52bead-700d-4289-bdc2-2f11f774270e
 ------------------------------------ -------------------- ----- ------------------------------------

delete

Azure Sphere 테넌트에서 지정된 제품을 삭제합니다.

제품은 다음 경우에만 삭제할 수 있습니다.

사용자에게 테넌트에 대한 관리자 권한이 있습니다.
제품이 비어 있고 디바이스 그룹에 디바이스가 없습니다. azsphere product device list 명령은 제품의 모든 디바이스를 나열합니다. azsphere device update --device-group을 실행하여 디바이스를 다른 디바이스 그룹으로 이동하거나 azsphere device-group delete를 실행하여 디바이스 그룹을 삭제합니다.

필수 매개 변수

매개 변수	형식	설명
-p, --product	GUID 또는 이름	삭제할 제품을 지정합니다. Azure Sphere 제품의 ID 또는 이름을 지정할 수 있습니다.

선택적 매개 변수

매개 변수	형식	설명
-t, --tenant	GUID 또는 이름	이 작업을 수행할 테넌트 지정 선택한 기본 테넌트 재정의 테넌트 ID 또는 테넌트 이름을 지정할 수 있습니다.

전역 매개 변수

Azure Sphere CLI에 사용할 수 있는 전역 매개 변수는 다음과 같습니다.

매개 변수	설명
--debug	로깅 세부 정보를 늘려 모든 디버그 로그를 표시합니다. 버그가 발견된 경우, 버그 보고서를 제출할 때 `--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 쿼리 명령 출력을 참조하세요.
--verbose	작업 중에 Azure Sphere에서 만든 리소스에 대한 정보 및 기타 유용한 정보를 출력합니다. 전체 디버그 로그를 보려면 `--debug`를 사용합니다.

참고 항목

Azure Sphere 클래식 CLI를 사용하는 경우 사용 가능한 옵션에 대한 자세한 내용은 전역 매개 변수를 참조하세요.

예시

ID별로 제품을 지정하는 예제:

azsphere product delete --product 6f52bead-700d-4289-bdc2-2f11f774270e

이름으로 제품을 지정하는 예제:

azsphere product delete --product DW100

다음과 유사한 출력이 표시됩니다.

Successfully deleted the product

device

제품 내의 디바이스를 표시합니다.

연산	설명
list	지정된 제품 내의 디바이스를 표시합니다.
show-count	제품 내의 디바이스 수를 반환합니다.

디바이스 목록

지정된 제품 내에서 디바이스 ID 별로 나열된 디바이스를 표시합니다.

필수 매개 변수

매개 변수	형식	설명
-p, --product	GUID 또는 이름	디바이스를 나열할 제품을 지정합니다. Azure Sphere 제품의 ID 또는 이름을 지정할 수 있습니다.

선택적 매개 변수

매개 변수	형식	설명
-t, --tenant	GUID 또는 이름	이 작업을 수행할 테넌트 지정 선택한 기본 테넌트 재정의 테넌트 ID 또는 테넌트 이름을 지정할 수 있습니다.

전역 매개 변수

Azure Sphere CLI에 사용할 수 있는 전역 매개 변수는 다음과 같습니다.

매개 변수	설명
--debug	로깅 세부 정보를 늘려 모든 디버그 로그를 표시합니다. 버그가 발견된 경우, 버그 보고서를 제출할 때 `--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 쿼리 명령 출력을 참조하세요.
--verbose	작업 중에 Azure Sphere에서 만든 리소스에 대한 정보 및 기타 유용한 정보를 출력합니다. 전체 디버그 로그를 보려면 `--debug`를 사용합니다.

참고 항목

Azure Sphere 클래식 CLI를 사용하는 경우 사용 가능한 옵션에 대한 자세한 내용은 전역 매개 변수를 참조하세요.

예시

ID별로 제품을 지정하는 예제:

azsphere product device list --product 6f52bead-700d-4289-bdc2-2f11f774270e

이름으로 제품을 지정하는 예제:

azsphere product device list --product DW100

다음과 유사한 출력이 표시됩니다.

-------------------------------------------------------------------------------------------------------------------------------- ------------------------------------ ------------------------------------ ------------------------------------
DeviceId                                                                                                                         TenantId                             ProductId                            DeviceGroupId
===============================================================================================================================================================================================================================================
352FE1F59E40EF8A9266415E81AF32B5B07D8F2BBD6B5650CEF4A70B86C7FCBC70B129A41FBC6D02F8BB4AAABC52CD5740C85427D205E46A166B7E41135EB968 143adbc9-1bf0-4be2-84a2-084a331d81cb 6f52bead-700d-4289-bdc2-2f11f774270e 7f860cc1-4949-4000-a541-9a988ba4c3cd
-------------------------------------------------------------------------------------------------------------------------------- ------------------------------------ ------------------------------------ ------------------------------------

device show-count

제품 내의 모든 디바이스 그룹에 있는 모든 디바이스의 총 수를 반환합니다.

필수 매개 변수

매개 변수	형식	설명
-p, --product	GUID 또는 이름	대상 디바이스 수가 표시되는 제품을 지정합니다. Azure Sphere 제품의 ID 또는 이름을 지정할 수 있습니다.

선택적 매개 변수

매개 변수	형식	설명
-t, --tenant	GUID 또는 이름	이 작업을 수행할 테넌트 지정 선택한 기본 테넌트 재정의 테넌트 ID 또는 테넌트 이름을 지정할 수 있습니다.

전역 매개 변수

Azure Sphere CLI에 사용할 수 있는 전역 매개 변수는 다음과 같습니다.

매개 변수	설명
--debug	로깅 세부 정보를 늘려 모든 디버그 로그를 표시합니다. 버그가 발견된 경우, 버그 보고서를 제출할 때 `--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 쿼리 명령 출력을 참조하세요.
--verbose	작업 중에 Azure Sphere에서 만든 리소스에 대한 정보 및 기타 유용한 정보를 출력합니다. 전체 디버그 로그를 보려면 `--debug`를 사용합니다.

참고 항목

Azure Sphere 클래식 CLI를 사용하는 경우 사용 가능한 옵션에 대한 자세한 내용은 전역 매개 변수를 참조하세요.

예시

ID별로 제품을 지정하는 예제:

azsphere product device show-count --product 6f52bead-700d-4289-bdc2-2f11f774270e

이름으로 제품을 지정하는 예제:

azsphere product device show-count --product DW100

다음과 유사한 출력이 표시됩니다.

------
Result
======
2
------

device-group

제품 디바이스 그룹을 관리합니다.

연산	설명
create-defaults	지정된 제품 내에 기본 디바이스 그룹을 만듭니다.
목록	지정된 제품 내의 디바이스 그룹을 표시합니다.

device-group create-defaults

기존 제품 내에 기본 디바이스 그룹을 만듭니다.

필수 매개 변수

매개 변수	형식	설명
-p, --product	GUID 또는 이름	가져올 제품을 지정합니다. Azure Sphere 제품의 ID 또는 이름을 지정할 수 있습니다.

선택적 매개 변수

매개 변수	형식	설명
-t, --tenant	GUID 또는 이름	이 작업을 수행할 테넌트 지정 선택한 기본 테넌트 재정의 테넌트 ID 또는 테넌트 이름을 지정할 수 있습니다.

전역 매개 변수

Azure Sphere CLI에 사용할 수 있는 전역 매개 변수는 다음과 같습니다.

매개 변수	설명
--debug	로깅 세부 정보를 늘려 모든 디버그 로그를 표시합니다. 버그가 발견된 경우, 버그 보고서를 제출할 때 `--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 쿼리 명령 출력을 참조하세요.
--verbose	작업 중에 Azure Sphere에서 만든 리소스에 대한 정보 및 기타 유용한 정보를 출력합니다. 전체 디버그 로그를 보려면 `--debug`를 사용합니다.

참고 항목

Azure Sphere 클래식 CLI를 사용하는 경우 사용 가능한 옵션에 대한 자세한 내용은 전역 매개 변수를 참조하세요.

예시

ID별로 제품을 지정하는 예제:

azsphere product device-group create-defaults --product 6f52bead-700d-4289-bdc2-2f11f774270e

이름으로 제품을 지정하는 예제:

azsphere product device-group create-defaults --product  DW100

다음과 유사한 출력이 표시됩니다.

------------------------------------ ------------------------ --------------------------------------------- ------------------------------------ ---------- ---------------------------------------------------------------------- -------------------------
Id                                   Name                     Description                                   ProductId                            OsFeedType UpdatePolicy                                                           AllowCrashDumpsCollection     RegionalDataBoundary
=====================================================================================================================================================================================================================================================================================
6406868c-19bb-4bea-b4cf-fd80608ee5cb Development              Default development device group              ac181192-2569-4d95-8f70-f8fd9e8dd2e3 Retail     Accept only system software updates. Don't accept application updates. False                         None
------------------------------------ ------------------------ --------------------------------------------- ------------------------------------ ---------- ---------------------------------------------------------------------- ----------------------------- --------------------
d2e2b2e7-e219-4af8-8876-f8d10624778b Field Test               Default test device group                     ac181192-2569-4d95-8f70-f8fd9e8dd2e3 Retail     Accept all updates from the Azure Sphere Security Service.             False                         None
------------------------------------ ------------------------ --------------------------------------------- ------------------------------------ ---------- ---------------------------------------------------------------------- ----------------------------- --------------------
822f1bda-32d7-404a-bf37-9f90aad09509 Production               Default production device group               ac181192-2569-4d95-8f70-f8fd9e8dd2e3 Retail     Accept all updates from the Azure Sphere Security Service.             False                         None
------------------------------------ ------------------------ --------------------------------------------- ------------------------------------ ---------- ---------------------------------------------------------------------- ----------------------------- --------------------
3fafc0e1-f336-4a8a-9be4-fb275322d2cc Production OS Evaluation Default Production OS Evaluation device group ac181192-2569-4d95-8f70-f8fd9e8dd2e3 RetailEval Accept all updates from the Azure Sphere Security Service.             False                         None
------------------------------------ ------------------------ --------------------------------------------- ------------------------------------ ---------- ---------------------------------------------------------------------- ----------------------------- --------------------
b9b7f388-2ad4-4a7e-a4dc-6559fb80741d Field Test OS Evaluation Default Field Test OS Evaluation device group ac181192-2569-4d95-8f70-f8fd9e8dd2e3 RetailEval Accept all updates from the Azure Sphere Security Service.             False                         None
------------------------------------ ------------------------ --------------------------------------------- ------------------------------------ ---------- ---------------------------------------------------------------------- ----------------------------- --------------------

device-group list

제품의 모든 디바이스 그룹을 나열합니다.

필수 매개 변수

매개 변수	형식	설명
-p, --product	GUID 또는 이름	디바이스 그룹을 나열할 제품을 지정합니다. Azure Sphere 제품의 ID 또는 이름을 지정할 수 있습니다.

선택적 매개 변수

매개 변수	형식	설명
-t, --tenant	GUID 또는 이름	이 작업을 수행할 테넌트 지정 선택한 기본 테넌트 재정의 테넌트 ID 또는 테넌트 이름을 지정할 수 있습니다.

전역 매개 변수

Azure Sphere CLI에 사용할 수 있는 전역 매개 변수는 다음과 같습니다.

매개 변수	설명
--debug	로깅 세부 정보를 늘려 모든 디버그 로그를 표시합니다. 버그가 발견된 경우, 버그 보고서를 제출할 때 `--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 쿼리 명령 출력을 참조하세요.
--verbose	작업 중에 Azure Sphere에서 만든 리소스에 대한 정보 및 기타 유용한 정보를 출력합니다. 전체 디버그 로그를 보려면 `--debug`를 사용합니다.

참고 항목

Azure Sphere 클래식 CLI를 사용하는 경우 사용 가능한 옵션에 대한 자세한 내용은 전역 매개 변수를 참조하세요.

예시

ID별로 제품을 지정하는 예제:

azsphere product device-group list --product 6f52bead-700d-4289-bdc2-2f11f774270e

이름으로 제품을 지정하는 예제:

azsphere product device-group list --product DW100

다음과 유사한 출력이 표시됩니다.

------------------------------------ ------------------------------------ ---------- ------------------------------------ ------------------------ --------------------------------------------- ---------------------------------------------------------------------- -------------------------
Id                                   TenantId                             OsFeedType ProductId                            Name                     Description                                   UpdatePolicy                                                           AllowCrashDumpsCollection     RegionalDataBoundary
==========================================================================================================================================================================================================================================================================================================================
6406868c-19bb-4bea-b4cf-fd80608ee5cb 143adbc9-1bf0-4be2-84a2-084a331d81cb Retail     4f48d618-09f7-45dc-a5a4-1433cabbee91 Development              Default development device group              Accept only system software updates. Don't accept application updates. False                         None
------------------------------------ ------------------------------------ ---------- ------------------------------------ ------------------------ --------------------------------------------- ---------------------------------------------------------------------- ----------------------------- --------------------
d2e2b2e7-e219-4af8-8876-f8d10624778b 143adbc9-1bf0-4be2-84a2-084a331d81cb Retail     4f48d618-09f7-45dc-a5a4-1433cabbee91 Field Test               Default test device group                     Accept all updates from the Azure Sphere Security Service.             False                         None
------------------------------------ ------------------------------------ ---------- ------------------------------------ ------------------------ --------------------------------------------- ---------------------------------------------------------------------- ----------------------------- --------------------
822f1bda-32d7-404a-bf37-9f90aad09509 143adbc9-1bf0-4be2-84a2-084a331d81cb Retail     4f48d618-09f7-45dc-a5a4-1433cabbee91 Production               Default production device group               Accept all updates from the Azure Sphere Security Service.             False                         None
------------------------------------ ------------------------------------ ---------- ------------------------------------ ------------------------ --------------------------------------------- ---------------------------------------------------------------------- ----------------------------- --------------------
a6c64cda-4ff0-48bb-8a30-6ffab322b846 143adbc9-1bf0-4be2-84a2-084a331d81cb RetailEval 4f48d618-09f7-45dc-a5a4-1433cabbee91 Production OS Evaluation Default Production OS Evaluation device group Accept all updates from the Azure Sphere Security Service.             False                         None
------------------------------------ ------------------------------------ ---------- ------------------------------------ ------------------------ --------------------------------------------- ---------------------------------------------------------------------- ----------------------------- --------------------
3fafc0e1-f336-4a8a-9be4-fb275322d2cc 143adbc9-1bf0-4be2-84a2-084a331d81cb RetailEval 4f48d618-09f7-45dc-a5a4-1433cabbee91 Field Test OS Evaluation Default Field Test OS Evaluation device group Accept all updates from the Azure Sphere Security Service.             False                         None
------------------------------------ ------------------------------------ ---------- ------------------------------------ ------------------------ --------------------------------------------- ---------------------------------------------------------------------- ----------------------------- --------------------
b9b7f388-2ad4-4a7e-a4dc-6559fb80741d 143adbc9-1bf0-4be2-84a2-084a331d81cb Retail     4f48d618-09f7-45dc-a5a4-1433cabbee91 Marketing                Default Marketing device group                Accept all updates from the Azure Sphere Security Service.             False                         None
------------------------------------ ------------------------------------ ---------- ------------------------------------ ------------------------ --------------------------------------------- ---------------------------------------------------------------------- ----------------------------- --------------------

list

Azure Sphere 테넌트에 있는 모든 제품을 나열합니다.

선택적 매개 변수

매개 변수	형식	설명
-t, --tenant	GUID 또는 이름	이 작업을 수행할 테넌트 지정 선택한 기본 테넌트 재정의 테넌트 ID 또는 테넌트 이름을 지정할 수 있습니다.

전역 매개 변수

Azure Sphere CLI에 사용할 수 있는 전역 매개 변수는 다음과 같습니다.

매개 변수	설명
--debug	로깅 세부 정보를 늘려 모든 디버그 로그를 표시합니다. 버그가 발견된 경우, 버그 보고서를 제출할 때 `--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 쿼리 명령 출력을 참조하세요.
--verbose	작업 중에 Azure Sphere에서 만든 리소스에 대한 정보 및 기타 유용한 정보를 출력합니다. 전체 디버그 로그를 보려면 `--debug`를 사용합니다.

참고 항목

Azure Sphere 클래식 CLI를 사용하는 경우 사용 가능한 옵션에 대한 자세한 내용은 전역 매개 변수를 참조하세요.

예시

azsphere product list
------------------------------------ ------------------------------------ --------- --------------------
Id                                   TenantId                             Name      Description
========================================================================================================
6f52bead-700d-4289-bdc2-2f11f774270e 143adbc9-1bf0-4be2-84a2-084a331d81cb DW100     Contoso DW100 models
------------------------------------ ------------------------------------ --------- --------------------
6a82518f-8965-4bd6-ba79-43aa3fcafe5e 143adbc9-1bf0-4be2-84a2-084a331d81cb DW200     Contoso DW200 models
------------------------------------ ------------------------------------ --------- --------------------

show

제품의 세부 정보를 표시합니다.

필수 매개 변수

매개 변수	형식	설명
-p, --product	GUID 또는 이름	가져올 제품을 지정합니다. Azure Sphere 제품의 ID 또는 이름을 지정할 수 있습니다.

선택적 매개 변수

매개 변수	형식	설명
-t, --tenant	GUID 또는 이름	이 작업을 수행할 테넌트 지정 선택한 기본 테넌트 재정의 테넌트 ID 또는 테넌트 이름을 지정할 수 있습니다.

전역 매개 변수

Azure Sphere CLI에 사용할 수 있는 전역 매개 변수는 다음과 같습니다.

매개 변수	설명
--debug	로깅 세부 정보를 늘려 모든 디버그 로그를 표시합니다. 버그가 발견된 경우, 버그 보고서를 제출할 때 `--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 쿼리 명령 출력을 참조하세요.
--verbose	작업 중에 Azure Sphere에서 만든 리소스에 대한 정보 및 기타 유용한 정보를 출력합니다. 전체 디버그 로그를 보려면 `--debug`를 사용합니다.

참고 항목

Azure Sphere 클래식 CLI를 사용하는 경우 사용 가능한 옵션에 대한 자세한 내용은 전역 매개 변수를 참조하세요.

예시

ID별로 제품 및 테넌트 지정 예제:

azsphere product show --product 6f52bead-700d-4289-bdc2-2f11f774270e --tenant 143adbc9-1bf0-4be2-84a2-084a331d81cb

이름으로 제품 및 테넌트 지정 예제:

azsphere product show --product DW100 --tenant MyTenant

다음과 유사한 출력이 표시됩니다.

------------------------------------ ------------------------------------ ----- --------------------
Id                                   TenantId                             Name  Description
====================================================================================================
6f52bead-700d-4289-bdc2-2f11f774270e 143adbc9-1bf0-4be2-84a2-084a331d81cb DW100 Contoso DW100 models
------------------------------------ ------------------------------------ ----- --------------------

업데이트

지정된 제품 메타데이터를 업데이트합니다.

하나 이상의 선택적 매개 변수를 --newname --newdescription제공해야 합니다. 둘 다 단일 명령으로 지정할 수 있습니다.

필수 매개 변수

매개 변수	형식	설명
-p, --product	GUID 또는 이름	업데이트할 제품을 지정합니다. Azure Sphere 제품의 ID 또는 이름을 지정할 수 있습니다.

선택적 매개 변수

매개 변수	형식	설명
-n, --new-name	문자열	제품의 새 이름을 지정합니다. 이름은 영숫자 문자만 포함할 수 있습니다. 이름에 공백이 포함된 경우 따옴표로 묶습니다. 제품 이름은 50자를 초과할 수 없으며 대/소문자를 구분하지 않으며 테넌트 내에서 고유해야 합니다.
-d, --new-description	문자열	제품을 설명하는 선택적 텍스트를 지정합니다. 최대 길이는 100자입니다.
-t, --tenant	문자열	이 작업을 수행할 테넌트 지정 선택한 기본 테넌트 재정의 테넌트 ID 또는 테넌트 이름을 지정할 수 있습니다.

전역 매개 변수

Azure Sphere CLI에 사용할 수 있는 전역 매개 변수는 다음과 같습니다.

매개 변수	설명
--debug	로깅 세부 정보를 늘려 모든 디버그 로그를 표시합니다. 버그가 발견된 경우, 버그 보고서를 제출할 때 `--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 쿼리 명령 출력을 참조하세요.
--verbose	작업 중에 Azure Sphere에서 만든 리소스에 대한 정보 및 기타 유용한 정보를 출력합니다. 전체 디버그 로그를 보려면 `--debug`를 사용합니다.

참고 항목

Azure Sphere 클래식 CLI를 사용하는 경우 사용 가능한 옵션에 대한 자세한 내용은 전역 매개 변수를 참조하세요.

예시

ID별로 제품을 지정하는 예제:

azsphere product update --product 6f52bead-700d-4289-bdc2-2f11f774270e --new-description Contoso DW100 models

이름으로 제품을 지정하는 예제:

azsphere product update --product DW100 --new-description Contoso DW100 models

다음과 유사한 출력이 표시됩니다.

------------------------------------ ------------------------------------ ----- ------------------
Id                                   TenantId                             Name  Description
==================================================================================================
6a82518f-8965-4bd6-ba79-43aa3fcafe5e 143adbc9-1bf0-4be2-84a2-084a331d81cb DW200 Contoso DW200 models
------------------------------------ ------------------------------------ ----- ------------------

다음을 통해 공유

product

만들기

필수 매개 변수

선택적 매개 변수

예시

delete

필수 매개 변수

선택적 매개 변수

예시

device

디바이스 목록

필수 매개 변수

선택적 매개 변수

예시

device show-count

필수 매개 변수

선택적 매개 변수

예시

device-group

device-group create-defaults

필수 매개 변수

선택적 매개 변수

예시

device-group list

필수 매개 변수

선택적 매개 변수

예시

list

선택적 매개 변수

예시

show

필수 매개 변수

선택적 매개 변수

예시

업데이트

필수 매개 변수

선택적 매개 변수

예시

피드백

추가 리소스