다음을 통해 공유


az deployment group

리소스 그룹에서 Azure Resource Manager 템플릿 배포를 관리합니다.

명령

Name Description 형식 상태
az deployment group cancel

리소스 그룹에서 배포를 취소합니다.

핵심 GA
az deployment group create

리소스 그룹에서 배포를 시작합니다.

핵심 GA
az deployment group delete

리소스 그룹에서 배포를 삭제합니다.

핵심 GA
az deployment group export

배포에 사용된 템플릿을 내보냅니다.

핵심 GA
az deployment group list

리소스 그룹의 배포를 나열합니다.

핵심 GA
az deployment group show

리소스 그룹에 배포를 표시합니다.

핵심 GA
az deployment group validate

리소스 그룹에서 템플릿이 유효한지 확인합니다.

핵심 GA
az deployment group wait

배포 조건이 충족될 때까지 CLI를 대기 상태로 유지합니다.

핵심 GA
az deployment group what-if

리소스 그룹 범위에서 배포 What-If 작업을 실행합니다.

핵심 GA

az deployment group cancel

리소스 그룹에서 배포를 취소합니다.

az deployment group cancel --name
                           --resource-group

예제

리소스 그룹에서 배포를 취소합니다.

az deployment group cancel -g testrg -n deployment01

필수 매개 변수

--name -n

배포 이름입니다.

--resource-group -g

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

전역 매개 변수
--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 deployment group create

리소스 그룹에서 배포를 시작합니다.

--template-file FILE | 중 하나만 지정하세요. --template-uri URI | ARM 템플릿을 입력하는 --template-spec입니다.

az deployment group create --resource-group
                           [--aux-subs]
                           [--aux-tenants]
                           [--confirm-with-what-if]
                           [--handle-extended-json-format]
                           [--mode {Complete, Incremental}]
                           [--name]
                           [--no-prompt {false, true}]
                           [--no-wait]
                           [--parameters]
                           [--proceed-if-no-change]
                           [--query-string]
                           [--rollback-on-error]
                           [--template-file]
                           [--template-spec]
                           [--template-uri]
                           [--what-if]
                           [--what-if-exclude-change-types {Create, Delete, Deploy, Ignore, Modify, NoChange, Unsupported}]
                           [--what-if-result-format {FullResourcePayloads, ResourceIdOnly}]

예제

로컬 JSON 파일의 매개 변수를 사용하여 원격 템플릿 파일에서 리소스 그룹에 배포를 만듭니다.

az deployment group create --resource-group testrg --name rollout01 \
    --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json

JSON 문자열의 매개 변수를 사용하여 로컬 템플릿 파일에서 리소스 그룹에 배포를 만듭니다.

az deployment group create --resource-group testrg --name rollout01 \
    --template-file azuredeploy.json  \
    --parameters '{ \"policyName\": { \"value\": \"policy2\" } }'

배열 문자열의 매개 변수를 사용하여 로컬 템플릿 파일에서 리소스 그룹에 배포를 만듭니다.

az deployment group create --resource-group testgroup --template-file demotemplate.json --parameters exampleString='inline string' exampleArray='("value1", "value2")'

로컬 템플릿에서 매개 변수 파일, 원격 매개 변수 파일을 사용하고 키/값 쌍을 선택적으로 재정의하여 리소스 그룹에 배포를 만듭니다.

az deployment group create --resource-group testrg --name rollout01 \
    --template-file azuredeploy.json  --parameters @params.json \
    --parameters https://mysite/params.json --parameters MyValue=This MyArray=@array.json

템플릿 사양에서 리소스 그룹 범위에서 배포 만들기

az deployment group create --resource-group testrg --template-spec "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.Resources/templateSpecs/myTemplateSpec/versions/1.0"

bicepparam 매개 변수 파일에서 리소스 그룹 범위에서 배포 만들기

az deployment group create --resource-group testrg --parameters parameters.bicepparam

테넌트 전체의 리소스 그룹에서 배포 만들기

az deployment group create --resource-group testrg --name rollout01 \
    --template-file azuredeploy.json --parameters @myparameters.json --aux-tenants auxiliary_tenant01 auxiliary_tenant02

필수 매개 변수

--resource-group -g

배포를 만들 리소스 그룹입니다.

선택적 매개 변수

--aux-subs
사용되지 않음

