az deployment group

Управление развертыванием шаблона Azure Resource Manager в группе ресурсов.

Команды

az deployment group cancel

Отмена развертывания в группе ресурсов.

az deployment group create

Запуск развертывания в группе ресурсов.

az deployment group delete

Удаление развертывания в группе ресурсов.

az deployment group export

Экспортирует шаблон, который использовался для развертывания.

az deployment group list

Вывод списка развертываний в группе ресурсов.

az deployment group show

Отображение развертывания в группе ресурсов.

az deployment group validate

Проверьте, является ли шаблон допустимым в группе ресурсов.

az deployment group wait

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

az deployment group what-if

Выполнение операции развертывания What-If в области группы ресурсов.

az deployment group cancel

Отмена развертывания в группе ресурсов.

az deployment group cancel --name
                           --resource-group
                           [--subscription]

Примеры

Отмена развертывания в группе ресурсов.

az deployment group cancel -g testrg -n deployment01

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

--name -n

Имя развертывания.

--resource-group -g

Имя группы ресурсов. Вы можете настроить расположение по умолчанию с помощью az configure --defaults group=<name>.

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

--subscription

Имя или идентификатор подписки Вы можете настроить подписку по умолчанию с помощью az account set -s NAME_OR_ID .

az deployment group create

Запуск развертывания в группе ресурсов.

az deployment group create --resource-group
                           [--aux-subs]
                           [--aux-tenants]
                           [--confirm-with-what-if]
                           [--handle-extended-json-format]
                           [--mode {Complete, Incremental}]
                           [--name]
                           [--no-prompt {false, true}]
                           [--no-wait]
                           [--parameters]
                           [--proceed-if-no-change]
                           [--query-string]
                           [--rollback-on-error]
                           [--subscription]
                           [--template-file]
                           [--template-spec]
                           [--template-uri]
                           [--what-if]
                           [--what-if-exclude-change-types {Create, Delete, Deploy, Ignore, Modify, NoChange, Unsupported}]
                           [--what-if-result-format {FullResourcePayloads, ResourceIdOnly}]

Примеры

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

az deployment group create --resource-group testrg --name rollout01 \
    --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json

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

az deployment group create --resource-group testrg --name rollout01 \
    --template-file azuredeploy.json  \
    --parameters '{ \"policyName\": { \"value\": \"policy2\" } }'

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

az deployment group create --resource-group testgroup --template-file demotemplate.json --parameters exampleString='inline string' exampleArray='("value1", "value2")'

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

az deployment group create --resource-group testrg --name rollout01 \
    --template-file azuredeploy.json  --parameters @params.json \
    --parameters https://mysite/params.json --parameters MyValue=This MyArray=@array.json

Создание развертывания в области подписки на основе шаблона-спецификации

az deployment group create --resource-group testrg --template-spec "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.Resources/templateSpecs/myTemplateSpec/versions/1.0"

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

--resource-group -g

Группа ресурсов для создания развертывания в.

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

--aux-subs

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

--aux-tenants

Вспомогательные клиенты, которые будут использоваться при развертывании между клиентами.

--confirm-with-what-if -c

Предложите команде выполнить развертывание What-If перед выполнением развертывания. После этого будет предложено подтвердить изменения ресурсов, прежде чем продолжить.

--handle-extended-json-format -j

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

--mode

Режим развертывания.

допустимые значения: Complete, Incremental
значение по умолчанию: Incremental
--name -n

Имя развертывания.

--no-prompt

Параметр для отключения запроса отсутствующих параметров для шаблона ARM. Если значение равно true, запрос, предлагающий пользователям указать отсутствующий параметр, будет проигнорирован. Значение по умолчанию — false.

допустимые значения: false, true
--no-wait

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

--parameters -p

Укажите значения параметров развертывания.

--proceed-if-no-change

Предложите команду на выполнение развертывания, если What-If результат не содержит изменений ресурсов. Применимо, если задан параметр--Confirm-with-What-If.

--query-string -q

Строка запроса (маркер SAS) для использования с шаблоном URI в случае с связанными шаблонами.

--rollback-on-error

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

--subscription

Имя или идентификатор подписки Вы можете настроить подписку по умолчанию с помощью az account set -s NAME_OR_ID .

--template-file -f

Путь к файлу шаблона или файлу Бицеп.

--template-spec -s

Идентификатор ресурса спецификации шаблона.

--template-uri -u

Универсальный код ресурса (URI) для файла шаблона.

--what-if -w

Укажите, что команда запускает развертывание что если.

--what-if-exclude-change-types -x

