az stack-whatif sub

구독 범위에서 배포 스택의 what-if 결과를 관리합니다.

명령

Name	Description	형식	상태
az stack-whatif sub create	구독 범위에서 배포 스택 what-if 결과를 만듭니다.	Core	GA
az stack-whatif sub delete	구독 범위에서 배포 스택 what-if 결과를 삭제합니다.	Core	GA
az stack-whatif sub list	구독의 모든 배포 스택 what-if 결과를 나열합니다.	Core	GA
az stack-whatif sub show	구독 범위에서 배포 스택 what-if 결과를 가져옵니다.	Core	GA

az stack-whatif sub create

구독 범위에서 배포 스택 what-if 결과를 만듭니다.

az stack-whatif sub create --action-on-unmanage --aou {deleteAll, deleteResources, detachAll}
                           --deny-settings-mode --dm {denyDelete, denyWriteAndDelete, none}
                           --location
                           --name
                           --retention-interval --ri
                           --stack-id
                           [--acquire-policy-token]
                           [--change-reference]
                           [--cs --deny-settings-apply-to-child-scopes]
                           [--deny-settings-excluded-actions --ea]
                           [--deny-settings-excluded-principals --ep]
                           [--deployment-resource-group --dr]
                           [--description]
                           [--no-color]
                           [--no-pretty-print]
                           [--no-wait]
                           [--parameters]
                           [--query-string]
                           [--resources-without-delete-support --rwd {detach, fail}]
                           [--tags]
                           [--template-file]
                           [--template-spec]
                           [--template-uri]
                           [--validation-level --vl {Provider, ProviderNoRbac, Template}]

예제

템플릿 파일을 사용하여 배포 스택에서 가상 작업을 수행하고 관리되지 않는 모든 리소스를 분리합니다.

az stack-whatif sub create --name StackName --template-file simpleTemplate.json --location westus2 --description description --deny-settings-mode None --action-on-unmanage detachAll --ri P5D --stack-id /subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Resources/deploymentStacks/mySubStack

매개 변수 파일을 사용하여 배포 스택에서 가상 작업을 수행하고, 관리되지 않는 경우 리소스를 삭제하고, 출력에서 색을 제거합니다.

az stack-whatif sub create --name StackName --action-on-unmanage deleteResources --no-color --template-file simpleTemplate.json --parameters simpleTemplateParams.json --location westus2 --description description --deny-settings-mode None --ri P5D --stack-id /subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Resources/deploymentStacks/mySubStack

템플릿 사양을 사용하여 배포 스택에서 가상 작업을 수행합니다.

az stack-whatif sub create --name StackName --template-spec TemplateSpecResourceIDWithVersion --location westus2 --description description --deny-settings-mode None --action-on-unmanage deleteResources --ri P5D --stack-id /subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Resources/deploymentStacks/mySubStack

bicep 파일을 사용하여 배포 스택에서 가상 작업을 수행하고 관리되지 않는 모든 리소스를 삭제합니다.

az stack-whatif sub create --name StackName --action-on-unmanage deleteAll --template-file simple.bicep --location westus2 --description description --deny-settings-mode None --ri P5D --stack-id /subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Resources/deploymentStacks/mySubStack

다른 구독의 배포 스택에서 가상 작업을 수행합니다.

az stack-whatif sub create --name StackName --template-file simpleTemplate.json --location westus2 --description description --subscription subscriptionId --deny-settings-mode None --action-on-unmanage deleteResources --ri P5D --stack-id /subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Resources/deploymentStacks/mySubStack

배포 스택에서 가상 작업을 수행하고 리소스 그룹 범위에서 배포합니다.

az stack-whatif sub create --name StackName --template-file simpleTemplate.json --location westus --deployment-resource-group ResourceGroup --description description --deny-settings-mode None --action-on-unmanage deleteResources --ri P5D --stack-id /subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Resources/deploymentStacks/mySubStack

키/값 쌍의 매개 변수를 사용하여 배포 스택에서 가상 작업을 수행합니다.

az stack-whatif sub create --name StackName --template-file simpleTemplate.json --location westus --description description --parameters simpleTemplateParams.json value1=foo value2=bar --deny-settings-mode None --action-on-unmanage deleteResources --ri P5D --stack-id /subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Resources/deploymentStacks/mySubStack

로컬 템플릿에서 매개 변수 파일, 원격 매개 변수 파일을 사용하고 키/값 쌍을 선택적으로 재정의하여 배포 스택에서 가상 작업을 수행합니다.

