Aracılığıyla paylaş

az image builder

  • Başvuru

Görüntü oluşturucu şablonlarını yönetme ve oluşturma.

Komutlar

Name Description Tür Durum
az image builder cancel

Görüntü şablonunu temel alarak uzun süre çalışan görüntü derlemesini iptal edin.

 Göbek GA
az image builder create

Görüntü oluşturucu şablonu oluşturun.

 Göbek GA
az image builder customizer

Görüntü oluşturucu şablon özelleştiricilerini yönetme.

 Göbek GA
az image builder customizer add

Görüntü oluşturucu şablonuna görüntü oluşturucu özelleştiricisi ekleyin.

 Göbek GA
az image builder customizer clear

Görüntü oluşturucu şablonundan tüm görüntü oluşturucu özelleştiricilerini kaldırın.

 Göbek GA
az image builder customizer remove

Görüntü oluşturucu şablonundan görüntü oluşturucu özelleştiricisini kaldırma.

 Göbek GA
az image builder delete

Görüntü oluşturucu şablonunu silin.

 Göbek GA
az image builder error-handler

Görüntü oluşturucu şablonu hata işleyicisini yönetme.

 Göbek GA
az image builder error-handler add

Mevcut görüntü oluşturucu şablonuna hata işleyicisi ekleyin.

 Göbek GA
az image builder error-handler remove

Mevcut görüntü oluşturucu şablonundan hata işleyicisini kaldırma.

 Göbek GA
az image builder error-handler show

Mevcut görüntü oluşturucu şablonunun hata işleyicisini gösterme.

 Göbek GA
az image builder identity

Görüntü oluşturucu şablonunun kimliklerini yönetme.

 Göbek GA
az image builder identity assign

Mevcut görüntü oluşturucu şablonuna yönetilen kimlikler ekleyin. Şu anda yalnızca bir kullanıcı kimliği desteklenmektedir.

 Göbek GA
az image builder identity remove

Mevcut görüntü oluşturucu şablonundan yönetilen kimlikleri kaldırma.

 Göbek GA
az image builder identity show

Görüntü oluşturucu şablonunun yönetilen kimliklerini görüntüleme.

 Göbek GA
az image builder list

Görüntü oluşturucu şablonlarını listeleyin.

 Göbek GA
az image builder optimizer

Görüntü oluşturucu şablonu iyileştiriciyi yönetme.

 Göbek GA
az image builder optimizer add

Mevcut görüntü oluşturucu şablonuna iyileştirici ekleyin.

 Göbek GA
az image builder optimizer remove

Mevcut görüntü oluşturucu şablonundan iyileştiriciyi kaldırın.

 Göbek GA
az image builder optimizer show

Mevcut görüntü oluşturucu şablonunun iyileştiricisini gösterir.

 Göbek GA
az image builder optimizer update

Mevcut görüntü oluşturucu şablonundan bir iyileştiriciyi güncelleştirin.

 Göbek GA
az image builder output

Görüntü oluşturucu şablonu çıkış dağıtımcılarını yönetme.

 Göbek GA
az image builder output add

Görüntü oluşturucu şablonuna görüntü oluşturucu çıkış dağıtımcısı ekleyin.

 Göbek GA
az image builder output clear

Görüntü oluşturucu şablonundan tüm görüntü oluşturucu çıkış dağıtımcılarını kaldırın.

 Göbek GA
az image builder output remove

Görüntü oluşturucusu çıktı dağıtımcısını görüntü oluşturucu şablonundan kaldırma.

 Göbek GA
az image builder output versioning

Görüntü oluşturucu şablonu çıkış sürüm oluşturucusunu yönetme.

 Göbek GA
az image builder output versioning remove

Belirtilen çıkışlardaki tüm sürüm oluşturma seçeneklerini kaldırın.

 Göbek GA
az image builder output versioning set

Görüntü oluşturucu şablonunun görüntü oluşturucu çıkış sürüm oluşturucusunu ayarlayın.

 Göbek GA
az image builder output versioning show

Belirtilen çıkışlarda sürüm oluşturma seçeneklerini göster.

 Göbek GA
az image builder run

Görüntü oluşturucu şablonu oluşturun.

 Göbek GA
az image builder show

