az image builder customizer

Aangepaste sjabloonaanpassers voor installatiekopieën beheren.

Opdracht

Name	Description	Type	Status
az image builder customizer add	Voeg een opbouwfunctie voor afbeeldingen toe aan een sjabloon voor de opbouwfunctie voor afbeeldingen.	Core	GA
az image builder customizer clear	Verwijder alle aanpassers van de opbouwfunctie voor afbeeldingen uit een sjabloon voor de opbouwfunctie voor afbeeldingen.	Core	GA
az image builder customizer remove	Een opbouwfunctie voor afbeeldingen verwijderen uit een sjabloon voor de opbouwfunctie voor afbeeldingen.	Core	GA

az image builder customizer add

Voeg een opbouwfunctie voor afbeeldingen toe aan een sjabloon voor de opbouwfunctie voor afbeeldingen.

Moet worden gebruikt met --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]

Voorbeelden

Een inline shellaanpasser toevoegen aan een afbeeldingssjabloon in de cli-objectcache

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

Een bestandsaanpasser toevoegen aan een afbeeldingssjabloon in de cli-objectcache

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

Een windows-herstartaanpasser toevoegen aan een afbeeldingssjabloon in de cli-objectcache

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

Voeg een Windows Update-aanpasser toe aan een afbeeldingssjabloon in de cli-objectcache.

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

Vereiste parameters

--customizer-name

Naam van de aanpasser.

--type -t

Het type aanpasser dat moet worden toegevoegd aan de afbeeldingssjabloon.

Eigenschap	Waarde
Geaccepteerde waarden:	file, powershell, shell, windows-restart, windows-update

Optionele parameters

De volgende parameters zijn optioneel, maar afhankelijk van de context kunnen een of meer parameters vereist zijn om de opdracht uit te voeren.

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

--dest-path

Het absolute doelpad waarnaar het bestand dat is opgegeven in --file-source, wordt gedownload naar de afbeelding.

Eigenschap	Waarde
Parametergroep:	File Arguments

--exit-codes -e

Door spaties gescheiden lijst met geldige afsluitcodes, als gehele getallen.

Eigenschap	Waarde
Parametergroep:	Powershell Arguments

--file-source

De URI van het bestand dat moet worden gedownload naar de afbeelding. Het kan een github-koppeling, SAS-URI voor Azure Storage, enzovoort zijn.

Eigenschap	Waarde
Parametergroep:	File Arguments

--filters

Door spaties gescheiden filters om updates te selecteren die moeten worden toegepast. Laat de lege matrix weg of geef deze op om de standaardwaarde te gebruiken (geen filter).

Eigenschap	Waarde
Parametergroep:	Windows Update Arguments

--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. U moet ofwel --id's of andere 'Resource Id'-argumenten opgeven.

Eigenschap	Waarde
Parametergroep:	Resource Id Arguments

--inline-script

Door spaties gescheiden lijst met regels voor inlinescripts waarmee u de afbeelding kunt aanpassen.

Eigenschap	Waarde
Parametergroep:	Shell and Powershell Arguments

--name -n

De naam van de afbeeldingssjabloon.

Eigenschap	Waarde
Parametergroep:	Resource Id Arguments

--resource-group -g

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

Eigenschap	Waarde
Parametergroep:	Resource Id Arguments

--restart-check-command

Opdracht om te controleren of opnieuw opstarten is voltooid.

Eigenschap	Waarde
Parametergroep:	Windows Restart Arguments

--restart-command

Opdracht voor het uitvoeren van de herstartbewerking.

Eigenschap	Waarde
Parametergroep:	Windows Restart Arguments

--restart-timeout

Time-out voor opnieuw opstarten die is opgegeven als een tekenreeks die bestaat uit een grootte en eenheid, bijvoorbeeld '5 min. (5 minuten) of '2h' (2 uur).

Eigenschap	Waarde
Parametergroep:	Windows Restart Arguments
Default value:	5m

--script-url

URL van het script waarmee de afbeelding moet worden aangepast. De URL moet openbaar toegankelijk zijn.

Eigenschap	Waarde
Parametergroep:	Shell and Powershell Arguments

--search-criteria

Criteria voor het zoeken naar updates. Laat de lege tekenreeks weg of geef deze op om de standaardreeks te gebruiken (zoek alles). Raadpleeg de bovenstaande koppeling voor voorbeelden en gedetailleerde beschrijving van dit veld.

Eigenschap	Waarde
Parametergroep:	Windows Update Arguments

--subscription

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

Eigenschap	Waarde
Parametergroep:	Resource Id Arguments

--update-limit

Maximum aantal updates dat tegelijk moet worden toegepast. Laat 0 weg of geef 0 op om de standaardwaarde te gebruiken (1000).

Eigenschap	Waarde
Parametergroep:	Windows Update Arguments

Globale parameters

--debug

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

Eigenschap	Waarde
Default value:	False

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap	Waarde
Default value:	False

--output -o

Uitvoerindeling.

Eigenschap	Waarde
Default value:	json
Geaccepteerde waarden:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--verbose

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

Eigenschap	Waarde
Default value:	False