az image builder customizer

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

Polecenia

Nazwa	Opis	Typ	Stan
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 customizer add

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

Należy używać z --defer.

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]

Przykłady

Dodawanie wbudowanego konfiguratora powłoki do szablonu obrazu w pamięci podręcznej obiektów interfejsu wiersza polecenia

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

Dodawanie konfiguratora plików do szablonu obrazu w pamięci podręcznej obiektów interfejsu wiersza polecenia

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

Dodawanie konfiguratora ponownego uruchamiania systemu Windows do szablonu obrazu w pamięci podręcznej obiektów interfejsu wiersza polecenia

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

Dodaj konfigurator aktualizacji systemu Windows do szablonu obrazu w pamięci podręcznej obiektów interfejsu wiersza polecenia.

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

Parametry wymagane

--customizer-name

Nazwa konfiguratora.

--type -t

Typ konfiguratora, który ma zostać dodany do szablonu obrazu.

Właściwość	Wartość
Dopuszczalne wartości:	file, powershell, shell, windows-restart, windows-update

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.

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

--dest-path

Bezwzględna ścieżka docelowa, do której zostanie pobrany plik określony w pliku --file-source na obrazie.

Właściwość	Wartość
Grupa parametrów:	File Arguments

--exit-codes -e

Rozdzielona spacjami lista prawidłowych kodów zakończenia jako liczba całkowita.

Właściwość	Wartość
Grupa parametrów:	Powershell Arguments

--file-source

Identyfikator URI pliku, który ma zostać pobrany do obrazu. Może to być link github, identyfikator URI sygnatury dostępu współdzielonego dla usługi Azure Storage itp.

Właściwość	Wartość
Grupa parametrów:	File Arguments

--filters

Filtry rozdzielane spacjami, aby wybrać aktualizacje do zastosowania. Pomiń lub określ pustą tablicę, aby użyć wartości domyślnej (bez filtru).

Właściwość	Wartość
Grupa parametrów:	Windows Update Arguments

--ids

Co najmniej jeden identyfikator zasobu (rozdzielany spacjami). Powinien to być kompletny identyfikator zasobu, zawierający wszystkie informacje dotyczące argumentów „Identyfikator zasobu”. Należy podać argumenty --ids lub inne argumenty "Identyfikator zasobu".

Właściwość	Wartość
Grupa parametrów:	Resource Id Arguments

--inline-script

Rozdzielona spacjami lista wbudowanych wierszy skryptu w celu dostosowania obrazu za pomocą polecenia.

Właściwość	Wartość
Grupa parametrów:	Shell and Powershell Arguments

--name -n

Nazwa szablonu obrazu.

Właściwość	Wartość
Grupa parametrów:	Resource Id Arguments

--resource-group -g

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

Właściwość	Wartość
Grupa parametrów:	Resource Id Arguments

--restart-check-command

Polecenie, aby sprawdzić, czy ponowne uruchomienie zakończyło się pomyślnie.

Właściwość	Wartość
Grupa parametrów:	Windows Restart Arguments

--restart-command

Polecenie do wykonania operacji ponownego uruchamiania.

Właściwość	Wartość
Grupa parametrów:	Windows Restart Arguments

--restart-timeout

Limit czasu ponownego uruchamiania określony jako ciąg składający się z wielkości i jednostki, np. "5m" (5 minut) lub "2h" (2 godziny).

Właściwość	Wartość
Grupa parametrów:	Windows Restart Arguments
Domyślna wartość:	5m

--script-url

Adres URL skryptu w celu dostosowania obrazu za pomocą polecenia . Adres URL musi być publicznie dostępny.

Właściwość	Wartość
Grupa parametrów:	Shell and Powershell Arguments

--search-criteria

Kryteria wyszukiwania aktualizacji. Pomiń lub określ pusty ciąg, aby użyć wartości domyślnej (wyszukaj wszystko). Zapoznaj się z powyższym linkiem, aby zapoznać się z przykładami i szczegółowym opisem tego pola.

Właściwość	Wartość
Grupa parametrów:	Windows Update Arguments

--subscription

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

Właściwość	Wartość
Grupa parametrów:	Resource Id Arguments

--update-limit

Maksymalna liczba aktualizacji do zastosowania w danym momencie. Pomiń lub określ wartość 0, aby użyć wartości domyślnej (1000).

Właściwość	Wartość
Grupa parametrów:	Windows Update Arguments

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