az image builder

Képszerkesztő-sablonok kezelése és létrehozása.

Parancsok

Name	Description	Típus	Állapot
az image builder cancel	A képsablon alapján megszakíthatja a hosszú ideig futó rendszerkép-buildet.	Alapvető	FE
az image builder create	Hozzon létre egy képszerkesztő sablont.	Alapvető	FE
az image builder customizer	Képszerkesztő-sablon testreszabásának kezelése.	Alapvető	FE
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 delete	Képszerkesztő sablon törlése.	Alapvető	FE
az image builder error-handler	Képszerkesztő sablon hibakezelőjének kezelése.	Alapvető	FE
az image builder error-handler add	Hibakezelő hozzáadása meglévő képszerkesztő sablonhoz.	Alapvető	FE
az image builder error-handler remove	Hibakezelő eltávolítása meglévő képszerkesztő sablonból.	Alapvető	FE
az image builder error-handler show	Meglévő képszerkesztő-sablon hibakezelőjének megjelenítése.	Alapvető	FE
az image builder identity	Képszerkesztő-sablon identitásainak kezelése.	Alapvető	FE
az image builder identity assign	Felügyelt identitások hozzáadása meglévő képszerkesztő sablonhoz. Jelenleg csak egy felhasználói identitás támogatott.	Alapvető	FE
az image builder identity remove	Felügyelt identitások eltávolítása meglévő képszerkesztő sablonból.	Alapvető	FE
az image builder identity show	Képszerkesztő-sablon felügyelt identitásainak megjelenítése.	Alapvető	FE
az image builder list	Képszerkesztő-sablonok listázása.	Alapvető	FE
az image builder optimizer	Képszerkesztő sablonoptimalizáló kezelése.	Alapvető	FE
az image builder optimizer add	Optimalizáló hozzáadása meglévő képszerkesztő sablonhoz.	Alapvető	FE
az image builder optimizer remove	Az optimalizáló eltávolítása meglévő képszerkesztő sablonból.	Alapvető	FE
az image builder optimizer show	Meglévő képszerkesztő-sablon optimalizálójának megjelenítése.	Alapvető	FE
az image builder optimizer update	Optimalizáló frissítése meglévő képszerkesztő sablonból.	Alapvető	FE
az image builder output	Képszerkesztő sablon kimeneti forgalmazóinak kezelése.	Alapvető	FE
az image builder output add	Képszerkesztő kimeneti forgalmazó hozzáadása képszerkesztő sablonhoz.	Alapvető	FE
az image builder output clear	Távolítsa el az összes képszerkesztő kimeneti forgalmazót egy képszerkesztő sablonból.	Alapvető	FE
az image builder output remove	Távolítsa el a képszerkesztő kimeneti forgalmazót egy képszerkesztő sablonból.	Alapvető	FE
az image builder output versioning	Képszerkesztő sablon kimeneti verziószámozó kezelése.	Alapvető	FE
az image builder output versioning remove	Távolítsa el az összes verziószámozási beállítást a megadott kimeneteken.	Alapvető	FE
az image builder output versioning set	Állítsa be egy képszerkesztő sablon képszerkesztő kimeneti verziószámozóját.	Alapvető	FE
az image builder output versioning show	Verziószámozási beállítások megjelenítése a megadott kimeneteken.	Alapvető	FE
az image builder run	Képszerkesztő sablon létrehozása.	Alapvető	FE
az image builder show	Képszerkesztő sablon megjelenítése.	Alapvető	FE
az image builder show-runs	Képszerkesztő-sablon futtatási kimeneteinek megjelenítése.	Alapvető	FE
az image builder trigger	Képszerkesztő-sablon eseményindító kezelése.	Alapvető	FE
az image builder trigger create	Hozzon létre egy eseményindítót a megadott virtuálisgép-rendszerképsablonhoz.	Alapvető	FE
az image builder trigger delete	Törölje a megadott virtuálisgép-rendszerképsablon eseményindítóját.	Alapvető	FE
az image builder trigger list	Listázza a megadott képsablon-erőforrás összes eseményindítójának listáját.	Alapvető	FE
az image builder trigger show	Kérje le a megadott rendszerképsablon-erőforráshoz tartozó eseményindítót.	Alapvető	FE
az image builder trigger wait	Helyezze a parancssori felületet várakozási állapotba, amíg egy feltétel teljesül.	Alapvető	FE
az image builder update	Képszerkesztő-sablon frissítése.	Alapvető	FE
az image builder validator	Képszerkesztő-sablon ellenőrzése.	Alapvető	FE
az image builder validator add	Érvényesítés hozzáadása meglévő képszerkesztő sablonhoz.	Alapvető	FE
az image builder validator remove	Az ellenőrzés eltávolítása meglévő képszerkesztő sablonból.	Alapvető	FE
az image builder validator show	Meglévő képszerkesztő-sablon érvényesítésének megjelenítése.	Alapvető	FE
az image builder wait	Helyezze a parancssori felületet várakozási állapotba, amíg a sablon egy feltétele nem teljesül.	Alapvető	FE

