az sig image-version

Примечание.

Эта группа команд содержит команды, определенные как в Azure CLI, так и в одном расширении. Установите каждое расширение, чтобы воспользоваться расширенными возможностями. Подробнее о расширениях.

Управление версией образа общей коллекции с помощью виртуальной машины.

Команды

Имя	Описание	Тип	Состояние
az sig image-version create	Создание новой версии образа.	Основные сведения	Общедоступная версия
az sig image-version delete	Удалите версию образа коллекции.	Основные сведения	Общедоступная версия
az sig image-version list	Вывод списка версий образов коллекции в определении образа коллекции.	Основные сведения	Общедоступная версия
az sig image-version list-community	Вывод списка версий образов виртуальной машины в сообществе коллекции.	Основные сведения	Общедоступная версия
az sig image-version list-community (image-gallery Расширение)	Вывод списка версий образов виртуальных машин в сообществе коллекции (предварительная версия).	Расширение	Экспериментальный
az sig image-version list-shared	Вывод списка версий образов виртуальных машин в коллекции, к которым предоставлен доступ непосредственно вашей подписке или клиенту.	Основные сведения	Общедоступная версия
az sig image-version show	Извлекает сведения о версии образа коллекции.	Основные сведения	Общедоступная версия
az sig image-version show-community	Получите версию образа коллекции сообщества.	Основные сведения	Общедоступная версия
az sig image-version show-community (image-gallery Расширение)	Получение версии образа в сообществе коллекции (предварительная версия).	Расширение	Экспериментальный
az sig image-version show-shared	Получите версию образа в коллекции, доступную непосредственно вашей подписке или клиенту.	Основные сведения	Общедоступная версия
az sig image-version undelete	Восстановление обратимой удаленной версии образа.	Основные сведения	Предварительный просмотр
az sig image-version update	Обновление версии образа общего ресурса.	Основные сведения	Общедоступная версия
az sig image-version wait	Дождитесь операции, связанной с версией образа.	Основные сведения	Общедоступная версия

az sig image-version create

Создание новой версии образа.

Эта операция может занять много времени в зависимости от номера региона реплика te. Рекомендуется использовать "--no-wait".

az sig image-version create --gallery-image-definition
                            --gallery-image-version
                            --gallery-name
                            --resource-group
                            [--allow-replicated-location-deletion {false, true}]
                            [--data-snapshot-luns]
                            [--data-snapshots]
                            [--data-vhds-luns]
                            [--data-vhds-sa]
                            [--data-vhds-uris]
                            [--end-of-life-date]
                            [--exclude-from-latest {false, true}]
                            [--image-version]
                            [--location]
                            [--managed-image]
                            [--no-wait]
                            [--os-snapshot]
                            [--os-vhd-storage-account]
                            [--os-vhd-uri]
                            [--replica-count]
                            [--replication-mode {Full, Shallow}]
                            [--storage-account-type {Premium_LRS, Standard_LRS, Standard_ZRS}]
                            [--tags]
                            [--target-edge-zone-encryption]
                            [--target-edge-zones]
                            [--target-region-cvm-encryption]
                            [--target-region-encryption]
                            [--target-regions]
                            [--virtual-machine]

Примеры

Добавление новой версии образа из виртуальной машины

az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--virtual-machine /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/virtualMachines/MyVM

Добавление новой версии образа из управляемого образа

az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--managed-image /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/images/MyManagedImage

Добавление новой версии образа из другой версии образа

az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--image-version /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/galleries/MyGallery/images/MyImageDefinition/versions/1.0.0

Добавление новой версии образа с управляемого диска

az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--os-snapshot /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/disks/MyOSDisk

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

az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--os-snapshot /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/disks/MyOSDisk \
--data-snapshots /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/disks/MyDataDisk \
--data-snapshot-luns 0

Добавьте новую версию образа из моментального снимка диска ОС.

az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--os-snapshot /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/snapshots/MyOsDiskSnapshot

