az image builder customizer

  • Başvuru

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

Komutlar

Name Description Tür Durum
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 customizer add

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

--defer ile kullanılmalıdır.

az image builder customizer add --customizer-name
                                --type {file, powershell, shell, windows-restart, windows-update}
                                [--defer]
                                [--dest-path]
                                [--exit-codes]
                                [--file-source]
                                [--filters]
                                [--ids]
                                [--inline-script]
                                [--name]
                                [--resource-group]
                                [--restart-check-command]
                                [--restart-command]
                                [--restart-timeout]
                                [--script-url]
                                [--search-criteria]
                                [--subscription]
                                [--update-limit]

Örnekler

Cli nesne önbelleğindeki bir görüntü şablonuna satır içi kabuk özelleştiricisi ekleme

az image builder customizer add -n myTemplate -g myGroup \
    --inline-script "sudo mkdir /buildArtifacts" \
                    "sudo cp /tmp/index.html /buildArtifacts/index.html" \
    --customizer-name shellScriptInline --type shell --defer

Cli nesne önbelleğindeki bir görüntü şablonuna dosya özelleştirici ekleme

az image builder customizer add -n myTemplate -g myGroup \
    --customizer-name myFile --type file \
    --file-source "https://my-remote-file.html" --dest-path "/tmp/index.html" --defer

Cli nesne önbelleğindeki bir görüntü şablonuna Windows yeniden başlatma özelleştiricisi ekleme

az image builder customizer add -n myTemplate -g myGroup \
--customizer-name shellScriptUrl \
--restart-check-command "echo Azure-Image-Builder-Restarted-the-VM  > \
                        c:\buildArtifacts\restart.txt" \
    --type windows-restart --restart-timeout 10m --defer

Cli nesne önbelleğindeki bir görüntü şablonuna Windows Update özelleştiricisi ekleyin.

az image builder customizer add -n myTemplate -g myGroup --customizer-name winUpdate --type windows-update --search-criteria IsInstalled=0 --filters "exclude:\$_.Title -like \'*Preview*\'" "include:\$true" --update-limit 20 --defer

Gerekli Parametreler

--customizer-name

Özelleştiricinin adı.

--type -t

Görüntü şablonuna eklenecek özelleştiricinin türü.

kabul edilen değerler: file, powershell, shell, windows-restart, windows-update

İsteğe Bağlı Parametreler

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

--dest-path

--file-source içinde belirtilen dosyanın görüntüde indirileceği mutlak hedef yol.

--exit-codes -e

Geçerli çıkış kodlarının boşlukla ayrılmış listesi, tamsayılar olarak.

--file-source

Görüntüye indirilecek dosyanın URI'sini. Github bağlantısı, Azure Depolama için SAS URI'si vb. olabilir.

--filters

Uygulanacak güncelleştirmeleri seçmek için boşlukla ayrılmış filtreler. Varsayılanı kullanmak için boş diziyi atla veya belirt (filtre yok).

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

--inline-script

Görüntüyü özelleştirmek için satır içi betik satırlarının boşlukla ayrılmış listesi.

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

--restart-check-command

Yeniden başlatmanın başarılı olduğunu doğrulamak için komutu.

--restart-command

Yeniden başlatma işlemini yürütmek için komut.

--restart-timeout

Yeniden başlatma zaman aşımı bir büyüklüğe ve birime sahip bir dize olarak belirtilir; örneğin, '5m' (5 dakika) veya '2h' (2 saat).

varsayılan değer: 5m
--script-url

Görüntüyü özelleştirmek için betiğin URL'si. URL'ye genel erişim sağlanmalı.

--search-criteria

Güncelleştirmeleri aramak için ölçütler. Varsayılanı kullanmak için boş dizeyi atla veya belirt (tümünü ara). Bu alanın örnekleri ve ayrıntılı açıklaması için yukarıdaki bağlantıya bakın.

--subscription

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

--update-limit

Bir kerede uygulanacak en fazla güncelleştirme sayısı. Varsayılan değeri (1000) kullanmak için 0 değerini atlar veya belirtin.

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

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

--defer ile kullanılmalıdır.

az image builder customizer clear [--defer]
                                  [--ids]
                                  [--name]
                                  [--resource-group]
                                  [--subscription]

İsteğe Bağlı Parametreler

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

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

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

--defer ile kullanılmalıdır.

az image builder customizer remove --customizer-name
                                   [--defer]
                                   [--ids]
                                   [--name]
                                   [--resource-group]
                                   [--subscription]

Gerekli Parametreler

--customizer-name

Özelleştiricinin adı.

İsteğe Bağlı Parametreler

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

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