az image builder customizer

이미지 작성기 템플릿 사용자 지정자를 관리합니다.

명령

Name	Description	형식	상태
az image builder customizer add	이미지 작성기 템플릿에 이미지 작성기 사용자 지정자를 추가합니다.	Core	GA
az image builder customizer clear	이미지 작성기 템플릿에서 모든 이미지 작성기 사용자 지정자를 제거합니다.	Core	GA
az image builder customizer remove	이미지 작성기 템플릿에서 이미지 작성기 사용자 지정자를 제거합니다.	Core	GA

az image builder customizer add

이미지 작성기 템플릿에 이미지 작성기 사용자 지정자를 추가합니다.

--defer와 함께 사용해야 합니다.

az image builder customizer add --customizer-name
                                --type {file, powershell, shell, windows-restart, windows-update}
                                [--defer]
                                [--dest-path]
                                [--exit-codes]
                                [--file-source]
                                [--filters]
                                [--ids]
                                [--inline-script]
                                [--name]
                                [--resource-group]
                                [--restart-check-command]
                                [--restart-command]
                                [--restart-timeout]
                                [--script-url]
                                [--search-criteria]
                                [--subscription]
                                [--update-limit]

예제

cli 개체 캐시의 이미지 템플릿에 인라인 셸 사용자 지정자 추가

az image builder customizer add -n myTemplate -g myGroup \
    --inline-script "sudo mkdir /buildArtifacts" \
                    "sudo cp /tmp/index.html /buildArtifacts/index.html" \
    --customizer-name shellScriptInline --type shell --defer

cli 개체 캐시의 이미지 템플릿에 파일 사용자 지정자 추가

az image builder customizer add -n myTemplate -g myGroup \
    --customizer-name myFile --type file \
    --file-source "https://my-remote-file.html" --dest-path "/tmp/index.html" --defer

cli 개체 캐시의 이미지 템플릿에 Windows 다시 시작 사용자 지정자 추가

az image builder customizer add -n myTemplate -g myGroup \
--customizer-name shellScriptUrl \
--restart-check-command "echo Azure-Image-Builder-Restarted-the-VM  > \
                        c:\buildArtifacts\restart.txt" \
    --type windows-restart --restart-timeout 10m --defer

cli 개체 캐시의 이미지 템플릿에 Windows 업데이트 사용자 지정자를 추가합니다.

az image builder customizer add -n myTemplate -g myGroup --customizer-name winUpdate --type windows-update --search-criteria IsInstalled=0 --filters "exclude:\$_.Title -like \'*Preview*\'" "include:\$true" --update-limit 20 --defer

필수 매개 변수

--customizer-name

사용자 지정자의 이름입니다.

--type -t

이미지 템플릿에 추가할 사용자 지정자의 유형입니다.

속성	값
허용되는 값:	file, powershell, shell, windows-restart, windows-update

선택적 매개 변수

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--defer

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

--dest-path

--file-source에 지정된 파일이 이미지에 다운로드되는 절대 대상 경로입니다.

속성	값
Parameter group:	File Arguments

--exit-codes -e

공백으로 구분된 유효한 종료 코드 목록(정수)입니다.

속성	값
Parameter group:	Powershell Arguments

--file-source

이미지에 다운로드할 파일의 URI입니다. Github 링크, Azure Storage용 SAS URI 등이 될 수 있습니다.

속성	값
Parameter group:	File Arguments

--filters

적용할 업데이트를 선택하기 위해 공백으로 구분된 필터입니다. 기본값을 사용하도록 빈 배열을 생략하거나 지정합니다(필터 없음).

속성	값
Parameter group:	Windows Update Arguments

--ids

하나 이상의 리소스 ID(공백으로 구분). '리소스 ID' 인수의 모든 정보를 포함하는 전체 리소스 ID여야 합니다. --ids 또는 다른 '리소스 ID' 인수를 제공해야 합니다.

속성	값
Parameter group:	Resource Id Arguments

--inline-script

이미지를 사용자 지정할 인라인 스크립트 줄의 공백으로 구분된 목록입니다.

속성	값
Parameter group:	Shell and Powershell Arguments

--name -n

이미지 템플릿의 이름입니다.

속성	값
Parameter group:	Resource Id Arguments

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>사용하여 기본 그룹을 구성할 수 있습니다.

속성	값
Parameter group:	Resource Id Arguments

--restart-check-command

다시 시작이 성공했는지 확인하는 명령입니다.

속성	값
Parameter group:	Windows Restart Arguments

--restart-command

다시 시작 작업을 실행하는 명령입니다.

속성	값
Parameter group:	Windows Restart Arguments

--restart-timeout

크기 및 단위로 구성된 문자열로 지정된 다시 시작 시간 제한(예: '5m'(5분) 또는 '2h'(2시간)입니다.

속성	값
Parameter group:	Windows Restart Arguments
Default value:	5m

--script-url

이미지를 사용자 지정할 스크립트의 URL입니다. URL은 공개적으로 액세스할 수 있어야 합니다.

속성	값
Parameter group:	Shell and Powershell Arguments

--search-criteria

업데이트를 검색할 조건입니다. 기본값을 사용하도록 빈 문자열을 생략하거나 지정합니다(모두 검색). 이 필드에 대한 예제 및 자세한 설명은 위의 링크를 참조하세요.

속성	값
Parameter group:	Windows Update Arguments

--subscription

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

속성	값
Parameter group:	Resource Id Arguments

--update-limit

한 번에 적용할 최대 업데이트 수입니다. 기본값(1000)을 사용하려면 0을 생략하거나 지정합니다.

속성	값
Parameter group:	Windows Update Arguments

전역 매개 변수

--debug

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

속성	값
Default value:	False

--help -h

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

--only-show-errors

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

속성	값
Default value:	False

--output -o

Output format.

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

--query

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

--verbose

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

속성	값
Default value:	False