Разделенный пробелами список типов изменений ресурсов, исключаемых из результатов What-If. Применимо, если задан параметр--Confirm-with-What-If.

допустимые значения: Create, Delete, Deploy, Ignore, Modify, NoChange, Unsupported
--what-if-result-format -r

Формат результатов What-If. Применяется --confirm-with-what-if , если задан параметр.

допустимые значения: FullResourcePayloads, ResourceIdOnly
значение по умолчанию: FullResourcePayloads

az deployment group delete

Удаление развертывания в группе ресурсов.

az deployment group delete --name
                           --resource-group
                           [--no-wait]
                           [--subscription]

Примеры

Удаление развертывания в группе ресурсов.

az deployment group delete -g testrg -n deployment01

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

--name -n

Имя развертывания.

--resource-group -g

Имя группы ресурсов. Вы можете настроить расположение по умолчанию с помощью az configure --defaults group=<name>.

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

--no-wait

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

--subscription

Имя или идентификатор подписки Вы можете настроить подписку по умолчанию с помощью az account set -s NAME_OR_ID .

az deployment group export

Экспортирует шаблон, который использовался для развертывания.

az deployment group export --name
                           --resource-group
                           [--subscription]

Примеры

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

az deployment group export --resource-group testrg --name MyDeployment

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

--name -n

Имя развертывания.

--resource-group -g

Имя группы ресурсов. Вы можете настроить расположение по умолчанию с помощью az configure --defaults group=<name>.

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

--subscription

Имя или идентификатор подписки Вы можете настроить подписку по умолчанию с помощью az account set -s NAME_OR_ID .

az deployment group list

Вывод списка развертываний в группе ресурсов.

az deployment group list --resource-group
                         [--filter]
                         [--query-examples]
                         [--subscription]

Примеры

Вывод списка развертываний в группе ресурсов.

az deployment group list -g testrg

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

--resource-group -g

Имя группы ресурсов. Вы можете настроить расположение по умолчанию с помощью az configure --defaults group=<name>.

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

--filter

Критерий фильтра с использованием нотации OData. Для фильтрации provisioningState можно использовать параметр--Filter "provisioningState EQ" {State} "". Чтобы получить дополнительные сведения, перейдите по адресу https://docs.microsoft.com/en-us/rest/api/resources/deployments/listatsubscriptionscope#uri-parameters .

--query-examples

Рекомендуемая строка JMESPath. Можно скопировать один из запросов и вставить его после параметра--query в двойных кавычках, чтобы увидеть результаты. Можно добавить одно или несколько позиций ключевых слов, чтобы мы могли предоставлять предложения на основе этих ключевых слов.

--subscription

Имя или идентификатор подписки Вы можете настроить подписку по умолчанию с помощью az account set -s NAME_OR_ID .

az deployment group show

Отображение развертывания в группе ресурсов.

az deployment group show --name
                         --resource-group
                         [--query-examples]
                         [--subscription]

Примеры

Отображение развертывания в группе ресурсов.

az deployment group show -g testrg -n deployment01

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

--name -n

Имя развертывания.

--resource-group -g

Имя группы ресурсов. Вы можете настроить расположение по умолчанию с помощью az configure --defaults group=<name>.

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

--query-examples

Рекомендуемая строка JMESPath. Можно скопировать один из запросов и вставить его после параметра--query в двойных кавычках, чтобы увидеть результаты. Можно добавить одно или несколько позиций ключевых слов, чтобы мы могли предоставлять предложения на основе этих ключевых слов.

--subscription

Имя или идентификатор подписки Вы можете настроить подписку по умолчанию с помощью az account set -s NAME_OR_ID .

az deployment group validate

Проверьте, является ли шаблон допустимым в группе ресурсов.

az deployment group validate --resource-group
                             [--handle-extended-json-format]
                             [--mode {Complete, Incremental}]
                             [--name]
                             [--no-prompt {false, true}]
                             [--parameters]
                             [--query-string]
                             [--rollback-on-error]
                             [--subscription]
                             [--template-file]
                             [--template-spec]
                             [--template-uri]

Примеры

Проверьте, является ли шаблон допустимым в группе ресурсов.

az deployment group validate --resource-group testrg --template-file {template-file}

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

az deployment group validate --parameters MyValue=This MyArray=@array.json --resource-group testrg --template-file azuredeploy.json

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

--resource-group -g

Группа ресурсов для создания развертывания в.

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

--handle-extended-json-format -j

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

--mode

Режим развертывания.

допустимые значения: Complete, Incremental
значение по умолчанию: Incremental
--name -n

Имя развертывания.

--no-prompt

