다음을 통해 공유

디바이스 그룹 관리

  • 아티클

Important

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

이 항목에서는 CLI 또는 Azure Sphere Explorer를 사용하여 디바이스 그룹을 관리하는 방법을 설명합니다. 이 항목의 단계에서는 Azure Sphere 테넌트, 제품 및 디바이스 그룹의 개념에 익숙하다고 가정합니다.

디바이스 그룹 나열

azsphere device-group list 명령을 사용하거나 디바이스 그룹 - 목록 API를 사용하여 Azure Sphere 테넌트에서 모든 디바이스 그룹을 나열합니다.

모든 디바이스 그룹을 나열하려면 다음을 수행합니다.

azsphere device-group list

azsphere product device-group list 명령을 사용하거나 Product - List Groups API를 사용하여 특정 제품의 디바이스 그룹을 나열합니다.

azsphere product device-group list --product <product-name>

  1. Azure Sphere Explorer를 엽니다.

  2. 관심 있는 테넌트에 대한 테넌트 노드를 확장합니다.

  1. Azure Sphere Explorer를 엽니다.

  2. 관심 있는 테넌트에 대한 테넌트 노드를 확장합니다.

테넌트의 제품 및 디바이스 그룹을 보려면 다음을 수행합니다.

  1. Azure Sphere Explorer를 엽니다.

  2. 관심 있는 테넌트에 대한 테넌트 노드를 확장합니다.

나열된 제품이 없는 경우 제품을 만듭니다.

디바이스가 이미 제품과 연결되어 있고 그룹에 할당된 경우 언제든지 디바이스 그룹을 업데이트할 수 있습니다.

테넌트의 제품 및 디바이스 그룹을 보려면 다음을 수행합니다.

  1. Azure Sphere Explorer를 엽니다.

  2. 관심 있는 테넌트에 대한 테넌트 노드를 확장합니다.

나열된 제품이 없는 경우 제품을 만듭니다.

디바이스가 이미 제품과 연결되어 있고 그룹에 할당된 경우 언제든지 디바이스 그룹을 업데이트할 수 있습니다.

디바이스 그룹 만들기

azsphere device-group create 명령을 사용하거나 디바이스 그룹 - Create API를 사용하여 디바이스 그룹을 만듭니다.

디바이스 그룹을 만들려면 다음을 수행합니다.

azsphere device-group create --product <product-name> --name <device-group-name> --description <device-group-description>

디바이스 그룹의 이름은 영숫자 문자와 공백만 포함할 수 있습니다. 50자를 초과할 수 없습니다. 이름 또는 설명에 공백이 포함된 경우 따옴표로 묶습니다.

다음과 같은 선택적 매개 변수를 포함할 수 있습니다.

  • --os-feed 는 OS 업데이트에 사용할 OS 피드 유형을 지정합니다.
  • --application-update 는 이 디바이스 그룹에 대한 애플리케이션 업데이트 정책을 설정합니다.

  1. Azure Sphere Explorer를 엽니다.

  2. 관심 있는 테넌트에 대해 Product 노드를 확장합니다.

  3. 관심 있는 제품의 경우 마우스 오른쪽 단추를 클릭하고 새 디바이스 그룹을 선택합니다.

  4. 디바이스 그룹의 이름을 지정하고 Enter 키를 누릅니다. 디바이스 그룹의 이름은 영숫자 문자와 공백만 포함할 수 있습니다. 50자를 초과할 수 없습니다. 잘못된 이름을 지정하면 출력 창에 오류가 보고됩니다.

Visual Studio Code에서 디바이스 그룹을 만들 수 있지만 삭제할 수는 없습니다. 디바이스 그룹을 삭제하려면 azsphere device-group delete 명령 또는 Azure Sphere Public API를 사용합니다.

  1. Azure Sphere Explorer를 엽니다.

  2. 관심 있는 테넌트에 대해 Product 노드를 확장합니다.

  3. 관심 있는 제품의 경우 마우스 오른쪽 단추를 클릭하고 새 디바이스 그룹을 선택합니다.

  4. 디바이스 그룹의 이름을 지정하고 Enter 키를 누르거나 적용을 클릭합니다. 디바이스 그룹의 이름은 영숫자 문자와 공백만 포함할 수 있습니다. 50자를 초과할 수 없습니다. 잘못된 이름을 지정하면 출력 창에 오류가 보고됩니다.

Visual Studio에서 디바이스 그룹을 만들 수 있지만 삭제할 수는 없습니다. 제품을 삭제하려면 azsphere device-group delete 명령 또는 Azure Sphere Public API를 사용합니다.

디바이스 그룹 업데이트

azsphere device-group update 명령을 사용하거나 디바이스 그룹 - 패치 API를 사용하여 디바이스 그룹의 이름 또는 설명을 수정할 수 있습니다.

디바이스 그룹의 이름 및 설명을 업데이트하려면 다음을 수행합니다.

azsphere device-group update --device-group <device group ID or product-name/device-group-name> --new-name <new-device-group-name> --new-description <new-device-group-description>