Görüntü oluşturucu şablonunu gösterme.

 Göbek GA
az image builder show-runs

Görüntü oluşturucu şablonunun çalıştırma çıkışlarını gösterin.

 Göbek GA
az image builder trigger

Görüntü oluşturucu şablonu tetikleyiciyi yönetme.

 Göbek GA
az image builder trigger create

Belirtilen sanal makine görüntüsü şablonu için bir tetikleyici oluşturun.

 Göbek GA
az image builder trigger delete

Belirtilen sanal makine görüntü şablonu için tetikleyiciyi silin.

 Göbek GA
az image builder trigger list

Belirtilen Görüntü Şablonu kaynağı için tüm tetikleyicileri listeleyin.

 Göbek GA
az image builder trigger show

Belirtilen görüntü şablonu kaynağı için belirtilen tetikleyiciyi alın.

 Göbek GA
az image builder trigger wait

Bir koşul karşılanıncaya kadar CLI'yi bekleme durumuna yerleştirin.

 Göbek GA
az image builder update

Görüntü oluşturucu şablonunu güncelleştirme.

 Göbek GA
az image builder validator

Görüntü oluşturucu şablonunu doğrulamayı yönetme.

 Göbek GA
az image builder validator add

Mevcut görüntü oluşturucu şablonuna doğrulama ekleyin.

 Göbek GA
az image builder validator remove

Mevcut görüntü oluşturucu şablonundan doğrulamayı kaldırın.

 Göbek GA
az image builder validator show

Mevcut görüntü oluşturucu şablonunun doğrulamasını gösterme.

 Göbek GA
az image builder wait

Şablonun bir koşulu karşılanıncaya kadar CLI'yi bekleme durumuna yerleştirin.

 Göbek GA

az image builder cancel

Görüntü şablonunu temel alarak uzun süre çalışan görüntü derlemesini iptal edin.

az image builder cancel [--ids]
                        [--name]
                        [--resource-group]
                        [--subscription]

Örnekler

Görüntü derlemeyi iptal etme.

az image builder cancel -n mytemplate -g my-group

İsteğe Bağlı Parametreler

--ids

Bir veya daha fazla kaynak kimlikleri (boşlukla ayrılmış). 'Kaynak Kimliği' bağımsız değişkenlerinin tüm bilgilerini içeren eksiksiz bir kaynak kimliği olmalıdır. --ids veya diğer 'Kaynak Kimliği' bağımsız değişkenlerini sağlamanız gerekir.

--name -n

Görüntü şablonunun adı.

--resource-group -g

Kaynak grubunun adı. az configure --defaults group=<name>kullanarak varsayılan grubu yapılandırabilirsiniz.

--subscription

Aboneliğin adı veya kimliği. az account set -s NAME_OR_IDkullanarak varsayılan aboneliği yapılandırabilirsiniz.

Global Parametreler
--debug

Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.

--help -h

Bu yardım iletisini göster ve çık.

--only-show-errors

Yalnızca hataları gösterir ve uyarıları gizler.

--output -o

Çıkış biçimi.

Kabul edilen değerler: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz. http://jmespath.org/.

--subscription

Aboneliğin adı veya kimliği. az account set -s NAME_OR_IDkullanarak varsayılan aboneliği yapılandırabilirsiniz.

--verbose

Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.

az image builder create

Görüntü oluşturucu şablonu oluşturun.

az image builder create --name
                        --resource-group
                        [--build-timeout]
                        [--build-vm-identities]
                        [--checksum]
                        [--defer]
                        [--identity]
                        [--image-source]
                        [--image-template]
                        [--location]
                        [--managed-image-destinations]
                        [--no-wait]
                        [--os-disk-size]
                        [--proxy-vm-size]
                        [--scripts]
                        [--shared-image-destinations]
                        [--staging-resource-group]
                        [--subnet]
                        [--tags]
                        [--validator]
                        [--vm-size]
                        [--vnet]

Örnekler

Ubuntu2204 görüntüsünden görüntü oluşturucu şablonu oluşturun. Yönetilen görüntü ve paylaşılan görüntü galerisi görüntü sürümü olarak dağıt. Hazırlama kaynak grubu kimliğini, görüntüyü oluşturmak için kullanılacak görüntü şablonu olarak belirtin.