Параметр для отключения запроса отсутствующих параметров для шаблона ARM. Если значение равно true, запрос, предлагающий пользователям указать отсутствующий параметр, будет проигнорирован. Значение по умолчанию — false.

допустимые значения: false, true
--parameters -p

Укажите значения параметров развертывания.

--query-string -q

Строка запроса (маркер SAS) для использования с шаблоном URI в случае с связанными шаблонами.

--rollback-on-error

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

--subscription

Имя или идентификатор подписки Вы можете настроить подписку по умолчанию с помощью az account set -s NAME_OR_ID .

--template-file -f

Путь к файлу шаблона или файлу Бицеп.

--template-spec -s

Идентификатор ресурса спецификации шаблона.

--template-uri -u

Универсальный код ресурса (URI) для файла шаблона.

az deployment group wait

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

az deployment group wait --name
                         --resource-group
                         [--created]
                         [--custom]
                         [--deleted]
                         [--exists]
                         [--interval]
                         [--subscription]
                         [--timeout]
                         [--updated]

Примеры

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

az deployment group wait --created --name MyDeployment --resource-group MyResourceGroup

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

--name -n

Имя развертывания.

--resource-group -g

Имя группы ресурсов. Вы можете настроить расположение по умолчанию с помощью az configure --defaults group=<name>.

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

--created

Дождитесь создания "provisioningState" в "выполнено".

--custom

Дождитесь, пока условие не будет удовлетворять пользовательскому запросу JMESPath. Пример: provisioningState! = ' Progress ', instanceView. statuss [? code = = ' PowerState/выполняется '].

--deleted

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

--exists

Дождитесь существования ресурса.

--interval

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

значение по умолчанию: 30
--subscription

Имя или идентификатор подписки Вы можете настроить подписку по умолчанию с помощью az account set -s NAME_OR_ID .

--timeout

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

значение по умолчанию: 3600
--updated

Дождитесь обновления с provisioningState в "выполнено".

az deployment group what-if

Выполнение операции развертывания What-If в области группы ресурсов.

az deployment group what-if --resource-group
                            [--aux-tenants]
                            [--exclude-change-types {Create, Delete, Deploy, Ignore, Modify, NoChange, Unsupported}]
                            [--mode {Complete, Incremental}]
                            [--name]
                            [--no-pretty-print]
                            [--no-prompt {false, true}]
                            [--parameters]
                            [--query-string]
                            [--result-format {FullResourcePayloads, ResourceIdOnly}]
                            [--subscription]
                            [--template-file]
                            [--template-spec]
                            [--template-uri]

Примеры

Выполнение операции развертывания What-If в группе ресурсов.

az deployment group what-if --resource-group testrg --name rollout01 --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json

Выполните операцию What-If развертывания в группе ресурсов с форматом Ресаурцеидонли.

az deployment group what-if --resource-group testrg --name rollout01 --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json --result-format ResourceIdOnly

Выполните операцию развертывания What-If в группе ресурсов, не выполняя при этом достаточное для печати результата.

az deployment group what-if --resource-group testrg --name rollout01 --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json --no-pretty-print

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

--resource-group -g

Группа ресурсов для выполнения операции развертывания What-If в.

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

--aux-tenants

Вспомогательные клиенты, которые будут использоваться при развертывании между клиентами.

--exclude-change-types -x

Разделенный пробелами список типов изменений ресурсов, исключаемых из результатов What-If.

допустимые значения: Create, Delete, Deploy, Ignore, Modify, NoChange, Unsupported
--mode

Режим развертывания.

допустимые значения: Complete, Incremental
значение по умолчанию: Incremental
--name -n

Имя развертывания.

--no-pretty-print

Отключите печать для What-If результатов. Если этот параметр задан, будет использоваться тип выходного формата.

--no-prompt

Параметр для отключения запроса отсутствующих параметров для шаблона ARM. Если значение равно true, запрос, предлагающий пользователям указать отсутствующий параметр, будет проигнорирован. Значение по умолчанию — false.

допустимые значения: false, true
--parameters -p

Укажите значения параметров развертывания.

--query-string -q

Строка запроса (маркер SAS) для использования с шаблоном URI в случае с связанными шаблонами.

--result-format -r

Формат результатов What-If.

допустимые значения: FullResourcePayloads, ResourceIdOnly
значение по умолчанию: FullResourcePayloads
--subscription

Имя или идентификатор подписки Вы можете настроить подписку по умолчанию с помощью az account set -s NAME_OR_ID .

--template-file -f

Путь к файлу шаблона или файлу Бикпе.

--template-spec -s

Идентификатор ресурса спецификации шаблона.

--template-uri -u

Универсальный код ресурса (URI) для файла шаблона.