Udostępnij za pośrednictwem

az image builder

  • Odwołanie

Zarządzanie szablonami konstruktora obrazów i tworzenie ich.

Polecenia

Nazwa Opis Typ Stan
az image builder cancel

Anuluj długotrwałą kompilację obrazu na podstawie szablonu obrazu.

 Podstawowe funkcje Ogólna dostępność
az image builder create

Utwórz szablon konstruktora obrazów.

 Podstawowe funkcje Ogólna dostępność
az image builder customizer

Zarządzanie konfiguratorami szablonów konstruktora obrazów.

 Podstawowe funkcje Ogólna dostępność
az image builder customizer add

Dodaj konfigurator konstruktora obrazów do szablonu konstruktora obrazów.

 Podstawowe funkcje Ogólna dostępność
az image builder customizer clear

Usuń wszystkie konfiguratory konstruktora obrazów z szablonu konstruktora obrazów.

 Podstawowe funkcje Ogólna dostępność
az image builder customizer remove

Usuń konfigurator konstruktora obrazów z szablonu konstruktora obrazów.

 Podstawowe funkcje Ogólna dostępność
az image builder delete

Usuń szablon konstruktora obrazów.

 Podstawowe funkcje Ogólna dostępność
az image builder error-handler

Zarządzanie procedurą obsługi błędów szablonu konstruktora obrazów.

 Podstawowe funkcje Ogólna dostępność
az image builder error-handler add

Dodaj procedurę obsługi błędów do istniejącego szablonu konstruktora obrazów.

 Podstawowe funkcje Ogólna dostępność
az image builder error-handler remove

Usuń procedurę obsługi błędów z istniejącego szablonu konstruktora obrazów.

 Podstawowe funkcje Ogólna dostępność
az image builder error-handler show

Pokaż procedurę obsługi błędów istniejącego szablonu konstruktora obrazów.

 Podstawowe funkcje Ogólna dostępność
az image builder identity

Zarządzanie tożsamościami szablonu konstruktora obrazów.

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

 Podstawowe funkcje Ogólna dostępność
az image builder identity remove

Usuń tożsamości zarządzane z istniejącego szablonu konstruktora obrazów.

 Podstawowe funkcje Ogólna dostępność
az image builder identity show

Wyświetlanie tożsamości zarządzanych szablonu konstruktora obrazów.

 Podstawowe funkcje Ogólna dostępność
az image builder list

Wyświetlanie listy szablonów konstruktora obrazów.

 Podstawowe funkcje Ogólna dostępność
az image builder optimizer

Zarządzaj optymalizatorem szablonów konstruktora obrazów.

 Podstawowe funkcje Ogólna dostępność
az image builder optimizer add

Dodaj optymalizator do istniejącego szablonu konstruktora obrazów.

 Podstawowe funkcje Ogólna dostępność
az image builder optimizer remove

Usuń optymalizator z istniejącego szablonu konstruktora obrazów.

 Podstawowe funkcje Ogólna dostępność
az image builder optimizer show

Pokaż optymalizator istniejącego szablonu konstruktora obrazów.

 Podstawowe funkcje Ogólna dostępność
az image builder optimizer update

Zaktualizuj optymalizator na podstawie istniejącego szablonu konstruktora obrazów.

 Podstawowe funkcje Ogólna dostępność
az image builder output

Zarządzanie dystrybutorami wyjściowymi szablonu konstruktora obrazów.

 Podstawowe funkcje Ogólna dostępność
az image builder output add

Dodaj dystrybutor danych wyjściowych konstruktora obrazów do szablonu konstruktora obrazów.

 Podstawowe funkcje Ogólna dostępność
az image builder output clear

Usuń wszystkich dystrybutorów wyjściowych konstruktora obrazów z szablonu konstruktora obrazów.

 Podstawowe funkcje Ogólna dostępność
az image builder output remove