Добавление новой версии образа из моментального снимка диска ОС и добавление дополнительных моментальных снимков в качестве дисков данных

az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--os-snapshot /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/snapshots/MyOsDiskSnapshot \
--data-snapshots /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/snapshots/MyDiskSnapshot \
--data-snapshot-luns 0

Добавьте новую версию образа из VHD диска ОС.

az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--os-vhd-storage-account /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Storage/storageAccounts/mystorageaccount \
--os-vhd-uri https://mystorageaccount.blob.core.windows.net/container/path_to_vhd_file

Добавление новой версии образа из VHD диска ОС и добавление дополнительных виртуальных жестких дисков в качестве дисков данных

az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--os-vhd-storage-account /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Storage/storageAccounts/mystorageaccount \
--os-vhd-uri https://mystorageaccount.blob.core.windows.net/container/path_to_vhd_file \
--data-vhds-sa /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Storage/storageAccounts/myotherstorageaccount \
--data-vhds-uris https://myotherstorageaccount.blob.core.windows.net/container/path_to_vhd_file \
--data-vhds-luns 0

Для создания новой версии образа можно объединить моментальные снимки, управляемые диски и виртуальные жесткие диски. Добавьте новую версию образа с помощью виртуального жесткого диска в качестве диска ОС и управляемого диска и моментального снимка в качестве дисков данных.

az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--os-vhd-storage-account /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Storage/storageAccounts/mystorageaccount \
--os-vhd-uri https://mystorageaccount.blob.core.windows.net/container/path_to_vhd_file \
--data-snapshots /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/disks/MyDataDisk subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/snapshots/MyDiskSnapshot \
--data-snapshot-luns 0 1

Добавьте новую версию образа и скопируйте ее в дополнительные регионы. Домашнее расположение для источника версии образа должно быть включено в список целевых регионов. Для каждого дополнительного региона можно указать другой тип реплика счетчика и учетной записи хранения. В противном случае регион наследуется от глобального. Число реплика по умолчанию равно 1, а тип учетной записи хранения по умолчанию — standard LRS. В этом примере eastus2 будет иметь один реплика, хранящийся в хранилище Standard ZRS, ukwest будет иметь 3 реплика, хранящихся в хранилище Standard ZRS, southindia будет иметь один реплика храниться в хранилище Standard LRS, а бразилия будет иметь 2 реплика, хранящихся в хранилище LRS уровня "Стандартный".

az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 --replica-count 1 \
--storage-account-type Standard_ZRS --managed-image image-name \
--target-regions eastus2 ukwest=3 southindia=standard_lrs \
brazilsouth=2=standard_lrs

Добавьте новую версию образа с шифрованием с помощью набора шифрования дисков. Шифрование применяется к каждому диску, который является частью версии образа.

az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--virtual-machine /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/virtualMachines/MyVM \
--target-regions westus=2=standard eastus \
--target-region-encryption WestUSDiskEncryptionSet1,0,WestUSDiskEncryptionSet2 \
EastUSDiskEncryptionSet1,0,EastUSDiskEncryptionSet2

Добавьте новую версию образа и скопируйте ее в расширенные расположения.

az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 --replica-count 1 \
--storage-account-type Standard_ZRS --managed-image image-name \
--target-edge-zones westus=microsoftlosangeles1 eastus=microsoftlosangeles2=1 \
brazilsouth=2=standard_lrs

Добавьте новую версию образа и скопируйте ее в расширенные расположения с шифрованием с помощью набора шифрования дисков.

az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--virtual-machine /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/virtualMachines/MyVM \
--target-edge-zones westus=microsoftlosangeles1 \
--target-edge-zone-encryption microsoftlosangeles1,WestUSDiskEncryptionSet1,0,WestUSDiskEncryptionSet2

Добавьте новую версию образа и не подождите. Позже можно вызвать команду az sig image-version wait, когда она готова к созданию виртуальной машины из версии образа коллекции.

