az iot du device deployment

참고

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

디바이스 배포 관리.

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

명령

az iot du device deployment cancel

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

az iot du device deployment create

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

az iot du device deployment delete

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

az iot du device deployment list

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

az iot du device deployment list-devices

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

az iot du device deployment retry

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

az iot du device deployment show

배포가 진행 중이거나 완료되었거나 실패한 디바이스 수에 대한 분석을 자세히 보여 주는 상태를 포함하여 디바이스 그룹 또는 디바이스 클래스 하위 그룹에 대한 배포를 표시합니다.

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

--instance -i

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

선택적 매개 변수

--resource-group -g

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

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

--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'에 해당하는 값이 사용됩니다.

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

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

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

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

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

--instance -i

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

선택적 매개 변수

--filter

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

--resource-group -g

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

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

--instance -i

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

선택적 매개 변수

--resource-group -g

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

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

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