다음을 통해 공유


az blueprint

참고 항목

이 참조는 Azure CLI(버전 2.50.0 이상)에 대한 청사진 확장의 일부입니다. az blueprint 명령을 처음 실행할 때 확장이 자동으로 설치됩니다. 확장 프로그램에 대해 자세히 알아보세요.

청사진을 관리하는 명령입니다.

명령

Name Description 형식 상태
az blueprint artifact

청사진 아티팩트 관리를 위한 명령입니다.

내선 번호 GA
az blueprint artifact delete

청사진 아티팩트를 삭제합니다.

내선 번호 미리 보기
az blueprint artifact list

지정된 청사진 정의에 대한 아티팩트를 나열합니다.

내선 번호 미리 보기
az blueprint artifact policy

청사진 정책 할당 아티팩트 관리를 위한 명령입니다.

내선 번호 GA
az blueprint artifact policy create

청사진 정책 아티팩트 만들기

내선 번호 GA
az blueprint artifact policy update

청사진 정책 아티팩트 업데이트

내선 번호 GA
az blueprint artifact role

청사진 역할 할당 아티팩트 관리를 위한 명령입니다.

내선 번호 GA
az blueprint artifact role create

청사진 역할 아티팩트 만들기

내선 번호 GA
az blueprint artifact role update

청사진 역할 아티팩트 업데이트

내선 번호 GA
az blueprint artifact show

청사진 아티팩트를 가져옵니다.

내선 번호 미리 보기
az blueprint artifact template

청사진 ARM 템플릿 아티팩트 관리를 위한 명령입니다.

내선 번호 GA
az blueprint artifact template create

청사진 암 아티팩트 만들기

내선 번호 GA
az blueprint artifact template update

청사진 암 아티팩트 업데이트

내선 번호 GA
az blueprint assignment

청사진 할당을 관리하는 명령입니다.

내선 번호 GA
az blueprint assignment create

청사진 할당을 만듭니다.

내선 번호 GA
az blueprint assignment delete

청사진 할당을 삭제합니다.

내선 번호 미리 보기
az blueprint assignment list

구독 내에서 청사진 할당을 나열합니다.

내선 번호 미리 보기
az blueprint assignment show

청사진 할당을 가져옵니다.

내선 번호 미리 보기
az blueprint assignment update

청사진 할당을 업데이트합니다.

내선 번호 GA
az blueprint assignment wait

청사진 할당 조건이 충족될 때까지 CLI를 대기 상태로 설정합니다.

내선 번호 GA
az blueprint assignment who

Blueprint Servie Principal Name objectId를 가져옵니다.

내선 번호 미리 보기
az blueprint create

청사진 정의를 만듭니다.

내선 번호 미리 보기
az blueprint delete

청사진 정의를 삭제합니다.

내선 번호 미리 보기
az blueprint export

청사진 정의 및 아티팩트를 json 파일로 내보냅니다.

내선 번호 GA
az blueprint import

json 파일의 directoy에서 청사진 정의 및 아티팩트를 가져옵니다.

내선 번호 GA
az blueprint list

청사진 정의를 나열합니다.

내선 번호 미리 보기
az blueprint publish

최신 아티팩트를 사용하여 청사진 정의의 새 버전을 게시합니다. 게시된 청사진 정의는 변경할 수 없습니다.

내선 번호 미리 보기
az blueprint resource-group

청사진 리소스 그룹 아티팩트 관리를 위한 명령입니다.

내선 번호 GA
az blueprint resource-group add

청사진에 리소스 그룹 아티팩트를 추가합니다.

내선 번호 GA
az blueprint resource-group list

청사진 리소스 그룹 아티팩트 나열

내선 번호 GA
az blueprint resource-group remove

청사진 리소스 그룹 아티팩트를 제거합니다.

내선 번호 GA
az blueprint resource-group show

청사진 리소스 그룹 아티팩트 표시

내선 번호 GA
az blueprint resource-group update

청사진 리소스 그룹 아티팩트 업데이트

