az iot du device deployment

참고 항목

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

디바이스 배포 관리.

배포는 그룹 내의 디바이스 클래스 간에 업데이트를 배포하는 대상 디바이스 그룹에 대해 원하는 호환 업데이트를 적용합니다. 클라우드 시작 롤백 정책은 필요에 따라 구성할 수 있습니다.

명령

Name Description 형식 상태
az iot du device deployment cancel

디바이스 클래스 하위 그룹 배포를 취소합니다.

내선 번호 GA
az iot du device deployment create

디바이스 그룹에 대한 배포를 만듭니다. 배포는 대상 그룹 내의 모든 디바이스 클래스 하위 그룹에 대해 다중 캐스팅됩니다.

내선 번호 GA
az iot du device deployment delete

디바이스 그룹 또는 디바이스 클래스 하위 그룹별로 배포를 삭제합니다.

내선 번호 GA
az iot du device deployment list

디바이스 그룹 또는 디바이스 클래스 하위 그룹에 대한 배포를 나열합니다.

내선 번호 GA
az iot du device deployment list-devices

디바이스 클래스 하위 그룹 배포의 디바이스를 해당 상태와 함께 나열합니다. 실패한 디바이스 목록을 가져오는 데 유용합니다.

내선 번호 GA
az iot du device deployment retry

디바이스 클래스 하위 그룹 배포를 다시 시도합니다.

내선 번호 GA
az iot du device deployment show

상태 포함하여 디바이스 그룹 또는 디바이스 클래스 하위 그룹에 대한 배포를 표시합니다. 여기에는 배포가 진행 중, 완료 또는 실패한 디바이스 수에 대한 분석 정보가 나와 있습니다.

내선 번호 GA

az iot du device deployment cancel

디바이스 클래스 하위 그룹 배포를 취소합니다.

az iot du device deployment cancel --account
                                   --cid
                                   --deployment-id
                                   --gid
                                   --instance
                                   [--resource-group]

예제

대상 디바이스 클래스 하위 그룹 배포를 취소합니다.

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

필수 매개 변수

--account -n

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

--cid --class-id

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

--deployment-id --did

호출자가 제공한 배포 ID입니다. 73자를 초과할 수 없으며 모두 소문자여야 하며 '&', '^', '[', ']', '{', '}', '|', '', '<', '>', 슬래시, 백슬래시 또는 큰따옴표를 포함할 수 없습니다.

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

전역 매개 변수
--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 deployment create

디바이스 그룹에 대한 배포를 만듭니다. 배포는 대상 그룹 내의 모든 디바이스 클래스 하위 그룹에 대해 다중 캐스팅됩니다.

az iot du device deployment create --account
                                   --deployment-id
                                   --gid
                                   --instance
                                   --un
                                   --up
                                   --update-version
                                   [--failed-count]
                                   [--failed-percentage]
                                   [--rbun]
                                   [--rbup]
                                   [--rbuv]
                                   [--resource-group]
                                   [--start-time]

예제

UTC 시간과 관련하여 즉시 시작하도록 예약된 디바이스 그룹 배포를 만듭니다.

az iot du device deployment create -n {account_name} -i {instance_name} --group-id {device_group_id} --deployment-id {deployment_id} --update-name {update_name} --update-provider {update_provider} --update-version {update_version}

원하는 iso-8601 호환 날짜/시간에 시작하도록 예약된 디바이스 그룹 배포를 만듭니다.

az iot du device deployment create -n {account_name} -i {instance_name} --group-id {device_group_id} --deployment-id {deployment_id} --update-name {update_name} --update-provider {update_provider} --update-version {update_version} --start-time "2022-12-20T01:00:00"

정의된 클라우드 시작 롤백 정책으로 즉시 시작하도록 예약된 디바이스 그룹 배포를 만듭니다. 클라우드 롤백은 실패한 수 또는 실패한 백분율 대상이 충족될 때 시작됩니다.

az iot du device deployment create -n {account_name} -i {instance_name} --group-id {device_group_id} --deployment-id {deployment_id} --update-name {update_name} --update-provider {update_provider} --update-version {update_version} --failed-count 10 --failed-percentage 5 --rollback-update-name {rollback_update_name} --rollback-update-provider {rollback_update_provider} --rollback-update-version {rollback_update_version}

필수 매개 변수

--account -n

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

--deployment-id --did

호출자가 제공한 배포 ID입니다. 73자를 초과할 수 없으며 모두 소문자여야 하며 '&', '^', '[', ']', '{', '}', '|', '', '<', '>', 슬래시, 백슬래시 또는 큰따옴표를 포함할 수 없습니다.

--gid --group-id

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

--instance -i

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

--un --update-name

업데이트 이름입니다.

--up --update-provider

업데이트 공급자입니다.

--update-version --uv

업데이트 버전입니다.

선택적 매개 변수

--failed-count --fc

클라우드 초기화 롤백이 발생하기 전에 배포에서 실패한 디바이스 수를 나타내는 정수입니다. 롤백 정책을 정의할 때 필요합니다.

--failed-percentage --fp

클라우드 초기화 롤백이 발생하기 전에 배포에서 실패한 디바이스의 백분율을 나타내는 정수입니다. 롤백 정책을 정의할 때 필요합니다.

--rbun --rollback-update-name

롤백 업데이트 이름입니다.