Usuń dystrybutor danych wyjściowych konstruktora obrazów z szablonu konstruktora obrazów.

 Podstawowe funkcje Ogólna dostępność
az image builder output versioning

Zarządzanie wersjonerem wyjściowym szablonu konstruktora obrazów.

 Podstawowe funkcje Ogólna dostępność
az image builder output versioning remove

Usuń wszystkie opcje przechowywania wersji w określonych danych wyjściowych.

 Podstawowe funkcje Ogólna dostępność
az image builder output versioning set

Ustaw program wersji wyjściowej konstruktora obrazów szablonu konstruktora obrazów.

 Podstawowe funkcje Ogólna dostępność
az image builder output versioning show

Pokaż opcje przechowywania wersji dla określonych danych wyjściowych.

 Podstawowe funkcje Ogólna dostępność
az image builder run

Tworzenie szablonu konstruktora obrazów.

 Podstawowe funkcje Ogólna dostępność
az image builder show

Pokaż szablon konstruktora obrazów.

 Podstawowe funkcje Ogólna dostępność
az image builder show-runs

Pokaż dane wyjściowe uruchamiania szablonu konstruktora obrazów.

 Podstawowe funkcje Ogólna dostępność
az image builder trigger

Zarządzanie wyzwalaczem szablonu konstruktora obrazów.

 Podstawowe funkcje Ogólna dostępność
az image builder trigger create

Utwórz wyzwalacz dla określonego szablonu obrazu maszyny wirtualnej.

 Podstawowe funkcje Ogólna dostępność
az image builder trigger delete

Usuń wyzwalacz dla określonego szablonu obrazu maszyny wirtualnej.

 Podstawowe funkcje Ogólna dostępność
az image builder trigger list

Wyświetl listę wszystkich wyzwalaczy dla określonego zasobu szablonu obrazu.

 Podstawowe funkcje Ogólna dostępność
az image builder trigger show

Pobierz określony wyzwalacz dla określonego zasobu szablonu obrazu.

 Podstawowe funkcje Ogólna dostępność
az image builder trigger wait

Umieść interfejs wiersza polecenia w stanie oczekiwania do momentu spełnienia warunku.

 Podstawowe funkcje Ogólna dostępność
az image builder update

Aktualizowanie szablonu konstruktora obrazów.

 Podstawowe funkcje Ogólna dostępność
az image builder validator

Zarządzanie weryfikacją szablonu konstruktora obrazów.

 Podstawowe funkcje Ogólna dostępność
az image builder validator add

Dodaj walidację do istniejącego szablonu konstruktora obrazów.

 Podstawowe funkcje Ogólna dostępność
az image builder validator remove

Usuń walidację z istniejącego szablonu konstruktora obrazów.

 Podstawowe funkcje Ogólna dostępność
az image builder validator show

Pokaż weryfikację istniejącego szablonu konstruktora obrazów.

 Podstawowe funkcje Ogólna dostępność
az image builder wait

Umieść interfejs wiersza polecenia w stanie oczekiwania do momentu spełnienia warunku szablonu.

 Podstawowe funkcje Ogólna dostępność

az image builder cancel

Anuluj długotrwałą kompilację obrazu na podstawie szablonu obrazu.

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

--ids

Co najmniej jeden identyfikator zasobu (rozdzielany spacjami). Powinien to być pełny identyfikator zasobu zawierający wszystkie informacje o argumentach "Identyfikator zasobu". Należy podać argumenty --ids lub inne argumenty "Identyfikator zasobu".

--name -n

Nazwa szablonu obrazu.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.

--subscription

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

Parametry globalne
--debug

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

--help -h

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

--only-show-errors

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

--output -o

Format danych wyjściowych.

Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
Domyślna wartość: json
--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 polecenia az account set -s NAME_OR_ID.

--verbose

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

az image builder create

Utwórz szablon konstruktora obrazów.

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

