az blueprint assignment

  • Критическое изменение

Note

Эта ссылка является частью расширения blueprint для Azure CLI (версия 2.50.0 или более поздней). Расширение будет автоматически устанавливаться при первом запуске команды az blueprint assignment. Подробнее о расширениях.

Схемы и связанные команды будут устарели до июля 2026 года. Клиентам рекомендуется перейти на спецификации шаблонов и комплекты развертываний для поддержки своих сценариев после этой даты. Документация по миграции доступна в https://learn.microsoft.com/en-us/azure/azure-resource-manager/bicep/migrate-blueprint. Эта группа команд неявно устарела, так как команда az blueprint устарела и будет удалена в будущем выпуске.

Команды для управления назначением схемы.

Команды

Имя Описание Тип Состояние
az blueprint assignment create

Создание назначения схемы.

 Extension GA
az blueprint assignment delete

Удаление назначения схемы.

 Extension Preview
az blueprint assignment list

Вывод списка назначений схемы в подписке.

 Extension Preview
az blueprint assignment show

Получение назначения схемы.

 Extension Preview
az blueprint assignment update

Обновление назначения схемы.

 Extension GA
az blueprint assignment wait

Поместите интерфейс командной строки в состояние ожидания до тех пор, пока не будет выполнено условие назначения схемы.

 Extension GA
az blueprint assignment who

Получение объекта ObjectId объекта имени субъекта-объекта Blueprint Servie.

 Extension Preview

az blueprint assignment create

Критическое изменение

Схемы и связанные команды будут устарели до июля 2026 года. Клиентам рекомендуется перейти на спецификации шаблонов и комплекты развертываний для поддержки своих сценариев после этой даты. Документация по миграции доступна в https://learn.microsoft.com/en-us/azure/azure-resource-manager/bicep/migrate-blueprint. Эта команда неявно устарела, так как команда az blueprint устарела и будет удалена в будущем выпуске.

Создание назначения схемы.

az blueprint assignment create --name
                               [--acquire-policy-token]
                               [--blueprint-version]
                               [--change-reference]
                               [--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]

Примеры

Назначение с управляемым удостоверением, назначаемое системой

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" \

Назначение с управляемым удостоверением, назначаемое пользователем

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

Имя назначения схемы.

Необязательные параметры

Следующие параметры являются необязательными, но в зависимости от контекста один или несколько могут потребоваться для успешного выполнения команды.

--acquire-policy-token

Автоматическое получение маркера Политика Azure для этой операции ресурса.

Свойство Значение
Группа параметров: Global Policy Arguments
--blueprint-version

Идентификатор ресурса опубликованной версии определения схемы.

--change-reference

Связанный идентификатор ссылки на изменение для этой операции ресурса.

Свойство Значение
Группа параметров: Global Policy Arguments
--description

В нескольких строках объясняется этот ресурс.

--display-name

Строка однострочный поясняет этот ресурс.

--identity-type

Тип управляемого удостоверения.

Свойство Значение
Группа параметров: Identity Arguments
Default value: SystemAssigned
Допустимые значения: None, SystemAssigned, UserAssigned
--location -l

Location. Значения от az account list-locations. Расположение по умолчанию можно настроить с помощью az configure --defaults location=<location>.

--locks-excluded-principals

Список субъектов AAD, исключенных из блокировок схемы. Разрешено до 5 субъектов.

--locks-mode

Режим блокировки.

Свойство Значение
Допустимые значения: AllResourcesDoNotDelete, AllResourcesReadOnly, None
--management-group -m

Используйте группу управления для целевой области назначения схемы. Он зарезервирован для дальнейшего использования. Вместо этого используйте --subscription.

Свойство Значение
Группа параметров: Resource_scope Arguments
--parameters -p

Значения параметров назначения схемы. Это может быть строка JSON или путь к файлу JSON.

--resource-group-value

Key=Value пар для группы ресурсов. Ключи включают "artifact_name"(обязательный), "name", "location".

--subscription -s

Используйте подписку для целевой области назначения схемы. Значение по умолчанию susbcription будет использоваться, если параметр не указан.

Свойство Значение
Группа параметров: Resource_scope Arguments
--user-assigned-identity

Назначаемое пользователем управляемое удостоверение, связанное с ресурсом.

