az image builder

Polecenia

Nazwa	Opis	Typ	Stan
az image builder cancel	Anuluj długotrwałą kompilację obrazu na podstawie szablonu obrazu.	Core	ogólna dostępność
az image builder create	Utwórz szablon konstruktora obrazów.	Core	ogólna dostępność
az image builder customizer	Zarządzanie konfiguratorami szablonów konstruktora obrazów.	Core	ogólna dostępność
az image builder customizer add	Dodaj konfigurator konstruktora obrazów do szablonu konstruktora obrazów.	Core	ogólna dostępność
az image builder customizer clear	Usuń wszystkie konfiguratory konstruktora obrazów z szablonu konstruktora obrazów.	Core	ogólna dostępność
az image builder customizer remove	Usuń konfigurator konstruktora obrazów z szablonu konstruktora obrazów.	Core	ogólna dostępność
az image builder delete	Usuń szablon konstruktora obrazów.	Core	ogólna dostępność
az image builder error-handler	Zarządzanie procedurą obsługi błędów szablonu konstruktora obrazów.	Core	ogólna dostępność
az image builder error-handler add	Dodaj procedurę obsługi błędów do istniejącego szablonu konstruktora obrazów.	Core	ogólna dostępność
az image builder error-handler remove	Usuń procedurę obsługi błędów z istniejącego szablonu konstruktora obrazów.	Core	ogólna dostępność
az image builder error-handler show	Pokaż procedurę obsługi błędów istniejącego szablonu konstruktora obrazów.	Core	ogólna dostępność
az image builder identity	Zarządzanie tożsamościami szablonu konstruktora obrazów.	Core	ogólna dostępność
az image builder identity assign	Dodaj tożsamości zarządzane do istniejącego szablonu konstruktora obrazów. Obecnie obsługiwana jest tylko jedna tożsamość użytkownika.	Core	ogólna dostępność
az image builder identity remove	Usuń tożsamości zarządzane z istniejącego szablonu konstruktora obrazów.	Core	ogólna dostępność
az image builder identity show	Wyświetlanie tożsamości zarządzanych szablonu konstruktora obrazów.	Core	ogólna dostępność
az image builder list	Wyświetlanie listy szablonów konstruktora obrazów.	Core	ogólna dostępność
az image builder optimizer	Zarządzaj optymalizatorem szablonów konstruktora obrazów.	Core	ogólna dostępność
az image builder optimizer add	Dodaj optymalizator do istniejącego szablonu konstruktora obrazów.	Core	ogólna dostępność
az image builder optimizer remove	Usuń optymalizator z istniejącego szablonu konstruktora obrazów.	Core	ogólna dostępność
az image builder optimizer show	Pokaż optymalizator istniejącego szablonu konstruktora obrazów.	Core	ogólna dostępność
az image builder optimizer update	Zaktualizuj optymalizator na podstawie istniejącego szablonu konstruktora obrazów.	Core	ogólna dostępność
az image builder output	Zarządzanie dystrybutorami wyjściowymi szablonu konstruktora obrazów.	Core	ogólna dostępność
az image builder output add	Dodaj dystrybutor danych wyjściowych konstruktora obrazów do szablonu konstruktora obrazów.	Core	ogólna dostępność
az image builder output clear	Usuń wszystkich dystrybutorów wyjściowych konstruktora obrazów z szablonu konstruktora obrazów.	Core	ogólna dostępność
az image builder output remove	Usuń dystrybutor danych wyjściowych konstruktora obrazów z szablonu konstruktora obrazów.	Core	ogólna dostępność
az image builder output versioning	Zarządzanie wersjonerem wyjściowym szablonu konstruktora obrazów.	Core	ogólna dostępność
az image builder output versioning remove	Usuń wszystkie opcje przechowywania wersji w określonych danych wyjściowych.	Core	ogólna dostępność
az image builder output versioning set	Ustaw program wersji wyjściowej konstruktora obrazów szablonu konstruktora obrazów.	Core	ogólna dostępność
az image builder output versioning show	Pokaż opcje przechowywania wersji dla określonych danych wyjściowych.	Core	ogólna dostępność
az image builder run	Tworzenie szablonu konstruktora obrazów.	Core	ogólna dostępność
az image builder show	Pokaż szablon konstruktora obrazów.	Core	ogólna dostępność
az image builder show-runs	Pokaż dane wyjściowe uruchamiania szablonu konstruktora obrazów.	Core	ogólna dostępność
az image builder trigger	Zarządzanie wyzwalaczem szablonu konstruktora obrazów.	Core	ogólna dostępność
az image builder trigger create	Utwórz wyzwalacz dla określonego szablonu obrazu maszyny wirtualnej.	Core	ogólna dostępność
az image builder trigger delete	Usuń wyzwalacz dla określonego szablonu obrazu maszyny wirtualnej.	Core	ogólna dostępność
az image builder trigger list	Wyświetl listę wszystkich wyzwalaczy dla określonego zasobu szablonu obrazu.	Core	ogólna dostępność
az image builder trigger show	Pobierz określony wyzwalacz dla określonego zasobu szablonu obrazu.	Core	ogólna dostępność
az image builder trigger wait	Umieść interfejs wiersza polecenia w stanie oczekiwania do momentu spełnienia warunku.	Core	ogólna dostępność
az image builder update	Aktualizowanie szablonu konstruktora obrazów.	Core	ogólna dostępność
az image builder validator	Zarządzanie weryfikacją szablonu konstruktora obrazów.	Core	ogólna dostępność
az image builder validator add	Dodaj walidację do istniejącego szablonu konstruktora obrazów.	Core	ogólna dostępność
az image builder validator remove	Usuń walidację z istniejącego szablonu konstruktora obrazów.	Core	ogólna dostępność
az image builder validator show	Pokaż weryfikację istniejącego szablonu konstruktora obrazów.	Core	ogólna dostępność
az image builder wait	Umieść interfejs wiersza polecenia w stanie oczekiwania do momentu spełnienia warunku szablonu.	Core	ogólna dostępność

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

