az iot du update

참고 항목

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

디바이스 업데이트 업데이트 관리.

명령

Name	Description	형식	상태
az iot du update calculate-hash	파일의 base64 해시 표현을 계산합니다.	내선 번호	GA
az iot du update delete	특정 업데이트 버전을 삭제합니다.	내선 번호	GA
az iot du update file	파일 작업을 업데이트합니다.	내선 번호	GA
az iot du update file list	업데이트 공급자, 이름 및 버전과 관련하여 업데이트 파일 ID를 나열합니다.	내선 번호	GA
az iot du update file show	업데이트 공급자, 이름 및 버전과 관련하여 특정 업데이트 파일의 세부 정보를 표시합니다.	내선 번호	GA
az iot du update import	새 업데이트 버전을 디바이스 업데이트 인스턴스로 가져옵니다.	내선 번호	GA
az iot du update init	매니페스트 초기화를 가져오기 위한 유틸리티입니다.	내선 번호	미리 보기
az iot du update init v5	원하는 상태로 v5 가져오기 매니페스트를 초기화합니다.	내선 번호	미리 보기
az iot du update list	디바이스 업데이트 인스턴스로 가져온 업데이트를 나열합니다.	내선 번호	GA
az iot du update show	특정 업데이트 버전을 표시합니다.	내선 번호	GA
az iot du update stage	대상 인스턴스로 가져오기 위한 업데이트를 준비합니다.	내선 번호	미리 보기

az iot du update calculate-hash

파일의 base64 해시 표현을 계산합니다.

az iot du update calculate-hash --file-path
                                [--hash-algo {sha256}]

예제

대상 업데이트 파일에 대한 sha256 다이제스트의 base64 표현을 계산합니다.

az iot du update calculate-hash --file-path /path/to/file

여러 대상 업데이트 파일에 대한 sha256 다이제스트의 base64 표현을 계산합니다.

az iot du update calculate-hash --file-path /path/to/file1 --file-path /path/to/file2 --file-path /path/to/file3

필수 매개 변수

--file-path -f

해시 계산을 위해 대상 파일에 대한 로컬 경로입니다. --file-path는 1회 이상 사용할 수 있습니다.

선택적 매개 변수

--hash-algo

해시에 사용할 암호화 알고리즘입니다.

허용되는 값: sha256

기본값: sha256

전역 매개 변수

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

특정 업데이트 버전을 삭제합니다.

az iot du update delete --account
                        --instance
                        --un
                        --up
                        --update-version
                        [--no-wait]
                        [--resource-group]
                        [--yes {false, true}]

예제

업데이트 공급자, 이름 및 버전과 관련하여 대상 업데이트를 삭제합니다.

az iot du update delete -n {account_name} -i {instance_name} --update-provider {provider_name} --update-name {update_name} --update-version {update_version}

필수 매개 변수

--account -n

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

--instance -i

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

--un --update-name

업데이트 이름입니다.

--up --update-provider

업데이트 공급자입니다.

--update-version --uv

업데이트 버전입니다.

선택적 매개 변수

--no-wait

장기 실행 작업이 완료되기를 기다리지 마세요.

기본값: False

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

새 업데이트 버전을 디바이스 업데이트 인스턴스로 가져옵니다.

이 명령은 기능을 지원합니다 --defer . 이 명령을 사용하면 Azure로 전송할 개체 페이로드가 로컬 캐시에 저장됩니다. 이 명령을 사용하지 않고 --defer 다음으로 사용하면 새 요청 페이로드를 함께 보내는 캐시된 개체와 결합합니다.

성공하면 해당 로컬 캐시 항목이 제거됩니다. 오류가 발생하면 캐시된 콘텐츠는 제거되지 않습니다. 명령을 사용하여 az cache 로컬 캐시 항목을 독립적으로 관리합니다.

지연 지원은 주로 부모 및 자식 업데이트를 함께 제출할 수 있도록 여러 참조 단계가 있는 업데이트를 위한 것입니다.

az iot du update import --account
                        --instance
                        --url
                        [--defer]
                        [--file]
                        [--friendly-name]
                        [--hashes]
                        [--no-wait]
                        [--resource-group]
                        [--size]

예제

매니페스트 해시 값과 매니페스트 크기(바이트)를 명시적으로 제공하는 두 개의 관련 파일과 참조 단계가 없는 업데이트를 가져옵니다.

az iot du update import -n {account_name} -i {instance_name} --hashes sha256={hash_value} --size {size_in_bytes} --url {manifest_location} --file filename={file1_name} url={file1_url} --file filename={file2_name} url={file2_url}

CLI에서 가져오기 매니페스트 해시 값과 크기(바이트)를 계산할 수 있도록 두 개의 관련 파일과 참조 단계가 없는 업데이트를 가져옵니다.

az iot du update import -n {account_name} -i {instance_name} --url {manifest_location} --file filename={file1_name} url={file1_url} --file filename={file2_name} url={file2_url}

