az deployment group

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

명령

az deployment group cancel

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

az deployment group create

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

az deployment group delete

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

az deployment group export

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

az deployment group list

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

az deployment group show

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

az deployment group validate

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

az deployment group wait

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

az deployment group what-if

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

az deployment group cancel

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

az deployment group cancel --name
                           --resource-group
                           [--subscription]

예제

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

az deployment group cancel -g testrg -n deployment01

필수 매개 변수

--name -n

배포 이름입니다.

--resource-group -g

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

선택적 매개 변수

--subscription

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

az deployment group create

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

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]
                           [--subscription]
                           [--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"

필수 매개 변수

--resource-group -g

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

선택적 매개 변수

--aux-subs

테 넌 트 간 배포 중에 사용 되는 보조 구독입니다.

--aux-tenants

테 넌 트 간 배포 중에 사용 되는 보조 테 넌 트입니다.

--confirm-with-what-if -c

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

--handle-extended-json-format -j

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

--mode

배포 모드입니다.

허용되는 값: Complete, Incremental
기본값: Incremental
--name -n

배포 이름입니다.

--no-prompt

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

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

장기 실행 작업이 완료될 때까지 기다리지 마세요.

--parameters -p

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

--proceed-if-no-change

What-If 결과에 리소스 변경 내용이 포함 되지 않은 경우 배포를 실행 하도록 명령을 지시 합니다. --Confirm-if가 설정 된 경우에 해당 합니다.

--query-string -q

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

--rollback-on-error

오류가 발생 한 경우 롤백할 배포의 이름입니다. 마지막으로 성공한 배포로 롤백하려면 플래그로를 사용 합니다.

--subscription

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

--template-file -f

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

--template-spec -s

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

--template-uri -u

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

--what-if -w

배포 작업을 실행 하도록 명령에 지시 합니다.

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

What-If 결과에서 제외할 리소스 변경 형식의 공백으로 구분 된 목록입니다. --Confirm-if가 설정 된 경우에 해당 합니다.

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

What-If 결과의 형식입니다. --confirm-with-what-if가 설정 된 경우 적용할 수 있습니다.

허용되는 값: FullResourcePayloads, ResourceIdOnly
기본값: FullResourcePayloads

az deployment group delete

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

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

예제

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

az deployment group delete -g testrg -n deployment01

필수 매개 변수

--name -n

배포 이름입니다.

--resource-group -g

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

선택적 매개 변수

--no-wait

장기 실행 작업이 완료될 때까지 기다리지 마세요.

--subscription

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

az deployment group export

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

az deployment group export --name
                           --resource-group
                           [--subscription]

예제

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

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

필수 매개 변수

--name -n

배포 이름입니다.

--resource-group -g

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

선택적 매개 변수

--subscription

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

az deployment group list

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

az deployment group list --resource-group
                         [--filter]
                         [--query-examples]
                         [--subscription]

예제

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

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/en-us/rest/api/resources/deployments/listatsubscriptionscope#uri-parameters .

--query-examples

JMESPath 문자열을 권장 합니다. 쿼리 중 하나를 복사 하 여 결과를 볼 수 있도록 큰따옴표 내에서--query 매개 변수 뒤에 붙여 넣을 수 있습니다. 이러한 주요 단어를 기준으로 제안을 제공할 수 있도록 하나 이상의 위치 키워드를 추가할 수 있습니다.

--subscription

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

az deployment group show

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

az deployment group show --name
                         --resource-group
                         [--query-examples]
                         [--subscription]

예제

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

az deployment group show -g testrg -n deployment01

필수 매개 변수

--name -n

배포 이름입니다.

--resource-group -g

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

선택적 매개 변수

--query-examples

JMESPath 문자열을 권장 합니다. 쿼리 중 하나를 복사 하 여 결과를 볼 수 있도록 큰따옴표 내에서--query 매개 변수 뒤에 붙여 넣을 수 있습니다. 이러한 주요 단어를 기준으로 제안을 제공할 수 있도록 하나 이상의 위치 키워드를 추가할 수 있습니다.

--subscription

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

az deployment group validate

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

az deployment group validate --resource-group
                             [--handle-extended-json-format]
                             [--mode {Complete, Incremental}]
                             [--name]
                             [--no-prompt {false, true}]
                             [--parameters]
                             [--query-string]
                             [--rollback-on-error]
                             [--subscription]
                             [--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

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

--mode

배포 모드입니다.

허용되는 값: Complete, Incremental
기본값: Incremental
--name -n

배포 이름입니다.

--no-prompt

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

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

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

--query-string -q

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

--rollback-on-error

오류가 발생 한 경우 롤백할 배포의 이름입니다. 마지막으로 성공한 배포로 롤백하려면 플래그로를 사용 합니다.

--subscription

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

--template-file -f

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

--template-spec -s

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

--template-uri -u

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

az deployment group wait

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

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

예제

배포 조건이 충족 될 때까지 CLI를 대기 상태에 배치 합니다. 자동 생성

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

필수 매개 변수

--name -n

배포 이름입니다.

--resource-group -g

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

선택적 매개 변수

--created

' 성공 '에서 ' provisioningState '를 사용 하 여 만들 때까지 기다립니다.

--custom

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

--deleted

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

--exists

리소스가 있을 때까지 기다립니다.

--interval

폴링 간격 (초)입니다.

기본값: 30
--subscription

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

--timeout

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

기본값: 3600
--updated

' 성공 '으로 provisioningState으로 업데이트할 때까지 기다립니다.

az deployment group what-if

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

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}]
                            [--subscription]
                            [--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 format을 사용 하 여 리소스 그룹에서 배포 What-If 작업을 실행 합니다.

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

결과를 예쁜 인쇄 하지 않고 리소스 그룹에서 배포 What-If 작업을 실행 합니다.

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
기본값: Incremental
--name -n

배포 이름입니다.

--no-pretty-print

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

--no-prompt

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

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

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

--query-string -q

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

--result-format -r

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

허용되는 값: FullResourcePayloads, ResourceIdOnly
기본값: FullResourcePayloads
--subscription

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

--template-file -f

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

--template-spec -s

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

--template-uri -u

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