az image

Poznámka:

Tato skupina příkazů obsahuje příkazy, které jsou definované v Azure CLI i alespoň v jednom rozšíření. Nainstalujte každé rozšíření, abyste mohli využívat své rozšířené funkce. Přečtěte si další informace o rozšířeních.

Správa vlastních imagí virtuálních počítačů

Příkazy

Name	Description	Typ	Stav
az image builder	Umožňuje spravovat a vytvářet šablony tvůrce imagí.	Základ	GA
az image builder cancel	Zrušte sestavení dlouhotrvající image na základě šablony image.	Základ	GA
az image builder create	Vytvořte šablonu tvůrce obrázků.	Základ	GA
az image builder customizer	Správa úprav šablon tvůrce obrázků	Základ	GA
az image builder customizer add	Přidejte úpravce tvůrce obrázků do šablony tvůrce obrázků.	Základ	GA
az image builder customizer clear	Odeberte všechny úpravce tvůrce obrázků ze šablony tvůrce obrázků.	Základ	GA
az image builder customizer remove	Odeberte úpravce tvůrce obrázků ze šablony tvůrce obrázků.	Základ	GA
az image builder delete	Odstraňte šablonu tvůrce obrázků.	Základ	GA
az image builder error-handler	Správa obslužné rutiny chyby šablony tvůrce obrázků	Základ	GA
az image builder error-handler add	Přidejte obslužnou rutinu chyby do existující šablony tvůrce obrázků.	Základ	GA
az image builder error-handler remove	Odeberte obslužnou rutinu chyby z existující šablony tvůrce obrázků.	Základ	GA
az image builder error-handler show	Zobrazí obslužnou rutinu chyby existující šablony tvůrce obrázků.	Základ	GA
az image builder identity	Správa identit šablony tvůrce obrázků	Základ	GA
az image builder identity assign	Přidání spravovaných identit do existující šablony tvůrce imagí V současné době se podporuje pouze jedna identita uživatele.	Základ	GA
az image builder identity remove	Odeberte spravované identity z existující šablony tvůrce imagí.	Základ	GA
az image builder identity show	Zobrazení spravovaných identit šablony tvůrce obrázků	Základ	GA
az image builder list	Vypsat šablony tvůrce obrázků	Základ	GA
az image builder optimizer	Správa optimalizátoru šablon tvůrce obrázků	Základ	GA
az image builder optimizer add	Přidejte optimalizátor do existující šablony tvůrce obrázků.	Základ	GA
az image builder optimizer remove	Odeberte optimalizátor z existující šablony tvůrce obrázků.	Základ	GA
az image builder optimizer show	Zobrazí optimalizátor existující šablony tvůrce obrázků.	Základ	GA
az image builder optimizer update	Aktualizujte optimalizátor z existující šablony tvůrce obrázků.	Základ	GA
az image builder output	Spravujte distributory výstupů šablony tvůrce obrázků.	Základ	GA
az image builder output add	Přidání výstupního distributora tvůrce obrázků do šablony tvůrce obrázků	Základ	GA
az image builder output clear	Odeberte všechny distributory výstupů tvůrce obrázků ze šablony tvůrce obrázků.	Základ	GA
az image builder output remove	Odeberte výstupní distributor tvůrce obrázků ze šablony tvůrce obrázků.	Základ	GA
az image builder output versioning	Správa nástroje pro správu verzí šablony tvůrce obrázků	Základ	GA
az image builder output versioning remove	Odeberte všechny možnosti správy verzí u zadaných výstupů.	Základ	GA
az image builder output versioning set	Nastavte výstupní verzi tvůrce obrázků šablony tvůrce obrázků.	Základ	GA
az image builder output versioning show	Umožňuje zobrazit možnosti správy verzí u zadaných výstupů.	Základ	GA
az image builder run	Vytvořte šablonu tvůrce obrázků.	Základ	GA
az image builder show	Zobrazí šablonu tvůrce obrázků.	Základ	GA
az image builder show-runs	Zobrazí výstupy spuštění šablony tvůrce obrázků.	Základ	GA
az image builder trigger	Správa triggeru šablony tvůrce obrázků	Základ	GA
az image builder trigger create	Vytvořte trigger pro zadanou šablonu image virtuálního počítače.	Základ	GA
az image builder trigger delete	Odstraňte trigger pro zadanou šablonu image virtuálního počítače.	Základ	GA
az image builder trigger list	Zobrazí seznam všech aktivačních událostí pro zadaný prostředek šablony obrázku.	Základ	GA
az image builder trigger show	Získejte zadaný trigger pro zadaný prostředek šablony image.	Základ	GA
az image builder trigger wait	Umístěte rozhraní příkazového řádku do stavu čekání, dokud není splněna podmínka.	Základ	GA
az image builder update	Aktualizujte šablonu tvůrce obrázků.	Základ	GA
az image builder validator	Umožňuje spravovat ověření šablony tvůrce obrázků.	Základ	GA
az image builder validator add	Přidejte ověření do existující šablony tvůrce obrázků.	Základ	GA
az image builder validator remove	Odeberte ověření z existující šablony tvůrce obrázků.	Základ	GA
az image builder validator show	Zobrazí ověření existující šablony tvůrce obrázků.	Základ	GA
az image builder wait	Umístěte rozhraní příkazového řádku do stavu čekání, dokud nebude splněna podmínka šablony.	Základ	GA
az image copy	Zkopírujte spravovanou image (nebo virtuální počítač) do jiných oblastí. Vyžaduje, aby byl zdrojový disk dostupný.	Rozšíření	GA
az image create	Vytvořte vlastní image virtuálního počítače ze spravovaných disků nebo snímků.	Základ	GA
az image delete	Odstraňte obrázek.	Základ	GA
az image list	Vypíše seznam imagí ve skupině prostředků.	Základ	GA
az image show	Získejte obrázek.	Základ	GA
az image update	Aktualizace vlastních imagí virtuálních počítačů	Základ	GA
az image wait	Umístěte rozhraní příkazového řádku do stavu čekání, dokud není splněna podmínka.	Základ	GA