az image builder cancel

A képsablon alapján megszakíthatja a hosszú ideig futó rendszerkép-buildet.

az image builder cancel [--ids]
                        [--name]
                        [--resource-group]
                        [--subscription]

Példák

Kép buildelésének megszakítása.

az image builder cancel -n mytemplate -g my-group

Opcionális paraméterek

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

Hozzon létre egy képszerkesztő sablont.

az image builder create --name
                        --resource-group
                        [--build-timeout]
                        [--build-vm-identities]
                        [--checksum]
                        [--defer]
                        [--identity]
                        [--image-source]
                        [--image-template]
                        [--location]
                        [--managed-image-destinations]
                        [--no-wait]
                        [--os-disk-size]
                        [--proxy-vm-size]
                        [--scripts]
                        [--shared-image-destinations]
                        [--staging-resource-group]
                        [--subnet]
                        [--tags]
                        [--validator]
                        [--vm-size]
                        [--vnet]

Példák

Hozzon létre egy képszerkesztő sablont egy Ubuntu2204-rendszerképből. Ossza el felügyelt képként és megosztott képgyűjtemény képverzióként. Adja meg az átmeneti erőforráscsoport azonosítóját a rendszerkép létrehozásához használni kívánt képsablonként.

scripts="https://my-script-url.net/customize_script.sh"
imagesource="Canonical:0001-com-ubuntu-server-jammy:22_04-lts-gen2:latest"

az image builder create --image-source $imagesource -n myTemplate -g myGroup \
    --scripts $scripts --managed-image-destinations image_1=westus \
    --shared-image-destinations my_shared_gallery/linux_image_def=westus,brazilsouth \
    --identity myIdentity --staging-resource-group myStagingResourceGroup

Képszerkesztő sablon létrehozása képsablonfájl használatával.

az image builder create -g my-group -n myTemplate --image-template filename

[Speciális] Hozzon létre egy képsablont több testreszabóval és terjesztővel a parancssori felület objektumgyorsítótárával a --hafer használatával. Olyan funkciókat támogat, mint a testreszabási és kimeneti nevek, a PowerShell kilépési kódjai, a beágyazott szkriptek, a Windows újraindítása, a fájlszabók, az összetevőcímkék és a vhd kimeneti forgalmazók.

script="https://my-script-url.com/customize_script.ps1"
imagesource="MicrosoftWindowsServer:WindowsServer:2019-Datacenter:2019.0.20190214"

# create and update template object in local cli cache. Defers put request to ARM
# Cache object ttl set via az configure.
az image builder create --image-source $imagesource -n myTemplate \
    -g myGroup --scripts $script --identity myIdentity --defer

# add customizers
az image builder customizer add -n myTemplate -g myGroup  \
    --customizer-name myPwshScript --exit-codes 0 1 --inline-script \
    "mkdir c:\buildActions" "echo Azure-Image-Builder-Was-Here \
     > c:\buildActions\Output.txt" --type powershell --defer

az image builder customizer add -n myTemplate -g myGroup \
    --customizer-name myFileCustomizer --type file \
    --file-source "https://my-file-source.net/file.txt"  \
    --dest-path "c:\buildArtifacts\file.txt" --defer

# add distributors
az image builder output add -n myTemplate -g myGroup --is-vhd \
    --output-name myWinImageVhd --artifact-tags "is_vhd=True" --defer

az image builder output add -n myTemplate -g myGroup \
    --output-name myWinImageManaged --managed-image winImage \
    --managed-image-location eastus \
    --artifact-tags "is_vhd=False" --defer

# Stop deferring put request to ARM. Create the template from the object cache.
# Cache object will be deleted.
az image builder update -n myTemplate -g myGroup

Kötelező paraméterek

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

Opcionális paraméterek

--build-timeout

A képsablon létrehozása során a várakozás maximális időtartama percekben. Az alapértelmezett érték 60.

--build-vm-identities

A virtuális hálózat opcionális konfigurációja a build virtuális gép üzembe helyezéséhez. Kihagyja, ha nincs szükség konkrét virtuális hálózatra.

--checksum

A Red Hat ISO-rendszerkép SHA256 ellenőrzőösszege.

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

--identity

A képsablon felhasználó által hozzárendelt identitásainak listája (név vagy azonosító, szóköz tagolt).

