다음을 통해 공유

az image builder customizer

  • 참조

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

명령

Name Description 형식 상태
az image builder customizer add

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

 핵심 GA
az image builder customizer clear

이미지 작성기 템플릿에서 모든 이미지 작성기 사용자 지정자를 제거합니다.

 핵심 GA
az image builder customizer remove

이미지 작성기 템플릿에서 이미지 작성기 사용자 지정자를 제거합니다.

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

선택적 매개 변수

--defer

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

--dest-path

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

--exit-codes -e

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

--file-source

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

--filters

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

--ids

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

--inline-script

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

--name -n

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

--resource-group -g

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

--restart-check-command

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

--restart-command

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

--restart-timeout

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

Default value: 5m
--script-url

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

--search-criteria

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

--subscription

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

--update-limit

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

전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

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

--only-show-errors

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

--output -o

출력 형식입니다.

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

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

--subscription

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

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az image builder customizer clear

이미지 작성기 템플릿에서 모든 이미지 작성기 사용자 지정자를 제거합니다.

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

az image builder customizer clear [--defer]
                                  [--ids]
                                  [--name]
                                  [--resource-group]
                                  [--subscription]

선택적 매개 변수

--defer

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

--ids

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

--name -n

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

--resource-group -g

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

--subscription

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

전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

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

--only-show-errors

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

--output -o

출력 형식입니다.

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

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

--subscription

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

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az image builder customizer remove

이미지 작성기 템플릿에서 이미지 작성기 사용자 지정자를 제거합니다.

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

az image builder customizer remove --customizer-name
                                   [--defer]
                                   [--ids]
                                   [--name]
                                   [--resource-group]
                                   [--subscription]

필수 매개 변수

--customizer-name

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

선택적 매개 변수

--defer

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

--ids

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

--name -n

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

--resource-group -g

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

--subscription

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

전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

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

--only-show-errors

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

--output -o

출력 형식입니다.

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

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

--subscription

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

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.