az image

Referenz

Benutzerdefinierte VM-Images verwalten.

Befehle

az image builder	Verwalten und Erstellen von Bild-Generatorvorlagen.
az image builder cancel	Abbrechen des langfristig ausgeführten Bildbuilds basierend auf der Bildvorlage.
az image builder create	Erstellen Sie eine Bild-Generatorvorlage.
az image builder customizer	Image Builder-Vorlagenanpassung verwalten.
az image builder customizer add	Fügen Sie einem Bild-Generator-Anpassungsgeber eine Bild-Generatorvorlage hinzu.
az image builder customizer clear	Entfernen Sie alle Bild-Generator-Anpassungen aus einer Bild-Generatorvorlage.
az image builder customizer remove	Entfernen Sie einen Bild-Generator-Customizer aus einer Bild-Generatorvorlage.
az image builder delete	Bild-Generatorvorlage löschen.
az image builder list	Listenbild-Generatorvorlagen.
az image builder output	Image Builder-Vorlagenausgabeverteiler verwalten.
az image builder output add	Fügen Sie einen Ausgabeverteiler eines Bild-Generators zu einer Bild-Generator-Vorlage hinzu.
az image builder output clear	Entfernen Sie alle Ausgabeverteiler des Bild-Generators aus einer Bild-Generator-Vorlage.
az image builder output remove	Entfernen Sie einen Ausgabeverteiler eines Bild-Generators aus einer Bild-Generatorvorlage.
az image builder run	Erstellen Sie eine Bild-Generatorvorlage.
az image builder show	Zeigen Sie eine Bild-Generatorvorlage an.
az image builder show-runs	Zeigen Sie die Ausführungsausgabe einer Bild-Generatorvorlage an.
az image builder update	Aktualisieren einer Bild-Generatorvorlage.
az image builder validator	Verwalten der Vorlagenvorlage für den Bild-Generator.
az image builder validator add	Fügen Sie eine vorhandene Bild-Generatorvorlage hinzu.
az image builder validator remove	Entfernen Sie die Überprüfung aus einer vorhandenen Bild-Generatorvorlage.
az image builder validator show	Zeigen Sie die Überprüfung einer vorhandenen Bild-Generatorvorlage an.
az image builder wait	Platzieren Sie die CLI in einem Wartezustand, bis eine Bedingung der Vorlage erfüllt ist.
az image copy	Kopieren Sie ein verwaltetes Image (oder vm) in andere Regionen. Es erfordert, dass der Quelldatenträger verfügbar ist.
az image create	Erstellen Sie ein benutzerdefiniertes Virtuelles Computerimage aus verwalteten Datenträgern oder Momentaufnahmen.
az image delete	Löscht ein Bild.
az image list	Listet benutzerdefinierte VM-Images auf.
az image show	Ruft ein Bild ab.
az image update	Aktualisieren von benutzerdefinierten VM-Images.

az image copy

Kopieren Sie ein verwaltetes Image (oder vm) in andere Regionen. Es erfordert, dass der Quelldatenträger verfügbar ist.

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]

Beispiele

Kopieren Sie ein Bild an mehrere Regionen und bereinigung am Ende.

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

Verwenden Sie eine bereits generalisierte VM, um Bilder in anderen Regionen zu erstellen.

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"

Erforderliche Parameter

--source-object-name

Der Name des Bilds oder der vm-Ressource.

--source-resource-group

Name der Ressourcengruppe der Quellressource.

--target-location

Leerzeichenliste zum Erstellen des Bilds (z. B. Westeurope usw.).

--target-resource-group

Name der Ressourcengruppe zum Erstellen von Bildern in.

Optionale Parameter

--cleanup

Schließen Sie diesen Wechsel ein, um temporäre Ressourcen nach Abschluss zu löschen.

--export-as-snapshot

Fügen Sie diesen Wechsel ein, um die Kopien anstelle von Bildern als Momentaufnahmen zu exportieren.

--parallel-degree

Anzahl der parallelen Kopiervorgänge.

Standardwert: -1

--source-type

Image oder vm.

Zulässige Werte: image, vm

Standardwert: image

--tags

Leergetrennte Tags: key[=value] [key[=value] ...]. Verwenden Sie "", um vorhandene Tags zu löschen.

--target-name

Name des endgültigen Bilds, das erstellt wird.

--target-subscription

Name oder ID des Abonnements, in dem das endgültige Bild erstellt werden soll.

--temporary-resource-group-name --temporary_resource_group_name

Ressourcengruppenname, auf dem temporäre Speicherkonto erstellt wird. --temporary_resource_group_name wird in 0.2.7 veraltet sein.

Standardwert: image-copy-rg

--timeout

Zeit in Sekunden, um den Kopiervorgang abzuschließen. Erhöhen Sie diese Zeit, wenn Sie große Bilder (Datenträger) wie 512 GB oder mehr kopieren möchten.

Standardwert: 3600

Globale Parameter

--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az image create