--name -n

Nazwa szablonu obrazu.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.

Parametry opcjonalne

--build-timeout

Maksymalny czas trwania oczekiwania podczas kompilowania szablonu obrazu w minutach. Wartość domyślna to 60.

--build-vm-identities

Opcjonalna konfiguracja sieci wirtualnej używanej do wdrażania maszyny wirtualnej kompilacji. Pomiń, jeśli nie trzeba używać określonej sieci wirtualnej.

--checksum

Suma kontrolna SHA256 obrazu ISO Red Hat.

--defer

Tymczasowo przechowuj obiekt w lokalnej pamięci podręcznej zamiast wysyłania na platformę Azure. Użyj az cache poleceń, aby wyświetlić/wyczyścić.

--identity

Lista tożsamości przypisanych przez użytkownika (nazwa lub identyfikator, spacja rozdzielana) szablonu obrazu.

--image-source -i

Obraz podstawowy do dostosowania. Musi być prawidłowym identyfikatorem URI obrazu platformy, aliasem obrazu platformy, identyfikatorem URI obrazu ISO systemu Red Hat, nazwą/identyfikatorem obrazu zarządzanego lub identyfikatorem wersji obrazu udostępnionego.

Wartość od: az vm image list, az vm image show
--image-template

Ścieżka lokalna lub adres URL do pliku szablonu obrazu. W przypadku korzystania z --image-template wszystkie inne parametry są ignorowane z wyjątkiem -g i -n. Dokumentacja: https://docs.microsoft.com/azure/virtual-machines/linux/image-builder-json.

--location -l

Lokalizacja. Wartości z: az account list-locations. Lokalizację domyślną można skonfigurować przy użyciu polecenia az configure --defaults location=<location>.

--managed-image-destinations

Informacje o dystrybutorze danych wyjściowych obrazu zarządzanego. Rozdzielona spacjami lista par klucz-wartość. Np. "image_1=westus2 image_2=westus". Każdy klucz to nazwa lub identyfikator zasobu obrazu zarządzanego do utworzenia. Każda wartość to lokalizacja obrazu.

--no-wait

Nie czekaj na zakończenie długotrwałej operacji.

Domyślna wartość: False
--os-disk-size

Rozmiar dysku systemu operacyjnego w GB. Pomiń lub określ wartość 0, aby użyć domyślnego rozmiaru dysku systemu operacyjnego platformy Azure.

--proxy-vm-size

Rozmiar maszyny wirtualnej używanej do kompilowania, dostosowywania i przechwytywania obrazów (Standard_D1_v2 dla obrazów gen1 i Standard_D2ds_v4 obrazów gen2).

--scripts

Rozdzielona spacjami lista skryptów powłoki lub programu PowerShell w celu dostosowania obrazu za pomocą polecenia. Każdy skrypt musi być publicznie dostępnym adresem URL. Wywnioskuje typ skryptu z rozszerzenia pliku ('.sh' lub'.ps1') lub z typu źródłowego. Więcej opcji i elastyczności konfiguratora można znaleźć w temacie "az image template customizer add".

--shared-image-destinations

Informacje o dystrybutorze danych wyjściowych galerii obrazów udostępnionych (sig). Rozdzielona spacjami lista par klucz-wartość. Np. "my_gallery_1/image_def_1=eastus,westus my_gallery_2/image_def_2=uksouth,canadaeast,francesouth". Każdy klucz jest identyfikatorem definicji obrazu sig lub sig nazwy galerii i sig definicji obrazu rozdzielanym przez znak "/". Każda wartość jest rozdzielaną przecinkami listą lokalizacji replik.

--staging-resource-group

Identyfikator przejściowej grupy zasobów w tej samej subskrypcji co szablon obrazu, który będzie używany do kompilowania obrazu.

--subnet

Nazwa lub identyfikator podsieci w celu wdrożenia maszyny wirtualnej kompilacji.