az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--virtual-machine /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/virtualMachines/MyVM \
--no-wait

Добавление новой версии образа, но удаление ее из рассмотрения в качестве последней версии в определении образа

az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--virtual-machine /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/virtualMachines/MyVM \
--exclude-from-latest true

Добавьте новую версию образа и задайте дату окончания срока действия. Версия образа по-прежнему может использоваться для создания виртуальной машины после окончания срока действия.

az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--virtual-machine /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/virtualMachines/MyVM \
--end-of-life-date 2024-08-02T00:00:00+00:00

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

--gallery-image-definition -i

Определение изображения коллекции.

--gallery-image-version -e

Версия образа коллекции в шаблоне семантической версии. Допустимые символы — цифры и точки. Цифры должны находиться в диапазоне 32-разрядного целого числа, например <MajorVersion>.<MinorVersion>.<Patch>.

--gallery-name -r

Имя коллекции.

--resource-group -g

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

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

--allow-replicated-location-deletion

Укажите, разрешено ли удаление этой версии образа коллекции из реплика регионов.

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

--data-snapshot-luns

Логические номера единиц (разделенные пробелами) моментальных снимков диска данных.

--data-snapshots

Имена или идентификаторы (разделенные пробелами) моментальных снимков диска данных.

--data-vhds-luns

Логические номера единиц (разделенные пробелами) исходных URI VHD дисков данных.

--data-vhds-sa --data-vhds-storage-accounts

Имена или идентификаторы (разделенные пробелами) учетных записей хранения исходных URI VHD дисков данных.

--data-vhds-uris

Исходные URI VHD (разделенные пробелами) дисков данных.

--end-of-life-date

Дата окончания жизни, например "2020-12-31".

--exclude-from-latest

Флаг означает, что если задано значение true, пользователи, развертывающие виртуальные машины с опущенной версией, не будут использовать эту версию.

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

--image-version

Идентификатор ресурса источника версии образа коллекции.

--location -l

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

--managed-image

Имя изображения (если в той же группе ресурсов) или идентификатор ресурса.

--no-wait

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

значение по умолчанию: False

--os-snapshot

Имя или идентификатор моментального снимка диска ОС.

--os-vhd-storage-account

Имя или идентификатор учетной записи хранения исходного URI VHD диска ОС.

--os-vhd-uri

Исходный URI VHD диска ОС.

--replica-count

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

--replication-mode

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

допустимые значения: Full, Shallow

--storage-account-type

Тип учетной записи хранения по умолчанию для каждого региона. Чтобы задать типы учетных записей регионального хранения, используйте --target-регионы.

допустимые значения: Premium_LRS, Standard_LRS, Standard_ZRS

--tags

Теги, разделенные пробелами: key[=value] [key[=value] ...]. Используйте "" для очистки существующих тегов.

--target-edge-zone-encryption --zone-encryption

Разделенный пробелами список управляемых клиентом ключей для шифрования дисков ОС и данных в артефакте коллекции для каждого региона. Формат для каждой пограничной зоны: ,<os_des,lun1_des,lun2_des<>><>.

--target-edge-zones

Разделенный пробелами список регионов, пограничных зон, реплика счетчиков и типов хранилища. Используйте =[=][=]] для дополнительного задания типа реплика счетчика и (или) учетной записи хранения для каждого региона. Если счетчик реплика не указан, будет использоваться значение реплика по умолчанию. Если тип учетной записи хранения не указан, будет использоваться тип учетной записи хранения по умолчанию. Если указан параметр --target-edge-zones None, то целевое расширенное расположение будет снято.

--target-region-cvm-encryption

Разделенный пробелами список управляемых клиентом ключей для конфиденциальной виртуальной машины, шифрующей диск ОС в артефакте коллекции для каждого региона. Формат для каждого региона: <os_cvm_encryption_type>,<os_cvm_des> Допустимые значения для os_cvm_encryption_type: EncryptedVMGuestStateOnlyWithPmk, EncryptedWithPmk, EncryptedWithCmk.