옵션 '--aux-subs'는 더 이상 사용되지 않으며 향후 릴리스에서 제거될 예정입니다. 대신 '--aux-tenants'를 사용합니다.

테넌트 간에 배포하는 동안 사용할 보조 구독입니다.

--aux-tenants

테넌트 간에 배포하는 동안 사용할 보조 테넌트입니다.

--confirm-with-what-if -c

배포를 실행하기 전에 배포 What-If를 실행하도록 명령에 지시합니다. 그런 다음 계속하기 전에 리소스 변경 내용을 승인하라는 메시지가 표시됩니다.

--handle-extended-json-format -j
사용되지 않음

옵션 '--handle-extended-json-format/-j'은 더 이상 사용되지 않으며 향후 릴리스에서 제거될 예정입니다.

배포에서 여러 줄 및 주석을 포함하여 확장된 템플릿 콘텐츠를 처리하도록 지원합니다.

--mode

배포 모드입니다.

허용되는 값: Complete, Incremental
Default value: Incremental
--name -n

배포 이름입니다.

--no-prompt

ARM 템플릿에 대한 매개 변수 누락 프롬프트를 사용하지 않도록 설정하는 옵션입니다. 값이 true이면 사용자가 누락된 매개 변수를 제공하도록 요구하는 프롬프트가 무시됩니다. 기본값은 false입니다.

허용되는 값: false, true
Default value: False
--no-wait

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

Default value: False
--parameters -p

배포 매개 변수 값을 제공합니다.

구문, JSON 문자열 또는 KEY=VALUE> 쌍을 <사용하여 @{path} 파일에서 매개 변수를 제공할 수 있습니다. 매개 변수는 순서대로 평가되므로 값이 두 번 할당되면 후자의 값이 사용됩니다. 먼저 매개 변수 파일을 제공한 다음 KEY=VALUE 구문을 사용하여 선택적으로 재정의하는 것이 좋습니다. 또한 bicepparam 파일을 제공하는 경우 이 인수를 한 번만 사용할 수 있습니다.

--proceed-if-no-change

What-If 결과에 리소스 변경 내용이 없는 경우 배포를 실행하도록 명령에 지시합니다. --confirm-with-what-if가 설정된 경우 적용됩니다.

--query-string -q

연결된 템플릿의 경우 template-uri와 함께 사용할 쿼리 문자열(SAS 토큰)입니다.

--rollback-on-error

오류 발생 시에 롤백하거나 플래그로 사용하여 마지막으로 성공한 배포로 롤백할 배포의 이름입니다.

--template-file -f

템플릿 파일 또는 Bicep 파일의 경로입니다.

--template-spec -s

템플릿 사양 리소스 ID입니다.

--template-uri -u

템플릿 파일에 대한 URI입니다.

--what-if -w

명령에 배포 What-If를 실행하도록 지시합니다.

--what-if-exclude-change-types -x

What-If 결과에서 제외할 리소스 변경 유형의 공백으로 구분된 목록입니다. --confirm-with-what-if가 설정된 경우 적용됩니다.

허용되는 값: Create, Delete, Deploy, Ignore, Modify, NoChange, Unsupported
--what-if-result-format -r

What-If 결과의 형식입니다. 설정된 경우 --confirm-with-what-if 적용됩니다.

허용되는 값: FullResourcePayloads, ResourceIdOnly
Default value: FullResourcePayloads
전역 매개 변수
--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 deployment group delete

리소스 그룹에서 배포를 삭제합니다.

az deployment group delete --name
                           --resource-group
                           [--no-wait]

예제

리소스 그룹에서 배포를 삭제합니다.

az deployment group delete -g testrg -n deployment01

필수 매개 변수

--name -n

배포 이름입니다.

--resource-group -g

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

선택적 매개 변수

--no-wait

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

Default value: False
전역 매개 변수
--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 deployment group export

배포에 사용된 템플릿을 내보냅니다.

az deployment group export --name
                           --resource-group

예제

리소스 그룹에서 배포에 사용되는 템플릿을 내보냅니다.

az deployment group export --resource-group testrg --name MyDeployment

필수 매개 변수

--name -n

배포 이름입니다.

--resource-group -g

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

전역 매개 변수
--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 deployment group list

리소스 그룹의 배포를 나열합니다.

