다음을 통해 공유

az iot du update init

  • 미리 보기

Note

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

이 명령 그룹은 미리 보기 상태이며 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus

매니페스트 초기화를 가져오기 위한 유틸리티입니다.

명령

Name Description 형식 상태
az iot du update init v5

원하는 상태로 v5 가져오기 매니페스트를 초기화합니다.

 Extension Preview

az iot du update init v5

미리 보기

명령 그룹 'iot du update init'는 미리 보기로 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus

원하는 상태로 v5 가져오기 매니페스트를 초기화합니다.

이 명령은 v5 가져오기 매니페스트의 모든 특성을 지원합니다. 위치 민감도와 위치 구분 --step--file--file--related-file이 있습니다. 작업을 완전히 활용하는 방법에 대한 자세한 내용은 예제 및 매개 변수 설명을 검토합니다.

다른 셸에서 따옴표와 이스케이프 문자를 사용하는 방법에 대해 자세히 알아 https://aka.ms/aziotcli-json보세요.

az iot du update init v5 --compat
                         --step
                         --update-name
                         --update-provider
                         --update-version
                         [--description]
                         [--file]
                         [--is-deployable {false, true}]
                         [--no-validation {false, true}]
                         [--related-file]

예제

최소 콘텐츠 가져오기 매니페스트를 초기화합니다. 'bash'에 최적화된 인라인 json입니다.

az iot du update init v5 --update-provider Microsoft --update-name myAptUpdate --update-version 1.0.0 --description "My minimum update" --compat manufacturer=Contoso model=Vacuum --step handler=microsoft/apt:1 properties='{"installedCriteria": "1.0"}' --file path=/my/apt/manifest/file

최소 콘텐츠 가져오기 매니페스트를 초기화합니다. 'powershell'에 최적화된 인라인 json입니다.

az iot du update init v5 --update-provider Microsoft --update-name myAptUpdate --update-version 1.0.0 --description "My minimum update" --compat manufacturer=Contoso model=Vacuum --step handler=microsoft/apt:1 properties='{\"installedCriteria\": \"1.0\"}' --file path=/my/apt/manifest/file

최소 콘텐츠 가져오기 매니페스트를 초기화합니다. 'cmd'에 최적화된 인라인 json입니다.

az iot du update init v5 --update-provider Microsoft --update-name myAptUpdate --update-version 1.0.0 --description "My minimum update" --compat manufacturer=Contoso model=Vacuum --step handler=microsoft/apt:1 properties="{\"installedCriteria\": \"1.0\"}" --file path=/my/apt/manifest/file

최소 콘텐츠 가져오기 매니페스트를 초기화합니다. json에 대한 파일 입력을 사용합니다.

az iot du update init v5 --update-provider Microsoft --update-name myAptUpdate --update-version 1.0.0 --description "My minimum update" --compat manufacturer=Contoso model=Vacuum --step handler=microsoft/apt:1 properties="@/path/to/file" --file path=/my/apt/manifest/file

번들 업데이트에서 참조할 배포할 수 없는 리프 업데이트를 초기화합니다. 'bash'에 최적화된 인라인 json입니다.

az iot du update init v5 --update-provider Microsoft --update-name mySwUpdate --update-version 1.1.0 --compat manufacturer=Contoso model=Microphone --step handler=microsoft/swupdate:1 description="Deploy Update" properties='{"installedCriteria": "1.0"}' --file path=/my/update/image/file1 --file path=/my/update/image/file2 --is-deployable false

리프 업데이트를 참조하고 독립적인 단계를 정의하는 번들 업데이트를 초기화합니다. 명령 연속을 사용하여 가져오기 매니페스트 세그먼트를 구분하는 'bash'에 최적화된 예제입니다.

az iot du update init v5 \
--update-provider Microsoft --update-name myBundled --update-version 2.0 \
--compat manufacturer=Contoso model=SpaceStation \
--step handler=microsoft/script:1 properties='{"arguments": "--pre"}' description="Pre-install script" \
--file path=/my/update/scripts/preinstall.sh downloadHandler=microsoft/delta:1 \
--related-file path=/my/update/scripts/related_preinstall.json properties='{"microsoft.sourceFileHashAlgorithm": "sha256"}' \
--step updateId.provider=Microsoft updateId.name=SwUpdate updateId.version=1.1 \
--step handler=microsoft/script:1 properties='{"arguments": "--post"}' description="Post-install script" \
--file path=/my/update/scripts/postinstall.sh

필수 매개 변수

--compat

이 업데이트가 호환되는 디바이스의 속성에 해당하는 공백으로 구분된 key=value 쌍입니다. 일반적으로 제조업체 및 모델과 같은 속성을 정의하는 데 사용됩니다. --compat는 1회 이상 사용할 수 있습니다.

--step

'instructions.steps' 요소 속성에 해당하는 공백으로 구분된 key=value 쌍입니다. 클라이언트는 제공된 키 값 쌍에 따라 단계가 인라인 또는 참조 단계인지 확인합니다. 인라인 또는 참조 단계를 충족할 수 있는 경우 참조 단계의 우선 순위가 지정됩니다. --file의 사용은 가장 가까운 인라인 --step 항목과 연결되어 'files'에 대한 값을 파생합니다. updateId.provider, updateId.name, updateId.version 및 description참조 단계 키가 지원됩니다. 지원되는 인라인 단계 키는 handler(예: 'microsoft/script:1' 또는 'microsoft/swupdate:1' 또는 'microsoft/apt:1'), properties(에이전트가 처리기에 전달할 인라인 json 개체) 및 description. --step은 1회 이상 사용할 수 있습니다.

--update-name

updateId의 구성 요소인 업데이트 이름입니다.

--update-provider

updateId의 구성 요소인 업데이트 공급자입니다.

--update-version

updateId의 구성 요소인 업데이트 버전입니다.

선택적 매개 변수

다음 매개 변수는 선택 사항이지만 컨텍스트에 따라 명령이 성공적으로 실행되려면 하나 이상의 매개 변수가 필요할 수 있습니다.

--description

가져오기 매니페스트에 대한 설명입니다.

--file

'files' 요소 속성에 해당하는 공백으로 구분된 key=value 쌍입니다. --file 항목은 제공된 경우 가장 가까운 --related-file 항목을 포함할 수 있습니다. 다음 키가 지원됩니다. path 파일 업데이트에 대한 로컬 파일 경로, downloadHandler(예: 'microsoft/delta:1') 관련 파일을 활용하여 페이로드 파일을 다운로드하기 위한 처리기, properties(에이전트가 처리기에 전달할 인라인 json 개체). --file은 1회 이상 사용할 수 있습니다.

--is-deployable

업데이트를 독립적으로 배포할 수 있는지 여부를 나타냅니다.

속성 값
허용되는 값: false, true
--no-validation

가져오기 매니페스트 콘텐츠의 클라이언트 쪽 json 스키마 유효성 검사를 사용하지 않도록 설정합니다.

속성 값
허용되는 값: false, true
--related-file

'files[*].relatedFiles' 요소 속성에 해당하는 공백으로 구분된 key=value 쌍입니다. --related-file 항목이 있는 경우 가장 가까운 --file 항목에 연결됩니다. 다음 키가 지원됩니다. path 관련 업데이트 파일, properties(다운로드 처리기에 전달된 인라인 json 개체)에 대한 로컬 파일 경로를 path. --related-file을 1회 이상 사용할 수 있습니다.

전역 매개 변수
--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성 값
Default value: False
--help -h

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

--only-show-errors

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

속성 값
Default value: False
--output -o

출력 형식

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

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

--subscription

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

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성 값
Default value: False