Udostępnij za pośrednictwem

az image builder customizer

  • Odwołanie

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.

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

Dopuszczalne wartości: file, powershell, shell, windows-restart, windows-update

Parametry opcjonalne

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

--exit-codes -e

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

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

--filters

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

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

--inline-script

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

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

--restart-check-command

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

--restart-command

Polecenie do wykonania operacji ponownego uruchamiania.

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

Domyślna wartość: 5m
--script-url

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

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

--subscription

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

--update-limit

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

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

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

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

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

Parametry opcjonalne

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

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

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

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

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

Parametry wymagane

--customizer-name

Nazwa konfiguratora.

Parametry opcjonalne

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

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