az image builder customizer

Sjabloon customizers voor Image Builder beheren.

Opdracht

az image builder customizer add

Voeg een aanwijzer voor de opbouw van afbeeldingen toe aan een sjabloon voor de opbouw van afbeeldingen.

az image builder customizer clear

Verwijder alle aanpasers voor de opbouw van afbeeldingen uit een sjabloon voor de opbouw van afbeeldingen.

az image builder customizer remove

Verwijder een aanwijzer voor de opbouw van afbeeldingen uit een sjabloon voor de opbouw van afbeeldingen.

az image builder customizer add

Voeg een aanwijzer voor de opbouw van afbeeldingen toe aan een sjabloon voor de opbouw van 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 shell-aanwijzer toevoegen aan een afbeeldingssjabloon in de cli-objectcache

az image builder customizer add -n mytemplate -g my-group \
    --inline-script "sudo mkdir /buildArtifacts" \
                    "sudo cp /tmp/index.html /buildArtifacts/index.html" \
    --customizer-name shell-script-inline --type shell --defer

Een bestandssjabloon toevoegen aan een afbeeldingssjabloon in de cli-objectcache

az image builder customizer add -n mytemplate -g my-group \
    --customizer-name my-file --type file \
    --file-source "https://my-remote-file.html" --dest-path "/tmp/index.html" --defer

Een windows-aanwijzer voor opnieuw opstarten toevoegen aan een afbeeldingssjabloon in de cli-objectcache

az image builder customizer add -n mytemplate -g my-group \
--customizer-name shell-script-url \
--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-aanwijzer toe aan een afbeeldingssjabloon in de cli-objectcache.

az image builder customizer add -n mytemplate -g my-group --customizer-name win_update --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 aanwijzer.

--type -t

Het type aanwijzer 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 clearen.

--dest-path

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

--exit-codes -e

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

--file-source

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

--filters

Spatiefilters met scheidingstekens om updates te selecteren die moeten worden toegepast. Laat een lege matrix weg of geef deze op om de standaardinstelling (geen filter) te gebruiken.

--ids

Een of meer resource-ID's (door spaties scheidingstekens). Dit moet een volledige resource-id zijn die alle gegevens van de argumenten 'Resource-id' bevat. U moet --id's of andere argumenten voor resource-id's verstrekken.

--inline-script

Door spaties gescheiden lijst met inline scriptregels om de afbeelding mee aan te passen.

--name -n

De naam van de afbeeldingssjabloon.

--resource-group -g

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

--restart-check-command

Opdracht om te controleren of opnieuw opstarten is geslaagd.

--restart-command

Opdracht om de herstartbewerking uit te voeren.

--restart-timeout

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

standaardwaarde: 5m
--script-url

URL van script om de afbeelding mee aan te passen. De URL moet openbaar toegankelijk zijn.

--search-criteria

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

--subscription

Naam of id van het 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 standaardinstelling (1000) te gebruiken.

az image builder customizer clear

Verwijder alle aanpasers voor de opbouw van afbeeldingen uit een sjabloon voor de opbouw van 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 clearen.

--ids

Een of meer resource-ID's (door spaties scheidingstekens). Dit moet een volledige resource-id zijn die alle gegevens van de argumenten 'Resource-id' bevat. U moet --id's of andere argumenten voor resource-id's verstrekken.

--name -n

De naam van de afbeeldingssjabloon.

--resource-group -g

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

--subscription

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

az image builder customizer remove

Verwijder een aanwijzer voor de opbouw van afbeeldingen uit een sjabloon voor de opbouw van 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 aanwijzer.

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

--ids

Een of meer resource-ID's (door spaties scheidingstekens). Dit moet een volledige resource-id zijn die alle gegevens van de argumenten 'Resource-id' bevat. U moet --id's of andere argumenten voor resource-id's verstrekken.

--name -n

De naam van de afbeeldingssjabloon.

--resource-group -g

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

--subscription

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