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

Aşağıdaki parametreler isteğe bağlıdır, ancak bağlama bağlı olarak komutun başarıyla yürütülmesi için bir veya daha fazla parametre gerekli olabilir.

--acquire-policy-token

Bu kaynak işlemi için otomatik olarak bir Azure İlkesi belirteci alma.

Özellik	Değer
Parametre grubu:	Global Policy Arguments

--change-reference

Bu kaynak işlemi için ilgili değişiklik başvuru kimliği.

Özellik	Değer
Parametre grubu:	Global Policy Arguments

--ids

Bir veya daha fazla kaynak kimliği (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' parametrelerini vermelisiniz.

Özellik	Değer
Parametre grubu:	Resource Id Arguments

--name -n

Görüntü şablonunun adı.

Özellik	Değer
Parametre grubu:	Resource Id Arguments

--resource-group -g

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

Özellik	Değer
Parametre grubu:	Resource Id Arguments

--subscription

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

Özellik	Değer
Parametre grubu:	Resource Id Arguments

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.

Özellik	Değer
Default value:	False

--help -h

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

--only-show-errors

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

Özellik	Değer
Default value:	False

--output -o

Çıkış biçimi.

Özellik	Değer
Default value:	json
Kabul edilen değerler:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--verbose

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

Özellik	Değer
Default value:	False

az image builder create

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

az image builder create --name
                        --resource-group
                        [--acquire-policy-token]
                        [--build-timeout]
                        [--build-vm-identities]
                        [--change-reference]
                        [--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

Aşağıdaki parametreler isteğe bağlıdır, ancak bağlama bağlı olarak komutun başarıyla yürütülmesi için bir veya daha fazla parametre gerekli olabilir.

--acquire-policy-token

Bu kaynak işlemi için otomatik olarak bir Azure İlkesi belirteci alma.

Özellik	Değer
Parametre grubu:	Global Policy Arguments

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

--change-reference

Bu kaynak işlemi için ilgili değişiklik başvuru kimliği.

Özellik	Değer
Parametre grubu:	Global Policy Arguments

--checksum

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

Özellik	Değer
Parametre grubu:	Image Source Arguments

--defer

nesneyi Azure 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.

Özellik	Değer
Parametre grubu:	Image Source Arguments
Ş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

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

Özellik	Değer
Parametre grubu:	Output Arguments

--no-wait

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

Özellik	Değer
Default value:	False

--os-disk-size

İşletim sistemi diskinin GB cinsinden boyutu. Azure 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'.

Özellik	Değer
Parametre grubu:	Customizer Arguments

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

Özellik	Değer
Parametre grubu:	Output Arguments

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

Özellik	Değer
Default value:	False

--help -h

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

--only-show-errors

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

Özellik	Değer
Default value:	False

--output -o

Çıkış biçimi.

Özellik	Değer
Default value:	json
Kabul edilen değerler:	json, jsonc, none, table, tsv, yaml, yamlc

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

Özellik	Değer
Default value:	False

az image builder delete

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

az image builder delete [--acquire-policy-token]
                        [--change-reference]
                        [--ids]
                        [--name]
                        [--resource-group]
                        [--subscription]

Örnekler

Görüntü oluşturucu şablonunu silin. (autogenerated)

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

İsteğe Bağlı Parametreler

Aşağıdaki parametreler isteğe bağlıdır, ancak bağlama bağlı olarak komutun başarıyla yürütülmesi için bir veya daha fazla parametre gerekli olabilir.

--acquire-policy-token

Bu kaynak işlemi için otomatik olarak bir Azure İlkesi belirteci alma.

Özellik	Değer
Parametre grubu:	Global Policy Arguments

--change-reference

Bu kaynak işlemi için ilgili değişiklik başvuru kimliği.

Özellik	Değer
Parametre grubu:	Global Policy Arguments

--ids

Bir veya daha fazla kaynak kimliği (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' parametrelerini vermelisiniz.

Özellik	Değer
Parametre grubu:	Resource Id Arguments

--name -n

Görüntü şablonunun adı.

Özellik	Değer
Parametre grubu:	Resource Id Arguments

--resource-group -g

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

Özellik	Değer
Parametre grubu:	Resource Id Arguments

--subscription

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

Özellik	Değer
Parametre grubu:	Resource Id Arguments

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.

Özellik	Değer
Default value:	False

--help -h

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

--only-show-errors

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

Özellik	Değer
Default value:	False

--output -o

Çıkış biçimi.

Özellik	Değer
Default value:	json
Kabul edilen değerler:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--verbose

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

Özellik	Değer
Default value:	False

az image builder list

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

az image builder list [--resource-group]

İsteğe Bağlı Parametreler

Aşağıdaki parametreler isteğe bağlıdır, ancak bağlama bağlı olarak komutun başarıyla yürütülmesi için bir veya daha fazla parametre gerekli olabilir.

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

Özellik	Değer
Default value:	False

--help -h

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

--only-show-errors

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

Özellik	Değer
Default value:	False

--output -o

Çıkış biçimi.

Özellik	Değer
Default value:	json
Kabul edilen değerler:	json, jsonc, none, table, tsv, yaml, yamlc

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

Özellik	Değer
Default value:	False

az image builder run

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

az image builder run [--acquire-policy-token]
                     [--change-reference]
                     [--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

Aşağıdaki parametreler isteğe bağlıdır, ancak bağlama bağlı olarak komutun başarıyla yürütülmesi için bir veya daha fazla parametre gerekli olabilir.

--acquire-policy-token

Bu kaynak işlemi için otomatik olarak bir Azure İlkesi belirteci alma.

Özellik	Değer
Parametre grubu:	Global Policy Arguments

--change-reference

Bu kaynak işlemi için ilgili değişiklik başvuru kimliği.

Özellik	Değer
Parametre grubu:	Global Policy Arguments

--ids

Bir veya daha fazla kaynak kimliği (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' parametrelerini vermelisiniz.

Özellik	Değer
Parametre grubu:	Resource Id Arguments

--name -n

Görüntü şablonunun adı.

Özellik	Değer
Parametre grubu:	Resource Id Arguments

--no-wait

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

Özellik	Değer
Default value:	False

--resource-group -g

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

Özellik	Değer
Parametre grubu:	Resource Id Arguments

--subscription

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

Özellik	Değer
Parametre grubu:	Resource Id Arguments

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.

Özellik	Değer
Default value:	False

--help -h

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

--only-show-errors

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

Özellik	Değer
Default value:	False

--output -o

Çıkış biçimi.

Özellik	Değer
Default value:	json
Kabul edilen değerler:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--verbose

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

Özellik	Değer
Default value:	False

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

Aşağıdaki parametreler isteğe bağlıdır, ancak bağlama bağlı olarak komutun başarıyla yürütülmesi için bir veya daha fazla parametre gerekli olabilir.

--ids

Bir veya daha fazla kaynak kimliği (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' parametrelerini vermelisiniz.

Özellik	Değer
Parametre grubu:	Resource Id Arguments

--name -n

Görüntü şablonunun adı.

Özellik	Değer
Parametre grubu:	Resource Id Arguments

--resource-group -g

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

Özellik	Değer
Parametre grubu:	Resource Id Arguments

--subscription

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

Özellik	Değer
Parametre grubu:	Resource Id Arguments

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.

Özellik	Değer
Default value:	False

--help -h

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

--only-show-errors

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

Özellik	Değer
Default value:	False

--output -o

Çıkış biçimi.

Özellik	Değer
Default value:	json
Kabul edilen değerler:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--verbose

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

Özellik	Değer
Default value:	False

az image builder show-runs

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

az image builder show-runs [--acquire-policy-token]
                           [--change-reference]
                           [--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

Aşağıdaki parametreler isteğe bağlıdır, ancak bağlama bağlı olarak komutun başarıyla yürütülmesi için bir veya daha fazla parametre gerekli olabilir.

--acquire-policy-token

Bu kaynak işlemi için otomatik olarak bir Azure İlkesi belirteci alma.

Özellik	Değer
Parametre grubu:	Global Policy Arguments

--change-reference

Bu kaynak işlemi için ilgili değişiklik başvuru kimliği.

Özellik	Değer
Parametre grubu:	Global Policy Arguments

--ids

Bir veya daha fazla kaynak kimliği (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' parametrelerini vermelisiniz.

Özellik	Değer
Parametre grubu:	Resource Id Arguments

--name -n

Görüntü şablonunun adı.

Özellik	Değer
Parametre grubu:	Resource Id Arguments

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

Özellik	Değer
Parametre grubu:	Resource Id Arguments

--subscription

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

Özellik	Değer
Parametre grubu:	Resource Id Arguments

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.

Özellik	Değer
Default value:	False

--help -h

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

--only-show-errors

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

Özellik	Değer
Default value:	False

--output -o

Çıkış biçimi.

Özellik	Değer
Default value:	json
Kabul edilen değerler:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--verbose

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

Özellik	Değer
Default value:	False

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 komutu olmadan belirtilen görüntü şablonunu önbellekten alır ve görüntü şablonunu oluşturmak için Azure bir istek gönderir.

az image builder update [--acquire-policy-token]
                        [--add]
                        [--change-reference]
                        [--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

Aşağıdaki parametreler isteğe bağlıdır, ancak bağlama bağlı olarak komutun başarıyla yürütülmesi için bir veya daha fazla parametre gerekli olabilir.

--acquire-policy-token

Bu kaynak işlemi için otomatik olarak bir Azure İlkesi belirteci alma.

Özellik	Değer
Parametre grubu:	Global Policy Arguments

--add

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

Özellik	Değer
Parametre grubu:	Generic Update Arguments
Default value:	[]

--change-reference

Bu kaynak işlemi için ilgili değişiklik başvuru kimliği.

Özellik	Değer
Parametre grubu:	Global Policy Arguments

--defer

nesneyi Azure 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.

Özellik	Değer
Parametre grubu:	Generic Update Arguments
Default value:	False

--ids

Bir veya daha fazla kaynak kimliği (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' parametrelerini vermelisiniz.

Özellik	Değer
Parametre grubu:	Resource Id Arguments

--name -n

Görüntü şablonunun adı.

Özellik	Değer
Parametre grubu:	Resource Id Arguments

--remove

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

Özellik	Değer
Parametre grubu:	Generic Update Arguments
Default value:	[]

--resource-group -g

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

Özellik	Değer
Parametre grubu:	Resource Id Arguments

--set

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

Özellik	Değer
Parametre grubu:	Generic Update Arguments
Default value:	[]

--subscription

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

Özellik	Değer
Parametre grubu:	Resource Id Arguments

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.

Özellik	Değer
Default value:	False

--help -h

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

--only-show-errors

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

Özellik	Değer
Default value:	False

--output -o

Çıkış biçimi.

Özellik	Değer
Default value:	json
Kabul edilen değerler:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--verbose

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

Özellik	Değer
Default value:	False

az image builder wait

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

az image builder wait [--acquire-policy-token]
                      [--change-reference]
                      [--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

Aşağıdaki parametreler isteğe bağlıdır, ancak bağlama bağlı olarak komutun başarıyla yürütülmesi için bir veya daha fazla parametre gerekli olabilir.

--acquire-policy-token

Bu kaynak işlemi için otomatik olarak bir Azure İlkesi belirteci alma.

Özellik	Değer
Parametre grubu:	Global Policy Arguments

--change-reference

Bu kaynak işlemi için ilgili değişiklik başvuru kimliği.

Özellik	Değer
Parametre grubu:	Global Policy Arguments

--created

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

Özellik	Değer
Parametre grubu:	Wait Condition Arguments
Default value:	False

--custom

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

Özellik	Değer
Parametre grubu:	Wait Condition Arguments

--deleted

Silinene kadar bekleyin.

Özellik	Değer
Parametre grubu:	Wait Condition Arguments
Default value:	False

--exists

Kaynak var olana kadar bekleyin.

Özellik	Değer
Parametre grubu:	Wait Condition Arguments
Default value:	False

--ids

Bir veya daha fazla kaynak kimliği (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' parametrelerini vermelisiniz.

Özellik	Değer
Parametre grubu:	Resource Id Arguments

--interval

Saniye cinsinden yoklama aralığı.

Özellik	Değer
Parametre grubu:	Wait Condition Arguments
Default value:	30

--name -n

Görüntü şablonunun adı.

Özellik	Değer
Parametre grubu:	Resource Id Arguments

--resource-group -g

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

Özellik	Değer
Parametre grubu:	Resource Id Arguments

--subscription

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

Özellik	Değer
Parametre grubu:	Resource Id Arguments

--timeout

Saniye cinsinden en fazla bekleme.

Özellik	Değer
Parametre grubu:	Wait Condition Arguments
Default value:	3600

--updated

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

Özellik	Değer
Parametre grubu:	Wait Condition Arguments
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.

Özellik	Değer
Default value:	False

--help -h

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

--only-show-errors

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

Özellik	Değer
Default value:	False

--output -o

Çıkış biçimi.

Özellik	Değer
Default value:	json
Kabul edilen değerler:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--verbose

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

Özellik	Değer
Default value:	False