az image copy

Zkopírujte spravovanou image (nebo virtuální počítač) do jiných oblastí. Vyžaduje, aby byl zdrojový disk dostupný.

az image copy --source-object-name
              --source-resource-group
              --target-location
              --target-resource-group
              [--cleanup]
              [--export-as-snapshot]
              [--parallel-degree]
              [--source-type {image, vm}]
              [--tags]
              [--target-name]
              [--target-subscription]
              [--temporary-resource-group-name]
              [--timeout]

Příklady

Zkopírujte obrázek do několika oblastí a na konci ho vyčistěte.

az image copy --source-resource-group mySources-rg --source-object-name myImage \
    --target-location uksouth northeurope --target-resource-group "images-repo-rg" --cleanup

K vytvoření imagí v jiných oblastech použijte již generalizovaný virtuální počítač.

az image copy --source-resource-group mySources-rg --source-object-name myVm \
    --source-type vm --target-location uksouth northeurope --target-resource-group "images-repo-rg"

Povinné parametry

--source-object-name

Název prostředku image nebo virtuálního počítače.

--source-resource-group

Název skupiny prostředků zdrojového prostředku

--target-location

Seznam umístění oddělený mezerami pro vytvoření image (např. westeurope atd.).

--target-resource-group

Název skupiny prostředků pro vytvoření imagí

Volitelné parametry

--cleanup

Pokud chcete po dokončení odstranit dočasné prostředky, zahrňte tento přepínač.

výchozí hodnota: False

--export-as-snapshot

Pokud chcete exportovat kopie jako snímky místo obrázků, zahrňte tento přepínač.

výchozí hodnota: False

--parallel-degree

Počet paralelních operací kopírování

výchozí hodnota: -1

--source-type

Obrázek nebo virtuální počítač

přijímané hodnoty: image, vm

výchozí hodnota: image

--tags

Značky oddělené mezerami: klíč[=hodnota] [klíč[=hodnota] ...]. K vymazání existujících značek použijte "".

--target-name

Název konečné image, která se vytvoří.

--target-subscription

Název nebo ID předplatného, ve kterém by se měla vytvořit konečná image.

--temporary-resource-group-name

Název skupiny prostředků, kde se vytvoří dočasný účet úložiště.

výchozí hodnota: image-copy-rg

--timeout

Doba v sekundách, než se operace kopírování dokončí. Tuto dobu zvyšte, pokud budete kopírovat velké image (disky), jako je 512 GB nebo více.

