az image builder

Umožňuje spravovat a vytvářet šablony tvůrce imagí.

Příkazy

Name	Description	Typ	Stav
az image builder cancel	Zrušte sestavení dlouhotrvající image na základě šablony image.	Core	GA
az image builder create	Vytvořte šablonu tvůrce obrázků.	Core	GA
az image builder customizer	Správa úprav šablon tvůrce obrázků	Core	GA
az image builder customizer add	Přidejte úpravce tvůrce obrázků do šablony tvůrce obrázků.	Core	GA
az image builder customizer clear	Odeberte všechny úpravce tvůrce obrázků ze šablony tvůrce obrázků.	Core	GA
az image builder customizer remove	Odeberte úpravce tvůrce obrázků ze šablony tvůrce obrázků.	Core	GA
az image builder delete	Odstraňte šablonu tvůrce obrázků.	Core	GA
az image builder error-handler	Správa obslužné rutiny chyby šablony tvůrce obrázků	Core	GA
az image builder error-handler add	Přidejte obslužnou rutinu chyby do existující šablony tvůrce obrázků.	Core	GA
az image builder error-handler remove	Odeberte obslužnou rutinu chyby z existující šablony tvůrce obrázků.	Core	GA
az image builder error-handler show	Zobrazí obslužnou rutinu chyby existující šablony tvůrce obrázků.	Core	GA
az image builder identity	Správa identit šablony tvůrce obrázků	Core	GA
az image builder identity assign	Přidání spravovaných identit do existující šablony tvůrce imagí V současné době se podporuje pouze jedna identita uživatele.	Core	GA
az image builder identity remove	Odeberte spravované identity z existující šablony tvůrce imagí.	Core	GA
az image builder identity show	Zobrazení spravovaných identit šablony tvůrce obrázků	Core	GA
az image builder list	Vypsat šablony tvůrce obrázků	Core	GA
az image builder optimizer	Správa optimalizátoru šablon tvůrce obrázků	Core	GA
az image builder optimizer add	Přidejte optimalizátor do existující šablony tvůrce obrázků.	Core	GA
az image builder optimizer remove	Odeberte optimalizátor z existující šablony tvůrce obrázků.	Core	GA
az image builder optimizer show	Zobrazí optimalizátor existující šablony tvůrce obrázků.	Core	GA
az image builder optimizer update	Aktualizujte optimalizátor z existující šablony tvůrce obrázků.	Core	GA
az image builder output	Spravujte distributory výstupů šablony tvůrce obrázků.	Core	GA
az image builder output add	Přidání výstupního distributora tvůrce obrázků do šablony tvůrce obrázků	Core	GA
az image builder output clear	Odeberte všechny distributory výstupů tvůrce obrázků ze šablony tvůrce obrázků.	Core	GA
az image builder output remove	Odeberte výstupní distributor tvůrce obrázků ze šablony tvůrce obrázků.	Core	GA
az image builder output versioning	Správa nástroje pro správu verzí šablony tvůrce obrázků	Core	GA
az image builder output versioning remove	Odeberte všechny možnosti správy verzí u zadaných výstupů.	Core	GA
az image builder output versioning set	Nastavte výstupní verzi tvůrce obrázků šablony tvůrce obrázků.	Core	GA
az image builder output versioning show	Umožňuje zobrazit možnosti správy verzí u zadaných výstupů.	Core	GA
az image builder run	Vytvořte šablonu tvůrce obrázků.	Core	GA
az image builder show	Zobrazí šablonu tvůrce obrázků.	Core	GA
az image builder show-runs	Zobrazí výstupy spuštění šablony tvůrce obrázků.	Core	GA
az image builder trigger	Správa triggeru šablony tvůrce obrázků	Core	GA
az image builder trigger create	Vytvořte trigger pro zadanou šablonu image virtuálního počítače.	Core	GA
az image builder trigger delete	Odstraňte trigger pro zadanou šablonu image virtuálního počítače.	Core	GA
az image builder trigger list	Zobrazí seznam všech aktivačních událostí pro zadaný prostředek šablony obrázku.	Core	GA
az image builder trigger show	Získejte zadaný trigger pro zadaný prostředek šablony image.	Core	GA
az image builder trigger wait	Umístěte rozhraní příkazového řádku do stavu čekání, dokud není splněna podmínka.	Core	GA
az image builder update	Aktualizujte šablonu tvůrce obrázků.	Core	GA
az image builder validator	Umožňuje spravovat ověření šablony tvůrce obrázků.	Core	GA
az image builder validator add	Přidejte ověření do existující šablony tvůrce obrázků.	Core	GA
az image builder validator remove	Odeberte ověření z existující šablony tvůrce obrázků.	Core	GA
az image builder validator show	Zobrazí ověření existující šablony tvůrce obrázků.	Core	GA
az image builder wait	Umístěte rozhraní příkazového řádku do stavu čekání, dokud nebude splněna podmínka šablony.	Core	GA

