az image builder

Sjablonen voor de opbouwfunctie voor installatiekopieën beheren en bouwen.

Opdracht

Name	Description	Type	Status
az image builder cancel	Annuleer de langlopende build van de installatiekopieën op basis van de installatiekopieënsjabloon.	Basis	GA
az image builder create	Maak een sjabloon voor de opbouwfunctie voor afbeeldingen.	Basis	GA
az image builder customizer	Aangepaste sjabloonaanpassers voor installatiekopieën beheren.	Basis	GA
az image builder customizer add	Voeg een opbouwfunctie voor afbeeldingen toe aan een sjabloon voor de opbouwfunctie voor afbeeldingen.	Basis	GA
az image builder customizer clear	Verwijder alle aanpassers van de opbouwfunctie voor afbeeldingen uit een sjabloon voor de opbouwfunctie voor afbeeldingen.	Basis	GA
az image builder customizer remove	Een opbouwfunctie voor afbeeldingen verwijderen uit een sjabloon voor de opbouwfunctie voor afbeeldingen.	Basis	GA
az image builder delete	Sjabloon voor het maken van installatiekopieën verwijderen.	Basis	GA
az image builder error-handler	Fouthandler voor afbeeldingsbouwersjabloon beheren.	Basis	GA
az image builder error-handler add	Voeg een fouthandler toe aan een bestaande sjabloon voor de opbouwfunctie voor afbeeldingen.	Basis	GA
az image builder error-handler remove	Verwijder de fouthandler uit een bestaande sjabloon voor de opbouwfunctie voor afbeeldingen.	Basis	GA
az image builder error-handler show	Fouthandler van een bestaande sjabloon voor de opbouwfunctie voor afbeeldingen weergeven.	Basis	GA
az image builder identity	Identiteiten van een sjabloon voor de opbouwfunctie voor afbeeldingen beheren.	Basis	GA
az image builder identity assign	Beheerde identiteiten toevoegen aan een bestaande sjabloon voor het maken van afbeeldingen. Op dit moment wordt slechts één gebruikersidentiteit ondersteund.	Basis	GA
az image builder identity remove	Beheerde identiteiten verwijderen uit een bestaande sjabloon voor de opbouwfunctie voor afbeeldingen.	Basis	GA
az image builder identity show	Beheerde identiteiten van een sjabloon voor de opbouwfunctie voor afbeeldingen weergeven.	Basis	GA
az image builder list	Sjablonen voor de opbouwfunctie voor afbeeldingen weergeven.	Basis	GA
az image builder optimizer	Sjabloonoptimalisatie voor installatiekopieën beheren.	Basis	GA
az image builder optimizer add	Een optimizer toevoegen aan een bestaande sjabloon voor de opbouwfunctie voor afbeeldingen.	Basis	GA
az image builder optimizer remove	Optimizer verwijderen uit een bestaande sjabloon voor het maken van afbeeldingen.	Basis	GA
az image builder optimizer show	De optimalisatie van een bestaande sjabloon voor de opbouwfunctie voor afbeeldingen weergeven.	Basis	GA
az image builder optimizer update	Een optimizer bijwerken op basis van een bestaande sjabloon voor de opbouwfunctie voor afbeeldingen.	Basis	GA
az image builder output	Manage image builder template output distributors.	Basis	GA
az image builder output add	Voeg een uitvoerverdeler voor de opbouwfunctie voor afbeeldingen toe aan een sjabloon voor de opbouwfunctie voor afbeeldingen.	Basis	GA
az image builder output clear	Verwijder alle uitvoerdistributeurs van afbeeldingen uit een sjabloon voor de opbouwfunctie voor afbeeldingen.	Basis	GA
az image builder output remove	Verwijder een uitvoerdistributeur voor de opbouwfunctie voor afbeeldingen uit een sjabloon voor de opbouwfunctie voor afbeeldingen.	Basis	GA
az image builder output versioning	Uitvoerversie van image builder-sjabloon beheren.	Basis	GA
az image builder output versioning remove	Verwijder alle versiebeheeropties voor opgegeven uitvoer.	Basis	GA
az image builder output versioning set	Stel de uitvoerversie van de opbouwfunctie voor installatiekopieën in van een sjabloon voor de opbouwfunctie voor afbeeldingen.	Basis	GA
az image builder output versioning show	Versiebeheeropties weergeven voor opgegeven uitvoer.	Basis	GA
az image builder run	Bouw een sjabloon voor de opbouwfunctie voor afbeeldingen.	Basis	GA
az image builder show	Een sjabloon voor de opbouwfunctie voor afbeeldingen weergeven.	Basis	GA
az image builder show-runs	Uitvoer van een afbeeldingsbouwersjabloon weergeven.	Basis	GA
az image builder trigger	Sjabloontrigger voor installatiekopieën beheren.	Basis	GA
az image builder trigger create	Maak een trigger voor de opgegeven sjabloon voor de installatiekopieën van de virtuele machine.	Basis	GA
az image builder trigger delete	Verwijder een trigger voor de opgegeven sjabloon voor de installatiekopieën van de virtuele machine.	Basis	GA
az image builder trigger list	Geef alle triggers weer voor de opgegeven resource voor de afbeeldingssjabloon.	Basis	GA
az image builder trigger show	Haal de opgegeven trigger op voor de opgegeven resource van de afbeeldingssjabloon.	Basis	GA
az image builder trigger wait	Plaats de CLI in een wachtstatus totdat aan een voorwaarde is voldaan.	Basis	GA
az image builder update	Een sjabloon voor de opbouwfunctie voor afbeeldingen bijwerken.	Basis	GA
az image builder validator	Manage image builder template validate.	Basis	GA
az image builder validator add	Valideer een bestaande sjabloon voor de opbouwfunctie voor afbeeldingen.	Basis	GA
az image builder validator remove	Verwijder valideren uit een bestaande sjabloon voor de opbouwfunctie voor installatiekopieën.	Basis	GA
az image builder validator show	Valideer de validatie van een bestaande sjabloon voor de opbouwfunctie voor afbeeldingen.	Basis	GA
az image builder wait	Plaats de CLI in een wachtstatus totdat aan een voorwaarde van de sjabloon is voldaan.	Basis	GA

