az deployment sub

구독 범위에서 Azure Resource Manager 템플릿 배포를 관리합니다.

명령

az deployment sub cancel

구독 범위에서 배포를 취소합니다.

az deployment sub create

구독 범위에서 배포를 시작합니다.

az deployment sub delete

구독 범위에서 배포를 삭제합니다.

az deployment sub export

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

az deployment sub list

구독 범위에서 배포를 나열합니다.

az deployment sub show

구독 범위에서 배포를 표시합니다.

az deployment sub validate

구독 범위에서 템플릿이 유효한지 확인합니다.

az deployment sub wait

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

az deployment sub what-if

구독 범위에서 배포 What-If 작업을 실행 합니다.

az deployment sub cancel

구독 범위에서 배포를 취소합니다.

az deployment sub cancel --name
                         [--subscription]

예제

구독 범위에서 배포를 취소합니다.

az deployment sub cancel -n deployment01

필수 매개 변수

--name -n

배포 이름입니다.

선택적 매개 변수

--subscription

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

az deployment sub create

구독 범위에서 배포를 시작합니다.

az deployment sub create --location
                         [--confirm-with-what-if]
                         [--handle-extended-json-format]
                         [--name]
                         [--no-prompt {false, true}]
                         [--no-wait]
                         [--parameters]
                         [--proceed-if-no-change]
                         [--query-string]
                         [--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 sub create --location WestUS --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json

JSON 문자열의 매개 변수를 사용하여 로컬 템플릿 파일에서 구독 범위에서 배포를 만듭니다.

az deployment sub create --location WestUS --template-file azuredeploy.json  \
    --parameters '{ \"policyName\": { \"value\": \"policy2\" } }'

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

az deployment sub create --location WestUS --template-file azuredeploy.json  \
    --parameters @params.json --parameters https://mysite/params.json --parameters MyValue=This MyArray=@array.json

필수 매개 변수

--location -l

배포 메타데이터를 저장할 위치입니다.

선택적 매개 변수

--confirm-with-what-if -c

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

--handle-extended-json-format -j

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

--name -n

배포 이름입니다.

--no-prompt

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

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

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

--parameters -p

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

--proceed-if-no-change

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

--query-string -q

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

--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를 실행하도록 지시합니다.

--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
기본값: FullResourcePayloads

az deployment sub delete

구독 범위에서 배포를 삭제합니다.

az deployment sub delete --name
                         [--no-wait]
                         [--subscription]

예제

구독 범위에서 배포를 삭제합니다.

az deployment sub delete -n deployment01

필수 매개 변수

--name -n

배포 이름입니다.

선택적 매개 변수

--no-wait

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

--subscription

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

az deployment sub export

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

az deployment sub export --name
                         [--subscription]

예제

구독 범위에서 배포에 사용되는 템플릿을 내보냅니다.

az deployment sub export --name MyDeployment

필수 매개 변수

--name -n

배포 이름입니다.

선택적 매개 변수

--subscription

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

az deployment sub list

구독 범위에서 배포를 나열합니다.

az deployment sub list [--filter]
                       [--query-examples]
                       [--subscription]

예제

구독 범위에서 배포를 나열합니다.

az deployment sub list

선택적 매개 변수

--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 sub show

구독 범위에서 배포를 표시합니다.

az deployment sub show --name
                       [--query-examples]
                       [--subscription]

예제

구독 범위에서 배포를 표시합니다.

az deployment sub show -n deployment01

필수 매개 변수

--name -n

배포 이름입니다.

선택적 매개 변수

--query-examples

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

--subscription

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

az deployment sub validate

구독 범위에서 템플릿이 유효한지 확인합니다.

az deployment sub validate --location
                           [--handle-extended-json-format]
                           [--name]
                           [--no-prompt {false, true}]
                           [--parameters]
                           [--query-string]
                           [--subscription]
                           [--template-file]
                           [--template-spec]
                           [--template-uri]

예제

구독 범위에서 템플릿이 유효한지 확인합니다.

az deployment sub validate --location westus2 --template-file {template-file}

구독 범위에서 템플릿이 유효한지 확인합니다. (자동 생성)

az deployment sub validate --location westus2 --parameters MyValue=This MyArray=@array.json --template-file azuredeploy.json

필수 매개 변수

--location -l

배포 메타데이터를 저장할 위치입니다.

선택적 매개 변수

--handle-extended-json-format -j

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

--name -n

배포 이름입니다.

--no-prompt

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

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

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

--query-string -q

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

--subscription

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

--template-file -f

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

--template-spec -s

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

--template-uri -u

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

az deployment sub wait

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

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

예제

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

az deployment sub wait --created --name MyDeployment

필수 매개 변수

--name -n

배포 이름입니다.

선택적 매개 변수

--created

'Succeeded'에서 'provisioningState'를 통해 생성될 때까지 기다립니다.

--custom

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

--deleted

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

--exists

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

--interval

폴링 간격(초)입니다.

기본값: 30
--subscription

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

--timeout

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

기본값: 3600
--updated

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

az deployment sub what-if

구독 범위에서 배포 What-If 작업을 실행 합니다.

az deployment sub what-if --location
                          [--exclude-change-types {Create, Delete, Deploy, Ignore, Modify, NoChange, Unsupported}]
                          [--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 sub what-if --location WestUS --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json

ResourceIdOnly format을 사용 하 여 구독에서 배포 What-If 작업을 실행 합니다.

az deployment sub what-if --location WestUS --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json --result-format ResourceIdOnly

결과를 예쁜 인쇄 하지 않고 구독에서 배포 What-If 작업을 실행 합니다.

az deployment sub what-if --location WestUS --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json --no-pretty-print

필수 매개 변수

--location -l

배포 What-If 작업 메타 데이터를 저장할 위치입니다.

선택적 매개 변수

--exclude-change-types -x

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

허용되는 값: Create, Delete, Deploy, Ignore, Modify, NoChange, Unsupported
--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

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

--template-spec -s

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

--template-uri -u

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