device-group

아티클
08/09/2023

디바이스 그룹을 만들고 관리합니다.

디바이스 그룹은 식별자(ID) 또는 제품 이름 및 디바이스 그룹 이름 쌍으로 주소가 지정됩니다.

작업	설명
만들	새 디바이스 그룹을 만듭니다.
목록	Azure Sphere 테넌트에서 모든 디바이스 그룹을 나열합니다.
삭제	기존 디바이스 그룹을 삭제합니다.
배포	디바이스 그룹 내의 배포를 관리합니다.
장치	디바이스 그룹의 디바이스를 나열합니다.
표시	디바이스 그룹에 대한 정보를 표시합니다.
업데이트	기존 디바이스 그룹을 수정합니다.

만들

지정된 제품의 지정된 이름을 가진 디바이스 그룹을 만듭니다. 디바이스 그룹은 동일한 제품이 있고 클라우드에서 동일한 애플리케이션을 수신하는 디바이스를 구성합니다.

필수 매개 변수

매개 변수	형식	설명
-p, --product	GUID 또는 이름	이 디바이스 그룹을 추가할 제품을 지정합니다. Azure Sphere 제품의 ID 또는 이름을 지정할 수 있습니다.
-n, --name	문자열	디바이스 그룹의 이름을 지정합니다. 이름은 영숫자 문자만 포함할 수 있습니다. 이름에 공백이 포함된 경우 따옴표로 묶습니다. 디바이스 그룹 이름은 50자를 초과할 수 없으며 대/소문자를 구분하지 않습니다. 제품 내에서 고유해야 합니다.

선택적 매개 변수

매개 변수	형식	설명
-a, --application-update	열거형	이 디바이스 그룹에 적용할 애플리케이션 업데이트 정책을 지정합니다. 허용되는 값: `No3rdPartyAppUpdates`, `UpdateAll`및 `NoUpdates`. 기본값은 입니다 `UpdateAll`. 정책은 `NoUpdates` 현재 내부용으로만 예약되어 있습니다.
-f, --os-feed	열거형	OS 업데이트에 사용할 OS 피드 유형을 지정합니다. 허용되는 값: `Retail`, . `RetailEval`
-t, --tenant	GUID 또는 이름	이 작업을 수행할 테넌트 를 지정합니다. 선택한 기본 테넌트 를 재정의합니다. 테넌트 ID 또는 테넌트 이름을 지정할 수 있습니다.
-d, --description	문자열	디바이스 그룹을 설명하는 선택적 텍스트를 지정합니다. 최대 길이는 100자입니다. 설명에 공백이 포함된 경우 따옴표로 묶습니다.
-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 device-group create --name Marketing --product DW100

 ------------------------------------ ------------------------------------ ---------- ------------------------------------ ---------- ---------------------------------------------------------- ----------------------------- ---------------------
 Id                                   TenantId                             OsFeedType ProductId                            Name       UpdatePolicy                                               AllowCrashDumpsCollection     RegionalDataBoundary
 ===================================================================================================================================================================================================================================================
 7f860cc1-4949-4000-a541-9a988ba4c3cd 143adbc9-1bf0-4be2-84a2-084a331d81cb Retail     6f52bead-700d-4289-bdc2-2f11f774270e Marketing Accept all updates from the Azure Sphere Security Service. False                          None
 ------------------------------------ ------------------------------------ ---------- ------------------------------------ ---------- ---------------------------------------------------------- ----------------------------- --------------------

Azure Sphere 테넌트에서 모든 디바이스 그룹을 나열합니다.

선택적 매개 변수