Свойство Значение
Группа параметров: Identity Arguments
Глобальные параметры
--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/.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство Значение
Default value: False

az blueprint assignment delete

Предварительный просмотр Критическое изменение

Эта команда находится в предварительной версии и находится в процессе разработки. Уровни справки и поддержки: https://aka.ms/CLI_refstatus

Схемы и связанные команды будут устарели до июля 2026 года. Клиентам рекомендуется перейти на спецификации шаблонов и комплекты развертываний для поддержки своих сценариев после этой даты. Документация по миграции доступна в https://learn.microsoft.com/en-us/azure/azure-resource-manager/bicep/migrate-blueprint. Эта команда неявно устарела, так как команда az blueprint устарела и будет удалена в будущем выпуске.

Удаление назначения схемы.

az blueprint assignment delete --name
                               [--acquire-policy-token]
                               [--change-reference]
                               [--delete-behavior {all, none}]
                               [--management-group]
                               [--subscription]
                               [--yes]

Примеры

Удаление назначения

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

Обязательные параметры

--name -n

Имя назначения схемы.

Необязательные параметры

Следующие параметры являются необязательными, но в зависимости от контекста один или несколько могут потребоваться для успешного выполнения команды.

--acquire-policy-token

Автоматическое получение маркера Политика Azure для этой операции ресурса.

Свойство Значение
Группа параметров: Global Policy Arguments
--change-reference

Связанный идентификатор ссылки на изменение для этой операции ресурса.

Свойство Значение
Группа параметров: Global Policy Arguments
--delete-behavior

При удаленииBehavior=all ресурсы, созданные назначением схемы, будут удалены.

Свойство Значение
Допустимые значения: all, none
--management-group -m

Используйте группу управления для области схемы.

Свойство Значение
Группа параметров: Resource_scope Arguments
--subscription -s

Используйте подписку для области схемы. Если группа --management-не указана, значение --subscription или подписка по умолчанию будет использоваться в качестве области.

Свойство Значение
Группа параметров: Resource_scope Arguments
--yes -y

Не запрашивать подтверждение.

Свойство Значение
Default value: False
Глобальные параметры
--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/.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство Значение
Default value: False

az blueprint assignment list

Предварительный просмотр Критическое изменение

Эта команда находится в предварительной версии и находится в процессе разработки. Уровни справки и поддержки: https://aka.ms/CLI_refstatus

Схемы и связанные команды будут устарели до июля 2026 года. Клиентам рекомендуется перейти на спецификации шаблонов и комплекты развертываний для поддержки своих сценариев после этой даты. Документация по миграции доступна в https://learn.microsoft.com/en-us/azure/azure-resource-manager/bicep/migrate-blueprint. Эта команда неявно устарела, так как команда az blueprint устарела и будет удалена в будущем выпуске.

Вывод списка назначений схемы в подписке.

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

Примеры

Перечисление заданий

az blueprint assignment list --subscription MySubscription

Необязательные параметры

Следующие параметры являются необязательными, но в зависимости от контекста один или несколько могут потребоваться для успешного выполнения команды.

--management-group -m

Используйте группу управления для области схемы.

Свойство Значение
Группа параметров: Resource_scope Arguments
--max-items

Общее количество элементов, возвращаемых в выходных данных команды. Если общее количество доступных элементов превышает указанное значение, маркер предоставляется в выходных данных команды. Чтобы возобновить разбиение на страницы, укажите значение маркера в --next-token аргументе последующей команды.

Свойство Значение
Группа параметров: Pagination Arguments
--next-token

Маркер, чтобы указать, где начать разбиение на страницы. Это значение маркера из ранее усеченного ответа.

Свойство Значение
Группа параметров: Pagination Arguments
--subscription -s

Используйте подписку для области схемы. Если группа --management-не указана, значение --subscription или подписка по умолчанию будет использоваться в качестве области.

Свойство Значение
Группа параметров: Resource_scope Arguments
Глобальные параметры
--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/.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство Значение
Default value: False

az blueprint assignment show

Предварительный просмотр Критическое изменение

Эта команда находится в предварительной версии и находится в процессе разработки. Уровни справки и поддержки: https://aka.ms/CLI_refstatus

