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

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

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

Эта операция может занять много времени в зависимости от номера региона репликации. Рекомендуется использовать "--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 будет иметь одну реплику, хранящуюся в хранилище 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

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

--managed-image

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

--no-wait

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

Default value: False
--os-snapshot

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

--os-vhd-storage-account

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

--os-vhd-uri

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

--replica-count

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

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

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

--target-edge-zones

Разделенный пробелами список регионов, пограничных зон, счетчиков реплик и типов хранилища. Используйте <region>=<edge zone>[=<replica count>][=<storage account type>], чтобы при необходимости задать количество реплик и (или) тип учетной записи хранения для каждого региона. Если число реплик не указано, будет использоваться число реплик по умолчанию. Если тип учетной записи хранения не указан, будет использоваться тип учетной записи хранения по умолчанию. Если указан параметр --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
Default value: 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
Default value: 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
Default value: 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

Местоположение. Значения из: 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
Default value: 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

Местоположение. Значения из: 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
Default value: 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

Местоположение. Значения из: 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
Default value: 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 [--expand {ReplicationStatus, UefiSettings}]
                          [--gallery-image-definition]
                          [--gallery-image-version]
                          [--gallery-name]
                          [--ids]
                          [--resource-group]
                          [--subscription]

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

--expand

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

Допустимые значения: ReplicationStatus, UefiSettings
--gallery-image-definition -i

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

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

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

--gallery-name -r

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

--ids

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

--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
Default value: 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

Местоположение. Значения из: 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
Default value: 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

Местоположение. Значения из: 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
Default value: 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-разрядного целого числа. Формат: <MajorVersion>.<MinorVersion>.<Patch>.

--gallery-unique-name

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

--ids

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

--location -l

Местоположение. Значения из: 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
Default value: 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

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

--no-wait

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

Default value: False
--tags

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

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

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

--help -h

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

--only-show-errors

Отображаются только ошибки, подавляющие предупреждения.

--output -o

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

Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
Default value: 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>.

Default value: []
--allow-replicated-location-deletion

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

Допустимые значения: false, true
--force-string

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

Default value: False
--no-wait

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

Default value: False
--remove

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

Default value: []
--replica-count

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

--set

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

Default value: []
--target-edge-zones

Разделенный пробелами список регионов, пограничных зон, счетчиков реплик и типов хранилища. Используйте <region>=<edge zone>[=<replica count>][=<storage account type>], чтобы при необходимости задать количество реплик и (или) тип учетной записи хранения для каждого региона. Если число реплик не указано, будет использоваться число реплик по умолчанию. Если тип учетной записи хранения не указан, будет использоваться тип учетной записи хранения по умолчанию. Если указан параметр --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
Default value: 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 [--created]
                          [--custom]
                          [--deleted]
                          [--exists]
                          [--expand {ReplicationStatus, UefiSettings}]
                          [--gallery-image-definition]
                          [--gallery-image-version]
                          [--gallery-name]
                          [--ids]
                          [--interval]
                          [--resource-group]
                          [--subscription]
                          [--timeout]
                          [--updated]

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

--created

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

Default value: False
--custom

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

--deleted

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

Default value: False
--exists

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

Default value: False
--expand

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

Допустимые значения: ReplicationStatus, UefiSettings
--gallery-image-definition -i

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

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

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

--gallery-name -r

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

--ids

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

--interval

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

Default value: 30
--resource-group -g

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

--subscription

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

--timeout

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

Default value: 3600
--updated

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

Default value: False
Глобальные параметры
--debug

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

--help -h

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

--only-show-errors

Отображаются только ошибки, подавляющие предупреждения.

--output -o

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

Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

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

--verbose

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