az iot du device group

참고

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

디바이스 그룹 관리.

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

명령

az iot du device group delete

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

az iot du device group list

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

az iot du device group show

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

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 디바이스/모듈 쌍의 ADUGroup 태그 값 또는 태그가 없는 디바이스에 대한 $default 만들어집니다.

--instance -i

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

선택적 매개 변수

--resource-group -g

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

--yes -y

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

허용되는 값: false, true

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 또는 하위 그룹WithOnLatestUpdateCount로 주문할 수 있습니다.

--resource-group -g

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

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 디바이스/모듈 쌍의 ADUGroup 태그 값 또는 태그가 없는 디바이스에 대한 $default 만들어집니다.

--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