Erstellen Sie ein benutzerdefiniertes Virtuelles Computerimage aus verwalteten Datenträgern oder Momentaufnahmen.

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}]

Beispiele

Erstellen Sie ein Image aus einem vorhandenen Datenträger.

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

Erstellen Sie ein Bild, indem Sie einen vorhandenen generalisierten virtuellen Computer in derselben Ressourcengruppe erfassen.

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

Erforderliche Parameter

--name -n

Neuer Bildname.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

--source

Betriebssystemdatenträgerquelle aus derselben Region, einschließlich einer virtuellen Computer-ID oder eines Namens, Betriebssystem-Blob-URI, verwalteter Betriebssystemdatenträger-ID oder Name oder Betriebssystem-Momentaufnahme-ID oder Name.

Optionale Parameter

--data-disk-caching

Speicherspeicherungstyp für den Datenträger des Bilds.

Zulässige Werte: None, ReadOnly, ReadWrite

--data-disk-sources

Leergetrennte Liste der Datenquellen, einschließlich nicht verwalteter Blob-URI, verwalteter Datenträger-ID oder Name oder Momentaufnahme-ID oder Name.

--edge-zone

Der Name der Edgezone.

--hyper-v-generation

Die Hypervisor-Generation des virtuellen Computers, der aus dem Image erstellt wurde.

Zulässige Werte: V1, V2

Standardwert: V1

--location -l

Der Standort. Werte aus: az account list-locations. Sie können den standardmäßig verwendeten Standort mit az configure --defaults location=<location> konfigurieren.

--os-disk-caching

Speicherspeicherungstyp für den Betriebssystemdatenträger des Bilds.

Zulässige Werte: None, ReadOnly, ReadWrite

--os-type

Zulässige Werte: Linux, Windows

--storage-sku

Die SKU des Speicherkontos, mit dem das VM-Image erstellt werden soll. Nicht verwendet, wenn die Quell-VM angegeben wird.

Zulässige Werte: PremiumV2_LRS, Premium_LRS, Premium_ZRS, StandardSSD_LRS, StandardSSD_ZRS, Standard_LRS, UltraSSD_LRS

--tags

Leergetrennte Tags: key[=value] [key[=value] ...]. Verwenden Sie "", um vorhandene Tags zu löschen.

--zone-resilient

Gibt an, ob ein Bild widerstandsfähig ist oder nicht. Der Standardwert ist "false". Zonenbelastbare Bilder können nur in Regionen erstellt werden, in denen Zone redundanter Speicher bereitgestellt wird.

Zulässige Werte: false, true

Globale Parameter

--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az image delete

Löscht ein Bild.

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

Optionale Parameter

--ids

Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Es sollte eine vollständige Ressourcen-ID sein, die alle Informationen der Argumente "Resource Id" enthält. Sie sollten entweder --ids oder andere Argumente "Resource Id" angeben.

--name -n

Der Name des Bildes. Erforderlich.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

Globale Parameter

--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az image list

Listet benutzerdefinierte VM-Images auf.

az image list [--resource-group]

Optionale Parameter

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

Globale Parameter

--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az image show

Ruft ein Bild ab.

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

Optionale Parameter

--expand

Der erweiterungsausdruck, der für den Vorgang angewendet werden soll. Der Standardwert ist Keine.

--ids

Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Es sollte eine vollständige Ressourcen-ID sein, die alle Informationen von Argumenten der Ressource-ID enthält. Sie sollten entweder --ids oder andere Argumente für die Ressourcen-ID angeben.

--name -n

Der Name des Bildes. Erforderlich.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

Globale Parameter

--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az image update

Aktualisieren von benutzerdefinierten VM-Images.

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

Beispiele

Hinzufügen oder Aktualisieren von Tags

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

Alle Tags entfernen.

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

Optionale Parameter

--add

Fügen Sie einer Liste von Objekten ein Objekt hinzu, indem Sie ein Pfad- und Schlüsselwertpaar angeben. Beispiel: --add property.listProperty <key=value, string or JSON string>.

--force-string

Wenn Sie "set" oder "add" verwenden, behalten Sie Zeichenfolgenliterale bei, anstatt zu versuchen, in JSON zu konvertieren.

--ids

--name -n

Der Name des Bildes. Erforderlich.

--remove

Entfernen einer Eigenschaft oder eines Elements aus einer Liste. Beispiel: --remove property.list OR --remove propertyToRemove.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

--set

Aktualisieren Sie ein Objekt, indem Sie einen Eigenschaftspfad und einen festzulegenden Wert angeben. Beispiel: --set property1.property2=.

--tags

Leerzeichentrennte Tags: key[=value] [key[=value] ...]. Verwenden Sie "", um vorhandene Tags zu löschen.

Globale Parameter

--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az image

Befehle

az image copy

Beispiele

Erforderliche Parameter

Optionale Parameter

az image create

Beispiele

Erforderliche Parameter

Optionale Parameter

az image delete

Optionale Parameter

az image list

Optionale Parameter

az image show

Optionale Parameter

az image update

Beispiele

Optionale Parameter

Feedback