매개 변수	형식	설명
-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-group list --tenant 143adbc9-1bf0-4be2-84a2-084a331d81cb

  ------------------------------------ ------------------------ --------------------------------------------- ------------------------------------ ---------- ---------------------------------------------------------------------- ----------------------------- ---------------------
 Id                                   Name                     Description                                   ProductId                            OsFeedType UpdatePolicy                                                           AllowCrashDumpsCollection     RegionalDataBoundary
 =====================================================================================================================================================================================================================================================================================
 a3a49688-4601-4422-8b51-a0838ea84627 Development              Default development device group              6f52bead-700d-4289-bdc2-2f11f774270e Retail     Accept only system software updates. Don't accept application updates. False                         None
 ------------------------------------ ------------------------ --------------------------------------------- ------------------------------------ ---------- ---------------------------------------------------------------------- ----------------------------- --------------------
 7cb46b96-8c17-4afd-bd3f-614acad9d264 Field Test               Default test device group                     6f52bead-700d-4289-bdc2-2f11f774270e Retail     Accept all updates from the Azure Sphere Security Service.             False                         None
 ------------------------------------ ------------------------ --------------------------------------------- ------------------------------------ ---------- ---------------------------------------------------------------------- ----------------------------- --------------------
 30c39bae-f525-4094-8008-d03705429ef0 Production               Default production device group               6f52bead-700d-4289-bdc2-2f11f774270e Retail     Accept all updates from the Azure Sphere Security Service.             False                         None
 ------------------------------------ ------------------------ --------------------------------------------- ------------------------------------ ---------- ---------------------------------------------------------------------- ----------------------------- --------------------
 cb5c9685-5dbe-470c-91a9-91dc129884d6 Production OS Evaluation Default Production OS Evaluation device group 6f52bead-700d-4289-bdc2-2f11f774270e RetailEval Accept all updates from the Azure Sphere Security Service.             False                         None
 ------------------------------------ ------------------------ --------------------------------------------- ------------------------------------ ---------- ---------------------------------------------------------------------- ----------------------------- --------------------
 63e72035-3fcf-4fdc-b88a-05e30d1ba224 Field Test OS Evaluation Default Field Test OS Evaluation device group 6f52bead-700d-4289-bdc2-2f11f774270e RetailEval Accept all updates from the Azure Sphere Security Service.             False                         None
 ------------------------------------ ------------------------ --------------------------------------------- ------------------------------------ ---------- ---------------------------------------------------------------------- --------------------------------------------------

삭제

Azure Sphere 테넌트에서 지정된 디바이스 그룹을 삭제합니다.

디바이스 그룹은 다음과 같은 경우에만 삭제할 수 있습니다.

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

필수 매개 변수

매개 변수	형식	설명
-g, --device-group	문자열	삭제할 디바이스 그룹을 지정합니다. 디바이스 그룹 ID 또는 디바이스 그룹 이름을 지정할 수 있습니다. 디바이스 그룹 이름을 사용하려면 제품 이름과 디바이스 그룹 이름을 `<product-name/device-group-name>` 형식으로 모두 제공해야 합니다.

선택적 매개 변수

매개 변수	형식	설명
-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-group delete --device-group 7f860cc1-4949-4000-a541-9a988ba4c3cd
Successfully deleted the device group

azsphere device-group delete --device-group DW100/Development
Successfully deleted the device group

배포

디바이스 그룹에 대한 배포를 관리합니다.

작업	설명
만들	지정된 디바이스 그룹에 대한 새 배포를 만듭니다.
목록	디바이스 그룹에 대한 배포를 표시합니다.

배포 만들기

제공된 이미지를 사용하여 디바이스 그룹에 대한 새 배포를 만듭니다.

식별자(ID) 또는 제품 이름 및 디바이스 그룹 이름 쌍으로 디바이스 그룹을 식별할 수 있습니다.

필수 매개 변수

매개 변수	형식	설명
-g, --device-group	문자열	배포를 만들 디바이스 그룹을 지정합니다. 디바이스 그룹 ID 또는 디바이스 그룹 이름을 지정할 수 있습니다. 디바이스 그룹 이름을 사용하려면 제품 이름과 디바이스 그룹 이름을 `<product-name/device-group-name>` 형식으로 모두 제공해야 합니다.
-i, --images	문자열	배포에 포함할 하나 이상의 이미지에 대한 이미지 ID를 지정합니다. 매개 변수를 추가하여 여러 이미지를 추가하거나 여러 이미지 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를 사용하는 경우 사용 가능한 옵션에 대한 자세한 내용은 전역 매개 변수 를 참조하세요.