az image builder cancel

Zrušte sestavení dlouhotrvající image na základě šablony image.

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

Příklady

Zrušení sestavení image

az image builder cancel -n mytemplate -g my-group

Volitelné parametry

Následující parametry jsou volitelné, ale v závislosti na kontextu se může stát, že se jeden nebo více vyžaduje, aby se příkaz úspěšně spustil.

--ids

Jedno nebo více ID prostředků (oddělené 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 buď argumenty --ids, nebo jiné argumenty 'ID prostředku'.

Vlastnost	Hodnota
Skupina parametrů:	Resource Id Arguments

--name -n

Název šablony obrázku

Vlastnost	Hodnota
Skupina parametrů:	Resource Id Arguments

--resource-group -g

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

Vlastnost	Hodnota
Skupina parametrů:	Resource Id Arguments

--subscription

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

Vlastnost	Hodnota
Skupina parametrů:	Resource Id Arguments

Globální parametry

--debug

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

Vlastnost	Hodnota
Default value:	False

--help -h

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

--only-show-errors

Zobrazit pouze chyby, potlačit upozornění.

Vlastnost	Hodnota
Default value:	False

--output -o

Výstupní formát

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

--query

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

--verbose

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

Vlastnost	Hodnota
Default value:	False

az image builder create

Vytvořte šablonu tvůrce obrázků.

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]

Příklady

Vytvořte šablonu tvůrce obrázků z image Ubuntu2204. Distribuujte ji jako spravovanou image a verzi sdílené image galerie imagí. Jako šablonu image, která se použije k sestavení image, zadejte ID pracovní skupiny prostředků.

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

Vytvořte šablonu tvůrce obrázků pomocí souboru šablony obrázku.

az image builder create -g my-group -n myTemplate --image-template filename

[Upřesnit] Vytvořte šablonu obrázku s několika úpravci a distributory pomocí mezipaměti objektů rozhraní příkazového řádku prostřednictvím parametru --defer. Podporuje funkce, jako jsou: vlastníci a výstupní názvy, ukončovací kódy PowerShellu, vložené skripty, restartování windows, úpravce souborů, značky artefaktů a distributory výstupu virtuálního pevného disku.

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

Povinné parametry

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

Volitelné parametry

Následující parametry jsou volitelné, ale v závislosti na kontextu se může stát, že se jeden nebo více vyžaduje, aby se příkaz úspěšně spustil.

--build-timeout

Maximální doba trvání čekání při sestavování šablony obrázku v minutách. Výchozí hodnota je 60.

--build-vm-identities

Volitelná konfigurace virtuální sítě, která se má použít k nasazení virtuálního počítače sestavení. Vynecháte, pokud není potřeba použít žádnou konkrétní virtuální síť.

--checksum

Kontrolní součet SHA256 image ISO systému Red Hat.

Vlastnost	Hodnota
Skupina parametrů:	Image Source Arguments