Przykłady

Anuluj kompilację obrazu.

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

Parametry opcjonalne

Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.

Parametry globalne

--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Właściwość	Wartość
Domyślna wartość:	False

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Właściwość	Wartość
Domyślna wartość:	False

--output -o

Format danych wyjściowych.

Właściwość	Wartość
Domyślna wartość:	json
Dopuszczalne wartości:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Właściwość	Wartość
Domyślna wartość:	False

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]

Przykłady

Utwórz szablon konstruktora obrazów na podstawie obrazu z systemem Ubuntu2204. Rozpowszechnij go jako obraz zarządzany i wersję obrazu galerii obrazów udostępnionych. Określ identyfikator przejściowej grupy zasobów jako szablon obrazu, który będzie używany do kompilowania obrazu.

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

Utwórz szablon konstruktora obrazów przy użyciu pliku szablonu obrazu.

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

[Zaawansowane] Utwórz szablon obrazu z wieloma konfiguratorami i dystrybutorami przy użyciu pamięci podręcznej obiektów interfejsu wiersza polecenia za pośrednictwem --defer. Obsługuje funkcje, takie jak: konfigurator i nazwy wyjściowe, kody zakończenia programu PowerShell, skrypty wbudowane, ponowne uruchomienie systemu Windows, konfiguratory plików, tagi artefaktów i dystrybutory danych wyjściowych wirtualnego dysku twardego.

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

Parametry wymagane

Parametry opcjonalne

Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.

Parametry globalne

--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Właściwość	Wartość
Domyślna wartość:	False

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Właściwość	Wartość
Domyślna wartość:	False

--output -o

Format danych wyjściowych.

Właściwość	Wartość
Domyślna wartość:	json
Dopuszczalne wartości:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Właściwość	Wartość
Domyślna wartość:	False

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

Przykłady

Usuń szablon konstruktora obrazów. (autogenerated)

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

Parametry opcjonalne

Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.

Parametry globalne

--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Właściwość	Wartość
Domyślna wartość:	False

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Właściwość	Wartość
Domyślna wartość:	False

--output -o

Format danych wyjściowych.

Właściwość	Wartość
Domyślna wartość:	json
Dopuszczalne wartości:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Właściwość	Wartość
Domyślna wartość:	False

az image builder list [--resource-group]

Parametry opcjonalne

Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.

Parametry globalne

--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Właściwość	Wartość
Domyślna wartość:	False

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Właściwość	Wartość
Domyślna wartość:	False

--output -o

Format danych wyjściowych.

Właściwość	Wartość
Domyślna wartość:	json
Dopuszczalne wartości:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Właściwość	Wartość
Domyślna wartość:	False

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

Przykłady

Uruchom uruchomienie kompilacji szablonu, a następnie zaczekaj na jego zakończenie.

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

Parametry opcjonalne

Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.

Parametry globalne

--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Właściwość	Wartość
Domyślna wartość:	False

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Właściwość	Wartość
Domyślna wartość:	False

--output -o

Format danych wyjściowych.

Właściwość	Wartość
Domyślna wartość:	json
Dopuszczalne wartości:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Właściwość	Wartość
Domyślna wartość:	False

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

Przykłady

Pokaż szablon konstruktora obrazów (wygenerowany automatycznie)

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

Parametry opcjonalne

Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.

Parametry globalne

--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Właściwość	Wartość
Domyślna wartość:	False

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Właściwość	Wartość
Domyślna wartość:	False

--output -o

Format danych wyjściowych.

Właściwość	Wartość
Domyślna wartość:	json
Dopuszczalne wartości:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Właściwość	Wartość
Domyślna wartość:	False

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

Przykłady

Uruchom uruchomienie kompilacji szablonu, a następnie wyświetl jego dane wyjściowe przebiegu.

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

Parametry opcjonalne

Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.

Parametry globalne

--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Właściwość	Wartość
Domyślna wartość:	False

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Właściwość	Wartość
Domyślna wartość:	False

--output -o

Format danych wyjściowych.

Właściwość	Wartość
Domyślna wartość:	json
Dopuszczalne wartości:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Właściwość	Wartość
Domyślna wartość:	False

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

Przykłady

Utwórz zasób szablonu na podstawie obiektu szablonu w pamięci podręcznej interfejsu wiersza polecenia. Aby uzyskać więcej informacji, zobacz "az image builder create/output add/ customizer add --help" i "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

Parametry opcjonalne

Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.

Parametry globalne

--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Właściwość	Wartość
Domyślna wartość:	False

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Właściwość	Wartość
Domyślna wartość:	False

--output -o

Format danych wyjściowych.

Właściwość	Wartość
Domyślna wartość:	json
Dopuszczalne wartości:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Właściwość	Wartość
Domyślna wartość:	False

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

Przykłady

Uruchom uruchomienie kompilacji szablonu, a następnie zaczekaj na jego zakończenie.

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

Parametry opcjonalne

Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.

Parametry globalne

--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Właściwość	Wartość
Domyślna wartość:	False

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Właściwość	Wartość
Domyślna wartość:	False

--output -o

Format danych wyjściowych.

Właściwość	Wartość
Domyślna wartość:	json
Dopuszczalne wartości:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Właściwość	Wartość
Domyślna wartość:	False