예제

매개 변수는 --device-group 디바이스 그룹을 식별합니다. 디바이스 그룹 ID는 모든 제품에서 디바이스 그룹을 고유하게 식별하는 GUID를 제공합니다. 또는 제품 이름/<device-group-name 형식으로 <제품 이름> 및 디바이스 그룹 이름> 쌍을 사용할 수 있습니다. 이 이름 쌍은 특정 제품에 대한 디바이스 그룹을 고유하게 식별합니다.

ID별로 디바이스 그룹을 지정하는 예제:

azsphere device-group deployment create --device-group 7f860cc1-4949-4000-a541-9a988ba4c3cd --images 5572509b-43a4-45b0-88c5-365cbf9732c1

이름으로 디바이스 그룹을 지정하는 예제:

azsphere device-group deployment create --device-group DW100/Development --images 5572509b-43a4-45b0-88c5-365cbf9732c1

공백으로 구분된 값 목록을 제공하여 여러 이미지 ID를 지정하는 예제:

azsphere device-group deployment create --device-group DW100/Development --images 5572509b-43a4-45b0-88c5-365cbf9732c1 3bbd2d2a-2870-4dde-9db8-ae50548ea7b4

다음과 같은 출력이 표시됩니다.

------------------------------------ ------------------------------------ ------------------------------------ ------------------------------------
Id                                   TenantId                             DeployedImages                       DeploymentDateUtc                    
===================================================================================================================================================
7f860cc1-4949-4000-a541-9a988ba4c3cd 143adbc9-1bf0-4be2-84a2-084a331d81cb 5572509b-43a4-45b0-88c5-365cbf9732c1 2021-04-01T18:48:41.721662+00:00     
------------------------------------ ------------------------------------ ------------------------------------ ------------------------------------

배포 목록

디바이스 그룹의 배포 기록을 표시합니다. 배포 ID, 타임스탬프 및 포함된 이미지 목록을 반환합니다. 목록은 최신 배포에 따라 정렬됩니다.

필수 매개 변수

매개 변수	형식	설명
-g, --device-group	문자열	배포 기록 목록을 표시할 디바이스 그룹을 지정합니다. 디바이스 그룹 ID 또는 디바이스 그룹 이름을 지정할 수 있습니다. 디바이스 그룹 이름을 사용하려면 제품 이름과 디바이스 그룹 이름을 `<product-name/device-group-name>` 형식으로 모두 제공해야 합니다.

선택적 매개 변수

매개 변수	형식	설명
-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를 사용하는 경우 사용 가능한 옵션에 대한 자세한 내용은 전역 매개 변수 를 참조하세요.

예제

ID별로 디바이스 그룹을 지정하는 예제:

azsphere device-group deployment list --device-group 7f860cc1-4949-4000-a541-9a988ba4c3cd

이름으로 디바이스 그룹을 지정하는 예제:

azsphere device-group deployment list --device-group DW100/Development

다음과 같은 출력이 표시됩니다.

------------------------------------ ------------------------------------ ------------------------------------ ------------------------------------
Id                                   TenantId                             DeployedImages                       DeploymentDateUtc                   
===================================================================================================================================================
7f860cc1-4949-4000-a541-9a988ba4c3cd 143adbc9-1bf0-4be2-84a2-084a331d81cb e3769536-dc4b-48d9-afd4-22ed321ba4bc 2020-11-18T19:46:50.514429+00:00    
------------------------------------ ------------------------------------ ------------------------------------ ------------------------------------

장치

디바이스 그룹의 디바이스를 관리합니다.

작업	설명
목록	디바이스 그룹에 디바이스를 표시합니다.
show-count	디바이스 그룹의 디바이스 수를 표시합니다.

디바이스 목록

디바이스 그룹에 디바이스를 표시합니다.

필수 매개 변수