--defer

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

--identity

Seznam identit přiřazených uživatelem (název nebo ID, oddělený mezera) šablony obrázku

--image-source -i

Základní image, která se má přizpůsobit. Musí to být platný identifikátor URN image platformy, alias image platformy, identifikátor URI image ISO pro Red Hat, název/ID spravované image nebo ID sdílené verze image.

Vlastnost	Hodnota
Skupina parametrů:	Image Source Arguments
Počáteční hodnota:	az vm image list, az vm image show

--image-template

Místní cesta nebo adresa URL k souboru šablony obrázku Při použití šablony --image se všechny ostatní parametry ignorují s výjimkou -g a -n. Referenční informace: https://learn.microsoft.com/azure/virtual-machines/linux/image-builder-json.

--location -l

Location. Hodnoty z: az account list-locations. Výchozí umístění můžete nakonfigurovat pomocí .az configure --defaults location=<location>

--managed-image-destinations

Informace o distributorovi výstupu spravované image Seznam párů klíč-hodnota oddělených mezerami Například "image_1=westus2 image_2=westus". Každý klíč je název nebo ID prostředku spravované image, která se má vytvořit. Každá hodnota je umístění obrázku.

Vlastnost	Hodnota
Skupina parametrů:	Output Arguments

--no-wait

Nečekejte na dokončení dlouhotrvající operace.

Vlastnost	Hodnota
Default value:	False

--os-disk-size

Velikost disku s operačním systémem v GB Vynecháte nebo zadejte hodnotu 0 pro použití výchozí velikosti disku s operačním systémem Azure.

--proxy-vm-size

Velikost virtuálního počítače používaného k sestavení, přizpůsobení a zachycení imagí (Standard_D1_v2 pro image Gen1 a Standard_D2ds_v4 pro image Gen2).

--scripts

Seznam prostředí nebo skriptů PowerShellu oddělených mezerami pro přizpůsobení image. Každý skript musí být veřejně přístupná adresa URL. Odvodí typ skriptu z přípony souboru (.sh nebo.ps1) nebo ze zdrojového typu. Další možnosti úpravce a flexibilita najdete v tématu: az image template customizer add.

Vlastnost	Hodnota
Skupina parametrů:	Customizer Arguments

--shared-image-destinations

Informace o distributorech ve sdílené galerii imagí (sig) Seznam párů klíč-hodnota oddělených mezerami Například "my_gallery_1/image_def_1=eastus,westus my_gallery_2/image_def_2=uksouth,canadaeast,francesouth." Každý klíč je ID definice obrázku sig nebo název galerie sig a definici obrázku sig oddělené znakem /. Každá hodnota je čárkami oddělený seznam umístění replik.

Vlastnost	Hodnota
Skupina parametrů:	Output Arguments

--staging-resource-group

ID pracovní skupiny prostředků ve stejném předplatném jako šablona image, která se použije k sestavení image.

--subnet

Název nebo ID podsítě pro nasazení virtuálního počítače sestavení

--tags

Značky oddělené mezerami: klíč[=hodnota] [klíč[=hodnota] ...]. K vymazání existujících značek použijte "".

--validator

Typ ověření, který chcete použít na obrázku. Například "Shell" může být ověření prostředí.

--vm-size

Velikost virtuálního počítače použitého k sestavení, přizpůsobení a zachycení imagí Vynecháte nebo zadejte prázdný řetězec, který se má použít jako výchozí (Standard_D1_v2).

--vnet

Název virtuální sítě pro nasazení virtuálního počítače sestavení Měli byste ho zadat jenom v případě, že podsíť je název.

Globální parametry

--debug

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

Vlastnost	Hodnota
Default value:	False

--help -h

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

--only-show-errors

Zobrazit pouze chyby, potlačit upozornění.

Vlastnost	Hodnota
Default value:	False

--output -o

Výstupní formát

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

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

Vlastnost	Hodnota
Default value:	False