--target-region-encryption

Разделенный пробелами список управляемых клиентом ключей для шифрования дисков ОС и данных в артефакте коллекции для каждого региона. Формат для каждого региона: <os_des>,<lun1>,<lun1_des>,<lun2>,<lun2_des> Используйте значение NULL в качестве заполнителя.

--target-regions

Разделенный пробелами список регионов и их реплика счетчиков. Используется <region>[=<replica count>][=<storage account type>] для задания типа реплика счетчика и (или) учетной записи хранения для каждого региона. Если счетчик реплика не указан, будет использоваться значение реплика по умолчанию. Если тип учетной записи хранения не указан, будет использоваться тип учетной записи хранения по умолчанию.

--virtual-machine

Идентификатор ресурса источника виртуальной машины.

Глобальные параметры

--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

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

--output -o

Формат вывода.

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc

значение по умолчанию: json

--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

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

--verbose

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

az sig image-version delete

Удалите версию образа коллекции.

az sig image-version delete [--gallery-image-definition]
                            [--gallery-image-version]
                            [--gallery-name]
                            [--ids]
                            [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                            [--resource-group]
                            [--subscription]

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

--gallery-image-definition --gallery-image-name -i

Имя определения образа коллекции, в котором находится версия образа.

--gallery-image-version --gallery-image-version-name -e

Имя версии образа коллекции для удаления.

--gallery-name -r

Имя Общая коллекция образов, в которой находится определение изображения.

--ids

Один или несколько идентификаторов ресурсов (через пробелы). Это должен быть полный идентификатор ресурса, содержащий все сведения о аргументах Resource Id. Необходимо указать аргументы --ids или другие аргументы Resource Id.

--no-wait

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

допустимые значения: 0, 1, f, false, n, no, t, true, y, yes

--resource-group -g

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

--subscription

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

Глобальные параметры

--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

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

--output -o

Формат вывода.

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc

значение по умолчанию: json

--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

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

--verbose

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

az sig image-version list

Вывод списка версий образов коллекции в определении образа коллекции.

az sig image-version list --gallery-image-definition
                          --gallery-name
                          --resource-group
                          [--max-items]
                          [--next-token]

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

--gallery-image-definition --gallery-image-name -i

Определение изображения коллекции.

--gallery-name -r

Имя коллекции.

--resource-group -g

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

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

--max-items

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

--next-token

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

Глобальные параметры

--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

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

--output -o

Формат вывода.

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc

значение по умолчанию: json

--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

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

--verbose

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

az sig image-version list-community

Вывод списка версий образов виртуальной машины в сообществе коллекции.

az sig image-version list-community [--gallery-image-definition]
                                    [--ids]
                                    [--location]
                                    [--marker]
                                    [--public-gallery-name]
                                    [--show-next-marker]
                                    [--subscription]

Примеры

Вывод списка версий изображений в сообществе коллекции.

az sig image-version list-community --public-gallery-name publicGalleryName \
--gallery-image-definition MyImage --location myLocation

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

--gallery-image-definition -i

Имя определения образа коллекции сообщества, из которого должны быть перечислены версии образа.

--ids

Один или несколько идентификаторов ресурсов (через пробелы). Это должен быть полный идентификатор ресурса, содержащий все сведения о аргументах Resource Id. Необходимо указать аргументы --ids или другие аргументы Resource Id.

--location -l

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

--marker

Строковое значение, определяющее часть списка контейнеров, возвращаемую с помощью следующей операции перечисления. Операция возвращает значение NextMarker в теле ответа, если операция перечисления не вернула все контейнеры, оставшиеся в списке с текущей страницей. Если задано, этот генератор начнет возвращать результаты с точки, где остановлен предыдущий генератор.

--public-gallery-name

Общедоступное имя коллекции сообщества.

--show-next-marker

Отображение nextMarker в результате при указании.

--subscription

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

Глобальные параметры

--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

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

--output -o

Формат вывода.

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc

значение по умолчанию: json

--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

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

--verbose

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

az sig image-version list-community (image-gallery Расширение)

Экспериментальный

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

Вывод списка версий образов виртуальных машин в сообществе коллекции (предварительная версия).

Список версий образов виртуальной машины в сообществе коллекции (функция частной предварительной версии, обратитесь к группе коллекции образов сообщества по электронной почте sigpmdev@microsoft.com , чтобы зарегистрироваться для предварительной версии, если вы хотите использовать эту функцию).

az sig image-version list-community [--gallery-image-definition]
                                    [--ids]
                                    [--location]
                                    [--marker]
                                    [--public-gallery-name]
                                    [--show-next-marker]
                                    [--subscription]

Примеры

Вывод списка версий изображений в сообществе коллекции.

az sig image-version list-community --public-gallery-name publicGalleryName \
--gallery-image-definition MyImage --location myLocation

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

--gallery-image-definition -i

Имя определения образа коллекции сообщества, из которого должны быть перечислены версии образа.

--ids

Один или несколько идентификаторов ресурсов (через пробелы). Это должен быть полный идентификатор ресурса, содержащий все сведения о аргументах Resource Id. Необходимо указать аргументы --ids или другие аргументы Resource Id.

--location -l

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

--marker

Строковое значение, определяющее часть списка контейнеров, возвращаемую с помощью следующей операции перечисления. Операция возвращает значение NextMarker в теле ответа, если операция перечисления не вернула все контейнеры, оставшиеся в списке с текущей страницей. Если задано, этот генератор начнет возвращать результаты с точки, где остановлен предыдущий генератор.

--public-gallery-name

Общедоступное имя коллекции сообщества.

--show-next-marker

Отображение nextMarker в результате при указании.

--subscription

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

Глобальные параметры

--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

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

--output -o

Формат вывода.

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc

значение по умолчанию: json

--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

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

--verbose

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

az sig image-version list-shared

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

az sig image-version list-shared [--gallery-image-definition]
                                 [--gallery-unique-name]
                                 [--ids]
                                 [--location]
                                 [--marker]
                                 [--shared-to {tenant}]
                                 [--show-next-marker]
                                 [--subscription]

Примеры

Вывод списка версий изображений в коллекции, общий доступ к подписке в заданном расположении и определении образа.

az sig image-version list-shared --gallery-unique-name galleryUniqueName \
--gallery-image-definition MyImage --location myLocation

Вывод списка версий изображений в коллекции, общий доступ к клиенту в заданном расположении и определении образа.

az sig image-version list-shared --gallery-unique-name galleryUniqueName \
--gallery-image-definition MyImage --location myLocation --shared-to tenant

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

--gallery-image-definition -i

Имя определения образа общей коллекции, из которого должны быть перечислены версии образа.

--gallery-unique-name

Уникальное имя общей коллекции.

--ids

Один или несколько идентификаторов ресурсов (через пробелы). Это должен быть полный идентификатор ресурса, содержащий все сведения о аргументах Resource Id. Необходимо указать аргументы --ids или другие аргументы Resource Id.

--location -l

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

--marker

Строковое значение, определяющее часть списка контейнеров, возвращаемую с помощью следующей операции перечисления. Операция возвращает значение NextMarker в теле ответа, если операция перечисления не вернула все контейнеры, оставшиеся в списке с текущей страницей. Если задано, этот генератор начнет возвращать результаты с точки, где остановлен предыдущий генератор.

--shared-to

Параметр запроса, чтобы решить, какие общие коллекции следует получить при выполнении операций с перечислением. Если этот параметр не указан, список по идентификатору подписки.

допустимые значения: tenant

--show-next-marker

Отображение nextMarker в результате при указании.

--subscription

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

Глобальные параметры

--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

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

--output -o

Формат вывода.

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc

значение по умолчанию: json

--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

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

--verbose

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

az sig image-version show

Извлекает сведения о версии образа коллекции.

az sig image-version show --gallery-image-definition
                          --gallery-image-version
                          --gallery-name
                          --resource-group
                          [--expand]

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

--gallery-image-definition -i

Определение изображения коллекции.

--gallery-image-version -e

Версия образа коллекции в шаблоне семантической версии. Допустимые символы — цифры и точки. Цифры должны находиться в диапазоне 32-разрядного целого числа, например <MajorVersion>.<MinorVersion>.<Patch>.

--gallery-name -r

Имя коллекции.

--resource-group -g

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

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

--expand

Выражение расширения, применяемое к операции, например ReplicationStatus.

Глобальные параметры

--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

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

--output -o

Формат вывода.

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc

значение по умолчанию: json

--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

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

--verbose

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

az sig image-version show-community

Получите версию образа коллекции сообщества.

az sig image-version show-community [--gallery-image-definition]
                                    [--gallery-image-version]
                                    [--ids]
                                    [--location]
                                    [--public-gallery-name]
                                    [--subscription]

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

--gallery-image-definition --gallery-image-name -i

Имя определения образа коллекции сообщества, из которого должны быть перечислены версии образа.

--gallery-image-version --gallery-image-version-name -e

Версия образа коллекции в шаблоне семантической версии. Допустимые символы — цифры и точки. Цифры должны находиться в диапазоне 32-разрядного целого числа, например <MajorVersion>.<MinorVersion>.<Patch>.

--ids

Один или несколько идентификаторов ресурсов (через пробелы). Это должен быть полный идентификатор ресурса, содержащий все сведения о аргументах Resource Id. Необходимо указать аргументы --ids или другие аргументы Resource Id.

--location -l

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

--public-gallery-name

Общедоступное имя коллекции сообщества.

--subscription

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

Глобальные параметры

--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

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

--output -o

Формат вывода.

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc

значение по умолчанию: json

--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

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

--verbose

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

az sig image-version show-community (image-gallery Расширение)

Экспериментальный

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

Получение версии образа в сообществе коллекции (предварительная версия).

Получите версию образа в сообществе галереи (функция частной предварительной версии, обратитесь к группе коллекции образов сообщества по электронной почте sigpmdev@microsoft.com , чтобы зарегистрироваться для предварительной версии, если вы хотите использовать эту функцию).

az sig image-version show-community [--gallery-image-definition]
                                    [--gallery-image-version]
                                    [--ids]
                                    [--location]
                                    [--public-gallery-name]
                                    [--subscription]

Примеры

Получите версию образа в сообществе коллекции в указанном расположении.

az sig image-version show-community --public-gallery-name publicGalleryName \
--gallery-image-definition MyImage --gallery-image-version 1.0.0 --location myLocation

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

--gallery-image-definition -i

Имя определения образа коллекции сообщества, из которого должны быть перечислены версии образа.

--gallery-image-version -e

Имя создаваемой версии образа коллекции. Необходимо следовать шаблону имени семантической версии: допустимые символы являются цифрами и периодами. Цифры должны находиться в диапазоне 32-разрядного целого числа. Формат:...

--ids

Один или несколько идентификаторов ресурсов (через пробелы). Это должен быть полный идентификатор ресурса, содержащий все сведения о аргументах Resource Id. Необходимо указать аргументы --ids или другие аргументы Resource Id.

--location -l

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

--public-gallery-name

Общедоступное имя коллекции сообщества.

--subscription

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

Глобальные параметры

--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

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

--output -o

Формат вывода.

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc

значение по умолчанию: json

--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

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

--verbose

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

az sig image-version show-shared

Получите версию образа в коллекции, доступную непосредственно вашей подписке или клиенту.

az sig image-version show-shared [--gallery-image-definition]
                                 [--gallery-image-version]
                                 [--gallery-unique-name]
                                 [--ids]
                                 [--location]
                                 [--subscription]

Примеры

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

az sig image-version show-shared --gallery-unique-name galleryUniqueName --gallery-image-definition MyImage --gallery-image-version 1.0.0 --location myLocation

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

--gallery-image-definition --gallery-image-name -i

Имя определения образа общей коллекции, из которого должны быть перечислены версии образа.

--gallery-image-version --gallery-image-version-name -e

Имя создаваемой версии образа коллекции. Необходимо следовать шаблону имени семантической версии: допустимые символы являются цифрами и периодами. Цифры должны находиться в диапазоне 32-разрядного целого числа. Формат:...

--gallery-unique-name

Уникальное имя общей коллекции.

--ids

Один или несколько идентификаторов ресурсов (через пробелы). Это должен быть полный идентификатор ресурса, содержащий все сведения о аргументах Resource Id. Необходимо указать аргументы --ids или другие аргументы Resource Id.

--location -l

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

--subscription

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

Глобальные параметры

--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

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

--output -o

Формат вывода.

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc

значение по умолчанию: json

--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

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

--verbose

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

az sig image-version undelete

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

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

Восстановление обратимой удаленной версии образа.

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

az sig image-version undelete --gallery-image-definition
                              --gallery-image-version
                              --gallery-name
                              --resource-group
                              [--allow-replicated-location-deletion {false, true}]
                              [--location]
                              [--no-wait]
                              [--tags]

Примеры

Восстановление обратимой удаленной версии образа

az sig image-version undelete --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.1.1

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

--gallery-image-definition -i

Определение изображения коллекции.

--gallery-image-version -e

Версия образа коллекции в шаблоне семантической версии. Допустимые символы — цифры и точки. Цифры должны находиться в диапазоне 32-разрядного целого числа, например <MajorVersion>.<MinorVersion>.<Patch>.

--gallery-name -r

Имя коллекции.

--resource-group -g

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

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

--allow-replicated-location-deletion

Укажите, разрешено ли удаление этой версии образа коллекции из реплика регионов.

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

--location -l

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

--no-wait

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

значение по умолчанию: False

--tags

Теги, разделенные пробелами: key[=value] [key[=value] ...]. Используйте "" для очистки существующих тегов.

Глобальные параметры

--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

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

--output -o

Формат вывода.

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc

значение по умолчанию: json

--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

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

--verbose

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

az sig image-version update

Обновление версии образа общего ресурса.

az sig image-version update --gallery-image-definition
                            --gallery-image-version
                            --gallery-name
                            --resource-group
                            [--add]
                            [--allow-replicated-location-deletion {false, true}]
                            [--force-string]
                            [--no-wait]
                            [--remove]
                            [--replica-count]
                            [--set]
                            [--target-edge-zones]
                            [--target-regions]

Примеры

Изменение регионов реплика и счетчика реплика

az sig image-version update --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--target-regions westcentralus=2 eastus2

Изменение расширенных расположений реплика

az sig image-version update --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--target-edge-zones westus=microsoftlosangeles1 eastus=microsoftlosangeles2=1

Очистка расширенных расположений реплика

az sig image-version update --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--target-edge-zones None

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

az sig image-version update --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--add publishingProfile.targetRegions name=westcentralus \
regionalReplicaCount=3 excludeFromLatest=true

Измените, следует ли включить изображение в учетную версию последней версии в определении образа. При задании этого значения значение true исключает изображение из рассмотрения и при задании этого значения значение false включает изображение для рассмотрения.

az sig image-version update -g MyResourceGroup --gallery-name MyGallery \
--gallery-image-definition MyImage --gallery-image-version 1.0.0 \
--set publishingProfile.excludeFromLatest=true

Измените дату окончания срока жизни для версии образа. Образ по-прежнему можно использовать для создания виртуальных машин после окончания срока жизни.

az sig image-version update -g MyResourceGroup --gallery-name MyGallery \
--gallery-image-definition MyImage --gallery-image-version 1.0.0 \
--set publishingProfile.endOfLifeDate=2024-08-02T00:00:00+00:00

Разрешить удалить версию образа коллекции из реплика регионов.

az sig image-version update -g MyResourceGroup --gallery-name MyGallery \
--gallery-image-definition MyImage --gallery-image-version 1.0.0 \
--set safetyProfile.allowDeletionOfReplicatedLocations=true

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

--gallery-image-definition -i

Определение изображения коллекции.

--gallery-image-version -e

Версия образа коллекции в шаблоне семантической версии. Допустимые символы — цифры и точки. Цифры должны находиться в диапазоне 32-разрядного целого числа, например <MajorVersion>.<MinorVersion>.<Patch>.

--gallery-name -r

Имя коллекции.

--resource-group -g

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

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

--add

Добавьте объект в список объектов, указав пары пути и значения ключа. Пример: --add property.listProperty <key=value, string or JSON string>.

значение по умолчанию: []

--allow-replicated-location-deletion

Укажите, разрешено ли удаление этой версии образа коллекции из реплика регионов.

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

--force-string

При использовании "set" или "add" сохраняйте строковые литералы вместо попытки преобразовать в JSON.

значение по умолчанию: False

--no-wait

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

значение по умолчанию: False

--remove

Удалите свойство или элемент из списка. Пример: --remove property.list <indexToRemove> OR --remove propertyToRemove.

значение по умолчанию: []

--replica-count

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

--set

Обновите объект, указав путь к свойству и значение для задания. Пример: --set property1.property2=<value>.

значение по умолчанию: []

--target-edge-zones

Разделенный пробелами список регионов, пограничных зон, реплика счетчиков и типов хранилища. Используйте =[=][=]] для дополнительного задания типа реплика счетчика и (или) учетной записи хранения для каждого региона. Если счетчик реплика не указан, будет использоваться значение реплика по умолчанию. Если тип учетной записи хранения не указан, будет использоваться тип учетной записи хранения по умолчанию. Если указан параметр --target-edge-zones None, то целевое расширенное расположение будет снято.

