다음을 통해 공유


IoT Hub에 대한 디바이스 업데이트에서 디바이스 그룹 만들기

IoT Hub에 대한 디바이스 업데이트를 통해 IoT 디바이스 그룹에 업데이트를 배포할 수 있습니다.

참고

사용자가 만든 그룹 대신 기본 그룹에 배포하려는 경우 업데이트를 배포하는 방법으로 직접 이동할 수 있습니다.

필수 구성 요소

디바이스에 태그 추가

IoT Hub에 대한 디바이스 업데이트를 통해 IoT 디바이스 그룹에 업데이트를 배포할 수 있습니다. 그룹 만들기의 첫 번째 단계는 IoT Hub의 대상 디바이스 집합에 태그를 추가하는 것입니다. 태그는 디바이스 업데이트에 연결된 후에만 디바이스에 추가될 수 있습니다.

아래 문서에서는 태그를 추가하고 업데이트하는 방법을 설명합니다.

프로그래밍 방식으로 디바이스 쌍 업데이트

디바이스 업데이트를 사용하여 디바이스를 등록한 후 RegistryManager를 사용하여 적절한 태그로 디바이스 쌍을 업데이트할 수 있습니다.

디바이스 업데이트 태그 형식

     "tags": {
              "ADUGroup": "<CustomTagValue>"
             }

작업 사용

디바이스 업데이트 태그를 추가하거나 업데이트하기 위해 여러 디바이스에서 작업을 예약할 수 있습니다. 예를 들어 여러 디바이스에서 작업 예약을 참조하세요. 작업을 사용하여 디바이스 쌍 또는 모듈 쌍(디바이스 업데이트 에이전트가 모듈 ID로 설정된 경우)을 업데이트할 수 있습니다. 자세한 내용은 작업 예약 및 브로드캐스트를 참조하세요.

참고

이 작업은 IoT Hub 메시지 할당량에 대해 계산되며, 한 번에 최대 50,000개의 디바이스 또는 모듈 쌍 태그만 변경하는 것이 좋습니다. 그렇지 않으면 일일 IoT Hub 메시지 할당량을 초과하는 경우 더 많은 IoT Hub 단위를 구입해야 할 수 있습니다. 자세한 내용은 할당량 및 제한에서 확인할 수 있습니다.

직접 트윈 업데이트

디바이스 쌍 또는 모듈 쌍에서 직접 태그를 추가하거나 업데이트할 수도 있습니다.

  1. Azure Portal에 로그인하고 IoT Hub로 이동합니다.

  2. 탐색 메뉴에서 디바이스 를 선택하고 IoT 디바이스를 선택하여 디바이스 세부 정보를 엽니다.

  3. 트윈 세부 정보를 엽니다.

    • 디바이스 업데이트 에이전트가 디바이스 ID로 구성된 경우 디바이스 쌍을 선택합니다.
    • 디바이스 업데이트 에이전트가 모듈 ID로 구성된 경우 디바이스 업데이트 모듈을 선택한 다음 , 모듈 ID 쌍을 선택합니다.
  4. 디바이스 쌍 또는 모듈 쌍에서 null로 설정하여 기존 디바이스 업데이트 태그 값을 삭제합니다.

  5. 아래와 같이 새 디바이스 업데이트 태그 값을 추가합니다. 태그가 있는 디바이스 쌍 JSON 문서 예시입니다.

    "tags": {
            "ADUGroup": "<CustomTagValue>"
            }

제한 사항

  • 예약된 값인 '범주화되지 않음'을 제외하고 모든 값을 태그에 추가할 수 있습니다.
  • 태그 값은 255자를 초과할 수 없습니다.
  • 태그 값에는 영숫자 문자와 특수 문자 ".", "-", "_", "~"을 사용할 수 있습니다.
  • 태그 및 그룹 이름은 대/소문자를 구분합니다.
  • 디바이스에는 이름 ADUGroup을 가진 태그를 하나만 포함할 수 있습니다. 해당 이름의 태그를 추가하면 태그 이름 ADUGroup의 기존 값이 재정의됩니다.
  • 한 디바이스는 하나의 그룹에만 속할 수 있습니다.

기존 IoT Hub 태그를 선택하여 디바이스 그룹 만들기

  1. Azure Portal로 이동합니다.

  2. 이전에 디바이스 업데이트 인스턴스에 연결한 IoT Hub를 선택합니다.

  3. 왼쪽 탐색 모음에서 장치 관리 아래에 있는 업데이트 옵션을 선택합니다.

  4. 페이지 맨 위에 있는 그룹 및 배포 탭을 선택합니다.

    그룹으로 묶이지 않은 디바이스의 스크린샷

  5. 그룹 추가를 선택하여 새 그룹을 만듭니다.

    디바이스 그룹 추가의 스크린샷

  6. 목록에서 IoT Hub 태그 및 디바이스 클래스를 선택한 다음, 그룹 만들기를 선택합니다.

    태그 선택의 스크린샷

  7. 그룹이 만들어지면 업데이트 규정 준수 차트 및 그룹 목록이 업데이트된 것을 볼 수 있습니다. 업데이트 규정 준수 차트에는 최신 업데이트, 사용 가능한 새 업데이트, 진행 중인 업데이트 등 다양한 준수 상태의 디바이스 수가 표시됩니다. 업데이트 규정 준수에 대해 알아봅니다.

    업데이트 준수 보기의 스크린샷.

  8. 새로 만든 그룹 및 새 그룹의 디바이스에 사용 가능한 업데이트가 표시되어야 합니다. 그룹의 디바이스 클래스 요구 사항을 충족하지 않는 디바이스가 있는 경우 해당하는 잘못된 그룹에 표시됩니다. 그룹 옆에 있는 “배포” 단추를 클릭하여 이 보기에서 새 사용자 정의 그룹에 가장 적합한 사용 가능한 업데이트를 배포할 수 있습니다. 자세한 내용은 다음 단계: 업데이트 배포를 참조하세요.

만든 그룹의 디바이스 세부 정보 보기

  1. 새로 만든 그룹으로 이동하고 그룹 이름을 클릭합니다.

  2. 그룹의 일부인 디바이스 목록이 해당 디바이스 업데이트 속성과 함께 표시됩니다. 이 보기에서 해당 그룹의 구성 요소인 모든 디바이스의 업데이트 규정 준수 정보를 볼 수도 있습니다. 업데이트 규정 준수 차트는 최신 업데이트, 사용 가능한 새 업데이트 및 진행 중인 업데이트에 대한 다양한 준수 상태의 디바이스 수를 표시합니다.

    디바이스 그룹 세부 정보 보기의 스크린샷

  3. 그룹 내의 각 개별 디바이스를 클릭하여 IoT Hub의 디바이스 세부 정보 페이지로 리디렉션할 수도 있습니다.

    디바이스 그룹 세부 정보 보기의 스크린샷

다음 단계

업데이트 배포

디바이스 그룹에 대해 자세히 알아봅니다

업데이트 규정 준수에 대해 알아봅니다.