다음을 통해 공유

az iot du device group

  • 참조

참고 항목

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

디바이스 그룹 관리.

디바이스 그룹은 디바이스의 컬렉션을 말합니다. 디바이스 그룹은 여러 디바이스에 배포를 확장하는 방법을 제공합니다. 각 디바이스는 한 번에 정확히 하나의 디바이스 그룹에 속합니다. 디바이스 그룹은 디바이스 업데이트 사용 디바이스가 허브에 연결되고 해당 속성을 보고할 때 자동으로 만들어집니다.

명령

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

디바이스 그룹을 삭제합니다.

 내선 번호 GA
az iot du device group list

인스턴스 내의 디바이스 그룹을 나열합니다.

 내선 번호 GA
az iot du device group show

최상의 업데이트 및 업데이트 준수를 포함하여 디바이스 그룹에 대한 세부 정보를 표시합니다.

 내선 번호 GA

az iot du device group delete

디바이스 그룹을 삭제합니다.

디바이스 그룹은 자동으로 정리되지 않지만 기록 목적으로 유지됩니다. 그룹이 필요 없거나 해당 그룹에 대한 기록을 유지할 필요가 없는 경우 이 작업을 사용할 수 있습니다. 그룹이 삭제된 후 그룹에 대해 디바이스가 다시 연결되면 기록 없이 자동으로 다시 만들어집니다.

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

예제

디바이스 그룹을 삭제합니다.

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

확인 프롬프트를 건너뛰는 디바이스 그룹을 삭제합니다.

az iot du device group delete -n {account_name} -i {instance_name} --group-id {device_group_id} -y

필수 매개 변수

--account -n

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

--gid --group-id

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

--instance -i

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

선택적 매개 변수

--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
Default value: json
--query

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

--subscription

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

--verbose

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

az iot du device group list

인스턴스 내의 디바이스 그룹을 나열합니다.

az iot du device group list --account
                            --instance
                            [--order-by]
                            [--resource-group]

예제

디바이스 그룹을 나열합니다.

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

디바이스 그룹을 원하는 순서로 나열합니다(이 경우 deviceCount).

az iot du device group list -n {account_name} -i {instance_name} --order-by deviceCount

필수 매개 변수

--account -n

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

--instance -i

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

선택적 매개 변수

--order-by

반환된 그룹 집합을 주문합니다. groupId, deviceCount, createdDateTime, subgroupsWithNewUpdatesAvailableCount, subgroupsWithUpdatesInProgressCount 또는 subgroupsWithOnLatestUpdateCount로 주문할 수 있습니다.

--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
Default value: json
--query

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

--subscription

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

--verbose

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

az iot du device group show

최상의 업데이트 및 업데이트 준수를 포함하여 디바이스 그룹에 대한 세부 정보를 표시합니다.

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

예제

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

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

디바이스 그룹에 사용할 수 있는 최상의 업데이트를 표시합니다. 이 플래그는 목록을 반환하도록 명령을 수정합니다.

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

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

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

필수 매개 변수

--account -n

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

--gid --group-id

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

--instance -i

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

선택적 매개 변수

--best-updates

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

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

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

--update-compliance

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

허용되는 값: false, true
전역 매개 변수
--debug

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

--help -h

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

--only-show-errors

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

--output -o

출력 형식입니다.

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

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

--subscription

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

--verbose

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