az image

Referenz

Benutzerdefinierte VM-Images verwalten.

Befehle

az image builder	Verwalten und Erstellen von Image Builder-Vorlagen
az image builder cancel	Abbrechen des Imagebuilds mit langer Ausführungsdauer basierend auf der Imagevorlage.
az image builder create	Erstellen Sie eine Image Builder-Vorlage.
az image builder customizer	Image Builder-Vorlagenanpassung verwalten.
az image builder customizer add	Fügen Sie einer Image Builder-Vorlage einen Image Builder-Customizer hinzu.
az image builder customizer clear	Entfernen Sie alle Image Builder-Anpassungen aus einer Image Builder-Vorlage.
az image builder customizer remove	Entfernen Sie einen Image Builder-Customizer aus einer Image Builder-Vorlage.
az image builder delete	Löschen Sie die Image Builder-Vorlage.
az image builder identity	Verwalten von Identitäten einer Image Builder-Vorlage.
az image builder identity assign	Fügen Sie einer vorhandenen Image Builder-Vorlage verwaltete Identitäten hinzu. Derzeit wird nur eine Benutzeridentität unterstützt.
az image builder identity remove	Entfernen Sie verwaltete Identitäten aus einer vorhandenen Image Builder-Vorlage.
az image builder identity show	Zeigt verwaltete Identitäten einer Image Builder-Vorlage an.
az image builder list	Image Builder-Vorlagen auflisten.
az image builder output	Image Builder-Vorlagenausgabeverteiler verwalten.
az image builder output add	Fügen Sie einer Image Builder-Vorlage einen Image Builder-Ausgabeverteiler hinzu.
az image builder output clear	Entfernen Sie alle Image Builder-Ausgabeverteiler aus einer Image Builder-Vorlage.
az image builder output remove	Entfernen Sie einen Image Builder-Ausgabeverteiler aus einer Image Builder-Vorlage.
az image builder run	Erstellen Sie eine Image Builder-Vorlage.
az image builder show	Zeigen Sie eine Image Builder-Vorlage an.
az image builder show-runs	Zeigen Sie die Ausführungsausgaben einer Image Builder-Vorlage an.
az image builder update	Aktualisieren Sie eine Image Builder-Vorlage.
az image builder validator	Verwalten der Image Builder-Vorlagenüberprüfung.
az image builder validator add	Fügen Sie eine überprüfung zu einer vorhandenen Image Builder-Vorlage hinzu.
az image builder validator remove	Entfernen Sie validate aus einer vorhandenen Image Builder-Vorlage.
az image builder validator show	Zeigen Sie die Überprüfung einer vorhandenen Image Builder-Vorlage an.
az image builder wait	Versetzen Sie die CLI in einen Wartezustand, bis eine Bedingung der Vorlage erfüllt ist.
az image copy	Copy a managed image (or vm) to other regions. It requires the source disk to be available.
az image create	Create a custom Virtual Machine Image from managed disks or snapshots.
az image delete	Deletes an Image.
az image list	List custom VM images.
az image show	Gets an image.
az image update	Update custom VM images.

az image copy

Copy a managed image (or vm) to other regions. It requires the source disk to be available.

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 in mehrere Regionen, und bereinigen Sie 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 einen bereits generalisierten virtuellen Computer, um Images 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 Images oder der VM-Ressource.

--source-resource-group

Name der Ressourcengruppe der Quellressource.

--target-location

Leerzeichentrennte Positionsliste zum Erstellen des Bilds in (z. B. westeurope usw.).

--target-resource-group

Name der Ressourcengruppe, in der Images erstellt werden sollen.

Optionale Parameter

--cleanup

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

Standardwert: False

--export-as-snapshot

Schließen Sie diesen Schalter ein, um die Kopien als Momentaufnahmen anstelle von Bildern zu exportieren.

Standardwert: False

--parallel-degree

Anzahl der parallelen Kopiervorgänge.

Standardwert: -1

--source-type

Image oder VM.

Zulässige Werte: image, vm

Standardwert: image

--tags

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

--target-name

Der Name des endgültigen Images, das erstellt wird.

--target-subscription

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

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

Ressourcengruppenname, in dem ein temporäres Speicherkonto erstellt wird. --temporary_resource_group_name ist in Version 0.2.7 veraltet.

Standardwert: image-copy-rg

--timeout

Zeit in Sekunden, bis der Kopiervorgang abgeschlossen ist. Erhöhen Sie diese Zeit, wenn Sie große Images (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

Create a custom Virtual Machine Image from managed disks or snapshots.

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 von 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 Image, 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 Imagename.

--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 VM-ID oder eines Vm-Namens, Betriebssystemdatenträger-Blob-URI, verwalteter Betriebssystemdatenträger-ID oder -Name oder Betriebssystemmomentaufnahme-ID oder -Name.

Optionale Parameter

--data-disk-caching

Speicherzwischenspeicherungstyp für den Datenträger des Images.

Zulässige Werte: None, ReadOnly, ReadWrite

--data-disk-sources

Durch Leerzeichen getrennte Liste der Datenquellen, einschließlich nicht verwalteter Blob-URI, ID oder Name des verwalteten Datenträgers oder Momentaufnahme-ID oder -Name.

--edge-zone

Der Name der Edgezone.

--hyper-v-generation

Die Hypervisorgenerierung 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

Speicherzwischenspeicherungstyp für den Betriebssystemdatenträger des Images.

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. Wird nicht verwendet, wenn die Quell-VM angegeben ist.

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

--tags

Space-separated tags: key[=value] [key[=value] ...]. Use "" to clear existing tags.

--zone-resilient

Gibt an, ob ein Image zonenresilienz ist oder nicht. Der Standardwert ist "false". Zonenresiliente Images können nur in Regionen erstellt werden, die zonenredundanten Speicher bereitstellen.

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

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

Optionale Parameter

--ids

Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Es sollte sich um eine vollständige Ressourcen-ID mit allen Informationen der Argumente "Ressourcen-ID" handelt. 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.

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

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

Listen Sie 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 Image ab.

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

Optionale Parameter

--expand

Der expand-Ausdruck, der auf den Vorgang angewendet werden soll. Der Standardwert ist Keine.

--ids

Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). It should be a complete resource ID containing all information of 'Resource Id' arguments. You should provide either --ids or other 'Resource Id' arguments.

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

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

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 Sie benutzerdefinierte VM-Images.

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

Beispiele

Hinzufügen oder Aktualisieren von Tags

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

Entfernen Sie alle Tags.

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

Standardwert: []

--force-string

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

Standardwert: False

--ids

--name -n

Der Name des Bildes. Erforderlich.

--remove

Entfernen Sie eine Eigenschaft oder ein Element aus einer Liste. Beispiel: --remove property.list OR --remove propertyToRemove.

Standardwert: []

--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 Eigenschaftenpfad und wert angeben, der festgelegt werden soll. Beispiel: --set property1.property2=.

Standardwert: []

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

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

Zusätzliche Ressourcen