--tags

Tagi rozdzielone spacjami: klucz[=wartość] [key[=value] ...]. Użyj ciągu "", aby wyczyścić istniejące tagi.

--validator

Typ weryfikacji, którego chcesz użyć na obrazie. Na przykład wartość "Shell" może być walidacją powłoki.

--vm-size

Rozmiar maszyny wirtualnej używanej do kompilowania, dostosowywania i przechwytywania obrazów. Pomiń lub określ pusty ciąg, aby użyć wartości domyślnej (Standard_D1_v2).

--vnet

Nazwa sieci wirtualnej do wdrożenia maszyny wirtualnej kompilacji. Należy określić ją tylko wtedy, gdy podsieć jest nazwą.

Parametry globalne
--debug

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

--help -h

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

--only-show-errors

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

--output -o

Format danych wyjściowych.

Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
Domyślna wartość: json
--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 polecenia az account set -s NAME_OR_ID.

--verbose

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

az image builder delete

Usuń szablon konstruktora obrazów.

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

Przykłady

Usuń szablon konstruktora obrazów. (automatycznie wygenerowane)

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

Parametry opcjonalne

--ids

Co najmniej jeden identyfikator zasobu (rozdzielany spacjami). Powinien to być pełny identyfikator zasobu zawierający wszystkie informacje o argumentach "Identyfikator zasobu". Należy podać argumenty --ids lub inne argumenty "Identyfikator zasobu".

--name -n

Nazwa szablonu obrazu.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.

--subscription

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

Parametry globalne
--debug

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

--help -h

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

--only-show-errors

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

--output -o

Format danych wyjściowych.

Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
Domyślna wartość: json
--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 polecenia az account set -s NAME_OR_ID.

--verbose

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

az image builder list

Wyświetlanie listy szablonów konstruktora obrazów.

az image builder list [--resource-group]

Parametry opcjonalne

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.

Parametry globalne
--debug

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

--help -h

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

--only-show-errors

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

--output -o

Format danych wyjściowych.

Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
Domyślna wartość: json
--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 polecenia az account set -s NAME_OR_ID.

--verbose

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

az image builder run

Tworzenie szablonu konstruktora obrazów.

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

--ids

Co najmniej jeden identyfikator zasobu (rozdzielany spacjami). Powinien to być pełny identyfikator zasobu zawierający wszystkie informacje o argumentach "Identyfikator zasobu". Należy podać argumenty --ids lub inne argumenty "Identyfikator zasobu".

--name -n

Nazwa szablonu obrazu.

--no-wait

Nie czekaj na zakończenie długotrwałej operacji.

Domyślna wartość: False
--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.

--subscription

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

Parametry globalne
--debug

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

--help -h

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

--only-show-errors

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

--output -o

Format danych wyjściowych.

Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
Domyślna wartość: json
--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 polecenia az account set -s NAME_OR_ID.

--verbose

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

az image builder show

Pokaż szablon konstruktora obrazów.

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

--ids

Co najmniej jeden identyfikator zasobu (rozdzielany spacjami). Powinien to być pełny identyfikator zasobu zawierający wszystkie informacje o argumentach "Identyfikator zasobu". Należy podać argumenty --ids lub inne argumenty "Identyfikator zasobu".

--name -n

Nazwa szablonu obrazu.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.

--subscription

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

Parametry globalne
--debug

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

--help -h

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

--only-show-errors

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

--output -o

Format danych wyjściowych.

Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
Domyślna wartość: json
--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 polecenia az account set -s NAME_OR_ID.

--verbose

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

az image builder show-runs

Pokaż dane wyjściowe uruchamiania szablonu konstruktora obrazów.

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

--ids

Co najmniej jeden identyfikator zasobu (rozdzielany spacjami). Powinien to być pełny identyfikator zasobu zawierający wszystkie informacje o argumentach "Identyfikator zasobu". Należy podać argumenty --ids lub inne argumenty "Identyfikator zasobu".