az stack-whatif sub create --name StackName --template-file azuredeploy.json --parameters @params.json --parameters https://mysite/params.json --parameters MyValue=This MyArray=@array.json --location westus --deny-settings-mode None --action-on-unmanage deleteResources --ri P5D --stack-id /subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Resources/deploymentStacks/mySubStack

거부 설정을 사용하여 로컬 템플릿에서 배포 스택에서 가상 작업을 수행합니다.

az stack-whatif sub create --name StackName --template-file azuredeploy.json --deny-settings-mode denyDelete --deny-settings-excluded-actions Microsoft.Compute/virtualMachines/write --deny-settings-excluded-principals "test1 test2" --location westus --action-on-unmanage deleteResources --ri P5D --stack-id /subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Resources/deploymentStacks/mySubStack

로컬 템플릿에서 배포 스택에서 가상 작업을 수행하고 자식 범위에 거부 설정을 적용합니다.

az stack-whatif sub create --name StackName --template-file azuredeploy.json --deny-settings-mode denyDelete --deny-settings-excluded-actions Microsoft.Compute/virtualMachines/write --deny-settings-apply-to-child-scopes --location westus --action-on-unmanage deleteResources --ri P5D --stack-id /subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Resources/deploymentStacks/mySubStack

필수 매개 변수

--action-on-unmanage --aou

스택이 업데이트되거나 삭제된 후 더 이상 관리되지 않는 리소스에 발생하는 작업을 정의합니다.

속성	값
허용되는 값:	deleteAll, deleteResources, detachAll

--deny-settings-mode --dm

스택에서 관리하는 리소스에서 거부되는 작업을 정의합니다.

속성	값
허용되는 값:	denyDelete, denyWriteAndDelete, none

--location -l

배포 스택을 저장할 위치입니다.

--name -n

배포 스택 가상 결과의 이름입니다.

--retention-interval --ri

What-If 결과의 보존 간격입니다. 값은 ISO 8601 형식이어야 하며 1일에서 30일 사이여야 합니다.

--stack-id

가상 작업을 수행할 배포 스택의 정규화된 ID입니다.

선택적 매개 변수

다음 매개 변수는 선택 사항이지만 컨텍스트에 따라 명령이 성공적으로 실행되려면 하나 이상의 매개 변수가 필요할 수 있습니다.

--acquire-policy-token

이 리소스 작업에 대한 Azure Policy 토큰을 자동으로 획득합니다.

속성	값
매개 변수 그룹:	Global Policy Arguments

--change-reference

이 리소스 작업에 대한 관련 변경 참조 ID입니다.

속성	값
매개 변수 그룹:	Global Policy Arguments

--cs --deny-settings-apply-to-child-scopes

DenySettings는 자식 범위에 적용됩니다.

속성	값
Default value:	False

--deny-settings-excluded-actions --ea

denySettings에서 제외되는 역할 기반 관리 작업 목록입니다. 최대 200개의 작업이 허용됩니다.

--deny-settings-excluded-principals --ep

잠금에서 제외된 AAD 보안 주체 ID 목록입니다. 최대 5개의 보안 주체가 허용됩니다.

--deployment-resource-group --dr

초기 배포를 만들어야 하는 범위입니다. 범위를 지정하지 않으면 기본적으로 배포 스택의 범위가 됩니다.

--description

배포 스택에 대한 설명입니다.

--no-color

예쁜 인쇄된 what-if 결과에서 색을 사용하지 않도록 설정합니다.

--no-pretty-print

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

--no-wait

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

속성	값
Default value:	False

--parameters -p

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

--query-string -q

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

--resources-without-delete-support --rwd

더 이상 스택에서 관리되지 않는 경우 삭제를 지원하지 않는 리소스에 대해 발생하는 작업을 정의합니다.

속성	값
허용되는 값:	detach, fail

--tags

공백으로 구분된 태그: key[=value] [key[=value] ...]. ""를 사용하여 기존 태그를 지웁니다.

--template-file -f

파일 시스템의 템플릿 파일 또는 Bicep 파일에 대한 경로입니다.

--template-spec -s

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

--template-uri -u

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

--validation-level --vl

배포 스택에 대한 유효성 검사 수준입니다. 기본값은 '공급자'입니다.

속성	값
허용되는 값:	Provider, ProviderNoRbac, Template

전역 매개 변수

--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성	값
Default value:	False

--help -h

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

--only-show-errors

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

속성	값
Default value:	False

--output -o

출력 형식

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

--query

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

--subscription

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

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성	값
Default value:	False