výchozí hodnota: 3600

Globální parametry

--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

přijímané hodnoty: json, jsonc, none, table, tsv, yaml, yamlc

výchozí hodnota: json

--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az image create

Vytvořte vlastní image virtuálního počítače ze spravovaných disků nebo snímků.

az image create --name
                --resource-group
                --source
                [--data-disk-caching {None, ReadOnly, ReadWrite}]
                [--data-disk-sources]
                [--edge-zone]
                [--hyper-v-generation {V1, V2}]
                [--location]
                [--os-disk-caching {None, ReadOnly, ReadWrite}]
                [--os-type {Linux, Windows}]
                [--storage-sku {PremiumV2_LRS, Premium_LRS, Premium_ZRS, StandardSSD_LRS, StandardSSD_ZRS, Standard_LRS, UltraSSD_LRS}]
                [--tags]
                [--zone-resilient {false, true}]

Příklady

Vytvořte image z existujícího disku.

az image create -g MyResourceGroup -n image1 --os-type Linux \
    --source /subscriptions/db5eb68e-73e2-4fa8-b18a-0123456789999/resourceGroups/rg1/providers/Microsoft.Compute/snapshots/s1

Vytvořte image zachycením existujícího generalizovaného virtuálního počítače ve stejné skupině prostředků.

az image create -g MyResourceGroup -n image1 --source MyVm1

Povinné parametry

--name -n

Název nové image

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

--source

Zdroj disku s operačním systémem ze stejné oblasti, včetně ID nebo názvu virtuálního počítače, identifikátoru URI objektu blob disku operačního systému, ID spravovaného disku operačního systému nebo názvu nebo ID snímku operačního systému nebo názvu.

Volitelné parametry

--data-disk-caching

Typ ukládání do mezipaměti pro datový disk image

přijímané hodnoty: None, ReadOnly, ReadWrite

--data-disk-sources

Seznam zdrojů datových disků oddělených mezerami, včetně nespravovaného identifikátoru URI objektu blob, ID spravovaného disku nebo názvu nebo ID snímku nebo názvu.

--edge-zone

Název hraniční zóny.

--hyper-v-generation

Generace hypervisoru virtuálního počítače vytvořeného z image.

přijímané hodnoty: V1, V2

výchozí hodnota: V1

--location -l

Umístění. Hodnoty z: az account list-locations. Výchozí umístění můžete nakonfigurovat pomocí .az configure --defaults location=<location>

--os-disk-caching

Typ ukládání do mezipaměti pro disk s operačním systémem image

přijímané hodnoty: None, ReadOnly, ReadWrite

--os-type

přijímané hodnoty: Linux, Windows

--storage-sku

Skladová položka účtu úložiště, pomocí které se má vytvořit image virtuálního počítače. Nepoužité, pokud je zadaný zdrojový virtuální počítač.

přijímané hodnoty: PremiumV2_LRS, Premium_LRS, Premium_ZRS, StandardSSD_LRS, StandardSSD_ZRS, Standard_LRS, UltraSSD_LRS

--tags

Značky oddělené mezerami: klíč[=hodnota] [klíč[=hodnota] ...]. K vymazání existujících značek použijte "".

--zone-resilient

Určuje, jestli je image odolná nebo ne. Výchozí hodnota je False. Odolné image zóny je možné vytvářet pouze v oblastech, které poskytují zónově redundantní úložiště.

přijímané hodnoty: false, true

Globální parametry

--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

přijímané hodnoty: json, jsonc, none, table, tsv, yaml, yamlc

výchozí hodnota: json

--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az image delete

Odstraňte obrázek.