--name -n

Nazwa szablonu obrazu.

--output-name

Nazwa konstruktora obrazów uruchom dane wyjściowe.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.

--subscription

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

Parametry globalne
--debug

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

--help -h

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

--only-show-errors

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

--output -o

Format danych wyjściowych.

Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
Domyślna wartość: json
--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 polecenia az account set -s NAME_OR_ID.

--verbose

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

az image builder update

Aktualizowanie szablonu konstruktora obrazów.

Aktualizowanie szablonów konstruktora obrazów jest obecnie nieobsługiwane. To polecenie można użyć w połączeniu z poleceniem --defer w celu zaktualizowania obiektu szablonu obrazu w pamięci podręcznej interfejsu wiersza polecenia. Bez --odroczy pobiera określony szablon obrazu z pamięci podręcznej i wysyła żądanie do platformy Azure, aby utworzyć szablon obrazu.

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

--add

Dodaj obiekt do listy obiektów, określając pary ścieżki i wartości klucza. Przykład: --add property.listProperty <key=value, string or JSON string>.

Domyślna wartość: []
--defer

Tymczasowo przechowuj obiekt w lokalnej pamięci podręcznej zamiast wysyłania na platformę Azure. Użyj az cache poleceń, aby wyświetlić/wyczyścić.

--force-string

W przypadku używania polecenia "set" lub "add" zachowaj literały ciągu zamiast próbować konwertować na format JSON.

Domyślna wartość: False
--ids

Co najmniej jeden identyfikator zasobu (rozdzielany spacjami). Powinien to być pełny identyfikator zasobu zawierający wszystkie informacje o argumentach "Identyfikator zasobu". Należy podać argumenty --ids lub inne argumenty "Identyfikator zasobu".

--name -n

Nazwa szablonu obrazu.

--remove

Usuń właściwość lub element z listy. Przykład: --remove property.list <indexToRemove> OR --remove propertyToRemove.

Domyślna wartość: []
--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.

--set

Zaktualizuj obiekt, określając ścieżkę właściwości i wartość do ustawienia. Przykład: --set property1.property2=<value>.

Domyślna wartość: []
--subscription

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

Parametry globalne
--debug

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

--help -h

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

--only-show-errors

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

--output -o

Format danych wyjściowych.

Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
Domyślna wartość: json
--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 polecenia az account set -s NAME_OR_ID.

--verbose

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

az image builder wait

Umieść interfejs wiersza polecenia w stanie oczekiwania do momentu spełnienia warunku szablonu.

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

--created

Zaczekaj na utworzenie polecenia "provisioningState" o godzinie "Succeeded".

Domyślna wartość: False
--custom

Poczekaj, aż warunek spełnia niestandardowe zapytanie JMESPath. Np. provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Poczekaj na usunięcie.

Domyślna wartość: False
--exists

Zaczekaj, aż zasób istnieje.

Domyślna wartość: False
--ids

Co najmniej jeden identyfikator zasobu (rozdzielany spacjami). Powinien to być pełny identyfikator zasobu zawierający wszystkie informacje o argumentach "Identyfikator zasobu". Należy podać argumenty --ids lub inne argumenty "Identyfikator zasobu".

--interval

Interwał sondowania w sekundach.

Domyślna wartość: 30
--name -n

Nazwa szablonu obrazu.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.

--subscription

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

--timeout

Maksymalny czas oczekiwania w sekundach.

Domyślna wartość: 3600
--updated

Zaczekaj na zaktualizowanie stanu provisioningState o 'Powodzenie'.

Domyślna wartość: False
Parametry globalne
--debug

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

--help -h

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

--only-show-errors

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

--output -o

Format danych wyjściowych.

Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
Domyślna wartość: json
--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 polecenia az account set -s NAME_OR_ID.

--verbose

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