매개 변수	형식	설명
-g, --device-group	문자열	디바이스 목록을 표시할 디바이스 그룹을 지정합니다. 디바이스 그룹 ID 또는 디바이스 그룹 이름을 지정할 수 있습니다. 디바이스 그룹 이름을 사용하려면 제품 이름과 디바이스 그룹 이름을 `<product-name/device-group-name>` 형식으로 모두 제공해야 합니다.

선택적 매개 변수

매개 변수	형식	설명
-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를 사용하는 경우 사용 가능한 옵션에 대한 자세한 내용은 전역 매개 변수 를 참조하세요.

예제

ID별로 디바이스 그룹을 지정하는 예제:

azsphere device-group device list --device-group 7f860cc1-4949-4000-a541-9a988ba4c3cd

이름으로 디바이스 그룹을 지정하는 예제:

azsphere device-group device list --device-group DW100/Marketing

다음과 같은 출력이 표시됩니다.

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

device show-count

디바이스 그룹의 디바이스 수를 표시합니다.

필수 매개 변수

매개 변수	형식	설명
-g, --device-group	문자열	디바이스 수를 표시할 디바이스 그룹을 지정합니다. 디바이스 그룹 ID 또는 디바이스 그룹 이름을 지정할 수 있습니다. 디바이스 그룹 이름을 사용하려면 제품 이름과 디바이스 그룹 이름을 `<product-name/device-group-name>` 형식으로 모두 제공해야 합니다.

선택적 매개 변수

매개 변수	형식	설명
-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를 사용하는 경우 사용 가능한 옵션에 대한 자세한 내용은 전역 매개 변수 를 참조하세요.

예제

ID별로 device-group을 지정하는 예제:

azsphere device-group device show-count --device-group 7f860cc1-4949-4000-a541-9a988ba4c3cd

이름으로 device-group을 지정하는 예제:

azsphere device-group device show-count --device-group DW100/Marketing

다음과 같은 출력이 표시됩니다.

------
Result
======
1
------

표시

디바이스 그룹에 대한 정보를 반환합니다.

필수 매개 변수

매개 변수	형식	설명
-g, --device-group	문자열	세부 정보를 표시할 디바이스 그룹을 지정합니다. 디바이스 그룹 ID 또는 디바이스 그룹 이름을 지정할 수 있습니다. 디바이스 그룹 이름을 사용하려면 제품 이름과 디바이스 그룹 이름을 `<product-name/device-group-name>` 형식으로 모두 제공해야 합니다.

선택적 매개 변수

매개 변수	형식	설명
-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를 사용하는 경우 사용 가능한 옵션에 대한 자세한 내용은 전역 매개 변수 를 참조하세요.

예제

ID별로 device-group을 지정하는 예제:

azsphere device-group show --device-group 7f860cc1-4949-4000-a541-9a988ba4c3cd

이름으로 device-group을 지정하는 예제:

azsphere device-group show --device-group DW100/Marketing

다음과 같은 출력이 표시됩니다.

------------------------------------ --------- ---------------------- ------------------------------------ ------------------------------------ ---------- ---------------------------------------------------------- ----------------------------- --------------------
Id                                   Name      Description            TenantId                             ProductId                            OsFeedType UpdatePolicy                                               AllowCrashDumpsCollection     RegionalDataBoundary
========================================================================================================================================================================================================================================================================
7f860cc1-4949-4000-a541-9a988ba4c3cd Marketing Marketing device group 143adbc9-1bf0-4be2-84a2-084a331d81cb 6f52bead-700d-4289-bdc2-2f11f774270e Retail     Accept all updates from the Azure Sphere Security Service. False                         None                         
------------------------------------ --------- ---------------------- ------------------------------------ ------------------------------------ ---------- ---------------------------------------------------------- ----------------------------- --------------------

업데이트

ID 또는 제품 이름 및 디바이스 그룹 이름 쌍으로 식별되는 기존 디바이스 그룹을 업데이트.

필수 매개 변수