세 개의 가져오기 매니페스트에 하나의 관련 파일이 있는 두 개의 자식 업데이트 참조 단계를 사용하여 부모 업데이트를 가져옵니다. CLI가 해시 값과 크기를 모두 바이트 단위로 계산하도록 합니다. 이 작업은 '--defer' 기능에 의존합니다.

az iot du update import -n {account_name} -i {instance_name} --url {parent_manifest_location} --file filename={parent_file_name} url={parent_file_url} --defer

az iot du update import -n {account_name} -i {instance_name} --url {child1_manifest_location} --file filename={child1_file_name} url={child1_file_url} --defer

az iot du update import -n {account_name} -i {instance_name} --url {child2_manifest_location} --file filename={child2_file_name} url={child2_file_url}

필수 매개 변수

--account -n

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

--instance -i

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

--url

IoT Hub용 디바이스 업데이트에서 가져오기 매니페스트를 다운로드할 수 있는 라우팅 가능한 위치입니다. 일반적으로 만료가 3시간 이상으로 설정된 읽기 전용 SAS로 보호되는 Blob URL입니다.

선택적 매개 변수

--defer

Azure로 보내는 대신 로컬 캐시에 개체를 일시적으로 저장합니다. 명령을 사용하여 az cache 보거나 지웁니다.

--file

매니페스트 메타데이터 파일 속성을 가져오는 데 해당하는 공백으로 구분된 key=value 쌍입니다. 필수 키에는 파일 이름 및 URL이 포함됩니다. --file은 1회 이상 사용할 수 있습니다.

--friendly-name

업데이트 정의와 연결된 이름입니다.

--hashes

공백으로 구분된 key=value 쌍입니다. 여기서 키는 사용되는 해시 알고리즘이고 값은 base64로 인코딩된 가져오기 매니페스트 파일 해시입니다. sha256 항목 이상이 필요합니다. 제공되지 않으면 제공된 URL에서 계산됩니다.

--no-wait

장기 실행 작업이 완료되기를 기다리지 마세요.

기본값: False

--resource-group -g

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

--size

파일 크기(바이트 수)입니다. 제공되지 않으면 제공된 URL에서 계산됩니다.

전역 매개 변수

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

디바이스 업데이트 인스턴스로 가져온 업데이트를 나열합니다.

업데이트 공급자를 나열하는 경우 일반적인 인스턴스 조회 인수 외에 --by-provider 플래그만 제공해야 합니다. 업데이트 이름을 나열할 때 업데이트 공급자를 제공해야 합니다. 업데이트 버전을 나열할 때 업데이트 공급자 및 업데이트 이름을 제공해야 합니다.

az iot du update list --account
                      --instance
                      [--by-provider {false, true}]
                      [--filter]
                      [--resource-group]
                      [--search]
                      [--un]
                      [--up]

예제

모든 업데이트를 나열합니다.

az iot du update list -n {account_name} -i {instance_name}

자유 텍스트 검색 조건을 충족하는 모든 업데이트(이 경우 Contoso의 업데이트 공급자)를 나열합니다.

az iot du update list -n {account_name} -i {instance_name} --search 'Contoso'

배포할 수 없는 업데이트를 필터링하는 경우 odata 필터를 만족하는 모든 업데이트를 나열합니다.

az iot du update list -n {account_name} -i {instance_name} --filter 'isDeployable eq false'

모든 업데이트 공급자를 나열합니다.

az iot du update list -n {account_name} -i {instance_name} --by-provider

업데이트 공급자별로 모든 업데이트 이름을 나열합니다.

az iot du update list -n {account_name} -i {instance_name} --update-provider {provider_name}

업데이트 공급자 및 업데이트 이름을 사용하여 모든 업데이트 버전을 나열합니다.

az iot du update list -n {account_name} -i {instance_name} --update-provider {provider_name} --update-name {update_name}

필수 매개 변수

--account -n

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

--instance -i

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

선택적 매개 변수

--by-provider

결과 집합을 업데이트 공급자로 제한해야 함을 나타내는 플래그입니다.

허용되는 값: false, true

--filter

속성 값으로 반환되는 업데이트 집합을 제한합니다. 제약 조건이 없는 업데이트를 나열하거나 버전별로 나열할 때 지원됩니다.

--resource-group -g

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

--search

자유 텍스트 검색 식과 일치하는 업데이트를 요청합니다. 제약 조건 없이 업데이트를 나열할 때 지원됩니다.

--un --update-name

업데이트 이름입니다.

--up --update-provider

업데이트 공급자입니다.

전역 매개 변수

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

특정 업데이트 버전을 표시합니다.

az iot du update show --account
                      --instance
                      --un
                      --up
                      --update-version
                      [--resource-group]

예제

업데이트 공급자, 이름 및 버전과 관련하여 특정 업데이트를 표시합니다.

