az image
Заметка
Эта группа команд содержит команды, определенные как в Azure CLI, так и в одном расширении. Установите каждое расширение, чтобы воспользоваться расширенными возможностями. Узнайте больше о расширениях.
Управление пользовательскими образами виртуальных машин.
Команды
Имя | Описание | Тип | Состояние |
---|---|---|---|
az image builder |
Управление и создание шаблонов построителя образов. |
Ядро | ГА |
az image builder cancel |
Отмена длительной сборки образа на основе шаблона образа. |
Ядро | ГА |
az image builder create |
Создайте шаблон построителя образов. |
Ядро | ГА |
az image builder customizer |
Управление настройщиками шаблонов построителя образов. |
Ядро | ГА |
az image builder customizer add |
Добавьте настройщик построителя изображений в шаблон построителя образов. |
Ядро | ГА |
az image builder customizer clear |
Удалите всех настройщиков построителя образов из шаблона построителя образов. |
Ядро | ГА |
az image builder customizer remove |
Удалите настройщик построителя образов из шаблона построителя образов. |
Ядро | ГА |
az image builder delete |
Удаление шаблона построителя образов. |
Ядро | ГА |
az image builder error-handler |
Управление обработчиком ошибок шаблона построителя образов. |
Ядро | ГА |
az image builder error-handler add |
Добавьте обработчик ошибок в существующий шаблон построителя образов. |
Ядро | ГА |
az image builder error-handler remove |
Удалите обработчик ошибок из существующего шаблона построителя образов. |
Ядро | ГА |
az image builder error-handler show |
Отображение обработчика ошибок существующего шаблона построителя образов. |
Ядро | ГА |
az image builder identity |
Управление удостоверениями шаблона построителя образов. |
Ядро | ГА |
az image builder identity assign |
Добавьте управляемые удостоверения в существующий шаблон построителя образов. В настоящее время поддерживается только одно удостоверение пользователя. |
Ядро | ГА |
az image builder identity remove |
Удалите управляемые удостоверения из существующего шаблона построителя образов. |
Ядро | ГА |
az image builder identity show |
Отображение управляемых удостоверений шаблона построителя образов. |
Ядро | ГА |
az image builder list |
Вывод списка шаблонов построителя изображений. |
Ядро | ГА |
az image builder optimizer |
Управление оптимизатором шаблона построителя образов. |
Ядро | ГА |
az image builder optimizer add |
Добавьте оптимизатор в существующий шаблон построителя образов. |
Ядро | ГА |
az image builder optimizer remove |
Удалите оптимизатор из существующего шаблона построителя образов. |
Ядро | ГА |
az image builder optimizer show |
Показать оптимизатор существующего шаблона построителя образов. |
Ядро | ГА |
az image builder optimizer update |
Обновите оптимизатор из существующего шаблона построителя образов. |
Ядро | ГА |
az image builder output |
Управление распространителями выходных данных шаблона построителя образов. |
Ядро | ГА |
az image builder output add |
Добавьте распространитель выходных данных построителя изображений в шаблон построителя образов. |
Ядро | ГА |
az image builder output clear |
Удалите всех распространителей выходных данных построителя образов из шаблона построителя образов. |
Ядро | ГА |
az image builder output remove |
Удалите распространитель выходных данных построителя изображений из шаблона построителя образов. |
Ядро | ГА |
az image builder output versioning |
Управление выходным версиям шаблона построителя образов. |
Ядро | ГА |
az image builder output versioning remove |
Удалите все параметры управления версиями для указанных выходных данных. |
Ядро | ГА |
az image builder output versioning set |
Задайте выходную версию конструктора образов шаблона построителя образов. |
Ядро | ГА |
az image builder output versioning show |
Отображение параметров управления версиями для указанных выходных данных. |
Ядро | ГА |
az image builder run |
Создание шаблона построителя образов. |
Ядро | ГА |
az image builder show |
Отображение шаблона построителя изображений. |
Ядро | ГА |
az image builder show-runs |
Отображение выходных данных запуска шаблона построителя образов. |
Ядро | ГА |
az image builder trigger |
Управление триггером шаблона построителя образов. |
Ядро | ГА |
az image builder trigger create |
Создайте триггер для указанного шаблона образа виртуальной машины. |
Ядро | ГА |
az image builder trigger delete |
Удалите триггер для указанного шаблона образа виртуальной машины. |
Ядро | ГА |
az image builder trigger list |
Перечислить все триггеры для указанного ресурса шаблона образа. |
Ядро | ГА |
az image builder trigger show |
Получите указанный триггер для указанного ресурса шаблона образа. |
Ядро | ГА |
az image builder trigger wait |
Поместите интерфейс командной строки в состояние ожидания, пока не будет выполнено условие. |
Ядро | ГА |
az image builder update |
Обновите шаблон построителя образов. |
Ядро | ГА |
az image builder validator |
Управление проверкой шаблона построителя образов. |
Ядро | ГА |
az image builder validator add |
Добавьте проверку в существующий шаблон построителя образов. |
Ядро | ГА |
az image builder validator remove |
Удалите проверку из существующего шаблона построителя образов. |
Ядро | ГА |
az image builder validator show |
Отображение существующего шаблона построителя образов. |
Ядро | ГА |
az image builder wait |
Поместите интерфейс командной строки в состояние ожидания до тех пор, пока не будет выполнено условие шаблона. |
Ядро | ГА |
az image copy |
Скопируйте управляемый образ (или виртуальную машину) в другие регионы. Для этого требуется, чтобы исходный диск был доступен. |
Расширение | ГА |
az image create |
Создайте пользовательский образ виртуальной машины на управляемых дисках или моментальных снимках. |
Ядро | ГА |
az image delete |
Удаление изображения. |
Ядро | ГА |
az image list |
Список изображений в группе ресурсов. |
Ядро | ГА |
az image show |
Получение изображения. |
Ядро | ГА |
az image update |
Обновление пользовательских образов виртуальных машин. |
Ядро | ГА |
az image wait |
Поместите интерфейс командной строки в состояние ожидания, пока не будет выполнено условие. |
Ядро | ГА |
az image copy
Скопируйте управляемый образ (или виртуальную машину) в другие регионы. Для этого требуется, чтобы исходный диск был доступен.
az image copy --source-object-name
--source-resource-group
--target-location
--target-resource-group
[--cleanup]
[--export-as-snapshot]
[--parallel-degree]
[--source-type {image, vm}]
[--tags]
[--target-name]
[--target-subscription]
[--temporary-resource-group-name]
[--timeout]
Примеры
Скопируйте изображение в несколько регионов и очистите его в конце.
az image copy --source-resource-group mySources-rg --source-object-name myImage \
--target-location uksouth northeurope --target-resource-group "images-repo-rg" --cleanup
Используйте уже обобщенную виртуальную машину для создания образов в других регионах.
az image copy --source-resource-group mySources-rg --source-object-name myVm \
--source-type vm --target-location uksouth northeurope --target-resource-group "images-repo-rg"
Обязательные параметры
Имя ресурса образа или виртуальной машины.
Имя группы ресурсов исходного ресурса.
Список разделенных пробелами расположений для создания образа (например, westeurope и т. д.).
Имя группы ресурсов для создания изображений в.
Необязательные параметры
Включите этот параметр для удаления временных ресурсов после завершения.
Включите этот параметр для экспорта копий в виде моментальных снимков вместо изображений.
Число параллельных операций копирования.
Образ или виртуальная машина.
Теги, разделенные пробелами: key[=value] [key[=value] ...]. Используйте "" для очистки существующих тегов.
Имя окончательного образа, которое будет создано.
Имя или идентификатор подписки, в которой должен быть создан окончательный образ.
Имя группы ресурсов, в которой будет создана временная учетная запись хранения.
Время в секундах для завершения операции копирования. Увеличьте это время, если вы собираетесь скопировать большие образы (диски), например 512 ГБ или более.
Глобальные параметры
Увеличьте детализацию ведения журнала, чтобы отобразить все журналы отладки.
Отображение этого сообщения справки и выхода.
Отображаются только ошибки, подавляющие предупреждения.
Формат вывода.
Строка запроса JMESPath. Дополнительные сведения и примеры см. в http://jmespath.org/.
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Увеличьте детализацию ведения журнала. Используйте --debug для полных журналов отладки.
az image create
Создайте пользовательский образ виртуальной машины на управляемых дисках или моментальных снимках.
az image create --name
--resource-group
--source
[--data-disk-caching {None, ReadOnly, ReadWrite}]
[--data-disk-sources]
[--edge-zone]
[--hyper-v-generation {V1, V2}]
[--location]
[--os-disk-caching {None, ReadOnly, ReadWrite}]
[--os-type {Linux, Windows}]
[--storage-sku {PremiumV2_LRS, Premium_LRS, Premium_ZRS, StandardSSD_LRS, StandardSSD_ZRS, Standard_LRS, UltraSSD_LRS}]
[--tags]
[--zone-resilient {false, true}]
Примеры
Создайте образ с существующего диска.
az image create -g MyResourceGroup -n image1 --os-type Linux \
--source /subscriptions/db5eb68e-73e2-4fa8-b18a-0123456789999/resourceGroups/rg1/providers/Microsoft.Compute/snapshots/s1
Создайте образ, захватив существующую обобщенную виртуальную машину в той же группе ресурсов.
az image create -g MyResourceGroup -n image1 --source MyVm1
Обязательные параметры
Новое имя изображения.
Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>
.
Источник диска ОС из того же региона, включая идентификатор виртуальной машины или имя, URI большого двоичного объекта ОПЕРАЦИОННОй системы, идентификатор управляемого диска ОПЕРАЦИОННОй системы или имя, а также идентификатор моментального снимка ос или имя.
Необязательные параметры
Тип кэширования хранилища для диска данных образа.
Разделенный пробелами список источников диска данных, включая URI неуправляемого большого двоичного объекта, идентификатор управляемого диска или имя, или идентификатор моментального снимка или имя.
Имя пограничной зоны.
Создание гипервизора виртуальной машины, созданной на основе образа.
Местоположение. Значения из: az account list-locations
. Расположение по умолчанию можно настроить с помощью az configure --defaults location=<location>
.
Тип кэширования хранилища для диска ОС образа.
Номер SKU учетной записи хранения, с помощью которой создается образ виртуальной машины. Не используется, если указана исходная виртуальная машина.
Теги, разделенные пробелами: key[=value] [key[=value] ...]. Используйте "" для очистки существующих тегов.
Указывает, является ли изображение устойчивым к зонам. Значение по умолчанию — false. Устойчивые к зонам образы можно создавать только в регионах, которые предоставляют хранилище, избыточное между зонами.
Глобальные параметры
Увеличьте детализацию ведения журнала, чтобы отобразить все журналы отладки.
Отображение этого сообщения справки и выхода.
Отображаются только ошибки, подавляющие предупреждения.
Формат вывода.
Строка запроса JMESPath. Дополнительные сведения и примеры см. в http://jmespath.org/.
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Увеличьте детализацию ведения журнала. Используйте --debug для полных журналов отладки.
az image delete
Удаление изображения.
az image delete [--ids]
[--image-name]
[--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
[--resource-group]
[--subscription]
Необязательные параметры
Один или несколько идентификаторов ресурсов (разделенных пробелами). Это должен быть полный идентификатор ресурса, содержащий все сведения о аргументах Resource Id. Необходимо указать аргументы --ids или другие аргументы Resource Id.
Имя изображения.
Не дождитесь завершения длительной операции.
Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>
.
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Глобальные параметры
Увеличьте детализацию ведения журнала, чтобы отобразить все журналы отладки.
Отображение этого сообщения справки и выхода.
Отображаются только ошибки, подавляющие предупреждения.
Формат вывода.
Строка запроса JMESPath. Дополнительные сведения и примеры см. в http://jmespath.org/.
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Увеличьте детализацию ведения журнала. Используйте --debug для полных журналов отладки.
az image list
Список изображений в группе ресурсов.
az image list [--max-items]
[--next-token]
[--resource-group]
Необязательные параметры
Общее количество элементов, возвращаемых в выходных данных команды. Если общее количество доступных элементов превышает указанное значение, маркер предоставляется в выходных данных команды. Чтобы возобновить разбиение на страницы, укажите значение маркера в --next-token
аргументе последующей команды.
Маркер, чтобы указать, где начать разбиение на страницы. Это значение маркера из ранее усеченного ответа.
Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>
.
Глобальные параметры
Увеличьте детализацию ведения журнала, чтобы отобразить все журналы отладки.
Отображение этого сообщения справки и выхода.
Отображаются только ошибки, подавляющие предупреждения.
Формат вывода.
Строка запроса JMESPath. Дополнительные сведения и примеры см. в http://jmespath.org/.
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Увеличьте детализацию ведения журнала. Используйте --debug для полных журналов отладки.
az image show
Получение изображения.
az image show [--expand]
[--ids]
[--image-name]
[--resource-group]
[--subscription]
Необязательные параметры
Выражение расширения, применяемое к операции.
Один или несколько идентификаторов ресурсов (разделенных пробелами). Это должен быть полный идентификатор ресурса, содержащий все сведения о аргументах Resource Id. Необходимо указать аргументы --ids или другие аргументы Resource Id.
Имя изображения.
Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>
.
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Глобальные параметры
Увеличьте детализацию ведения журнала, чтобы отобразить все журналы отладки.
Отображение этого сообщения справки и выхода.
Отображаются только ошибки, подавляющие предупреждения.
Формат вывода.
Строка запроса JMESPath. Дополнительные сведения и примеры см. в http://jmespath.org/.
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Увеличьте детализацию ведения журнала. Используйте --debug для полных журналов отладки.
az image update
Обновление пользовательских образов виртуальных машин.
az image update [--add]
[--force-string {0, 1, f, false, n, no, t, true, y, yes}]
[--ids]
[--image-name]
[--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
[--remove]
[--resource-group]
[--set]
[--subscription]
[--tags]
Примеры
Добавление или обновление тегов.
az image update -n ImageName -g ResourceGroup --tags tag1=val1 tag2=val2
Удалите все теги.
az image update -n ImageName -g resourceGroup --tags
Необязательные параметры
Добавьте объект в список объектов, указав пары пути и значения ключа. Пример: --add property.listProperty <key=value, string or JSON string>
.
При использовании "set" или "add" сохраняйте строковые литералы вместо попытки преобразовать в JSON.
Один или несколько идентификаторов ресурсов (разделенных пробелами). Это должен быть полный идентификатор ресурса, содержащий все сведения о аргументах Resource Id. Необходимо указать аргументы --ids или другие аргументы Resource Id.
Имя изображения.
Не дождитесь завершения длительной операции.
Удалите свойство или элемент из списка. Пример: --remove property.list <indexToRemove>
ИЛИ --remove propertyToRemove
.
Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>
.
Обновите объект, указав путь к свойству и значение для задания. Пример: --set property1.property2=<value>
.
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Теги ресурсов поддерживают сокращенный синтаксис, json-file и yaml-file. Попробуйте "??", чтобы показать больше.
Глобальные параметры
Увеличьте детализацию ведения журнала, чтобы отобразить все журналы отладки.
Отображение этого сообщения справки и выхода.
Отображаются только ошибки, подавляющие предупреждения.
Формат вывода.
Строка запроса JMESPath. Дополнительные сведения и примеры см. в http://jmespath.org/.
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Увеличьте детализацию ведения журнала. Используйте --debug для полных журналов отладки.
az image wait
Поместите интерфейс командной строки в состояние ожидания, пока не будет выполнено условие.
az image wait [--created]
[--custom]
[--deleted]
[--exists]
[--expand]
[--ids]
[--image-name]
[--interval]
[--resource-group]
[--subscription]
[--timeout]
[--updated]
Необязательные параметры
Подождите, пока не будет создано с помощью provisioningState по адресу "Успешно".
Подождите, пока условие не будет удовлетворено пользовательским запросом JMESPath. Например, provisioningState!='InProgress', instanceView.statuses[?code='PowerState/running'].
Дождитесь удаления.
Подождите, пока ресурс не существует.
Выражение расширения, применяемое к операции.
Один или несколько идентификаторов ресурсов (разделенных пробелами). Это должен быть полный идентификатор ресурса, содержащий все сведения о аргументах Resource Id. Необходимо указать аргументы --ids или другие аргументы Resource Id.
Имя изображения.
Интервал опроса в секундах.
Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>
.
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Максимальное ожидание в секундах.
Подождите, пока не будет обновлено с помощью provisioningState по адресу "Успешно".
Глобальные параметры
Увеличьте детализацию ведения журнала, чтобы отобразить все журналы отладки.
Отображение этого сообщения справки и выхода.
Отображаются только ошибки, подавляющие предупреждения.
Формат вывода.
Строка запроса JMESPath. Дополнительные сведения и примеры см. в http://jmespath.org/.
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Увеличьте детализацию ведения журнала. Используйте --debug для полных журналов отладки.