내선 번호 GA
az blueprint show

청사진 정의를 가져옵니다.

내선 번호 미리 보기
az blueprint update

청사진 정의를 업데이트합니다.

내선 번호 미리 보기
az blueprint version

게시된 청사진 버전을 관리하는 명령입니다.

내선 번호 미리 보기
az blueprint version artifact

게시된 청사진 아티팩트 관리를 위한 명령입니다.

내선 번호 미리 보기
az blueprint version artifact list

게시된 청사진의 버전에 대한 아티팩트를 나열합니다.

내선 번호 미리 보기
az blueprint version artifact show

게시된 청사진에 대한 아티팩트를 표시합니다.

내선 번호 미리 보기
az blueprint version delete

게시된 청사진 버전을 삭제합니다.

내선 번호 미리 보기
az blueprint version list

게시된 버전의 지정된 청사진 정의를 나열합니다.

내선 번호 미리 보기
az blueprint version show

게시된 버전의 청사진을 가져옵니다.

내선 번호 미리 보기

az blueprint create

미리 보기

이 명령은 미리 보기로 제공되며 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus

청사진 정의를 만듭니다.

az blueprint create --name
                    --target-scope {managementGroup, subscription}
                    [--description]
                    [--display-name]
                    [--management-group]
                    [--parameters]
                    [--resource-groups]
                    [--subscription]

예제

구독 청사진 만들기

az blueprint create --subscription MySubscription --name MyBlueprint --description "blueprint contains all artifacts" --target-scope subscription

관리 그룹 청사진 만들기

az blueprint create --management-group MyManagementGroup --name MyBlueprint --description "blueprint contains all artifact" --target-scope subscription

필수 매개 변수

--name -n

청사진 정의의 이름입니다.

--target-scope

이 청사진 정의를 할당할 수 있는 범위입니다.

허용되는 값: managementGroup, subscription

선택적 매개 변수

--description

이 리소스를 여러 줄로 설명합니다.

--display-name

한 줄 문자열은 이 리소스를 설명합니다.

--management-group -m

청사진의 범위에 관리 그룹을 사용합니다.

--parameters -p

이 청사진 정의에 필요한 매개 변수입니다. JSON 문자열 또는 JSON 파일 경로일 수 있습니다. 약식 구문, json-file 및 yaml-file을 지원합니다. 더 많은 것을 표시하려면 "??"를 시도해 보세요.

--resource-groups

이 청사진 정의에 의해 정의된 리소스 그룹 자리 표시자입니다. 예상 값: json-string/@json-file. 약식 구문, json-file 및 yaml-file을 지원합니다. 더 많은 것을 표시하려면 "??"를 시도해 보세요.

--subscription -s

청사진의 범위에 대한 구독을 사용합니다. --management-group을 지정하지 않으면 --subscription 값 또는 기본 구독이 범위로 사용됩니다.

전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

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

--only-show-errors

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

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
기본값: json
--query

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

--subscription

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

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az blueprint delete

미리 보기

이 명령은 미리 보기로 제공되며 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus

청사진 정의를 삭제합니다.

az blueprint delete --name
                    [--management-group]
                    [--subscription]
                    [--yes]

예제

관리 그룹 청사진 삭제

az blueprint delete --management-group MyManagementGroup --name MyBlueprint

구독 청사진 삭제

az blueprint delete --subscription MySubscription --name MyBlueprint

필수 매개 변수

--name -n

청사진 정의의 이름입니다.

선택적 매개 변수

--management-group -m

청사진의 범위에 관리 그룹을 사용합니다.

--subscription -s

청사진의 범위에 대한 구독을 사용합니다. --management-group을 지정하지 않으면 --subscription 값 또는 기본 구독이 범위로 사용됩니다.

--yes -y

확인 메시지를 표시하지 않습니다.

기본값: False
전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

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

--only-show-errors

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

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
기본값: json
--query

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

--subscription

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

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az blueprint export

청사진 정의 및 아티팩트를 json 파일로 내보냅니다.

