Поделиться через

az blueprint assignment

  • Breaking change

Note

Эта ссылка является частью расширения схемы для 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

Breaking change

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

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

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]

Примеры

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

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

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

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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--blueprint-version

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

--description

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

--display-name

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

--identity-type

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

Свойство Значение
Parameter group: 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.

Свойство Значение
Parameter group: Resource_scope Arguments
--parameters -p

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

--resource-group-value

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

--subscription -s

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

Свойство Значение
Parameter group: Resource_scope Arguments
--user-assigned-identity

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

Свойство Значение
Parameter group: 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

Предварительный просмотр Breaking change

Эта команда находится в предварительной версии и находится в процессе разработки. Уровни справки и поддержки: 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
                               [--delete-behavior {all, none}]
                               [--management-group]
                               [--subscription]
                               [--yes]

Примеры

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

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

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

--name -n

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

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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--delete-behavior

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

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

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

Свойство Значение
Parameter group: Resource_scope Arguments
--subscription -s

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

Свойство Значение
Parameter group: 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

Предварительный просмотр Breaking change

Эта команда находится в предварительной версии и находится в процессе разработки. Уровни справки и поддержки: 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

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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--management-group -m

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

Свойство Значение
Parameter group: Resource_scope Arguments
--max-items

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

Свойство Значение
Parameter group: Pagination Arguments
--next-token

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

Свойство Значение
Parameter group: Pagination Arguments
--subscription -s

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

Свойство Значение
Parameter group: 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

Предварительный просмотр Breaking change

Эта команда находится в предварительной версии и находится в процессе разработки. Уровни справки и поддержки: 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

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

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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--management-group -m

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

Свойство Значение
Parameter group: Resource_scope Arguments
--subscription -s

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

Свойство Значение
Parameter group: 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

Breaking change

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

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

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

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

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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--blueprint-version

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

--description

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

--display-name

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

--identity-type

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

Свойство Значение
Parameter group: 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.

Свойство Значение
Parameter group: Resource_scope Arguments
--parameters -p

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

--resource-group-value

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

--subscription -s

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

Свойство Значение
Parameter group: Resource_scope Arguments
--user-assigned-identity

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

Свойство Значение
Parameter group: 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

Breaking change

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

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

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

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

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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--created

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

Свойство Значение
Parameter group: Wait Condition Arguments
Default value: False
--custom

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

Свойство Значение
Parameter group: Wait Condition Arguments
--deleted

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

Свойство Значение
Parameter group: Wait Condition Arguments
Default value: False
--exists

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

Свойство Значение
Parameter group: Wait Condition Arguments
Default value: False
--interval

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

Свойство Значение
Parameter group: Wait Condition Arguments
Default value: 30
--management-group -m

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

Свойство Значение
Parameter group: Resource_scope Arguments
--subscription -s

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

Свойство Значение
Parameter group: Resource_scope Arguments
--timeout

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

Свойство Значение
Parameter group: Wait Condition Arguments
Default value: 3600
--updated

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

Свойство Значение
Parameter group: 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

Предварительный просмотр Breaking change

Эта команда находится в предварительной версии и находится в процессе разработки. Уровни справки и поддержки: 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
                            [--management-group]
                            [--subscription]

Примеры

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

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

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

--name -n

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

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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--management-group -m

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

Свойство Значение
Parameter group: Resource_scope Arguments
--subscription -s

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

Свойство Значение
Parameter group: 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