매개 변수	형식	설명
-g, --device-group	문자열	세부 정보를 업데이트할 디바이스 그룹을 지정합니다. 디바이스 그룹 ID 또는 디바이스 그룹 이름을 지정할 수 있습니다. 디바이스 그룹 이름을 사용하려면 제품 이름과 디바이스 그룹 이름을 `<product-name/device-group-name>` 형식으로 모두 제공해야 합니다.

선택적 매개 변수

매개 변수	형식	설명
-c, --allow-crash-dumps-collection	문자열	디바이스 그룹에 대한 Microsoft의 크래시 덤프 수집에 대한 동의를 설정합니다. 기본값은 입니다 `Off`. 허용되는 값: `Off` 및 `On`. 매개 변수를 `--regional-data-boundary` 사용하여 크래시 덤프 파일을 저장할 위치를 지정합니다. 자세한 내용은 크래시 덤프 구성을 참조하세요.
-a, --application-update	ApplicationUpdatePolicyType	디바이스 그룹에 대한 애플리케이션 업데이트 정책을 지정합니다. 허용되는 값: `No3rdPartyAppUpdates`, `UpdateAll`및 `NoUpdates`. 기본값은 입니다 `UpdateAll`. 정책은 `NoUpdates` 현재 내부용으로만 예약되어 있습니다.
-d, --new-description	문자열	디바이스 그룹을 설명하는 선택적 텍스트를 지정합니다. 최대 길이는 100자입니다.
-n, --new-name	문자열	디바이스 그룹의 새 이름을 지정합니다. 이름은 영숫자 문자만 포함할 수 있습니다. 이름에 공백이 포함된 경우 따옴표로 묶습니다. 디바이스 그룹 이름은 50자를 초과할 수 없으며 대/소문자를 구분하지 않으며 제품 내에서 고유해야 합니다.
-f, --os-feed	문자열	디바이스 그룹에 대한 운영 체제 피드를 지정합니다. 가능한 값은 및 `RetailEval`입니다`Retail`.
-t, --tenant	GUID 또는 이름	이 작업을 수행할 테넌트 를 지정합니다. 선택한 기본 테넌트 를 재정의합니다. 테넌트 ID 또는 테넌트 이름을 지정할 수 있습니다.
-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를 사용하는 경우 사용 가능한 옵션에 대한 자세한 내용은 전역 매개 변수 를 참조하세요.

예제

ID별로 device-group을 지정하는 예제:

azsphere device-group update --device-group 7f860cc1-4949-4000-a541-9a988ba4c3cd --new-description "Marketing device group"

이름으로 device-group을 지정하는 예제:

azsphere device-group update --device-group DW100/Marketing --new-description "Marketing device group"

다음과 같은 출력이 표시됩니다.

------------------------------------ ------------------------------------ ---------- ------------------------------------ --------- ---------------------- ---------------------------------------------------------- ----------------------------- --------------------
Id                                   TenantId                             OsFeedType ProductId                            Name      Description            UpdatePolicy                                               AllowCrashDumpsCollection     RegionalDataBoundary
========================================================================================================================================================================================================================================================================
7f860cc1-4949-4000-a541-9a988ba4c3cd 143adbc9-1bf0-4be2-84a2-084a331d81cb Retail     6f52bead-700d-4289-bdc2-2f11f774270e Marketing Marketing device group Accept all updates from the Azure Sphere Security Service. False                         None
------------------------------------ ------------------------------------ ---------- ------------------------------------ --------- ---------------------- ---------------------------------------------------------- ----------------------------- --------------------

다음을 통해 공유

device-group

만들

필수 매개 변수

선택적 매개 변수

예제

목록

선택적 매개 변수

예제

삭제

필수 매개 변수

선택적 매개 변수

예제

배포

배포 만들기

필수 매개 변수

선택적 매개 변수

예제

배포 목록

필수 매개 변수

선택적 매개 변수

예제

장치

디바이스 목록

필수 매개 변수

선택적 매개 변수

예제

device show-count

필수 매개 변수

선택적 매개 변수

예제

표시

필수 매개 변수

선택적 매개 변수

예제

업데이트

필수 매개 변수

선택적 매개 변수

예제

추가 리소스