scripts="https://my-script-url.net/customize_script.sh"
imagesource="Canonical:0001-com-ubuntu-server-jammy:22_04-lts-gen2:latest"

az image builder create --image-source $imagesource -n myTemplate -g myGroup \
    --scripts $scripts --managed-image-destinations image_1=westus \
    --shared-image-destinations my_shared_gallery/linux_image_def=westus,brazilsouth \
    --identity myIdentity --staging-resource-group myStagingResourceGroup

Görüntü şablonu dosyası kullanarak görüntü oluşturucu şablonu oluşturun.

az image builder create -g my-group -n myTemplate --image-template filename

[Gelişmiş] --defer aracılığıyla CLI'nın nesne önbelleğini kullanarak birden çok özelleştirici ve dağıtımcı ile bir görüntü şablonu oluşturun. Özelleştirici ve çıkış adları, powershell çıkış kodları, satır içi betikler, windows yeniden başlatma, dosya özelleştiriciler, yapıt etiketleri ve vhd çıkış dağıtımcıları gibi özellikleri destekler.

script="https://my-script-url.com/customize_script.ps1"
imagesource="MicrosoftWindowsServer:WindowsServer:2019-Datacenter:2019.0.20190214"

# create and update template object in local cli cache. Defers put request to ARM
# Cache object ttl set via az configure.
az image builder create --image-source $imagesource -n myTemplate \
    -g myGroup --scripts $script --identity myIdentity --defer

# add customizers
az image builder customizer add -n myTemplate -g myGroup  \
    --customizer-name myPwshScript --exit-codes 0 1 --inline-script \
    "mkdir c:\buildActions" "echo Azure-Image-Builder-Was-Here \
     > c:\buildActions\Output.txt" --type powershell --defer

az image builder customizer add -n myTemplate -g myGroup \
    --customizer-name myFileCustomizer --type file \
    --file-source "https://my-file-source.net/file.txt"  \
    --dest-path "c:\buildArtifacts\file.txt" --defer

# add distributors
az image builder output add -n myTemplate -g myGroup --is-vhd \
    --output-name myWinImageVhd --artifact-tags "is_vhd=True" --defer

az image builder output add -n myTemplate -g myGroup \
    --output-name myWinImageManaged --managed-image winImage \
    --managed-image-location eastus \
    --artifact-tags "is_vhd=False" --defer

# Stop deferring put request to ARM. Create the template from the object cache.
# Cache object will be deleted.
az image builder update -n myTemplate -g myGroup

Gerekli Parametreler

--name -n

Görüntü şablonunun adı.

--resource-group -g

Kaynak grubunun adı. az configure --defaults group=<name>kullanarak varsayılan grubu yapılandırabilirsiniz.

İsteğe Bağlı Parametreler

--build-timeout

Görüntü şablonunu oluştururken beklenme süresi üst sınırı (dakika cinsinden). Varsayılan değer 60'tır.

--build-vm-identities

Derleme sanal makinesini dağıtmak için kullanılacak sanal ağın isteğe bağlı yapılandırması. Belirli bir sanal ağın kullanılması gerekmiyorsa atla.

--checksum

Red Hat ISO görüntüsünün SHA256 sağlama toplamı.

--defer

Nesneyi Azure'a göndermek yerine geçici olarak yerel önbellekte depolayın. görüntülemek/temizlemek için az cache komutlarını kullanın.

--identity

Görüntü şablonunun kullanıcı tarafından atanan kimliklerin (ad veya kimlik, boşlukla ayrılmış) listesi.

--image-source -i

Özelleştirebileceğiniz temel görüntü. Geçerli bir platform görüntüsü URN'si, platform görüntüsü diğer adı, Red Hat ISO görüntü URI'si, yönetilen görüntü adı/kimliği veya paylaşılan görüntü sürümü kimliği olmalıdır.

Şuradan alınan değerler:: az vm image list, az vm image show
--image-template

Görüntü şablonu dosyasının yerel yolu veya URL'si. --image-template kullanılırken, -g ve -n dışındaki tüm parametreler yoksayılır. Başvuru: https://learn.microsoft.com/azure/virtual-machines/linux/image-builder-json.

--location -l