Схемы и связанные команды будут устарели до июля 2026 года. Клиентам рекомендуется перейти на спецификации шаблонов и комплекты развертываний для поддержки своих сценариев после этой даты. Документация по миграции доступна в https://learn.microsoft.com/en-us/azure/azure-resource-manager/bicep/migrate-blueprint. Эта команда неявно устарела, так как команда az blueprint устарела и будет удалена в будущем выпуске.

Получение назначения схемы.

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

Примеры

Отображение назначения

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

Обязательные параметры

--name -n

Имя назначения схемы.

Необязательные параметры

Следующие параметры являются необязательными, но в зависимости от контекста один или несколько могут потребоваться для успешного выполнения команды.

--management-group -m

Используйте группу управления для области схемы.

Свойство Значение
Группа параметров: Resource_scope Arguments
--subscription -s

Используйте подписку для области схемы. Если группа --management-не указана, значение --subscription или подписка по умолчанию будет использоваться в качестве области.

Свойство Значение
Группа параметров: Resource_scope Arguments
Глобальные параметры
--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/.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство Значение
Default value: False

az blueprint assignment update

Критическое изменение

Схемы и связанные команды будут устарели до июля 2026 года. Клиентам рекомендуется перейти на спецификации шаблонов и комплекты развертываний для поддержки своих сценариев после этой даты. Документация по миграции доступна в https://learn.microsoft.com/en-us/azure/azure-resource-manager/bicep/migrate-blueprint. Эта команда неявно устарела, так как команда az blueprint устарела и будет удалена в будущем выпуске.

Обновление назначения схемы.