--image-source -i

A testre szabandó alaprendszerkép. Érvényes platformrendszerkép-URI-nak, platformrendszerkép-aliasnak, Red Hat ISO-lemezkép URI-jának, felügyelt kép nevének/azonosítójának vagy megosztott képverzió-azonosítójának kell lennie.

Érték forrása: az vm image list, az vm image show

--image-template

Képsablonfájl helyi elérési útja vagy URL-címe. A --image-template használata esetén a rendszer figyelmen kívül hagyja az összes többi paramétert, kivéve a -g és a -n paramétert. Hivatkozás: https://docs.microsoft.com/azure/virtual-machines/linux/image-builder-json.

--location -l

Tartózkodási hely beállításnál. Értékek: az account list-locations. Az alapértelmezett helyet a következővel az configure --defaults location=<location>konfigurálhatja: .

--managed-image-destinations

Felügyelt képkimenet terjesztői információi. Kulcs-érték párok szóközzel elválasztott listája. Pl. "image_1=westus2 image_2=westus". Minden kulcs a létrehozandó felügyelt rendszerkép neve vagy erőforrás-azonosítója. Minden érték a kép helye.

--no-wait

Ne várja meg, amíg a hosszú ideig futó művelet befejeződik.

Alapértelmezett érték: False

--os-disk-size

Az operációsrendszer-lemez mérete GB-ban. Hagyja ki vagy adja meg a 0 értéket az Azure alapértelmezett operációsrendszer-lemezméretének használatához.

--proxy-vm-size

A rendszerképek létrehozásához, testreszabásához és rögzítéséhez használt virtuális gép mérete (gen1-es és Standard_D2ds_v4 Gen2-rendszerképekhez Standard_D1_v2).

--scripts

A rendszerhéj- vagy PowerShell-szkriptek szóközzel elválasztott listája a rendszerkép testreszabásához. Minden szkriptnek nyilvánosan elérhető URL-címnek kell lennie. A szkript típusát a fájlkiterjesztésből ('.sh' vagy '.ps1' ) vagy a forrástípusból következteti. További testreszabási lehetőségek és rugalmasság: "az image template customizer add".

--shared-image-destinations

Megosztott képgyűjtemény (sig) kimeneti forgalmazói információi. Kulcs-érték párok szóközzel elválasztott listája. Pl. "my_gallery_1/image_def_1=eastus,westus my_gallery_2/image_def_2=uksouth,canadaeast,francesouth." Minden kulcs a sig képdefiníció azonosítója vagy a Sig-katalógus neve és a "/" által tagolt sig képdefiníció. Minden érték a replikahelyek vesszővel tagolt listája.

--staging-resource-group

Az átmeneti erőforráscsoport azonosítója ugyanabban az előfizetésben, mint a rendszerképsablon, amelyet a rendszerkép létrehozásához használnak.

--subnet

Az alhálózat neve vagy azonosítója a build virtuális gép üzembe helyezéséhez.

--tags

Szóközzel elválasztott címkék: key[=value] [key[=value] ...]. Meglévő címkék törlése a "" használatával.

--validator

A képen használni kívánt érvényesítés típusa. A "Shell" lehet például a rendszerhéj ellenőrzése.

--vm-size

A képek létrehozásához, testreszabásához és rögzítéséhez használt virtuális gép mérete. Az alapértelmezett (Standard_D1_v2) használatához hagyja ki vagy adja meg az üres sztringet.

--vnet

A build virtuális gép üzembe helyezéséhez használt virtuális hálózat neve. Csak akkor adja meg, ha az alhálózat neve.

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 delete

Képszerkesztő sablon törlése.

az image builder delete [--ids]
                        [--name]
                        [--resource-group]
                        [--subscription]

Példák

Képszerkesztő sablon törlése. (automatikusan létrehozott)

az image builder delete --name MyImageTemplate --resource-group MyResourceGroup

Opcionális paraméterek

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

Képszerkesztő-sablonok listázása.

az image builder list [--resource-group]

Opcionális paraméterek

--resource-group -g

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

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 run

Képszerkesztő sablon létrehozása.

az image builder run [--ids]
                     [--name]
                     [--no-wait]
                     [--resource-group]
                     [--subscription]

Példák

Indítsa el a sablon buildfuttatását, majd várja meg, amíg befejeződik.

az image builder run -n mytemplate -g my-group --no-wait

az image builder wait -n mytemplate -g aibmdi \
    --custom "lastRunStatus.runState!='Running'"

az image builder show -n mytemplate -g my-group

Opcionális paraméterek

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

--no-wait