--rbup --rollback-update-provider

롤백 업데이트 공급자입니다.

--rbuv --rollback-update-version

롤백 업데이트 버전입니다.

--resource-group -g

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

--start-time

배포에 대한 iso-8601 규격 시작 시간입니다. 값이 제공되지 않으면 UTC 'now'에 해당하는 값이 사용됩니다.

전역 매개 변수
--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 deployment delete

디바이스 그룹 또는 디바이스 클래스 하위 그룹별로 배포를 삭제합니다.

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

예제

대상 디바이스 그룹 배포를 삭제합니다.

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

대상 디바이스 클래스 하위 그룹 배포를 삭제합니다.

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

필수 매개 변수

--account -n

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

--deployment-id --did

호출자가 제공한 배포 ID입니다. 73자를 초과할 수 없으며 모두 소문자여야 하며 '&', '^', '[', ']', '{', '}', '|', '', '<', '>', 슬래시, 백슬래시 또는 큰따옴표를 포함할 수 없습니다.

--gid --group-id

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

--instance -i

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

선택적 매개 변수

--cid --class-id

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

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

디바이스 그룹 또는 디바이스 클래스 하위 그룹에 대한 배포를 나열합니다.

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

예제

디바이스 그룹에 대한 배포를 나열합니다.

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

startDateTime 내림차순으로 디바이스 그룹 정렬 결과에 대한 배포를 나열합니다.

az iot du device deployment list -n {account_name} -i {instance_name} --group-id {device_group_id} --order-by "startDateTime desc"

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

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

필수 매개 변수

--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>기본 인스턴스 이름을 구성할 수 있습니다.

선택적 매개 변수

--cid --class-id

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

--order-by

반환된 배포 집합을 주문합니다. startDateTime [desc/asc]으로 주문할 수 있습니다.

--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 deployment list-devices

디바이스 클래스 하위 그룹 배포의 디바이스를 해당 상태와 함께 나열합니다. 실패한 디바이스 목록을 가져오는 데 유용합니다.

az iot du device deployment list-devices --account
                                         --cid
                                         --deployment-id
                                         --gid
                                         --instance
                                         [--filter]
                                         [--resource-group]

예제

디바이스 클래스 하위 그룹 배포에서 디바이스를 나열합니다.

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

deviceId 및 deviceState에 의한 디바이스 클래스 하위 그룹 배포 필터링의 디바이스를 나열합니다.

az iot du device deployment list-devices -n {account_name} -i {instance_name} --group-id {device_group_id} --class-id {device_class_id} --deployment-id {deployment_id} --filter "deviceId eq 'd0' and deviceState eq 'InProgress'"

필수 매개 변수

--account -n

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

--cid --class-id

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

--deployment-id --did

호출자가 제공한 배포 ID입니다. 73자를 초과할 수 없으며 모두 소문자여야 하며 '&', '^', '[', ']', '{', '}', '|', '', '<', '>', 슬래시, 백슬래시 또는 큰따옴표를 포함할 수 없습니다.

--gid --group-id

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

--instance -i

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

선택적 매개 변수

--filter

반환된 배포 디바이스 상태 집합을 제한합니다. deviceId 및 moduleId 및/또는 deviceState에서 필터링할 수 있습니다.

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

디바이스 클래스 하위 그룹 배포를 다시 시도합니다.

az iot du device deployment retry --account
                                  --cid
                                  --deployment-id
                                  --gid
                                  --instance
                                  [--resource-group]

예제

대상 디바이스 클래스 하위 그룹 배포를 다시 시도합니다.

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

필수 매개 변수

--account -n

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

--cid --class-id

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

--deployment-id --did

호출자가 제공한 배포 ID입니다. 73자를 초과할 수 없으며 모두 소문자여야 하며 '&', '^', '[', ']', '{', '}', '|', '', '<', '>', 슬래시, 백슬래시 또는 큰따옴표를 포함할 수 없습니다.

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

전역 매개 변수
--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 deployment show

상태 포함하여 디바이스 그룹 또는 디바이스 클래스 하위 그룹에 대한 배포를 표시합니다. 여기에는 배포가 진행 중, 완료 또는 실패한 디바이스 수에 대한 분석 정보가 나와 있습니다.

az iot du device deployment show --account
                                 --deployment-id
                                 --gid
                                 --instance
                                 [--cid]
                                 [--resource-group]
                                 [--status {false, true}]

예제

디바이스 그룹에 대한 배포를 표시합니다.

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

디바이스 그룹 배포의 상태 표시합니다.

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

디바이스 클래스 하위 그룹에 대한 배포를 표시합니다.

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

디바이스 클래스 하위 그룹 배포의 상태 표시합니다.

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

필수 매개 변수

--account -n

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

--deployment-id --did

호출자가 제공한 배포 ID입니다. 73자를 초과할 수 없으며 모두 소문자여야 하며 '&', '^', '[', ']', '{', '}', '|', '', '<', '>', 슬래시, 백슬래시 또는 큰따옴표를 포함할 수 없습니다.

--gid --group-id

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

--instance -i

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

선택적 매개 변수

--cid --class-id

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

--resource-group -g

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

--status

배포 진행 중, 완료 또는 실패한 디바이스 수에 대한 분석을 포함하여 배포의 상태 가져옵니다.

허용되는 값: 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를 사용합니다.