az image builder delete

Odstraňte šablonu tvůrce obrázků.

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

Příklady

Odstraňte šablonu tvůrce obrázků. (autogenerated)

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

Volitelné parametry

Následující parametry jsou volitelné, ale v závislosti na kontextu se může stát, že se jeden nebo více vyžaduje, aby se příkaz úspěšně spustil.

--ids

Jedno nebo více ID prostředků (oddělené 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 buď argumenty --ids, nebo jiné argumenty 'ID prostředku'.

Vlastnost	Hodnota
Skupina parametrů:	Resource Id Arguments

--name -n

Název šablony obrázku

Vlastnost	Hodnota
Skupina parametrů:	Resource Id Arguments

--resource-group -g

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

Vlastnost	Hodnota
Skupina parametrů:	Resource Id Arguments

--subscription

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

Vlastnost	Hodnota
Skupina parametrů:	Resource Id Arguments

Globální parametry

--debug

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

Vlastnost	Hodnota
Default value:	False

--help -h

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

--only-show-errors

Zobrazit pouze chyby, potlačit upozornění.

Vlastnost	Hodnota
Default value:	False

--output -o

Výstupní formát

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

--query

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

--verbose

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

Vlastnost	Hodnota
Default value:	False

az image builder list

Vypsat šablony tvůrce obrázků

az image builder list [--resource-group]

Volitelné parametry

Následující parametry jsou volitelné, ale v závislosti na kontextu se může stát, že se jeden nebo více vyžaduje, aby se příkaz úspěšně spustil.

--resource-group -g

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

Globální parametry

--debug

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

Vlastnost	Hodnota
Default value:	False

--help -h

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

--only-show-errors

Zobrazit pouze chyby, potlačit upozornění.

Vlastnost	Hodnota
Default value:	False

--output -o

Výstupní formát

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

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

Vlastnost	Hodnota
Default value:	False

az image builder run

Vytvořte šablonu tvůrce obrázků.

az image builder run [--ids]
                     [--name]
                     [--no-wait]
                     [--resource-group]
                     [--subscription]

Příklady

Spusťte spuštění sestavení šablony a počkejte na dokončení.

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

Volitelné parametry

Následující parametry jsou volitelné, ale v závislosti na kontextu se může stát, že se jeden nebo více vyžaduje, aby se příkaz úspěšně spustil.

--ids

Jedno nebo více ID prostředků (oddělené 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 buď argumenty --ids, nebo jiné argumenty 'ID prostředku'.

Vlastnost	Hodnota
Skupina parametrů:	Resource Id Arguments

--name -n

Název šablony obrázku

Vlastnost	Hodnota
Skupina parametrů:	Resource Id Arguments

--no-wait

Nečekejte na dokončení dlouhotrvající operace.

Vlastnost	Hodnota
Default value:	False

--resource-group -g

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

Vlastnost	Hodnota
Skupina parametrů:	Resource Id Arguments

--subscription

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

Vlastnost	Hodnota
Skupina parametrů:	Resource Id Arguments

Globální parametry

--debug

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

Vlastnost	Hodnota
Default value:	False

--help -h

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

--only-show-errors

Zobrazit pouze chyby, potlačit upozornění.

Vlastnost	Hodnota
Default value:	False

--output -o

Výstupní formát

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

--query

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

--verbose

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

Vlastnost	Hodnota
Default value:	False

az image builder show

Zobrazí šablonu tvůrce obrázků.

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

Příklady

Zobrazení šablony tvůrce obrázků (automaticky vygenerováno)

az image builder show --name mytemplate  --resource-group my-group

Volitelné parametry

Následující parametry jsou volitelné, ale v závislosti na kontextu se může stát, že se jeden nebo více vyžaduje, aby se příkaz úspěšně spustil.

--ids

Jedno nebo více ID prostředků (oddělené 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 buď argumenty --ids, nebo jiné argumenty 'ID prostředku'.

Vlastnost	Hodnota
Skupina parametrů:	Resource Id Arguments

--name -n

Název šablony obrázku

Vlastnost	Hodnota
Skupina parametrů:	Resource Id Arguments

--resource-group -g

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

Vlastnost	Hodnota
Skupina parametrů:	Resource Id Arguments

--subscription

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

Vlastnost	Hodnota
Skupina parametrů:	Resource Id Arguments

Globální parametry

--debug

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

Vlastnost	Hodnota
Default value:	False

--help -h

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

--only-show-errors

Zobrazit pouze chyby, potlačit upozornění.

Vlastnost	Hodnota
Default value:	False

--output -o

Výstupní formát

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

--query

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

--verbose

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

Vlastnost	Hodnota
Default value:	False

az image builder show-runs

Zobrazí výstupy spuštění šablony tvůrce obrázků.

az image builder show-runs [--ids]
                           [--name]
                           [--output-name]
                           [--resource-group]
                           [--subscription]

Příklady

Spusťte spuštění sestavení šablony a zobrazte jeho výstupy spuštění.

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

Volitelné parametry

Následující parametry jsou volitelné, ale v závislosti na kontextu se může stát, že se jeden nebo více vyžaduje, aby se příkaz úspěšně spustil.

--ids

Jedno nebo více ID prostředků (oddělené 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 buď argumenty --ids, nebo jiné argumenty 'ID prostředku'.

Vlastnost	Hodnota
Skupina parametrů:	Resource Id Arguments

--name -n

Název šablony obrázku

Vlastnost	Hodnota
Skupina parametrů:	Resource Id Arguments

--output-name

Název výstupu spuštění tvůrce imagí

--resource-group -g

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

Vlastnost	Hodnota
Skupina parametrů:	Resource Id Arguments

--subscription

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

Vlastnost	Hodnota
Skupina parametrů:	Resource Id Arguments

Globální parametry

--debug

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

Vlastnost	Hodnota
Default value:	False

--help -h

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

--only-show-errors

Zobrazit pouze chyby, potlačit upozornění.

Vlastnost	Hodnota
Default value:	False

--output -o

Výstupní formát

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

--query

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

--verbose

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

Vlastnost	Hodnota
Default value:	False

az image builder update

Aktualizujte šablonu tvůrce obrázků.

Aktualizace šablon tvůrce imagí se v současné době nepodporuje. Tento příkaz lze použít ve spojení s parametrem --defer k aktualizaci objektu šablony obrázku v mezipaměti rozhraní příkazového řádku. Bez --defer it načte zadanou šablonu image z mezipaměti a odešle požadavek do Azure k vytvoření šablony image.

az image builder update [--add]
                        [--defer]
                        [--force-string]
                        [--ids]
                        [--name]
                        [--remove]
                        [--resource-group]
                        [--set]
                        [--subscription]

Příklady

Vytvořte prostředek šablony z objektu šablony v mezipaměti rozhraní příkazového řádku. Další informace najdete v tématu "az image builder create / output add / customizer add --help" a "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

Volitelné parametry

Následující parametry jsou volitelné, ale v závislosti na kontextu se může stát, že se jeden nebo více vyžaduje, aby se příkaz úspěšně spustil.

--add

Přidejte objekt do seznamu objektů zadáním párů cest a klíč-hodnota. Příklad: --add property.listProperty <key=value, string or JSON string>.

Vlastnost	Hodnota
Skupina parametrů:	Generic Update Arguments
Default value:	[]

--defer

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

--force-string

Při použití set nebo add zachovávejte řetězcové literály místo pokusu o převod na JSON.

Vlastnost	Hodnota
Skupina parametrů:	Generic Update Arguments
Default value:	False

--ids

Jedno nebo více ID prostředků (oddělené 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 buď argumenty --ids, nebo jiné argumenty 'ID prostředku'.

Vlastnost	Hodnota
Skupina parametrů:	Resource Id Arguments

--name -n

Název šablony obrázku

Vlastnost	Hodnota
Skupina parametrů:	Resource Id Arguments

--remove

Odeberte vlastnost nebo prvek ze seznamu. Příklad: --remove property.list <indexToRemove> OR --remove propertyToRemove.

Vlastnost	Hodnota
Skupina parametrů:	Generic Update Arguments
Default value:	[]

--resource-group -g

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

Vlastnost	Hodnota
Skupina parametrů:	Resource Id Arguments

--set

Aktualizujte objekt zadáním cesty vlastnosti a hodnoty, která se má nastavit. Příklad: --set property1.property2=<value>.

Vlastnost	Hodnota
Skupina parametrů:	Generic Update Arguments
Default value:	[]

--subscription

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

Vlastnost	Hodnota
Skupina parametrů:	Resource Id Arguments

Globální parametry

--debug

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

Vlastnost	Hodnota
Default value:	False

--help -h

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

--only-show-errors

Zobrazit pouze chyby, potlačit upozornění.

Vlastnost	Hodnota
Default value:	False

--output -o

Výstupní formát

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

--query

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

--verbose

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

Vlastnost	Hodnota
Default value:	False

az image builder wait

Umístěte rozhraní příkazového řádku do stavu čekání, dokud nebude splněna podmínka šablony.

az image builder wait [--created]
                      [--custom]
                      [--deleted]
                      [--exists]
                      [--ids]
                      [--interval]
                      [--name]
                      [--resource-group]
                      [--subscription]
                      [--timeout]
                      [--updated]

Příklady

Spusťte spuštění sestavení šablony a počkejte na dokončení.

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

Volitelné parametry

Následující parametry jsou volitelné, ale v závislosti na kontextu se může stát, že se jeden nebo více vyžaduje, aby se příkaz úspěšně spustil.

--created

Počkejte na vytvoření s 'provisioningState' v 'Succeeded'.

Vlastnost	Hodnota
Skupina parametrů:	Wait Condition Arguments
Default value:	False

--custom

Počkejte, až podmínka splňuje vlastní dotaz JMESPath. Například provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

Vlastnost	Hodnota
Skupina parametrů:	Wait Condition Arguments

--deleted

Počkejte na odstranění.

Vlastnost	Hodnota
Skupina parametrů:	Wait Condition Arguments
Default value:	False

--exists

Počkejte, až prostředek existuje.

Vlastnost	Hodnota
Skupina parametrů:	Wait Condition Arguments
Default value:	False

--ids

Jedno nebo více ID prostředků (oddělené 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 buď argumenty --ids, nebo jiné argumenty 'ID prostředku'.

Vlastnost	Hodnota
Skupina parametrů:	Resource Id Arguments

--interval

Interval dotazování v sekundách

Vlastnost	Hodnota
Skupina parametrů:	Wait Condition Arguments
Default value:	30

--name -n

Název šablony obrázku

Vlastnost	Hodnota
Skupina parametrů:	Resource Id Arguments

--resource-group -g

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

Vlastnost	Hodnota
Skupina parametrů:	Resource Id Arguments

--subscription

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

Vlastnost	Hodnota
Skupina parametrů:	Resource Id Arguments

--timeout

Maximální čekání v sekundách.

Vlastnost	Hodnota
Skupina parametrů:	Wait Condition Arguments
Default value:	3600

--updated

Počkejte, dokud se neaktualizuje stav zřizování ve stavu Úspěch.

Vlastnost	Hodnota
Skupina parametrů:	Wait Condition Arguments
Default value:	False

Globální parametry

--debug

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

Vlastnost	Hodnota
Default value:	False

--help -h

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

--only-show-errors

Zobrazit pouze chyby, potlačit upozornění.

Vlastnost	Hodnota
Default value:	False

--output -o

Výstupní formát

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

--query

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

--verbose

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

Vlastnost	Hodnota
Default value:	False