az deployment group list --resource-group
                         [--filter]

예제

리소스 그룹의 배포를 나열합니다.

az deployment group list -g testrg

필수 매개 변수

--resource-group -g

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

선택적 매개 변수

--filter
미리 보기

OData 표기법을 사용하여 식을 필터링합니다. --filter "provisioningState eq '{state}'"를 사용하여 provisioningState를 필터링할 수 있습니다. 자세한 내용을 보려면 을 방문 https://docs.microsoft.com/rest/api/resources/deployments/listatsubscriptionscope#uri-parameters하십시오.

전역 매개 변수
--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 deployment group show

리소스 그룹에 배포를 표시합니다.

az deployment group show --name
                         --resource-group

예제

리소스 그룹에 배포를 표시합니다.

az deployment group show -g testrg -n deployment01

필수 매개 변수

--name -n

배포 이름입니다.

--resource-group -g

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

전역 매개 변수
--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 deployment group validate

리소스 그룹에서 템플릿이 유효한지 확인합니다.

--template-file FILE | 중 하나만 지정하세요. --template-uri URI | ARM 템플릿을 입력하는 --template-spec입니다.

az deployment group validate --resource-group
                             [--handle-extended-json-format]
                             [--mode {Complete, Incremental}]
                             [--name]
                             [--no-prompt {false, true}]
                             [--parameters]
                             [--query-string]
                             [--rollback-on-error]
                             [--template-file]
                             [--template-spec]
                             [--template-uri]

예제

리소스 그룹에서 템플릿이 유효한지 확인합니다.

az deployment group validate --resource-group testrg --template-file {template-file}

리소스 그룹에서 템플릿이 유효한지 확인합니다. (자동 생성됨)

az deployment group validate --parameters MyValue=This MyArray=@array.json --resource-group testrg --template-file azuredeploy.json

필수 매개 변수

--resource-group -g

배포를 만들 리소스 그룹입니다.

선택적 매개 변수

--handle-extended-json-format -j
사용되지 않음

옵션 '--handle-extended-json-format/-j'은 더 이상 사용되지 않으며 향후 릴리스에서 제거될 예정입니다.

배포에서 여러 줄 및 주석을 포함하여 확장된 템플릿 콘텐츠를 처리하도록 지원합니다.

--mode

배포 모드입니다.

허용되는 값: Complete, Incremental
Default value: Incremental
--name -n

배포 이름입니다.

--no-prompt

ARM 템플릿에 대한 매개 변수 누락 프롬프트를 사용하지 않도록 설정하는 옵션입니다. 값이 true이면 사용자가 누락된 매개 변수를 제공하도록 요구하는 프롬프트가 무시됩니다. 기본값은 false입니다.

허용되는 값: false, true
Default value: False
--parameters -p

배포 매개 변수 값을 제공합니다.

구문, JSON 문자열 또는 KEY=VALUE> 쌍을 <사용하여 @{path} 파일에서 매개 변수를 제공할 수 있습니다. 매개 변수는 순서대로 평가되므로 값이 두 번 할당되면 후자의 값이 사용됩니다. 먼저 매개 변수 파일을 제공한 다음 KEY=VALUE 구문을 사용하여 선택적으로 재정의하는 것이 좋습니다.

--query-string -q

연결된 템플릿의 경우 template-uri와 함께 사용할 쿼리 문자열(SAS 토큰)입니다.

--rollback-on-error

오류 발생 시에 롤백하거나 플래그로 사용하여 마지막으로 성공한 배포로 롤백할 배포의 이름입니다.

--template-file -f

템플릿 파일 또는 Bicep 파일의 경로입니다.

--template-spec -s

템플릿 사양 리소스 ID입니다.

--template-uri -u

템플릿 파일에 대한 URI입니다.

전역 매개 변수
--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 deployment group wait

배포 조건이 충족될 때까지 CLI를 대기 상태로 유지합니다.

az deployment group wait --name
                         --resource-group
                         [--created]
                         [--custom]
                         [--deleted]
                         [--exists]
                         [--interval]
                         [--timeout]
                         [--updated]

예제

배포 조건이 충족될 때까지 CLI를 대기 상태로 유지합니다. (자동 생성됨)

az deployment group wait --created --name MyDeployment --resource-group MyResourceGroup

필수 매개 변수

