Sdílet prostřednictvím

az image builder customizer

  • Reference

Správa úprav šablon tvůrce obrázků

Příkazy

Name Description Typ Stav
az image builder customizer add

Přidejte úpravce tvůrce obrázků do šablony tvůrce obrázků.

 Základ GA
az image builder customizer clear

Odeberte všechny úpravce tvůrce obrázků ze šablony tvůrce obrázků.

 Základ GA
az image builder customizer remove

Odeberte úpravce tvůrce obrázků ze šablony tvůrce obrázků.

 Základ GA

az image builder customizer add

Přidejte úpravce tvůrce obrázků do šablony tvůrce obrázků.

Musí se použít s --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]

Příklady

Přidání úpravce vloženého prostředí do šablony obrázku v mezipaměti objektů rozhraní příkazového řádku

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

Přidání úpravce souboru do šablony obrázku v mezipaměti objektů rozhraní příkazového řádku

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

Přidání úpravce windows restartu do šablony obrázku v mezipaměti objektů rozhraní příkazového řádku

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

Přidejte úpravce služby Windows Update do šablony obrázku v mezipaměti objektů rozhraní příkazového řádku.

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

Povinné parametry

--customizer-name

Název úpravce

--type -t

Typ úpravce, který se má přidat do šablony obrázku

Přípustné hodnoty: file, powershell, shell, windows-restart, windows-update

Volitelné parametry

--defer

Dočasně uložte objekt do místní mezipaměti místo odeslání do Azure. K zobrazení nebo vymazání použijte az cache příkazy.

--dest-path

Absolutní cílová cesta, kam se soubor zadaný ve zdroji --file-source stáhne do obrázku.

--exit-codes -e

Seznam platných ukončovacích kódů oddělených mezerami jako celá čísla

--file-source

Identifikátor URI souboru, který se má stáhnout do image. Může to být odkaz githubu, identifikátor URI SAS pro Azure Storage atd.

--filters

Filtry s oddělovači mezer pro výběr aktualizací, které se mají použít. Vynechání nebo zadání prázdného pole pro použití výchozího pole (bez filtru)

--ids

Jedno nebo více ID prostředků (oddělených mezerami) Mělo by se jednat o úplné ID prostředku obsahující všechny informace o argumentech ID prostředku. Měli byste zadat argumenty --ids nebo jiné argumenty ID prostředku.

--inline-script

Seznam řádků vložených skriptů oddělených mezerami pro přizpůsobení obrázku

--name -n

Název šablony obrázku

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

--restart-check-command

Příkaz k ověření úspěšného restartování

--restart-command

Příkaz, který spustí operaci restartování.

--restart-timeout

Časový limit restartování zadaný jako řetězec skládající se z velikosti a jednotky, např. "5 min" (5 minut) nebo "2h" (2 hodiny).

Default value: 5m
--script-url

Adresa URL skriptu pro přizpůsobení obrázku Adresa URL musí být veřejně přístupná.

--search-criteria

Kritéria pro vyhledávání aktualizací Vynecháte nebo zadejte prázdný řetězec, který se má použít jako výchozí (prohledávat vše). Příklady a podrobný popis tohoto pole najdete na výše uvedeném odkazu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--update-limit

Maximální početaktualizacích Vynechání nebo zadání hodnoty 0 pro použití výchozí hodnoty (1000).

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az image builder customizer clear

Odeberte všechny úpravce tvůrce obrázků ze šablony tvůrce obrázků.

Musí se použít s --defer.

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

Volitelné parametry

--defer

Dočasně uložte objekt do místní mezipaměti místo odeslání do Azure. K zobrazení nebo vymazání použijte az cache příkazy.

--ids

Jedno nebo více ID prostředků (oddělených mezerami) Mělo by se jednat o úplné ID prostředku obsahující všechny informace o argumentech ID prostředku. Měli byste zadat argumenty --ids nebo jiné argumenty ID prostředku.

--name -n

Název šablony obrázku

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az image builder customizer remove

Odeberte úpravce tvůrce obrázků ze šablony tvůrce obrázků.

Musí se použít s --defer.

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

Povinné parametry

--customizer-name

Název úpravce

Volitelné parametry

--defer

Dočasně uložte objekt do místní mezipaměti místo odeslání do Azure. K zobrazení nebo vymazání použijte az cache příkazy.

--ids

Jedno nebo více ID prostředků (oddělených mezerami) Mělo by se jednat o úplné ID prostředku obsahující všechny informace o argumentech ID prostředku. Měli byste zadat argumenty --ids nebo jiné argumenty ID prostředku.

--name -n

Název šablony obrázku

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.