az image builder customizer

Képszerkesztő-sablon testreszabásának kezelése.

Parancsok

Name	Description	Típus	Állapot
az image builder customizer add	Képszerkesztő-testreszabó hozzáadása képszerkesztő sablonhoz.	Alapvető	FE
az image builder customizer clear	Távolítsa el az összes képszerkesztő-testreszabót egy képszerkesztő sablonból.	Alapvető	FE
az image builder customizer remove	Képszerkesztő-testreszabó eltávolítása képszerkesztő-sablonból.	Alapvető	FE

az image builder customizer add

Képszerkesztő-testreszabó hozzáadása képszerkesztő sablonhoz.

A --halasztással együtt kell használni.

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]

Példák

Beágyazott rendszerhéj-testreszabó hozzáadása képsablonhoz a parancssori objektum gyorsítótárában

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

Fájlszabó hozzáadása képsablonhoz a parancssori objektum gyorsítótárában

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

Windows újraindítási testreszabó hozzáadása egy képsablonhoz a parancssori objektum gyorsítótárában

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

Windows Update-testreszabó hozzáadása egy képsablonhoz a parancssori objektum gyorsítótárában.

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

Kötelező paraméterek

--customizer-name

A testreszabó neve.

--type -t

A képsablonhoz hozzáadandó testreszabó típusa.

Elfogadott értékek: file, powershell, shell, windows-restart, windows-update

Opcionális paraméterek

--defer

Ideiglenesen tárolja az objektumot a helyi gyorsítótárban az Azure-ba való küldés helyett. Parancsok használatával az cache megtekintheti vagy törölheti a nézetet.

--dest-path

Az abszolút cél elérési útja, ahová a --file-source fájlban megadott fájl le lesz töltve a képen.

--exit-codes -e

Az érvényes kilépési kódok szóközzel elválasztott listája egész számként.

--file-source

A képbe letöltendő fájl URI-ja. Lehet github-hivatkozás, SAS URI az Azure Storage-hoz stb.

--filters

Szóközzel tagolt szűrők az alkalmazni kívánt frissítések kiválasztásához. Kihagyhatja vagy megadhatja az alapértelmezett (szűrő nélküli) üres tömböt.

--ids

Egy vagy több erőforrásazonosító (szóközzel tagolt). Teljes erőforrás-azonosítónak kell lennie, amely tartalmazza az "Erőforrás-azonosító" argumentumok összes információját. Adjon meg --ids vagy más "Erőforrás-azonosító" argumentumot.

--inline-script

A beágyazott szkriptvonalak szóközzel elválasztott listája a kép testreszabásához.

--name -n

A képsablon neve.

--resource-group -g

Az erőforráscsoport neve. Az alapértelmezett csoportot konfigurálhatja a következővel az configure --defaults group=<name>: .

--restart-check-command

Parancs az újraindítás sikerességének ellenőrzéséhez.

--restart-command

Az újraindítási művelet végrehajtására vonatkozó parancs.

--restart-timeout

Az újraindítási időtúllépés egy nagyságból és egységből álló sztringként van megadva, például "5 m" (5 perc) vagy "2 óra" (2 óra).

Alapértelmezett érték: 5m

--script-url

A kép testreszabásához használt szkript URL-címe. Az URL-címnek nyilvánosan hozzáférhetőnek kell lennie.

--search-criteria

A frissítések keresésének feltételei. Hagyja ki vagy adja meg az alapértelmezett (keresés az összesben) üres sztringet. A fenti hivatkozásban példákat és a mező részletes leírását találja.

--subscription

Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést konfigurálhatja a következővel az account set -s NAME_OR_ID: .

--update-limit

Egyszerre alkalmazható frissítések maximális száma. Hagyja ki vagy adja meg a 0 értéket az alapértelmezett (1000) használatához.

Globális paraméterek

--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

--output -o

Kimeneti formátum.

Elfogadott értékek: json, jsonc, none, table, tsv, yaml, yamlc

Alapértelmezett érték: json

--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést konfigurálhatja a következővel az account set -s NAME_OR_ID: .

--verbose

A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

az image builder customizer clear

Távolítsa el az összes képszerkesztő-testreszabót egy képszerkesztő sablonból.

A --halasztással együtt kell használni.

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

Opcionális paraméterek

--defer

Ideiglenesen tárolja az objektumot a helyi gyorsítótárban az Azure-ba való küldés helyett. Parancsok használatával az cache megtekintheti vagy törölheti a nézetet.

--ids

Egy vagy több erőforrásazonosító (szóközzel tagolt). Teljes erőforrás-azonosítónak kell lennie, amely tartalmazza az "Erőforrás-azonosító" argumentumok összes információját. Adjon meg --ids vagy más "Erőforrás-azonosító" argumentumot.

--name -n

A képsablon neve.

--resource-group -g

Az erőforráscsoport neve. Az alapértelmezett csoportot konfigurálhatja a következővel az configure --defaults group=<name>: .

--subscription

Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést konfigurálhatja a következővel az account set -s NAME_OR_ID: .

Globális paraméterek

--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

--output -o

Kimeneti formátum.

Elfogadott értékek: json, jsonc, none, table, tsv, yaml, yamlc

Alapértelmezett érték: json

--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést konfigurálhatja a következővel az account set -s NAME_OR_ID: .

--verbose

A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

az image builder customizer remove

Képszerkesztő-testreszabó eltávolítása képszerkesztő-sablonból.

A --halasztással együtt kell használni.

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

Kötelező paraméterek

--customizer-name

A testreszabó neve.

Opcionális paraméterek

--defer

Ideiglenesen tárolja az objektumot a helyi gyorsítótárban az Azure-ba való küldés helyett. Parancsok használatával az cache megtekintheti vagy törölheti a nézetet.

--ids

Egy vagy több erőforrásazonosító (szóközzel tagolt). Teljes erőforrás-azonosítónak kell lennie, amely tartalmazza az "Erőforrás-azonosító" argumentumok összes információját. Adjon meg --ids vagy más "Erőforrás-azonosító" argumentumot.

--name -n

A képsablon neve.

--resource-group -g

Az erőforráscsoport neve. Az alapértelmezett csoportot konfigurálhatja a következővel az configure --defaults group=<name>: .

--subscription

Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést konfigurálhatja a következővel az account set -s NAME_OR_ID: .

Globális paraméterek

--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

--output -o

Kimeneti formátum.

Elfogadott értékek: json, jsonc, none, table, tsv, yaml, yamlc

Alapértelmezett érték: json

--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést konfigurálhatja a következővel az account set -s NAME_OR_ID: .

--verbose

A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.