--name -n

배포 이름입니다.

--resource-group -g

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

선택적 매개 변수

--created

'Succeeded'에서 'provisioningState'를 사용하여 생성될 때까지 기다립니다.

Default value: False
--custom

조건이 사용자 지정 JMESPath 쿼리를 충족할 때까지 기다립니다. 예: provisioningState!='InProgress', instanceView. 상태es[?code=='PowerState/running'].

--deleted

삭제될 때까지 기다립니다.

Default value: False
--exists

리소스가 존재할 때까지 기다립니다.

Default value: False
--interval

폴링 간격(초)입니다.

Default value: 30
--timeout

최대 대기 시간(초)입니다.

Default value: 3600
--updated

'Succeeded'에서 provisioningState로 업데이트될 때까지 기다립니다.

Default value: False
전역 매개 변수
--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 deployment group what-if

리소스 그룹 범위에서 배포 What-If 작업을 실행합니다.

--template-file FILE | 중 하나만 지정하세요. --template-uri URI | ARM 템플릿을 입력하는 --template-spec입니다.

az deployment group what-if --resource-group
                            [--aux-tenants]
                            [--exclude-change-types {Create, Delete, Deploy, Ignore, Modify, NoChange, Unsupported}]
                            [--mode {Complete, Incremental}]
                            [--name]
                            [--no-pretty-print]
                            [--no-prompt {false, true}]
                            [--parameters]
                            [--query-string]
                            [--result-format {FullResourcePayloads, ResourceIdOnly}]
                            [--template-file]
                            [--template-spec]
                            [--template-uri]

예제

리소스 그룹에서 배포 What-If 작업을 실행합니다.

az deployment group what-if --resource-group testrg --name rollout01 --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json

ResourceIdOnly 형식의 리소스 그룹에서 배포 What-If 작업을 실행합니다.

az deployment group what-if --resource-group testrg --name rollout01 --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json --result-format ResourceIdOnly

결과를 잘 인쇄하지 않고 리소스 그룹에서 배포 가상 작업을 실행합니다.

az deployment group what-if --resource-group testrg --name rollout01 --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json --no-pretty-print

필수 매개 변수

--resource-group -g

배포 What-If 작업을 실행할 리소스 그룹입니다.

선택적 매개 변수

--aux-tenants

테넌트 간에 배포하는 동안 사용할 보조 테넌트입니다.

--exclude-change-types -x

What-If 결과에서 제외할 리소스 변경 유형의 공백으로 구분된 목록입니다.

허용되는 값: Create, Delete, Deploy, Ignore, Modify, NoChange, Unsupported
--mode

배포 모드입니다.

허용되는 값: Complete, Incremental
Default value: Incremental
--name -n

배포 이름입니다.

--no-pretty-print

What-If 결과에 대해 예쁜 인쇄를 사용하지 않도록 설정합니다. 설정되면 출력 형식 형식이 사용됩니다.

--no-prompt

ARM 템플릿에 대한 매개 변수 누락 프롬프트를 사용하지 않도록 설정하는 옵션입니다. 값이 true이면 사용자가 누락된 매개 변수를 제공하도록 요구하는 프롬프트가 무시됩니다. 기본값은 false입니다.

허용되는 값: false, true
Default value: False
--parameters -p

배포 매개 변수 값을 제공합니다.

구문, JSON 문자열 또는 KEY=VALUE> 쌍을 <사용하여 @{path} 파일에서 매개 변수를 제공할 수 있습니다. 매개 변수는 순서대로 평가되므로 값이 두 번 할당되면 후자의 값이 사용됩니다. 먼저 매개 변수 파일을 제공한 다음 KEY=VALUE 구문을 사용하여 선택적으로 재정의하는 것이 좋습니다.

--query-string -q

연결된 템플릿의 경우 template-uri와 함께 사용할 쿼리 문자열(SAS 토큰)입니다.

--result-format -r

What-If 결과의 형식입니다.

허용되는 값: FullResourcePayloads, ResourceIdOnly
Default value: FullResourcePayloads
--template-file -f

템플릿 파일 또는 Bicep 파일의 경로입니다.

--template-spec -s

템플릿 사양 리소스 ID입니다.

--template-uri -u

템플릿 파일에 대한 URI입니다.

전역 매개 변수
--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를 사용합니다.