az iot device-update device class

참고

이 참조는 Azure CLI(버전 2.30.0 이상)에 대한 azure-iot 확장의 일부입니다. az iot device-update device class 명령을 처음 실행할 때 확장이 자동으로 설치됩니다. 확장에 대해 자세히 알아보세요.

디바이스 클래스 및 디바이스 클래스 하위 그룹 관리.

디바이스 클래스는 여러 그룹에서 공통 특성 집합을 공유하는 디바이스 집합을 설명하고 디바이스 클래스 하위 그룹은 동일한 디바이스 클래스 ID를 공유하는 그룹의 디바이스 하위 집합입니다. 디바이스 클래스는 디바이스 업데이트 사용 디바이스가 허브에 연결될 때 자동으로 만들어집니다.

명령

az iot device-update device class delete

디바이스 클래스 또는 디바이스 클래스 하위 그룹을 삭제합니다.

az iot device-update device class list

디바이스 클래스 또는 디바이스 클래스 하위 그룹을 나열합니다.

az iot device-update device class show

설치 가능한 업데이트, 최상의 업데이트 및 업데이트 준수를 포함하여 디바이스 클래스 또는 디바이스 클래스 하위 그룹에 대한 세부 정보를 표시합니다.

az iot device-update device class update

디바이스 클래스를 업데이트합니다.

az iot device-update device class delete

디바이스 클래스 또는 디바이스 클래스 하위 그룹을 삭제합니다.

디바이스 클래스는 디바이스 업데이트 사용 디바이스가 허브에 연결되어 있지만 디바이스 클래스 하위 그룹에서 참조되므로 자동으로 정리되지 않을 때 자동으로 만들어집니다. 대상 디바이스 클래스에 대한 모든 디바이스 클래스 하위 그룹이 삭제되면 디바이스 클래스 자체를 삭제하여 시스템에서 레코드를 제거하고 디바이스 클래스와 새 업데이트의 호환성 확인을 중지할 수도 있습니다. 디바이스가 다시 연결된 경우 디바이스 클래스가 없으면 디바이스 클래스가 다시 만들어집니다.

az iot device-update device class delete --account
                                         --cid
                                         --instance
                                         [--gid]
                                         [--resource-group]
                                         [--yes {false, true}]

예제

디바이스 클래스를 삭제합니다.

az iot device-update device class delete -n {account_name} -i {instance_name} --class-id {device_class_id}

디바이스 클래스를 삭제하고 확인 프롬프트를 건너뜁니다.

az iot device-update device class delete -n {account_name} -i {instance_name} --class-id {device_class_id} -y

디바이스 클래스 하위 그룹을 삭제합니다.

az iot device-update device class delete -n {account_name} -i {instance_name} --class-id {device_class_id} --group-id {device_group_id}

필수 매개 변수

--account -n

디바이스 업데이트 계정 이름입니다. 를 사용하여 az config set defaults.adu_account=<name>기본 계정 이름을 구성할 수 있습니다.

--cid --class-id

디바이스 클래스 ID입니다. IoT Hub 디바이스 업데이트 PnP 인터페이스에서 디바이스 업데이트 에이전트가 보고한 모델 ID 및 호환성 속성에서 생성됩니다. 16진수로 인코딩된 SHA1 해시입니다.

--instance -i

디바이스 업데이트 인스턴스 이름입니다. 를 사용하여 az config set defaults.adu_instance=<name>기본 인스턴스 이름을 구성할 수 있습니다.

선택적 매개 변수

--gid --group-id

디바이스 그룹 ID입니다. 태그가 없는 디바이스에 대해 연결된 IoT Hub 디바이스/모듈 쌍 또는 $default ADUGroup 태그 값에서 생성됩니다.

--resource-group -g

디바이스 업데이트 계정 리소스 그룹 이름입니다. az config set defaults.adu_group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

--yes -y

사용자 프롬프트를 건너뜁니다. 작업 수락을 나타냅니다. 주로 자동화 시나리오에 사용됩니다. 기본값: false입니다.

허용되는 값: false, true

az iot device-update device class list

디바이스 클래스 또는 디바이스 클래스 하위 그룹을 나열합니다.

az iot device-update device class list --account
                                       --instance
                                       [--filter]
                                       [--gid]
                                       [--resource-group]

예제

인스턴스 내의 디바이스 클래스를 나열합니다.

az iot device-update device class list -n {account_name} -i {instance_name}

이름별로 필터링된 인스턴스 디바이스 클래스를 나열합니다.

az iot device-update device class list -n {account_name} -i {instance_name} --filter "friendlyName eq 'my-favorite-class'"

그룹에 대한 디바이스 클래스 하위 그룹을 나열합니다.

az iot device-update device class list -n {account_name} -i {instance_name} --group-id {device_group_id}

compatProperties/manufacturer로 필터링된 그룹에 대한 디바이스 클래스 하위 그룹을 나열합니다.

az iot device-update device class list -n {account_name} -i {instance_name} --group-id {device_group_id} --filter "compatProperties/manufacturer eq 'Contoso'"

필수 매개 변수

--account -n

디바이스 업데이트 계정 이름입니다. 를 사용하여 az config set defaults.adu_account=<name>기본 계정 이름을 구성할 수 있습니다.

--instance -i

디바이스 업데이트 인스턴스 이름입니다. 를 사용하여 az config set defaults.adu_instance=<name>기본 인스턴스 이름을 구성할 수 있습니다.

선택적 매개 변수

--filter