--target-regions

Разделенный пробелами список регионов и их реплика счетчиков. Используется <region>[=<replica count>][=<storage account type>] для задания типа реплика счетчика и (или) учетной записи хранения для каждого региона. Если счетчик реплика не указан, будет использоваться значение реплика по умолчанию. Если тип учетной записи хранения не указан, будет использоваться тип учетной записи хранения по умолчанию.

Глобальные параметры

--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

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

--output -o

Формат вывода.

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc

значение по умолчанию: json

--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

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

--verbose

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

az sig image-version wait

Дождитесь операции, связанной с версией образа.

az sig image-version wait --gallery-image-definition
                          --gallery-image-version
                          --gallery-name
                          --resource-group
                          [--created]
                          [--custom]
                          [--deleted]
                          [--exists]
                          [--expand]
                          [--interval]
                          [--timeout]
                          [--updated]

Примеры

Дождитесь обновления версии образа

az sig image-version wait --updated --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0

Дождитесь операции, связанной с версией образа. (автоматическое создание)

az sig image-version wait --created --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0

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

--gallery-image-definition -i

Определение изображения коллекции.

--gallery-image-version -e

Версия образа коллекции в шаблоне семантической версии. Допустимые символы — цифры и точки. Цифры должны находиться в диапазоне 32-разрядного целого числа, например <MajorVersion>.<MinorVersion>.<Patch>.

--gallery-name -r

Имя коллекции.

--resource-group -g

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

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

--created

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

значение по умолчанию: False

--custom

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

--deleted

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

значение по умолчанию: False

--exists

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

значение по умолчанию: False

--expand

Выражение расширения, применяемое к операции. Значение по умолчанию "ReplicationStatus" — None.

--interval

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

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

--timeout

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

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

--updated

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

значение по умолчанию: False

Глобальные параметры

--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

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

--output -o

Формат вывода.

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc

значение по умолчанию: json

--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

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

--verbose

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