az image builder cancel

Annuleer de langlopende build van de installatiekopieën op basis van de installatiekopieënsjabloon.

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

Voorbeelden

An image build annuleren.

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

Optionele parameters

--ids

Een of meer resource-id's (met spatie gescheiden). Dit moet een volledige resource-id zijn die alle informatie over de argumenten Resource-id bevat. Geef de argumenten --id's of andere resource-id's op.

--name -n

De naam van de afbeeldingssjabloon.

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

Globale parameters

--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc

standaardwaarde: json

--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az image builder create

Maak een sjabloon voor de opbouwfunctie voor afbeeldingen.

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]

Voorbeelden

Maak een sjabloon voor de opbouwfunctie voor installatiekopieën op basis van een Ubuntu2204-installatiekopie. Distribueer deze als een beheerde installatiekopieën en een versie van een gedeelde installatiekopieëngalerie. Geef de id van de faseringsresourcegroep op als de installatiekopieënsjabloon die wordt gebruikt om de installatiekopieën te bouwen.

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

Maak een sjabloon voor de opbouwfunctie voor afbeeldingen met behulp van een afbeeldingssjabloonbestand.

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

[Geavanceerd] Maak een afbeeldingssjabloon met meerdere aanpassers en distributeurs met behulp van de objectcache van de CLI via --defer. Ondersteunt functies zoals: aanpasser en uitvoernamen, powershell-afsluitcodes, inlinescripts, windows opnieuw opstarten, bestandsaanpassers, artefacttags en vhd-uitvoerdistributeurs.

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

Vereiste parameters

--name -n

De naam van de afbeeldingssjabloon.

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

Optionele parameters

--build-timeout

De maximale duur die moet worden gewacht tijdens het bouwen van de afbeeldingssjabloon, in minuten. De standaardwaarde is 60.

--build-vm-identities

Optionele configuratie van het virtuele netwerk dat moet worden gebruikt voor het implementeren van de virtuele buildmachine in. Weglaten als er geen specifiek virtueel netwerk moet worden gebruikt.

--checksum

De SHA256-controlesom van de Red Hat ISO-installatiekopie.

--defer

Sla het object tijdelijk op in de lokale cache in plaats van naar Azure te verzenden. Gebruik az cache opdrachten om weer te geven/te wissen.

--identity

Lijst met door de gebruiker toegewezen identiteiten (naam of id, spatie gescheiden) van de afbeeldingssjabloon.

--image-source -i

De basisinstallatiekopieën die u wilt aanpassen. Moet een geldige URN, platforminstallatiekopiealias, Red Hat ISO-installatiekopie-URI, naam/id van beheerde installatiekopie of versie-id van gedeelde installatiekopie zijn.

waarde vanaf: az vm image list, az vm image show

--image-template