--group-id와 함께 제공되는 경우 디바이스 클래스 호환 속성 이름 및 값을 기반으로 필터링을 지원합니다. 예를 들어 "compatProperties/manufacturer eq 'Contoso'"입니다. 그렇지 않으면 클래스 이름별로 필터링을 지원합니다.

--gid --group-id

디바이스 그룹 ID입니다. 태그가 없는 디바이스에 대해 연결된 IoT Hub 디바이스/모듈 쌍 또는 $default ADUGroup 태그 값에서 생성됩니다.

--resource-group -g

디바이스 업데이트 계정 리소스 그룹 이름입니다. az config set defaults.adu_group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

az iot device-update device class show

설치 가능한 업데이트, 최상의 업데이트 및 업데이트 준수를 포함하여 디바이스 클래스 또는 디바이스 클래스 하위 그룹에 대한 세부 정보를 표시합니다.

az iot device-update device class show --account
                                       --cid
                                       --instance
                                       [--best-update {false, true}]
                                       [--gid]
                                       [--installable-updates {false, true}]
                                       [--resource-group]
                                       [--update-compliance {false, true}]

예제

디바이스 클래스를 표시합니다.

az iot device-update device class show -n {account_name} -i {instance_name} --class-id {device_class_id}

디바이스 클래스에 대한 설치 가능한 업데이트를 표시합니다. 이 플래그는 목록을 반환하도록 명령을 수정합니다.

az iot device-update device class show -n {account_name} -i {instance_name} --class-id {device_class_id} --installable-updates

디바이스 클래스 하위 그룹을 표시합니다.

az iot device-update device class show -n {account_name} -i {instance_name} --class-id {device_class_id} --group-id {device_group_id}

디바이스 클래스 하위 그룹에 사용할 수 있는 최상의 업데이트를 표시합니다.

az iot device-update device class show -n {account_name} -i {instance_name} --class-id {device_class_id} --group-id {device_group_id} --best-update

디바이스 클래스 하위 그룹에 대한 업데이트 준수를 표시합니다.

az iot device-update device class show -n {account_name} -i {instance_name} --class-id {device_class_id} --group-id {device_group_id} --update-compliance

필수 매개 변수

--account -n

디바이스 업데이트 계정 이름입니다. 를 사용하여 az config set defaults.adu_account=<name>기본 계정 이름을 구성할 수 있습니다.

--cid --class-id

디바이스 클래스 ID입니다. IoT Hub 디바이스 업데이트 PnP 인터페이스에서 디바이스 업데이트 에이전트가 보고한 모델 ID 및 호환성 속성에서 생성됩니다. 16진수로 인코딩된 SHA1 해시입니다.

--instance -i

디바이스 업데이트 인스턴스 이름입니다. 를 사용하여 az config set defaults.adu_instance=<name>기본 인스턴스 이름을 구성할 수 있습니다.

선택적 매개 변수

--best-update

업데이트가 필요한 디바이스 수를 포함하여 명령이 디바이스 클래스 하위 그룹에 사용할 수 있는 최상의 업데이트를 가져와야 함을 나타내는 플래그입니다. 이 플래그에는 그룹 ID가 필요합니다. 최상의 업데이트는 디바이스 클래스의 모든 호환성 사양을 충족하는 최신 업데이트입니다.

허용되는 값: false, true
--gid --group-id

디바이스 그룹 ID입니다. 태그가 없는 디바이스에 대해 연결된 IoT Hub 디바이스/모듈 쌍 또는 $default ADUGroup 태그 값에서 생성됩니다.

--installable-updates

명령이 디바이스 클래스에 대한 설치 가능한 업데이트를 가져와야 함을 나타내는 플래그입니다.

허용되는 값: false, true
--resource-group -g

디바이스 업데이트 계정 리소스 그룹 이름입니다. az config set defaults.adu_group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

--update-compliance

명령이 디바이스 클래스 하위 그룹 업데이트 준수 정보를 가져와야 함을 나타내는 플래그(예: 최신 업데이트에 있는 디바이스 수, 새 업데이트가 필요한 디바이스 수 및 새 업데이트를 수신하는 진행 중인 디바이스 수). 이 플래그에는 그룹 ID가 필요합니다.

허용되는 값: false, true

az iot device-update device class update

디바이스 클래스를 업데이트합니다.

az iot device-update device class update --account
                                         --cid
                                         --instance
                                         [--friendly-name]
                                         [--resource-group]

예제

디바이스 클래스 이름을 업데이트합니다.

az iot device-update device class update -n {account_name} -i {instance_name} --class-id {device_class_id} --friendly-name "EU-region"

필수 매개 변수

--account -n

디바이스 업데이트 계정 이름입니다. 를 사용하여 az config set defaults.adu_account=<name>기본 계정 이름을 구성할 수 있습니다.

--cid --class-id

디바이스 클래스 ID입니다. IoT Hub 디바이스 업데이트 PnP 인터페이스에서 디바이스 업데이트 에이전트가 보고한 모델 ID 및 호환성 속성에서 생성됩니다. 16진수로 인코딩된 SHA1 해시입니다.

--instance -i

디바이스 업데이트 인스턴스 이름입니다. 를 사용하여 az config set defaults.adu_instance=<name>기본 인스턴스 이름을 구성할 수 있습니다.

선택적 매개 변수

--friendly-name

디바이스 클래스 이름입니다. 친숙한 이름은 1-100자여야 하며 영숫자, 점 및 대시 값을 지원합니다.

--resource-group -g

디바이스 업데이트 계정 리소스 그룹 이름입니다. az config set defaults.adu_group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.