az blueprint export --name
                    --output-path
                    [--management-group]
                    [--subscription]
                    [--yes]

예제

청사진 정의 및 아티팩트 내보내기

az blueprint export --name MyBlueprint \
--output-path "path/to/blueprint/directory"

필수 매개 변수

--name -n

내보낼 청사진 정의의 이름입니다.

--output-path

청사진 및 아티팩트 json 정의에 대한 디렉터리 경로입니다. 청사진 정의 파일의 이름은 blueprint.json입니다. 아티팩트 json 파일은 아티팩트라는 하위 디렉터리에 있습니다.

선택적 매개 변수

--management-group -m

청사진의 범위에 관리 그룹을 사용합니다.

--subscription -s

청사진의 범위에 대한 구독을 사용합니다. --management-group을 지정하지 않으면 --subscription 값 또는 기본 구독이 범위로 사용됩니다.

--yes -y

사용자 확인을 건너뜁니다. 설정되면 디렉터리가 없으면 생성됩니다. 디렉터리가 있고 내용이 있는 경우 덮어씁니다. 설정하지 않으면 계속 진행할 수 있는 권한이 사용자에게 표시됩니다.

기본값: False
전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

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

--only-show-errors

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

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
기본값: json
--query

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

--subscription

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

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az blueprint import

json 파일의 directoy에서 청사진 정의 및 아티팩트를 가져옵니다.

az blueprint import --input-path
                    --name
                    [--management-group]
                    [--subscription]
                    [--yes]

예제

청사진 정의 및 아티팩트 가져오기

az blueprint import --name MyBlueprint \
--input-path "path/to/blueprint/directory"

필수 매개 변수

--input-path

청사진 및 아티팩트 json 정의에 대한 디렉터리 경로입니다. 청사진 정의 파일의 이름은 blueprint.json이어야 합니다. 아티팩트 json 파일은 아티팩트라는 하위 디렉터리에 있어야 합니다.

--name -n

청사진 정의의 이름입니다.

선택적 매개 변수

--management-group -m

청사진의 범위에 관리 그룹을 사용합니다.

--subscription -s

청사진의 범위에 대한 구독을 사용합니다. --management-group을 지정하지 않으면 --subscription 값 또는 기본 구독이 범위로 사용됩니다.

--yes -y

확인 메시지를 표시하지 않습니다.

기본값: False
전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

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

--only-show-errors

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

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
기본값: json
--query

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

--subscription

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

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az blueprint list

미리 보기

이 명령은 미리 보기로 제공되며 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus

청사진 정의를 나열합니다.

az blueprint list [--management-group]
                  [--max-items]
                  [--next-token]
                  [--subscription]

예제

관리 그룹의 청사진 나열

az blueprint list --management-group MyManagementGroup

구독의 청사진 나열

az blueprint list --subscription MySubscription

선택적 매개 변수

--management-group -m

청사진의 범위에 관리 그룹을 사용합니다.

--max-items

명령의 출력에서 반환할 총 항목 수입니다. 사용 가능한 총 항목 수가 지정된 값보다 많으면 명령의 출력에 토큰이 제공됩니다. 페이지 매김을 다시 시작하려면 후속 명령의 인수에 --next-token 토큰 값을 제공합니다.

--next-token

페이지 매김을 시작할 위치를 지정하는 토큰입니다. 이는 이전에 잘린 응답의 토큰 값입니다.

--subscription -s

청사진의 범위에 대한 구독을 사용합니다. --management-group을 지정하지 않으면 --subscription 값 또는 기본 구독이 범위로 사용됩니다.

전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

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

--only-show-errors

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

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
기본값: json
--query

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

--subscription

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

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az blueprint publish

미리 보기

이 명령은 미리 보기로 제공되며 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus

최신 아티팩트를 사용하여 청사진 정의의 새 버전을 게시합니다. 게시된 청사진 정의는 변경할 수 없습니다.

az blueprint publish --blueprint-name
                     --version
                     [--change-notes]
                     [--management-group]
                     [--subscription]

예제

