Delen via

az image builder customizer

  • Referentie

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.

 Kern GA
az image builder customizer clear

Verwijder alle aanpassers van de opbouwfunctie voor afbeeldingen uit een sjabloon voor de opbouwfunctie voor afbeeldingen.

 Kern GA
az image builder customizer remove

Een opbouwfunctie voor afbeeldingen verwijderen uit een sjabloon voor de opbouwfunctie voor afbeeldingen.

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

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

Optionele parameters

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

--exit-codes -e

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

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

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

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

--inline-script

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

--name -n

De naam van de afbeeldingssjabloon.

--resource-group -g

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

--restart-check-command

Opdracht om te controleren of opnieuw opstarten is voltooid.

--restart-command

Opdracht voor het uitvoeren van de herstartbewerking.

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

Default value: 5m
--script-url

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

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

--subscription

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

--update-limit

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

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
Default value: json
--query

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

--subscription

Naam of id van 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 customizer clear

Verwijder alle aanpassers van de opbouwfunctie voor afbeeldingen uit een sjabloon voor de opbouwfunctie voor afbeeldingen.

Moet worden gebruikt met --defer.

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

Optionele parameters

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

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

--name -n

De naam van de afbeeldingssjabloon.

--resource-group -g

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

--subscription

Naam of id van 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
Default value: json
--query

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

--subscription

Naam of id van 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 customizer remove

Een opbouwfunctie voor afbeeldingen verwijderen uit een sjabloon voor de opbouwfunctie voor afbeeldingen.

Moet worden gebruikt met --defer.

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

Vereiste parameters

--customizer-name

Naam van de aanpasser.

Optionele parameters

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

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

--name -n

De naam van de afbeeldingssjabloon.

--resource-group -g

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

--subscription

Naam of id van 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
Default value: json
--query

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

--subscription

Naam of id van 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.