az image builder

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.	Temel	GA
az image builder create	Görüntü oluşturucu şablonu oluşturun.	Temel	GA
az image builder customizer	Görüntü oluşturucu şablon özelleştiricilerini yönetme.	Temel	GA
az image builder customizer add	Görüntü oluşturucu şablonuna görüntü oluşturucu özelleştiricisi ekleyin.	Temel	GA
az image builder customizer clear	Görüntü oluşturucu şablonundan tüm görüntü oluşturucu özelleştiricilerini kaldırın.	Temel	GA
az image builder customizer remove	Görüntü oluşturucu şablonundan görüntü oluşturucu özelleştiricisini kaldırma.	Temel	GA
az image builder delete	Görüntü oluşturucu şablonunu silin.	Temel	GA
az image builder error-handler	Görüntü oluşturucu şablonu hata işleyicisini yönetme.	Temel	GA
az image builder error-handler add	Mevcut görüntü oluşturucu şablonuna hata işleyicisi ekleyin.	Temel	GA
az image builder error-handler remove	Mevcut görüntü oluşturucu şablonundan hata işleyicisini kaldırma.	Temel	GA
az image builder error-handler show	Mevcut görüntü oluşturucu şablonunun hata işleyicisini gösterme.	Temel	GA
az image builder identity	Görüntü oluşturucu şablonunun kimliklerini yönetme.	Temel	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.	Temel	GA
az image builder identity remove	Mevcut görüntü oluşturucu şablonundan yönetilen kimlikleri kaldırma.	Temel	GA
az image builder identity show	Görüntü oluşturucu şablonunun yönetilen kimliklerini görüntüleme.	Temel	GA
az image builder list	Görüntü oluşturucu şablonlarını listeleyin.	Temel	GA
az image builder optimizer	Görüntü oluşturucu şablonu iyileştiriciyi yönetme.	Temel	GA
az image builder optimizer add	Mevcut görüntü oluşturucu şablonuna iyileştirici ekleyin.	Temel	GA
az image builder optimizer remove	Mevcut görüntü oluşturucu şablonundan iyileştiriciyi kaldırın.	Temel	GA
az image builder optimizer show	Mevcut görüntü oluşturucu şablonunun iyileştiricisini gösterir.	Temel	GA
az image builder optimizer update	Mevcut görüntü oluşturucu şablonundan bir iyileştiriciyi güncelleştirin.	Temel	GA
az image builder output	Görüntü oluşturucu şablonu çıkış dağıtımcılarını yönetme.	Temel	GA
az image builder output add	Görüntü oluşturucu şablonuna görüntü oluşturucu çıkış dağıtımcısı ekleyin.	Temel	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.	Temel	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.	Temel	GA
az image builder output versioning	Görüntü oluşturucu şablonu çıkış sürüm oluşturucusunu yönetme.	Temel	GA
az image builder output versioning remove	Belirtilen çıkışlardaki tüm sürüm oluşturma seçeneklerini kaldırın.	Temel	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.	Temel	GA
az image builder output versioning show	Belirtilen çıkışlarda sürüm oluşturma seçeneklerini göster.	Temel	GA
az image builder run	Görüntü oluşturucu şablonu oluşturun.	Temel	GA
az image builder show	Görüntü oluşturucu şablonunu gösterme.	Temel	GA
az image builder show-runs	Görüntü oluşturucu şablonunun çalıştırma çıkışlarını gösterin.	Temel	GA
az image builder trigger	Görüntü oluşturucu şablonu tetikleyiciyi yönetme.	Temel	GA
az image builder trigger create	Belirtilen sanal makine görüntüsü şablonu için bir tetikleyici oluşturun.	Temel	GA
az image builder trigger delete	Belirtilen sanal makine görüntü şablonu için tetikleyiciyi silin.	Temel	GA
az image builder trigger list	Belirtilen Görüntü Şablonu kaynağı için tüm tetikleyicileri listeleyin.	Temel	GA
az image builder trigger show	Belirtilen görüntü şablonu kaynağı için belirtilen tetikleyiciyi alın.	Temel	GA
az image builder trigger wait	Bir koşul karşılanıncaya kadar CLI'yi bekleme durumuna yerleştirin.	Temel	GA
az image builder update	Görüntü oluşturucu şablonunu güncelleştirme.	Temel	GA
az image builder validator	Görüntü oluşturucu şablonunu doğrulamayı yönetme.	Temel	GA
az image builder validator add	Mevcut görüntü oluşturucu şablonuna doğrulama ekleyin.	Temel	GA
az image builder validator remove	Mevcut görüntü oluşturucu şablonundan doğrulamayı kaldırın.	Temel	GA
az image builder validator show	Mevcut görüntü oluşturucu şablonunun doğrulamasını gösterme.	Temel	GA
az image builder wait	Şablonun bir koşulu karşılanıncaya kadar CLI'yi bekleme durumuna yerleştirin.	Temel	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ı. kullanarak varsayılan grubu az configure --defaults group=<name>yapılandırabilirsiniz.