관리 그룹 청사진 게시

az blueprint publish --management-group MyManagementGroup --blueprint-name MyBlueprint --version v2

구독 청사진 게시

az blueprint publish --subscription MySubscription --blueprint-name MyBlueprint --version v2

필수 매개 변수

--blueprint-name

청사진 정의의 이름입니다.

--version

게시된 청사진 정의의 버전입니다.

선택적 매개 변수

--change-notes

버전별 변경 정보입니다.

--management-group -m

청사진의 범위에 관리 그룹을 사용합니다.

--subscription -s

청사진의 범위에 대한 구독을 사용합니다. --management-group을 지정하지 않으면 --subscription 값 또는 기본 구독이 범위로 사용됩니다.

전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

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

--only-show-errors

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

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
기본값: json
--query

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

--subscription

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

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az blueprint show

미리 보기

이 명령은 미리 보기로 제공되며 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus

청사진 정의를 가져옵니다.

az blueprint show --name
                  [--management-group]
                  [--subscription]

예제

관리 그룹 청사진 표시

az blueprint show --management-group MyManagementGroup --name MyBlueprint

구독 청사진 표시

az blueprint show --subscription MySubscription --name MyBlueprint

필수 매개 변수

--name -n

청사진 정의의 이름입니다.

선택적 매개 변수

--management-group -m

청사진의 범위에 관리 그룹을 사용합니다.

--subscription -s

청사진의 범위에 대한 구독을 사용합니다. --management-group을 지정하지 않으면 --subscription 값 또는 기본 구독이 범위로 사용됩니다.

전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

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

--only-show-errors

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

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
기본값: json
--query

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

--subscription

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

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az blueprint update

미리 보기

이 명령은 미리 보기로 제공되며 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus

청사진 정의를 업데이트합니다.

az blueprint update --name
                    [--add]
                    [--description]
                    [--display-name]
                    [--force-string {0, 1, f, false, n, no, t, true, y, yes}]
                    [--management-group]
                    [--parameters]
                    [--remove]
                    [--resource-groups]
                    [--set]
                    [--subscription]
                    [--target-scope {managementGroup, subscription}]

필수 매개 변수

--name -n

청사진 정의의 이름입니다.

선택적 매개 변수

--add

경로 및 키 값 쌍을 지정하여 개체 목록에 개체를 추가합니다. 예: --add property.listProperty <key=value, string 또는 JSON 문자열>.

--description

이 리소스를 여러 줄로 설명합니다.

--display-name

한 줄 문자열은 이 리소스를 설명합니다.

--force-string

'set' 또는 'add'를 사용하는 경우 JSON으로 변환하는 대신 문자열 리터럴을 유지합니다.

허용되는 값: 0, 1, f, false, n, no, t, true, y, yes
--management-group -m

청사진의 범위에 관리 그룹을 사용합니다.

--parameters -p

이 청사진 정의에 필요한 매개 변수입니다. JSON 문자열 또는 JSON 파일 경로일 수 있습니다. 약식 구문, json-file 및 yaml-file을 지원합니다. 더 많은 것을 표시하려면 "??"를 시도해 보세요.

--remove

목록에서 속성 또는 요소를 제거합니다. 예: --remove property.list OR --remove propertyToRemove.

--resource-groups

이 청사진 정의에 의해 정의된 리소스 그룹 자리 표시자입니다. 약식 구문, json-file 및 yaml-file을 지원합니다. 더 많은 것을 표시하려면 "??"를 시도해 보세요.

--set

설정할 속성 경로와 값을 지정하여 개체를 업데이트합니다. 예: --set property1.property2=.

--subscription -s

청사진의 범위에 대한 구독을 사용합니다. --management-group을 지정하지 않으면 --subscription 값 또는 기본 구독이 범위로 사용됩니다.

--target-scope

이 청사진 정의를 할당할 수 있는 범위입니다.

허용되는 값: managementGroup, subscription
전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

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

--only-show-errors

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

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
기본값: json
--query

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

--subscription

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

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.