az image builder customizer

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

명령

az image builder customizer add

이미지 작성기 템플릿에 이미지 작성기 사용자 지정자 추가

az image builder customizer clear

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

az image builder customizer remove

이미지 작성기 템플릿에서 이미지 작성기 사용자 지정자 제거

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 my-group \
    --inline-script "sudo mkdir /buildArtifacts" \
                    "sudo cp /tmp/index.html /buildArtifacts/index.html" \
    --customizer-name shell-script-inline --type shell --defer

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

az image builder customizer add -n mytemplate -g my-group \
    --customizer-name my-file --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 my-group \
--customizer-name shell-script-url \
--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 my-group --customizer-name win_update --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시간)로 구성된 문자열로 지정된 다시 시작 시간 제한입니다.

기본값: 5m
--script-url

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

--search-criteria

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

--subscription

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

--update-limit

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

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 있습니다.

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 있습니다.