다음을 통해 공유

az blueprint assignment

  • 참조

참고 항목

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

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

명령

Name Description 형식 상태
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 assignment create

청사진 할당을 만듭니다.

az blueprint assignment create --name
                               [--blueprint-version]
                               [--description]
                               [--display-name]
                               [--identity-type {None, SystemAssigned, UserAssigned}]
                               [--location]
                               [--locks-excluded-principals]
                               [--locks-mode {AllResourcesDoNotDelete, AllResourcesReadOnly, None}]
                               [--management-group]
                               [--parameters]
                               [--resource-group-value]
                               [--subscription]
                               [--user-assigned-identity]

예제

시스템 할당 관리 ID를 사용하여 할당

az blueprint assignment create --subscription MySubscription --name \
MyBlueprintAssignment --location eastus --identity-type SystemAssigned \
--description "Enforce pre-defined MyBlueprint to this subscription." \
--blueprint-version "/providers/Microsoft.Management/managementGroups/ContosoOnlineGroup/provid \
ers/Microsoft.Blueprint/blueprints/MyBlueprint/versions/v2" \
--resource-group-value artifact_name=rg-art-1 name=rg1 location=westus \
--resource-group-value artifact_name=rg-art-2 name=rg2 location=eastus \
--parameters "path/to/parameter/file" \

사용자 할당 관리 ID를 사용하여 할당

az blueprint assignment create --subscription MySubscription --name \
MyBlueprintAssignment --location eastus --identity-type UserAssigned \
--user-assigned-identity "/subscriptions/00000000-0000-0000-0000-000000000000 \
/resourcegroups/myResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myIdentity"\
--description "Enforce pre-defined MyBlueprint to this subscription." \
--blueprint-version "/providers/Microsoft.Management/managementGroups/ContosoOnlineGroup \
/providers/Microsoft.Blueprint/blueprints/MyBlueprint/versions/v2" \
--resource-group-value artifact_name=rg-art-1 name=rg1 location=eastus \
--parameters "path/to/parameter/file" \

필수 매개 변수

--name -n

청사진 할당의 이름입니다.

선택적 매개 변수

--blueprint-version

게시된 청사진 정의 버전의 리소스 ID입니다.

--description

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

--display-name

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

--identity-type

관리 ID의 형식입니다.

허용되는 값: None, SystemAssigned, UserAssigned
Default value: SystemAssigned
--location -l

위치. 값: az account list-locations. az configure --defaults location=<location>을 사용하여 기본 위치를 구성할 수 있습니다.

--locks-excluded-principals

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

--locks-mode

잠금 모드입니다.

허용되는 값: AllResourcesDoNotDelete, AllResourcesReadOnly, None
--management-group -m

청사진 할당의 대상 범위에 관리 그룹을 사용합니다. 나중에 사용할 수 있습니다. 대신 --subscription을 사용합니다.

--parameters -p

청사진 할당 매개 변수 값입니다. JSON 문자열 또는 JSON 파일 경로일 수 있습니다.

--resource-group-value

리소스 그룹에 대한 키=값 쌍입니다. 키에는 'artifact_name'(필수), 'name', 'location'이 포함됩니다.

--subscription -s

청사진 할당의 대상 범위에 대한 구독을 사용합니다. 옵션을 지정하지 않으면 기본 susbcription이 사용됩니다.

--user-assigned-identity

리소스와 연결된 사용자 할당 관리 ID입니다.

전역 매개 변수
--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 blueprint assignment delete

미리 보기

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

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

az blueprint assignment delete --name
                               [--delete-behavior {all, none}]
                               [--management-group]
                               [--subscription]
                               [--yes]

예제

할당 삭제

az blueprint assignment delete --subscription MySubscription --name MyBlueprintAssignment

필수 매개 변수

--name -n

청사진 할당의 이름입니다.

선택적 매개 변수

--delete-behavior

deleteBehavior=all이면 청사진 할당에서 만든 리소스가 삭제됩니다.

허용되는 값: all, none
--management-group -m

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

--subscription -s

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

--yes -y

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

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 blueprint assignment list

미리 보기

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

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

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

예제

할당 나열

az blueprint assignment 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
Default value: json
--query

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

--subscription

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

--verbose

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

az blueprint assignment show

미리 보기

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

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

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

예제

과제 표시

az blueprint assignment show --subscription MySubscription --name MyBlueprintAssignment

필수 매개 변수

--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
Default value: json
--query

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

--subscription

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

--verbose

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

az blueprint assignment update

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

az blueprint assignment update --name
                               [--blueprint-version]
                               [--description]
                               [--display-name]
                               [--identity-type {None, SystemAssigned, UserAssigned}]
                               [--location]
                               [--locks-excluded-principals]
                               [--locks-mode {AllResourcesDoNotDelete, AllResourcesReadOnly, None}]
                               [--management-group]
                               [--parameters]
                               [--resource-group-value]
                               [--subscription]
                               [--user-assigned-identity]

필수 매개 변수

--name -n

청사진 할당의 이름입니다.

선택적 매개 변수

--blueprint-version

게시된 청사진 정의 버전의 리소스 ID입니다.

--description

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

--display-name

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

--identity-type

관리 ID의 형식입니다.

허용되는 값: None, SystemAssigned, UserAssigned
--location -l

위치. 값: az account list-locations. az configure --defaults location=<location>을 사용하여 기본 위치를 구성할 수 있습니다.

--locks-excluded-principals

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

--locks-mode

잠금 모드입니다.

허용되는 값: AllResourcesDoNotDelete, AllResourcesReadOnly, None
--management-group -m

청사진 할당의 대상 범위에 관리 그룹을 사용합니다. 나중에 사용할 수 있습니다. 대신 --subscription을 사용합니다.

--parameters -p

청사진 할당 매개 변수 값입니다. JSON 문자열 또는 JSON 파일 경로일 수 있습니다.

--resource-group-value

리소스 그룹에 대한 키=값 쌍입니다. 키에는 'artifact_name'(필수), 'name', 'location'이 포함됩니다.

--subscription -s

청사진 할당의 대상 범위에 대한 구독을 사용합니다. 옵션을 지정하지 않으면 기본 susbcription이 사용됩니다.

--user-assigned-identity

리소스와 연결된 사용자 할당 관리 ID입니다.

전역 매개 변수
--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 blueprint assignment wait

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

az blueprint assignment wait --name
                             [--created]
                             [--custom]
                             [--deleted]
                             [--exists]
                             [--interval]
                             [--management-group]
                             [--subscription]
                             [--timeout]
                             [--updated]

예제

청사진 할당이 성공적으로 프로비전될 때까지 CLI 스크립트의 다음 줄 실행을 일시 중지합니다.

az blueprint assignment wait --subscription MySubscription \ --name MyBlueprintAssignment --created

필수 매개 변수

--name -n

청사진 할당의 이름입니다.

선택적 매개 변수

--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
--management-group -m

청사진 할당의 대상 범위에 관리 그룹을 사용합니다. 나중에 사용할 수 있습니다. 대신 --subscription을 사용합니다.

--subscription -s

청사진 할당의 대상 범위에 대한 구독을 사용합니다. 옵션을 지정하지 않으면 기본 susbcription이 사용됩니다.

--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 blueprint assignment who

미리 보기

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

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

az blueprint assignment who --name
                            [--management-group]
                            [--subscription]

예제

SPN objectId 가져오기

az blueprint assignment who --subscription MySubscription --name MyBlueprintAssignment

필수 매개 변수

--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
Default value: json
--query

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

--subscription

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

--verbose

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