Dela via

az image builder customizer

  • Referens

Hantera mallanpassare för avbildningsverktyget.

Kommandon

Name Description Typ Status
az image builder customizer add

Lägg till en anpassning av avbildningsverktyget i en mall för avbildningsverktyget.

 Kärna GA
az image builder customizer clear

Ta bort alla anpassningar av avbildningsverktyget från en mall för bildverktyget.

 Kärna GA
az image builder customizer remove

Ta bort en anpassning av bildverktyget från en mall för bildverktyget.

 Kärna GA

az image builder customizer add

Lägg till en anpassning av avbildningsverktyget i en mall för avbildningsverktyget.

Måste användas med --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]

Exempel

Lägga till en inline shell-anpassning i en bildmall i cli-objektcachen

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

Lägga till en filanpassare i en bildmall i cli-objektcachen

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

Lägga till en windows-omstartsanpassare i en avbildningsmall i cli-objektcachen

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

Lägg till en windows update-anpassning i en bildmall i cli-objektcacheminnet.

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

Obligatoriska parametrar

--customizer-name

Namnet på anpassningen.

--type -t

Typ av anpassning som ska läggas till i bildmallen.

Godkända värden: file, powershell, shell, windows-restart, windows-update

Valfria parametrar

--defer

Lagra objektet tillfälligt i den lokala cachen i stället för att skicka till Azure. Använd az cache kommandon för att visa/rensa.

--dest-path

Den absoluta målsökvägen där filen som anges i --file-source laddas ned till i bilden.

--exit-codes -e

Blankstegsavgränsad lista över giltiga slutkoder, som heltal.

--file-source

URI:n för filen som ska laddas ned till avbildningen. Det kan vara en github-länk, SAS-URI för Azure Storage osv.

--filters

Utrymmesavgränsade filter för att välja uppdateringar som ska tillämpas. Utelämna eller ange en tom matris för att använda standardvärdet (inget filter).

--ids

Ett eller flera resurs-ID:t (utrymmesavgränsade). Det bör vara ett fullständigt resurs-ID som innehåller all information om 'resurs-ID' argumenten. Du bör ange antingen --id eller andra "Resurs-ID"-argument.

--inline-script

Blankstegsavgränsad lista över infogade skriptrader att anpassa avbildningen med.

--name -n

Namnet på bildmallen.

--resource-group -g

Namn på resursgrupp. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>.

--restart-check-command

Kommando för att kontrollera att omstarten lyckades.

--restart-command

Kommando för att köra omstartsåtgärden.

--restart-timeout

Timeout för omstart anges som en sträng som består av en storlek och enhet, t.ex. "5m" (5 minuter) eller "2h" (2 timmar).

Standardvärde: 5m
--script-url

URL för skript för att anpassa avbildningen med. URL:en måste vara offentligt tillgänglig.

--search-criteria

Villkor för att söka efter uppdateringar. Utelämna eller ange en tom sträng för att använda standardvärdet (sök efter alla). Se länken ovan för exempel och detaljerad beskrivning av det här fältet.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--update-limit

Maximalt antal uppdateringar som ska tillämpas åt gången. Utelämna eller ange 0 för att använda standardvärdet (1 000).

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az image builder customizer clear

Ta bort alla anpassningar av avbildningsverktyget från en mall för bildverktyget.

Måste användas med --defer.

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

Valfria parametrar

--defer

Lagra objektet tillfälligt i den lokala cachen i stället för att skicka till Azure. Använd az cache kommandon för att visa/rensa.

--ids

Ett eller flera resurs-ID:t (utrymmesavgränsade). Det bör vara ett fullständigt resurs-ID som innehåller all information om 'resurs-ID' argumenten. Du bör ange antingen --id eller andra "Resurs-ID"-argument.

--name -n

Namnet på bildmallen.

--resource-group -g

Namn på resursgrupp. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az image builder customizer remove

Ta bort en anpassning av bildverktyget från en mall för bildverktyget.

Måste användas med --defer.

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

Obligatoriska parametrar

--customizer-name

Namnet på anpassningen.

Valfria parametrar

--defer

Lagra objektet tillfälligt i den lokala cachen i stället för att skicka till Azure. Använd az cache kommandon för att visa/rensa.

--ids

Ett eller flera resurs-ID:t (utrymmesavgränsade). Det bör vara ett fullständigt resurs-ID som innehåller all information om 'resurs-ID' argumenten. Du bör ange antingen --id eller andra "Resurs-ID"-argument.

--name -n

Namnet på bildmallen.

--resource-group -g

Namn på resursgrupp. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.