--subscription

Aboneliğin adı veya kimliği. kullanarak az account set -s NAME_OR_IDvarsayı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

varsayılan değer: json

--query

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

--subscription

Aboneliğin adı veya kimliği. kullanarak az account set -s NAME_OR_IDvarsayı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ı. kullanarak varsayılan grubu az configure --defaults group=<name>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 komutları kullanın az cache .

--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://docs.microsoft.com/azure/virtual-machines/linux/image-builder-json.

--location -l

Konum. Değerleri: az account list-locations. kullanarak az configure --defaults location=<location>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.

varsayılan değer: 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. Betiğin türünü dosya uzantısından ('.sh' veya'.ps1') veya kaynak türünden çıkartır. 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

varsayılan değer: json

--query

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

--subscription

Aboneliğin adı veya kimliği. kullanarak az account set -s NAME_OR_IDvarsayı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ı. kullanarak varsayılan grubu az configure --defaults group=<name>yapılandırabilirsiniz.

--subscription

Aboneliğin adı veya kimliği. kullanarak az account set -s NAME_OR_IDvarsayı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

varsayılan değer: json

--query

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

--subscription

Aboneliğin adı veya kimliği. kullanarak az account set -s NAME_OR_IDvarsayı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ı. kullanarak varsayılan grubu az configure --defaults group=<name>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

varsayılan değer: json

--query

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

--subscription

Aboneliğin adı veya kimliği. kullanarak az account set -s NAME_OR_IDvarsayı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.

varsayılan değer: False

--resource-group -g

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

--subscription

Aboneliğin adı veya kimliği. kullanarak az account set -s NAME_OR_IDvarsayı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

varsayılan değer: json

--query

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

--subscription

Aboneliğin adı veya kimliği. kullanarak az account set -s NAME_OR_IDvarsayı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ı. kullanarak varsayılan grubu az configure --defaults group=<name>yapılandırabilirsiniz.

--subscription

Aboneliğin adı veya kimliği. kullanarak az account set -s NAME_OR_IDvarsayı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

varsayılan değer: json

--query

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

--subscription

Aboneliğin adı veya kimliği. kullanarak az account set -s NAME_OR_IDvarsayı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ı. kullanarak varsayılan grubu az configure --defaults group=<name>yapılandırabilirsiniz.

--subscription

Aboneliğin adı veya kimliği. kullanarak az account set -s NAME_OR_IDvarsayı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

varsayılan değer: json

--query

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

--subscription

Aboneliğin adı veya kimliği. kullanarak az account set -s NAME_OR_IDvarsayı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>.

varsayılan değer: []

--defer

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

--force-string

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

varsayılan değer: 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> OR --remove propertyToRemove.

varsayılan değer: []

--resource-group -g

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

--set

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

varsayılan değer: []

--subscription

Aboneliğin adı veya kimliği. kullanarak az account set -s NAME_OR_IDvarsayı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

varsayılan değer: json

--query

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

--subscription

Aboneliğin adı veya kimliği. kullanarak az account set -s NAME_OR_IDvarsayı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.

varsayılan değer: 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.

varsayılan değer: False

--exists

Kaynak var olana kadar bekleyin.

varsayılan değer: 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ığı.

varsayılan değer: 30

--name -n

Görüntü şablonunun adı.

--resource-group -g

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

--subscription

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

--timeout

Saniye cinsinden en fazla bekleme.

varsayılan değer: 3600

--updated

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

varsayılan değer: 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

varsayılan değer: json

--query

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

--subscription

Aboneliğin adı veya kimliği. kullanarak az account set -s NAME_OR_IDvarsayı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.