azsphere device-group update os-feed 명령을 사용하여 매개 변수 및 application-update 매개 변수를 업데이트할 수도 있습니다.

  1. Azure Sphere Explorer를 엽니다.

  2. 관심 있는 테넌트에 대해 Product 노드를 확장합니다.

  3. 관심 있는 제품의 경우 제품 노드를 확장하여 포함된 디바이스 그룹을 표시합니다. 디바이스 그룹의 이름을 바꾸거나 설명, OS 피드 유형 또는 업데이트 정책을 업데이트할 수 있습니다.

  • 디바이스 그룹의 이름을 바꾸려면 디바이스 그룹 이름을 마우스 오른쪽 단추로 클릭하고 이름 바꾸기를 선택하고 새 이름을 입력한 다음 Enter 키를 누릅니다. 디바이스 그룹의 이름은 영숫자 문자와 공백만 포함할 수 있습니다. 50자를 초과할 수 없습니다. 잘못된 이름을 지정하면 출력 창에 오류가 보고됩니다.

  • 디바이스 그룹에 대한 설명을 업데이트하려면 디바이스 그룹 이름을 마우스 오른쪽 단추로 클릭하고 설명 업데이트를 선택하고 새 설명을 입력한 다음 Enter 키를 누릅니다.

  • OS 피드 유형을 업데이트하려면 디바이스 그룹을 확장하고 OS 피드 유형을 마우스 오른쪽 단추로 클릭하고 업데이트를 선택한 다음 메뉴에서 Retail 또는 RetailEval을 선택합니다.

  • 업데이트 정책을 변경하려면 디바이스 그룹을 확장하고, 업데이트 정책을 마우스 오른쪽 단추로 클릭하고, 업데이트를 선택한 다음, 메뉴에서 No3rdPartyAppUpdates 또는 UpdateAll을 선택합니다. (세 번째 옵션, NoUpdates는 현재 내부용으로 예약되어 있습니다. 이 옵션을 선택하면 출력 창에 오류가 보고됩니다.)

azsphere device update 명령을 사용하거나 디바이스 - 이동 API를 사용하여 디바이스를 다른 디바이스 그룹으로 이동합니다.

  1. Azure Sphere Explorer를 엽니다.

  2. 관심 있는 테넌트에 대해 Product 노드를 확장합니다.

  3. 관심 있는 제품의 경우 제품 노드를 확장하여 포함된 디바이스 그룹을 표시합니다. 디바이스 그룹의 이름을 바꾸거나 설명, OS 피드 유형 또는 업데이트 정책을 업데이트할 수 있습니다.

  • 디바이스 그룹의 이름을 바꾸려면 디바이스 그룹 이름을 선택하고 F2 키를 누르거나 디바이스 그룹 이름을 마우스 오른쪽 단추로 클릭하고 이름 바꾸기를 선택하고 새 이름을 입력한 다음 Enter 키를 누르거나 적용을 클릭합니다. 디바이스 그룹의 이름은 영숫자 문자와 공백만 포함할 수 있습니다. 50자를 초과할 수 없습니다. 잘못된 이름을 지정하면 출력 창에 오류가 보고됩니다.

  • 디바이스 그룹에 대한 설명을 업데이트하려면 디바이스 그룹을 확장하고 설명을 선택하고 F2 키를 누르거나 [설명]을 마우스 오른쪽 단추로 클릭하고 [수정]을 선택하고 새 설명을 입력한 다음 Enter 키를 누르거나 [적용]을 클릭합니다.

  • OS 피드 유형을 업데이트하려면 디바이스 그룹을 확장하고 OS 피드 유형을 선택하고 F2 키를 누르거나 OS 피드 유형을 마우스 오른쪽 단추로 클릭하고 수정을 선택하고 메뉴에서 Retail 또는 RetailEval을 선택한 다음 Enter 키를 누르거나 적용을 클릭합니다.

  • 업데이트 정책을 변경하려면 디바이스 그룹을 확장하고, 업데이트 정책을 선택하고, F2 키를 누르거나, 업데이트 정책을 마우스 오른쪽 단추로 클릭하고, 수정을 선택하고, 메뉴에서 No3rdPartyAppUpdates 또는 UpdateAll을 선택한 다음 Enter 키를 누르거나 적용을 클릭합니다. (세 번째 옵션, NoUpdates는 현재 내부용으로 예약되어 있습니다. 이 옵션을 선택하면 출력 창에 오류가 보고됩니다.)

azsphere device update 명령을 사용하거나 디바이스 - 이동 API를 사용하여 디바이스를 다른 디바이스 그룹으로 이동합니다.

디바이스를 다른 디바이스 그룹으로 이동

azsphere device update 명령을 사용하거나 디바이스 - 이동 API를 사용하여 디바이스를 다른 디바이스 그룹으로 이동합니다.

제품 이름/<device-group-name 형식으로 디바이스 그룹 ID 또는 제품 이름과> 디바이스 그룹 이름의 <> 조합을 지정합니다.

azsphere device update --device-group <device-group-id>

azsphere device update --device-group <product-name/device-group-name>

디바이스 그룹 삭제

azsphere device-group delete 명령을 사용하거나 디바이스 그룹 - 삭제 API를 사용하여 Azure Sphere 테넌트에서 지정된 디바이스 그룹을 삭제합니다.

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

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

제품 이름/<device-group-name 형식으로 디바이스 그룹 ID 또는 제품 이름과> 디바이스 그룹 이름의 <> 조합을 지정합니다.

azsphere device-group delete --device-group <device-group-id>

azsphere device-group delete --device-group <product-name/device-group-name>