Lokaal pad of URL naar een afbeeldingssjabloonbestand. Wanneer u --image-template gebruikt, worden alle andere parameters genegeerd, behalve -g en -n. Naslaginformatie: https://docs.microsoft.com/azure/virtual-machines/linux/image-builder-json.

--location -l

Locatie. Waarden van: az account list-locations. U kunt de standaardlocatie configureren met behulp van az configure --defaults location=<location>.

--managed-image-destinations

Informatie over de distributeur van beheerde installatiekopieën. Door spaties gescheiden lijst met sleutel-waardeparen. Bijvoorbeeld "image_1=westus2 image_2=westus". Elke sleutel is de naam of resource-id van de beheerde installatiekopieën die moeten worden gemaakt. Elke waarde is de locatie van de afbeelding.

--no-wait

Wacht niet totdat de langdurige bewerking is voltooid.

standaardwaarde: False

--os-disk-size

Grootte van de besturingssysteemschijf in GB. Laat 0 weg of geef 0 op om de standaardschijfgrootte van het besturingssysteem van Azure te gebruiken.

--proxy-vm-size

Grootte van de virtuele machine die wordt gebruikt voor het bouwen, aanpassen en vastleggen van installatiekopieën (Standard_D1_v2 voor Gen1-installatiekopieën en Standard_D2ds_v4 voor Gen2-installatiekopieën).

--scripts

Door spaties gescheiden lijst met shell- of PowerShell-scripts om de installatiekopieën aan te passen. Elk script moet een openbaar toegankelijke URL zijn. Hiermee wordt het type script afgeleid van de bestandsextensie ('.sh' of '.ps1') of van het brontype. Meer opties voor aanpassen en flexibiliteit, zie: 'az image template customizer add'.

--shared-image-destinations

Informatie over de distributie van gedeelde installatiekopieëngalerie (sig). Door spaties gescheiden lijst met sleutel-waardeparen. Bijvoorbeeld "my_gallery_1/image_def_1=eastus,westus my_gallery_2/image_def_2=uksouth,canadaeast,francesouth.". Elke sleutel is de definitie-id van de sig-installatiekopieën of de naam van de sig-galerie en de definitie van de sig-installatiekopieën gescheiden door een '/'. Elke waarde is een door komma's gescheiden lijst met replicalocaties.

--staging-resource-group

De id van de faseringsresourcegroep in hetzelfde abonnement als de installatiekopieënsjabloon die wordt gebruikt om de installatiekopieën te bouwen.

--subnet

Naam of id van het subnet om de virtuele build-machine te implementeren.

--tags

Door spaties gescheiden tags: key[=value] [key[=value] ...]. Gebruik '' om bestaande tags te wissen.

--validator

Het type validatie dat u wilt gebruiken op de afbeelding. Shell kan bijvoorbeeld shellvalidatie zijn.

--vm-size

Grootte van de virtuele machine die wordt gebruikt voor het bouwen, aanpassen en vastleggen van installatiekopieën. Laat de lege tekenreeks weg of geef deze op om de standaardreeks te gebruiken (Standard_D1_v2).

--vnet

Naam van VNET voor het implementeren van de virtuele build-machine. U moet dit alleen opgeven wanneer het subnet een naam is.

Globale parameters

--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc

standaardwaarde: json

--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az image builder delete

Sjabloon voor het maken van installatiekopieën verwijderen.

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

Voorbeelden

Sjabloon voor het maken van installatiekopieën verwijderen. (automatisch gegenereerd)

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

Optionele parameters

--ids

Een of meer resource-id's (met spatie gescheiden). Dit moet een volledige resource-id zijn die alle informatie over de argumenten Resource-id bevat. Geef de argumenten --id's of andere resource-id's op.

--name -n

De naam van de afbeeldingssjabloon.

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

Globale parameters

--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc

standaardwaarde: json

--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az image builder list

Sjablonen voor de opbouwfunctie voor afbeeldingen weergeven.

az image builder list [--resource-group]

Optionele parameters

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

Globale parameters

--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc

standaardwaarde: json

--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az image builder run

Bouw een sjabloon voor de opbouwfunctie voor afbeeldingen.

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

Voorbeelden

Start de uitvoering van een sjabloonbuild en wacht totdat deze is voltooid.

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

Optionele parameters

--ids

Een of meer resource-id's (met spatie gescheiden). Dit moet een volledige resource-id zijn die alle informatie over de argumenten Resource-id bevat. Geef de argumenten --id's of andere resource-id's op.

--name -n

De naam van de afbeeldingssjabloon.

--no-wait

Wacht niet totdat de langdurige bewerking is voltooid.

standaardwaarde: False

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

Globale parameters

--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc

standaardwaarde: json

--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az image builder show

Een sjabloon voor de opbouwfunctie voor afbeeldingen weergeven.

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

Voorbeelden

Een sjabloon voor de opbouwfunctie voor afbeeldingen weergeven (automatisch gegenereerd)

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

Optionele parameters

--ids

Een of meer resource-id's (met spatie gescheiden). Dit moet een volledige resource-id zijn die alle informatie over de argumenten Resource-id bevat. Geef de argumenten --id's of andere resource-id's op.

--name -n

De naam van de afbeeldingssjabloon.

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

Globale parameters

--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc

standaardwaarde: json

--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az image builder show-runs

Uitvoer van een afbeeldingsbouwersjabloon weergeven.

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

Voorbeelden

Voer een build-uitvoering van een sjabloon uit en bekijk de uitvoer van de uitvoering.

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

Optionele parameters

--ids

Een of meer resource-id's (met spatie gescheiden). Dit moet een volledige resource-id zijn die alle informatie over de argumenten Resource-id bevat. Geef de argumenten --id's of andere resource-id's op.

--name -n

De naam van de afbeeldingssjabloon.

--output-name

Naam van de uitvoer van de opbouwfunctie voor installatiekopieën.

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

Globale parameters

--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc

standaardwaarde: json

--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az image builder update

Een sjabloon voor de opbouwfunctie voor afbeeldingen bijwerken.

Het bijwerken van sjablonen voor de opbouwfunctie voor afbeeldingen wordt momenteel niet ondersteund. Deze opdracht kan worden gebruikt in combinatie met --defer voor het bijwerken van een afbeeldingssjabloonobject in de CLI-cache. Zonder --uitstellen wordt de opgegeven installatiekopiesjabloon opgehaald uit de cache en wordt een aanvraag naar Azure verzonden om de installatiekopiesjabloon te maken.

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

Voorbeelden

Maak een sjabloonresource op basis van een sjabloonobject in de cli-cache. Zie 'az image builder create / output add / customizer add --help' en 'az cache -h' voor meer informatie

# 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

Optionele parameters

--add

Voeg een object toe aan een lijst met objecten door een pad- en sleutelwaardeparen op te geven. Voorbeeld: --add property.listProperty <key=value, string or JSON string>.

standaardwaarde: []

--defer

Sla het object tijdelijk op in de lokale cache in plaats van naar Azure te verzenden. Gebruik az cache opdrachten om weer te geven/te wissen.

--force-string

Wanneer u 'set' of 'toevoegen' gebruikt, behoudt u letterlijke tekenreeksen in plaats van te converteren naar JSON.

standaardwaarde: False

--ids

Een of meer resource-id's (met spatie gescheiden). Dit moet een volledige resource-id zijn die alle informatie over de argumenten Resource-id bevat. Geef de argumenten --id's of andere resource-id's op.

--name -n

De naam van de afbeeldingssjabloon.

--remove

Een eigenschap of element uit een lijst verwijderen. Voorbeeld: --remove property.list <indexToRemove> OF --remove propertyToRemove.

standaardwaarde: []

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

--set

Werk een object bij door een eigenschapspad en waarde op te geven die u wilt instellen. Voorbeeld: --set property1.property2=<value>.

standaardwaarde: []

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

Globale parameters

--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc

standaardwaarde: json

--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az image builder wait

Plaats de CLI in een wachtstatus totdat aan een voorwaarde van de sjabloon is voldaan.

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

Voorbeelden

Start de uitvoering van een sjabloonbuild en wacht totdat deze is voltooid.

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

Optionele parameters

--created

Wacht totdat u 'provisioningState' hebt gemaakt bij 'Succeeded'.

standaardwaarde: False

--custom

Wacht tot de voorwaarde voldoet aan een aangepaste JMESPath-query. Bijvoorbeeld provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Wacht totdat deze is verwijderd.

standaardwaarde: False

--exists

Wacht tot de resource bestaat.

standaardwaarde: False

--ids

Een of meer resource-id's (met spatie gescheiden). Dit moet een volledige resource-id zijn die alle informatie over de argumenten Resource-id bevat. Geef de argumenten --id's of andere resource-id's op.

--interval

Polling-interval in seconden.

standaardwaarde: 30

--name -n

De naam van de afbeeldingssjabloon.

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--timeout

Maximale wachttijd in seconden.

standaardwaarde: 3600

--updated

Wacht totdat deze is bijgewerkt met provisioningState op 'Succeeded'.

standaardwaarde: False

Globale parameters

--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc

standaardwaarde: json

--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.