az iot du update show -n {account_name} -i {instance_name} --update-provider {provider_name} --update-name {update_name} --update-version {update_version}

필수 매개 변수

--account -n

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

--instance -i

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

--un --update-name

업데이트 이름입니다.

--up --update-provider

업데이트 공급자입니다.

--update-version --uv

업데이트 버전입니다.

선택적 매개 변수

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

미리 보기

이 명령은 미리 보기로 제공되며 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus

대상 인스턴스로 가져오기 위한 업데이트를 준비합니다.

업데이트 준비는 대상 인스턴스로 업데이트를 가져오는 필수 구성 요소 단계를 가속화하는 것을 의미합니다. 지정된 가져오기 매니페스트의 경우 프로세스는 관련 파일을 결정하고, 원하는 스토리지 컨테이너로 푸시하고, SAS URI를 생성하고, 성공적인 가져오기를 위한 다른 준비 단계를 다룹니다.

이 명령은 규칙 기반 업데이트 파일 구성에 따라 달라집니다. 대상 매니페스트에 대한 모든 업데이트 파일은 가져오기 매니페스트가 상주하는 동일한 디렉터리에 있어야 합니다.

키 기반 액세스는 Blob 아티팩트 업로드 및 읽기 액세스를 사용하여 3시간 동안 SAS URI를 생성하는 데 사용됩니다.

플래그가 제공되면 --then-import 명령은 준비된 업데이트를 가져옵니다. 그렇지 않으면 이 작업의 결과는 나중에 동일한 결과를 얻기 위해 실행할 가져오기 명령입니다.

이 명령은 대상 인스턴스에 대한 로컬 캐시 항목을 제거하고 새로 고칩니다.

az iot du update stage --account
                       --instance
                       --manifest-path
                       --storage-account
                       --storage-container
                       [--friendly-name]
                       [--overwrite {false, true}]
                       [--resource-group]
                       [--storage-subscription]
                       [--then-import {false, true}]

예제

독립 실행형 업데이트를 준비합니다. 업데이트 파일은 매니페스트와 동일한 디렉터리에 상주해야 합니다. SAS 토큰 만료 전에 스테이징된 업데이트의 가져오기를 시작하기 위해 나중에 결과 가져오기 명령을 실행할 수 있습니다.

az iot du update stage -n {account_name} -i {instance_name} --storage-account {storage_account_name} --storage-container {storage_container_name} --manifest-path /path/to/manifest.json

독립 실행형 업데이트를 준비합니다. 스테이징 후 원하는 이름을 사용하여 인스턴스로 업데이트를 가져옵니다.

az iot du update stage -n {account_name} -i {instance_name} --storage-account {storage_account_name} --storage-container {storage_container_name} --manifest-path /path/to/manifest.json --then-import --friendly-name myAptUpdate

다중 참조 업데이트를 준비합니다. 업데이트 파일은 업데이트 계정에 대한 다른 구독에 있는 스토리지 Blob 컨테이너에 업로드됩니다.

az iot du update stage -n {account_name} -i {instance_name} --storage-account {storage_account_name} --storage-container {storage_container_name} --storage-subscription {storage_account_subscription} --manifest-path /path/to/parent/parent.manifest.json --manifest-path /path/to/leaf1/leaf1.manifest.json --manifest-path /path/to/leaf2/leaf2.manifest.json

기존 Blob이 있는 경우 덮어쓰는 다중 참조 업데이트를 준비합니다. 스테이징 후 인스턴스로 업데이트를 가져옵니다.

az iot du update stage -n {account_name} -i {instance_name} --storage-account {storage_account_name} --storage-container {storage_container_name} --manifest-path /path/to/parent/parent.manifest.json --manifest-path /path/to/leaf1/leaf1.manifest.json --manifest-path /path/to/leaf2/leaf2.manifest.json --then-import --overwrite

필수 매개 변수

--account -n

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

--instance -i

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

--manifest-path

준비해야 하는 가져오기 매니페스트의 로컬 파일 경로입니다. 1회 이상 사용할 수 있습니다.

--storage-account

가져오기 매니페스트 아티팩트 스테이지에 필요한 스토리지 계정 이름입니다.

--storage-container

가져오기 매니페스트 아티팩트 스테이지에 필요한 스토리지 컨테이너 이름입니다.

선택적 매개 변수

--friendly-name

업데이트 정의와 연결된 이름입니다.

--overwrite

충돌이 있는 경우 기존 Blob을 덮어쓸지 여부를 나타내는 플래그입니다.

허용되는 값: false, true

기본값: False

--resource-group -g

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

--storage-subscription

가져오기 매니페스트 아티팩트 스테이지에 필요한 스토리지 계정 구독입니다. 스토리지 및 디바이스 업데이트 계정이 서로 다른 구독에 있는 경우에 적용됩니다.

--then-import

스테이징 후 업데이트를 가져올지 여부를 나타내는 플래그입니다.

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