Ne várja meg, amíg a hosszú ideig futó művelet befejeződik.

Alapértelmezett érték: False

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

Képszerkesztő sablon megjelenítése.

az image builder show [--ids]
                      [--name]
                      [--resource-group]
                      [--subscription]

Példák

Képszerkesztő sablon megjelenítése (automatikusan létrehozva)

az image builder show --name mytemplate  --resource-group my-group

Opcionális paraméterek

--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 show-runs

Képszerkesztő-sablon futtatási kimeneteinek megjelenítése.

az image builder show-runs [--ids]
                           [--name]
                           [--output-name]
                           [--resource-group]
                           [--subscription]

Példák

Futtasson egy sablon buildfuttatását, majd tekintse meg a futtatási kimeneteket.

az image builder run -n mytemplate -g my-group --no-wait

az image builder wait -n mytemplate -g aibmdi \
    --custom "lastRunStatus.runState!='Running'"

az image builder show-runs -n mytemplate -g my-group

Opcionális paraméterek

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

--output-name

A képszerkesztő futtatási kimenetének 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 update

Képszerkesztő-sablon frissítése.

A képszerkesztő sablonok frissítése jelenleg nem támogatott. Ez a parancs a --halasztással együtt használható egy képsablon-objektum frissítéséhez a CLI-gyorsítótárban. Halasztás nélkül lekéri a megadott képsablont a gyorsítótárból, és kérést küld az Azure-nak a képsablon létrehozásához.

az image builder update [--add]
                        [--defer]
                        [--force-string]
                        [--ids]
                        [--name]
                        [--remove]
                        [--resource-group]
                        [--set]
                        [--subscription]

Példák

Sablonerőforrás létrehozása sablonobjektumból a parancssori felület gyorsítótárában. További információt az "az image builder create/output add/customizer add --help" és az "az cache -h" (az cache -h) című témakörben talál.

# create and write template object to local cli cache
az image builder create --image-source {image_source} -n mytemplate -g my-group \
    --scripts {script} --managed-image-destinations image_1=westus --identity myidentity --defer

# add customizers and outputs to local cache template object via az image template output / customizer add
# one can also update cache object properties through generic update options, such as: --set
az image builder output add -n mytemplate -g my-group --output-name my-win-image-managed \
    --artifact-tags "is_vhd=False"  --managed-image winImage --managed-image-location eastus --defer

# send template create request to azure to create template resource
az image builder update -n mytemplate -g my-group

Opcionális paraméterek

--add

Adjon hozzá egy objektumot az objektumok listájához egy elérési út és egy kulcsértékpár megadásával. Példa: --add property.listProperty <key=value, string or JSON string>

Alapértelmezett érték: []

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

--force-string

A "set" vagy a "add" használata esetén a JSON-ra való konvertálás helyett őrizze meg a sztringkonstansokat.

Alapértelmezett érték: False

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

--remove

Tulajdonság vagy elem eltávolítása a listából. Példa: --remove property.list <indexToRemove> VAGY --remove propertyToRemove.

Alapértelmezett érték: []

--resource-group -g

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

--set

Frissítsen egy objektumot egy beállítandó tulajdonság elérési útjának és értékének megadásával. Példa: --set property1.property2=<value>

Alapértelmezett érték: []

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

Helyezze a parancssori felületet várakozási állapotba, amíg a sablon egy feltétele nem teljesül.

az image builder wait [--created]
                      [--custom]
                      [--deleted]
                      [--exists]
                      [--ids]
                      [--interval]
                      [--name]
                      [--resource-group]
                      [--subscription]
                      [--timeout]
                      [--updated]

Példák

Indítsa el a sablon buildfuttatását, majd várja meg, amíg befejeződik.

az image builder run -n mytemplate -g my-group --no-wait

az image builder wait -n mytemplate -g aibmdi \
    --custom "lastRunStatus.runState!='Running'"

az image builder show -n mytemplate -g my-group

Opcionális paraméterek

--created

Várjon, amíg létre nem jön a "provisioningState" a "Sikeres" helyen.

Alapértelmezett érték: False

--custom

Várjon, amíg a feltétel megfelel egy egyéni JMESPath-lekérdezésnek. Pl. provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running"?.

--deleted

Várjon a törlésig.

Alapértelmezett érték: False

--exists

Várjon, amíg az erőforrás létezik.

Alapértelmezett érték: False

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

--interval

Lekérdezési időköz másodpercben.

Alapértelmezett érték: 30

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

--timeout

Maximális várakozás másodpercben.

Alapértelmezett érték: 3600

--updated

Várjon, amíg frissül a provisioningState a következő helyen: "Sikeres".

Alapértelmezett érték: False

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.