az iot du device class

  • 참조

참고 항목

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

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

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

명령

Name Description 형식 상태
az iot du device class delete

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

 내선 번호 GA
az iot du device class list

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

 내선 번호 GA
az iot du device class show

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

 내선 번호 GA
az iot du device class update

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

 내선 번호 GA

az iot du device class delete

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

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

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

예제

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

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

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

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

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

az iot du 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
전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
기본값: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az iot du device class list

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

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

예제

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

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

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

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

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

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

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

az iot du 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>기본 그룹을 구성할 수 있습니다.

전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
기본값: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az iot du device class show

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

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

예제

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

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

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

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

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

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

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

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

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

az iot du 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
전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
기본값: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az iot du device class update

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

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

예제

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

az iot du 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>기본 그룹을 구성할 수 있습니다.

전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
기본값: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.