az image builder customizer

  • Odwołanie

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

Polecenia

az image builder customizer add

Dodaj konfigurator konstruktora obrazów do szablonu konstruktora obrazów.
az image builder customizer clear

Usuń wszystkie konfiguratory konstruktora obrazów z szablonu konstruktora obrazów.
az image builder customizer remove

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

az image builder customizer add

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

Musi być używany 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]
                                [--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 my-group \
    --inline-script "sudo mkdir /buildArtifacts" \
                    "sudo cp /tmp/index.html /buildArtifacts/index.html" \
    --customizer-name shell-script-inline --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 my-group \
    --customizer-name my-file --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 my-group \
--customizer-name shell-script-url \
--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 my-group --customizer-name win_update --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.

akceptowane 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, w której plik określony w pliku --file-source zostanie pobrany do pliku na obrazie.

--exit-codes -e

Rozdzielona spacjami lista prawidłowych kodów zakończenia jako liczby całkowite.

--file-source

Identyfikator URI pliku, który ma zostać pobrany do obrazu. Może to być link usługi 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 spacją). Powinien to być kompletny 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 wierszy skryptów wbudowanych 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 , aby wykonać operację ponownego uruchomienia.

--restart-timeout

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

wartość domyślna: 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.

--update-limit

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

az image builder customizer clear

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

Musi być używany z --defer.

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

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 spacją). Powinien to być kompletny 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>.

az image builder customizer remove

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

Musi być używany z --defer.

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

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 spacją). Powinien to być kompletny 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>.