Yer. değerleri: az account list-locations. az configure --defaults location=<location>kullanarak varsayılan konumu yapılandırabilirsiniz.

--managed-image-destinations

Yönetilen görüntü çıktı dağıtımcısı bilgileri. Anahtar-değer çiftlerinin boşlukla ayrılmış listesi. Örneğin"image_1=westus2 image_2=westus". Her anahtar, oluşturulacak yönetilen görüntünün adı veya kaynak kimliğidir. Her değer görüntünün konumudur.

--no-wait

Uzun süre çalışan işlemin bitmesini beklemeyin.

Default value: False
--os-disk-size

İşletim sistemi diskinin GB cinsinden boyutu. Azure'ın varsayılan işletim sistemi disk boyutunu kullanmak için 0 değerini atlar veya belirtin.

--proxy-vm-size

Görüntüleri oluşturmak, özelleştirmek ve yakalamak için kullanılan sanal makinenin boyutu (1. Nesil görüntüleri için Standard_D1_v2 ve 2. Nesil görüntüleri için Standard_D2ds_v4).

--scripts

Görüntüyü özelleştirmek için boşlukla ayrılmış kabuk veya powershell betikleri listesi. Her betik genel olarak erişilebilen bir URL olmalıdır. Dosya uzantısından ('.sh' veya '.ps1' veya kaynak türünden betik türünü çıkarsar. Daha fazla özelleştirici seçeneği ve esnekliği için bkz. 'az image template customizer add'.

--shared-image-destinations

Paylaşılan görüntü galerisi (sig) çıkış dağıtımcısı bilgileri. Anahtar-değer çiftlerinin boşlukla ayrılmış listesi. Örneğin"my_gallery_1/image_def_1=eastus,westus my_gallery_2/image_def_2=uksouth,canadaeast,francesouth." Her anahtar, "/" ile sınırlandırılmış sig görüntü tanımı kimliği veya sig galeri adı ve sig görüntü tanımıdır. Her değer, çoğaltma konumlarının virgülle ayrılmış bir listesidir.

--staging-resource-group

Görüntüyü oluşturmak için kullanılacak görüntü şablonuyla aynı abonelikteki hazırlama kaynak grubu kimliği.

--subnet

Derleme sanal makinesinin dağıtılacağı alt ağın adı veya kimliği.

--tags

Boşlukla ayrılmış etiketler: key[=value] [key[=value] ...]. Mevcut etiketleri temizlemek için "" kullanın.

--validator

Görüntüde kullanmak istediğiniz doğrulama türü. Örneğin, "Kabuk" kabuk doğrulaması olabilir.

--vm-size

Görüntüleri oluşturmak, özelleştirmek ve yakalamak için kullanılan sanal makinenin boyutu. Varsayılanı kullanmak için boş dizeyi atla veya belirt (Standard_D1_v2).

--vnet

Derleme sanal makinesinin dağıtılacağı sanal ağın adı. Bunu yalnızca alt ağ bir ad olduğunda belirtmeniz gerekir.

Global Parametreler
--debug

Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.

--help -h

Bu yardım iletisini göster ve çık.

--only-show-errors

Yalnızca hataları gösterir ve uyarıları gizler.

--output -o

Çıkış biçimi.

Kabul edilen değerler: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz. http://jmespath.org/.

--subscription

Aboneliğin adı veya kimliği. az account set -s NAME_OR_IDkullanarak varsayılan aboneliği yapılandırabilirsiniz.

--verbose

Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.

az image builder delete

Görüntü oluşturucu şablonunu silin.

az image builder delete [--ids]
                        [--name]
                        [--resource-group]
                        [--subscription]

Örnekler

Görüntü oluşturucu şablonunu silin. (otomatik olarak oluşturulmuş)

az image builder delete --name MyImageTemplate --resource-group MyResourceGroup

İsteğe Bağlı Parametreler

--ids

Bir veya daha fazla kaynak kimlikleri (boşlukla ayrılmış). 'Kaynak Kimliği' bağımsız değişkenlerinin tüm bilgilerini içeren eksiksiz bir kaynak kimliği olmalıdır. --ids veya diğer 'Kaynak Kimliği' bağımsız değişkenlerini sağlamanız gerekir.

--name -n

Görüntü şablonunun adı.

--resource-group -g

Kaynak grubunun adı. az configure --defaults group=<name>kullanarak varsayılan grubu yapılandırabilirsiniz.

--subscription

Aboneliğin adı veya kimliği. az account set -s NAME_OR_IDkullanarak varsayılan aboneliği yapılandırabilirsiniz.

Global Parametreler
--debug

Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.

--help -h

Bu yardım iletisini göster ve çık.

--only-show-errors

Yalnızca hataları gösterir ve uyarıları gizler.

--output -o

Çıkış biçimi.

Kabul edilen değerler: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz. http://jmespath.org/.

--subscription

Aboneliğin adı veya kimliği. az account set -s NAME_OR_IDkullanarak varsayılan aboneliği yapılandırabilirsiniz.

--verbose

Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.

az image builder list

Görüntü oluşturucu şablonlarını listeleyin.

az image builder list [--resource-group]

İsteğe Bağlı Parametreler

--resource-group -g

Kaynak grubunun adı. az configure --defaults group=<name>kullanarak varsayılan grubu yapılandırabilirsiniz.

Global Parametreler
--debug

Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.

--help -h

Bu yardım iletisini göster ve çık.

--only-show-errors

Yalnızca hataları gösterir ve uyarıları gizler.

--output -o

Çıkış biçimi.

Kabul edilen değerler: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz. http://jmespath.org/.

--subscription

Aboneliğin adı veya kimliği. az account set -s NAME_OR_IDkullanarak varsayılan aboneliği yapılandırabilirsiniz.

--verbose

Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.

az image builder run

Görüntü oluşturucu şablonu oluşturun.

az image builder run [--ids]
                     [--name]
                     [--no-wait]
                     [--resource-group]
                     [--subscription]

Örnekler

Bir şablon derleme çalıştırması başlatın ve tamamlanmasını bekleyin.

az image builder run -n mytemplate -g my-group --no-wait

az image builder wait -n mytemplate -g aibmdi \
    --custom "lastRunStatus.runState!='Running'"

az image builder show -n mytemplate -g my-group

İsteğe Bağlı Parametreler

--ids

Bir veya daha fazla kaynak kimlikleri (boşlukla ayrılmış). 'Kaynak Kimliği' bağımsız değişkenlerinin tüm bilgilerini içeren eksiksiz bir kaynak kimliği olmalıdır. --ids veya diğer 'Kaynak Kimliği' bağımsız değişkenlerini sağlamanız gerekir.

--name -n

Görüntü şablonunun adı.

--no-wait

Uzun süre çalışan işlemin bitmesini beklemeyin.

Default value: False
--resource-group -g

Kaynak grubunun adı. az configure --defaults group=<name>kullanarak varsayılan grubu yapılandırabilirsiniz.

--subscription

Aboneliğin adı veya kimliği. az account set -s NAME_OR_IDkullanarak varsayılan aboneliği yapılandırabilirsiniz.

Global Parametreler
--debug

Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.

--help -h

Bu yardım iletisini göster ve çık.

--only-show-errors

Yalnızca hataları gösterir ve uyarıları gizler.

--output -o

Çıkış biçimi.

Kabul edilen değerler: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz. http://jmespath.org/.

--subscription

Aboneliğin adı veya kimliği. az account set -s NAME_OR_IDkullanarak varsayılan aboneliği yapılandırabilirsiniz.

--verbose

Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.

az image builder show

Görüntü oluşturucu şablonunu gösterme.

az image builder show [--ids]
                      [--name]
                      [--resource-group]
                      [--subscription]

Örnekler

Görüntü oluşturucu şablonunu gösterme (otomatik olarak oluşturulmuş)

az image builder show --name mytemplate  --resource-group my-group

İsteğe Bağlı Parametreler

--ids

Bir veya daha fazla kaynak kimlikleri (boşlukla ayrılmış). 'Kaynak Kimliği' bağımsız değişkenlerinin tüm bilgilerini içeren eksiksiz bir kaynak kimliği olmalıdır. --ids veya diğer 'Kaynak Kimliği' bağımsız değişkenlerini sağlamanız gerekir.

--name -n

Görüntü şablonunun adı.

--resource-group -g

Kaynak grubunun adı. az configure --defaults group=<name>kullanarak varsayılan grubu yapılandırabilirsiniz.

--subscription

Aboneliğin adı veya kimliği. az account set -s NAME_OR_IDkullanarak varsayılan aboneliği yapılandırabilirsiniz.

Global Parametreler
--debug

Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.

--help -h

Bu yardım iletisini göster ve çık.

--only-show-errors

Yalnızca hataları gösterir ve uyarıları gizler.

--output -o

Çıkış biçimi.

Kabul edilen değerler: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz. http://jmespath.org/.

--subscription

Aboneliğin adı veya kimliği. az account set -s NAME_OR_IDkullanarak varsayılan aboneliği yapılandırabilirsiniz.

--verbose

Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.

az image builder show-runs

Görüntü oluşturucu şablonunun çalıştırma çıkışlarını gösterin.

az image builder show-runs [--ids]
                           [--name]
                           [--output-name]
                           [--resource-group]
                           [--subscription]

Örnekler

Bir şablon derleme çalıştırması çalıştırın ve çalıştırma çıkışlarını görüntüleyin.

az image builder run -n mytemplate -g my-group --no-wait

az image builder wait -n mytemplate -g aibmdi \
    --custom "lastRunStatus.runState!='Running'"

az image builder show-runs -n mytemplate -g my-group

İsteğe Bağlı Parametreler

--ids

Bir veya daha fazla kaynak kimlikleri (boşlukla ayrılmış). 'Kaynak Kimliği' bağımsız değişkenlerinin tüm bilgilerini içeren eksiksiz bir kaynak kimliği olmalıdır. --ids veya diğer 'Kaynak Kimliği' bağımsız değişkenlerini sağlamanız gerekir.

--name -n

Görüntü şablonunun adı.

--output-name

Görüntü oluşturucu çalıştırma çıkışının adı.

--resource-group -g

Kaynak grubunun adı. az configure --defaults group=<name>kullanarak varsayılan grubu yapılandırabilirsiniz.

--subscription

Aboneliğin adı veya kimliği. az account set -s NAME_OR_IDkullanarak varsayılan aboneliği yapılandırabilirsiniz.

Global Parametreler
--debug

Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.

--help -h

Bu yardım iletisini göster ve çık.

--only-show-errors

Yalnızca hataları gösterir ve uyarıları gizler.

--output -o

Çıkış biçimi.

Kabul edilen değerler: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz. http://jmespath.org/.

--subscription

Aboneliğin adı veya kimliği. az account set -s NAME_OR_IDkullanarak varsayılan aboneliği yapılandırabilirsiniz.

--verbose

Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.

az image builder update

Görüntü oluşturucu şablonunu güncelleştirme.

Görüntü oluşturucu şablonlarının güncelleştirilmesi şu anda desteklenmiyor. Bu komut, CLI önbelleğindeki bir görüntü şablonu nesnesini güncelleştirmek için --defer ile birlikte kullanılabilir. --defer olmadan, belirtilen görüntü şablonunu önbellekten alır ve görüntü şablonunu oluşturmak için Azure'a bir istek gönderir.

az image builder update [--add]
                        [--defer]
                        [--force-string]
                        [--ids]
                        [--name]
                        [--remove]
                        [--resource-group]
                        [--set]
                        [--subscription]

Örnekler

Cli önbelleğindeki bir şablon nesnesinden şablon kaynağı oluşturun. Daha fazla bilgi için bkz. "az image builder create / output add /customizer add --help" ve "az cache -h"

# create and write template object to local cli cache
az image builder create --image-source {image_source} -n mytemplate -g my-group \
    --scripts {script} --managed-image-destinations image_1=westus --identity myidentity --defer

# add customizers and outputs to local cache template object via az image template output / customizer add
# one can also update cache object properties through generic update options, such as: --set
az image builder output add -n mytemplate -g my-group --output-name my-win-image-managed \
    --artifact-tags "is_vhd=False"  --managed-image winImage --managed-image-location eastus --defer

# send template create request to azure to create template resource
az image builder update -n mytemplate -g my-group

İsteğe Bağlı Parametreler

--add

Bir yol ve anahtar değer çiftleri belirterek nesne listesine nesne ekleyin. Örnek: --add property.listProperty <key=value, string or JSON string>.

Default value: []
--defer

Nesneyi Azure'a göndermek yerine geçici olarak yerel önbellekte depolayın. görüntülemek/temizlemek için az cache komutlarını kullanın.

--force-string

'set' veya 'add' kullanırken, JSON'a dönüştürmeye çalışmak yerine dize değişmez değerlerini koruyun.

Default value: False
--ids

Bir veya daha fazla kaynak kimlikleri (boşlukla ayrılmış). 'Kaynak Kimliği' bağımsız değişkenlerinin tüm bilgilerini içeren eksiksiz bir kaynak kimliği olmalıdır. --ids veya diğer 'Kaynak Kimliği' bağımsız değişkenlerini sağlamanız gerekir.

--name -n

Görüntü şablonunun adı.

--remove

Bir özelliği veya öğeyi listeden kaldırın. Örnek: --remove property.list <indexToRemove> VEYA --remove propertyToRemove.

Default value: []
--resource-group -g

Kaynak grubunun adı. az configure --defaults group=<name>kullanarak varsayılan grubu yapılandırabilirsiniz.

--set

Ayarlanacağı özellik yolunu ve değerini belirterek nesneyi güncelleştirin. Örnek: --set property1.property2=<value>.

Default value: []
--subscription

Aboneliğin adı veya kimliği. az account set -s NAME_OR_IDkullanarak varsayılan aboneliği yapılandırabilirsiniz.

Global Parametreler
--debug

Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.

--help -h

Bu yardım iletisini göster ve çık.

--only-show-errors

Yalnızca hataları gösterir ve uyarıları gizler.

--output -o

Çıkış biçimi.

Kabul edilen değerler: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz. http://jmespath.org/.

--subscription

Aboneliğin adı veya kimliği. az account set -s NAME_OR_IDkullanarak varsayılan aboneliği yapılandırabilirsiniz.

--verbose

Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.

az image builder wait

Şablonun bir koşulu karşılanıncaya kadar CLI'yi bekleme durumuna yerleştirin.

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

Örnekler

Bir şablon derleme çalıştırması başlatın ve tamamlanmasını bekleyin.

az image builder run -n mytemplate -g my-group --no-wait

az image builder wait -n mytemplate -g aibmdi \
    --custom "lastRunStatus.runState!='Running'"

az image builder show -n mytemplate -g my-group

İsteğe Bağlı Parametreler

--created

'ProvisioningState' ile 'Succeeded' konumunda oluşturulana kadar bekleyin.

Default value: False
--custom

Koşul özel bir JMESPath sorgusunu karşılayana kadar bekleyin. Örneğin provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Silinene kadar bekleyin.

Default value: False
--exists

Kaynak var olana kadar bekleyin.

Default value: False
--ids

Bir veya daha fazla kaynak kimlikleri (boşlukla ayrılmış). 'Kaynak Kimliği' bağımsız değişkenlerinin tüm bilgilerini içeren eksiksiz bir kaynak kimliği olmalıdır. --ids veya diğer 'Kaynak Kimliği' bağımsız değişkenlerini sağlamanız gerekir.

--interval

Saniye cinsinden yoklama aralığı.

Default value: 30
--name -n

Görüntü şablonunun adı.

--resource-group -g

Kaynak grubunun adı. az configure --defaults group=<name>kullanarak varsayılan grubu yapılandırabilirsiniz.

--subscription

Aboneliğin adı veya kimliği. az account set -s NAME_OR_IDkullanarak varsayılan aboneliği yapılandırabilirsiniz.

--timeout

Saniye cinsinden en fazla bekleme.

Default value: 3600
--updated

'Başarılı' konumunda provisioningState ile güncelleştirilene kadar bekleyin.

Default value: False
Global Parametreler
--debug

Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.

--help -h

Bu yardım iletisini göster ve çık.

--only-show-errors

Yalnızca hataları gösterir ve uyarıları gizler.

--output -o

Çıkış biçimi.

Kabul edilen değerler: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz. http://jmespath.org/.

--subscription

Aboneliğin adı veya kimliği. az account set -s NAME_OR_IDkullanarak varsayılan aboneliği yapılandırabilirsiniz.

--verbose

Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.