az image delete [--ids]
                [--image-name]
                [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                [--resource-group]
                [--subscription]

Volitelné parametry

--ids

Jedno nebo více ID prostředků (oddělených mezerami) Mělo by se jednat o úplné ID prostředku obsahující všechny informace o argumentech ID prostředku. Měli byste zadat argumenty --ids nebo jiné argumenty ID prostředku.

--image-name --name -n

Název obrázku.

--no-wait

Nečekejte na dokončení dlouhotrvající operace.

přijímané hodnoty: 0, 1, f, false, n, no, t, true, y, yes

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

Globální parametry

--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

přijímané hodnoty: json, jsonc, none, table, tsv, yaml, yamlc

výchozí hodnota: json

--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az image list

Vypíše seznam imagí ve skupině prostředků.

az image list [--max-items]
              [--next-token]
              [--resource-group]

Volitelné parametry

--max-items

Celkový počet položek, které se mají vrátit ve výstupu příkazu Pokud je celkový počet dostupných položek větší než zadaná hodnota, zobrazí se ve výstupu příkazu token. Chcete-li obnovit stránkování, zadejte hodnotu tokenu v --next-token argumentu následného příkazu.

--next-token

Token určující, kde se má stránkování spustit. Toto je hodnota tokenu z dříve zkrácené odpovědi.

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

Globální parametry

--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

přijímané hodnoty: json, jsonc, none, table, tsv, yaml, yamlc

výchozí hodnota: json

--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az image show

Získejte obrázek.

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

Volitelné parametry

--expand

Výraz rozbalení, který se má použít pro operaci.

--ids

Jedno nebo více ID prostředků (oddělených mezerami) Mělo by se jednat o úplné ID prostředku obsahující všechny informace o argumentech ID prostředku. Měli byste zadat argumenty --ids nebo jiné argumenty ID prostředku.

--image-name --name -n

Název obrázku.

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

Globální parametry

--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

přijímané hodnoty: json, jsonc, none, table, tsv, yaml, yamlc

výchozí hodnota: json

--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az image update

Aktualizace vlastních imagí virtuálních počítačů

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

Příklady

Přidání nebo aktualizace značek

az image update -n ImageName -g ResourceGroup --tags tag1=val1 tag2=val2

Odeberte všechny značky.

az image update -n ImageName -g resourceGroup --tags

Volitelné parametry

--add

Přidejte objekt do seznamu objektů zadáním párů cest a klíč-hodnota. Příklad: --add property.listProperty <key=value, string or JSON string>.

výchozí hodnota: []

--force-string

Při použití set nebo add zachovávejte řetězcové literály místo pokusu o převod na JSON.

výchozí hodnota: False

--ids

Jedno nebo více ID prostředků (oddělených mezerami) Mělo by se jednat o úplné ID prostředku obsahující všechny informace o argumentech ID prostředku. Měli byste zadat argumenty --ids nebo jiné argumenty ID prostředku.

--name -n

Název obrázku. Povinný:

--remove

Odeberte vlastnost nebo prvek ze seznamu. Příklad: --remove property.list <indexToRemove> OR --remove propertyToRemove.

výchozí hodnota: []

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

--set

Aktualizujte objekt zadáním cesty vlastnosti a hodnoty, která se má nastavit. Příklad: --set property1.property2=<value>.

výchozí hodnota: []

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--tags

Značky oddělené mezerami: klíč[=hodnota] [klíč[=hodnota] ...]. K vymazání existujících značek použijte "".

Globální parametry

--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

přijímané hodnoty: json, jsonc, none, table, tsv, yaml, yamlc

výchozí hodnota: json

--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az image wait

Umístěte rozhraní příkazového řádku do stavu čekání, dokud není splněna podmínka.

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

Volitelné parametry

--created

Počkejte na vytvoření s 'provisioningState' v 'Succeeded'.

výchozí hodnota: False

--custom

Počkejte, až podmínka splňuje vlastní dotaz JMESPath. Například provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Počkejte na odstranění.

výchozí hodnota: False

--exists

Počkejte, až prostředek existuje.

výchozí hodnota: False

--expand

Výraz rozbalení, který se má použít pro operaci.

--ids

Jedno nebo více ID prostředků (oddělených mezerami) Mělo by se jednat o úplné ID prostředku obsahující všechny informace o argumentech ID prostředku. Měli byste zadat argumenty --ids nebo jiné argumenty ID prostředku.

--image-name --name -n

Název obrázku.

--interval

Interval dotazování v sekundách

výchozí hodnota: 30

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--timeout

Maximální čekání v sekundách.

výchozí hodnota: 3600

--updated

Počkejte, dokud se neaktualizuje stav zřizování ve stavu Úspěch.

výchozí hodnota: False

Globální parametry

--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

přijímané hodnoty: json, jsonc, none, table, tsv, yaml, yamlc

výchozí hodnota: json

--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.