az blueprint assignment update --name
                               [--acquire-policy-token]
                               [--blueprint-version]
                               [--change-reference]
                               [--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

Имя назначения схемы.

Необязательные параметры

Следующие параметры являются необязательными, но в зависимости от контекста один или несколько могут потребоваться для успешного выполнения команды.

--acquire-policy-token

Автоматическое получение маркера Политика Azure для этой операции ресурса.

Свойство Значение
Группа параметров: Global Policy Arguments
--blueprint-version

Идентификатор ресурса опубликованной версии определения схемы.

--change-reference

Связанный идентификатор ссылки на изменение для этой операции ресурса.

Свойство Значение
Группа параметров: Global Policy Arguments
--description

В нескольких строках объясняется этот ресурс.

--display-name

Строка однострочный поясняет этот ресурс.

--identity-type

Тип управляемого удостоверения.

Свойство Значение
Группа параметров: Identity Arguments
Допустимые значения: None, SystemAssigned, UserAssigned
--location -l

Location. Значения от az account list-locations. Расположение по умолчанию можно настроить с помощью az configure --defaults location=<location>.

--locks-excluded-principals

Список субъектов AAD, исключенных из блокировок схемы. Разрешено до 5 субъектов.

--locks-mode

Режим блокировки.

Свойство Значение
Допустимые значения: AllResourcesDoNotDelete, AllResourcesReadOnly, None
--management-group -m

Используйте группу управления для целевой области назначения схемы. Он зарезервирован для дальнейшего использования. Вместо этого используйте --subscription.

Свойство Значение
Группа параметров: Resource_scope Arguments
--parameters -p

Значения параметров назначения схемы. Это может быть строка JSON или путь к файлу JSON.

--resource-group-value

Key=Value пар для группы ресурсов. Ключи включают "artifact_name"(обязательный), "name", "location".

--subscription -s

Используйте подписку для целевой области назначения схемы. Значение по умолчанию susbcription будет использоваться, если параметр не указан.

Свойство Значение
Группа параметров: Resource_scope Arguments
--user-assigned-identity

Назначаемое пользователем управляемое удостоверение, связанное с ресурсом.

Свойство Значение
Группа параметров: Identity Arguments
Глобальные параметры
--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/.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство Значение
Default value: False

az blueprint assignment wait

Критическое изменение

Схемы и связанные команды будут устарели до июля 2026 года. Клиентам рекомендуется перейти на спецификации шаблонов и комплекты развертываний для поддержки своих сценариев после этой даты. Документация по миграции доступна в https://learn.microsoft.com/en-us/azure/azure-resource-manager/bicep/migrate-blueprint. Эта команда неявно устарела, так как команда az blueprint устарела и будет удалена в будущем выпуске.

Поместите интерфейс командной строки в состояние ожидания до тех пор, пока не будет выполнено условие назначения схемы.

az blueprint assignment wait --name
                             [--acquire-policy-token]
                             [--change-reference]
                             [--created]
                             [--custom]
                             [--deleted]
                             [--exists]
                             [--interval]
                             [--management-group]
                             [--subscription]
                             [--timeout]
                             [--updated]

Примеры

Приостановка выполнения следующей строки скрипта CLI до тех пор, пока назначение схемы не будет успешно подготовлено.

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

Обязательные параметры

--name -n

Имя назначения схемы.

Необязательные параметры

Следующие параметры являются необязательными, но в зависимости от контекста один или несколько могут потребоваться для успешного выполнения команды.

--acquire-policy-token

Автоматическое получение маркера Политика Azure для этой операции ресурса.

Свойство Значение
Группа параметров: Global Policy Arguments
--change-reference

Связанный идентификатор ссылки на изменение для этой операции ресурса.

Свойство Значение
Группа параметров: Global Policy Arguments
--created

Подождите, пока не будет создано с помощью provisioningState по адресу "Успешно".

Свойство Значение
Группа параметров: Wait Condition Arguments
Default value: False
--custom

Подождите, пока условие не будет удовлетворено пользовательским запросом JMESPath. Например, provisioningState!='InProgress', instanceView.statuses[?code='PowerState/running'].

Свойство Значение
Группа параметров: Wait Condition Arguments
--deleted

Дождитесь удаления.

Свойство Значение
Группа параметров: Wait Condition Arguments
Default value: False
--exists

Подождите, пока ресурс не существует.

Свойство Значение
Группа параметров: Wait Condition Arguments
Default value: False
--interval

Интервал опроса в секундах.

Свойство Значение
Группа параметров: Wait Condition Arguments
Default value: 30
--management-group -m

Используйте группу управления для целевой области назначения схемы. Он зарезервирован для дальнейшего использования. Вместо этого используйте --subscription.

Свойство Значение
Группа параметров: Resource_scope Arguments
--subscription -s

Используйте подписку для целевой области назначения схемы. Значение по умолчанию susbcription будет использоваться, если параметр не указан.

Свойство Значение
Группа параметров: Resource_scope Arguments
--timeout

Максимальное ожидание в секундах.

Свойство Значение
Группа параметров: Wait Condition Arguments
Default value: 3600
--updated

Подождите, пока не будет обновлено с помощью provisioningState по адресу "Успешно".

Свойство Значение
Группа параметров: Wait Condition Arguments
Default value: False
Глобальные параметры
--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/.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство Значение
Default value: False

az blueprint assignment who

Предварительный просмотр Критическое изменение

Эта команда находится в предварительной версии и находится в процессе разработки. Уровни справки и поддержки: https://aka.ms/CLI_refstatus

Схемы и связанные команды будут устарели до июля 2026 года. Клиентам рекомендуется перейти на спецификации шаблонов и комплекты развертываний для поддержки своих сценариев после этой даты. Документация по миграции доступна в https://learn.microsoft.com/en-us/azure/azure-resource-manager/bicep/migrate-blueprint. Эта команда неявно устарела, так как команда az blueprint устарела и будет удалена в будущем выпуске.

Получение объекта ObjectId объекта имени субъекта-объекта Blueprint Servie.

az blueprint assignment who --name
                            [--acquire-policy-token]
                            [--change-reference]
                            [--management-group]
                            [--subscription]

Примеры

Получение объекта SPN

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

Обязательные параметры

--name -n

Имя назначения схемы.

Необязательные параметры

Следующие параметры являются необязательными, но в зависимости от контекста один или несколько могут потребоваться для успешного выполнения команды.

--acquire-policy-token

Автоматическое получение маркера Политика Azure для этой операции ресурса.

Свойство Значение
Группа параметров: Global Policy Arguments
--change-reference

Связанный идентификатор ссылки на изменение для этой операции ресурса.

Свойство Значение
Группа параметров: Global Policy Arguments
--management-group -m

Используйте группу управления для области схемы.

Свойство Значение
Группа параметров: Resource_scope Arguments
--subscription -s

Используйте подписку для области схемы. Если группа --management-не указана, значение --subscription или подписка по умолчанию будет использоваться в качестве области.

Свойство Значение
Группа параметров: Resource_scope Arguments
Глобальные параметры
--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/.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство Значение
Default value: False