az image
Hinweis
Diese Befehlsgruppe verfügt über Befehle, die sowohl in Azure CLI als auch in mindestens einer Erweiterung definiert sind. Installieren Sie jede Erweiterung, um von ihren erweiterten Funktionen zu profitieren. Weitere Informationen zu Erweiterungen
Benutzerdefinierte VM-Images verwalten.
Befehle
Name | Beschreibung | Typ | Status |
---|---|---|---|
az image builder |
Verwalten und Erstellen von Image Builder-Vorlagen |
Core | Allgemein verfügbar |
az image builder cancel |
Abbrechen des Builds für lang ausgeführtes Image basierend auf der Bildvorlage. |
Core | Allgemein verfügbar |
az image builder create |
Erstellen Sie eine Image Builder-Vorlage. |
Core | Allgemein verfügbar |
az image builder customizer |
Image Builder-Vorlagenanpassung verwalten. |
Core | Allgemein verfügbar |
az image builder customizer add |
Fügen Sie einer Image Builder-Vorlage einen Image Builder Customizer hinzu. |
Core | Allgemein verfügbar |
az image builder customizer clear |
Entfernen Sie alle Image Builder Customizer aus einer Image Builder-Vorlage. |
Core | Allgemein verfügbar |
az image builder customizer remove |
Entfernen Sie einen Image Builder Customizer aus einer Image Builder-Vorlage. |
Core | Allgemein verfügbar |
az image builder delete |
Löschen Sie die Bild-Generator-Vorlage. |
Core | Allgemein verfügbar |
az image builder error-handler |
Fehlerhandler für Die Image Builder-Vorlage verwalten. |
Core | Allgemein verfügbar |
az image builder error-handler add |
Fügen Sie einer vorhandenen Image Builder-Vorlage Einen Fehlerhandler hinzu. |
Core | Allgemein verfügbar |
az image builder error-handler remove |
Entfernen Sie den Fehlerhandler aus einer vorhandenen Image Builder-Vorlage. |
Core | Allgemein verfügbar |
az image builder error-handler show |
Fehlerhandler einer vorhandenen Image Builder-Vorlage anzeigen. |
Core | Allgemein verfügbar |
az image builder identity |
Verwalten von Identitäten einer Image Builder-Vorlage. |
Core | Allgemein verfügbar |
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. |
Core | Allgemein verfügbar |
az image builder identity remove |
Entfernen sie verwaltete Identitäten aus einer vorhandenen Image Builder-Vorlage. |
Core | Allgemein verfügbar |
az image builder identity show |
Anzeigen verwalteter Identitäten einer Image Builder-Vorlage. |
Core | Allgemein verfügbar |
az image builder list |
Bild-Generator-Vorlagen auflisten. |
Core | Allgemein verfügbar |
az image builder optimizer |
Verwalten sie den Optimierer für Image Builder-Vorlagen. |
Core | Allgemein verfügbar |
az image builder optimizer add |
Fügen Sie einer vorhandenen Image Builder-Vorlage Optimierer hinzu. |
Core | Allgemein verfügbar |
az image builder optimizer remove |
Entfernen Sie den Optimierer aus einer vorhandenen Image Builder-Vorlage. |
Core | Allgemein verfügbar |
az image builder optimizer show |
Optimierer einer vorhandenen Image Builder-Vorlage anzeigen. |
Core | Allgemein verfügbar |
az image builder optimizer update |
Aktualisieren Sie einen Optimierer aus einer vorhandenen Image Builder-Vorlage. |
Core | Allgemein verfügbar |
az image builder output |
Image Builder-Vorlagenausgabeverteiler verwalten. |
Core | Allgemein verfügbar |
az image builder output add |
Fügen Sie einer Image Builder-Vorlage einen Ausgabeverteiler für den Image Builder hinzu. |
Core | Allgemein verfügbar |
az image builder output clear |
Entfernen Sie alle Bild-Generator-Ausgabeverteiler aus einer Image Builder-Vorlage. |
Core | Allgemein verfügbar |
az image builder output remove |
Entfernen Sie einen Bild-Generator-Ausgabeverteiler aus einer Image Builder-Vorlage. |
Core | Allgemein verfügbar |
az image builder output versioning |
Verwalten sie die Ausgabeversionsverwaltung für Bild-Generator-Vorlagen. |
Core | Allgemein verfügbar |
az image builder output versioning remove |
Entfernen Sie alle Versionsverwaltungsoptionen für angegebene Ausgaben. |
Core | Allgemein verfügbar |
az image builder output versioning set |
Legen Sie die Ausgabeversionsverwaltung für den Image Builder einer Image Builder-Vorlage fest. |
Core | Allgemein verfügbar |
az image builder output versioning show |
Versionsverwaltungsoptionen für angegebene Ausgaben anzeigen. |
Core | Allgemein verfügbar |
az image builder run |
Erstellen Sie eine Image Builder-Vorlage. |
Core | Allgemein verfügbar |
az image builder show |
Zeigen Sie eine Bild-Generator-Vorlage an. |
Core | Allgemein verfügbar |
az image builder show-runs |
Zeigen Sie die Ausführungsausgabe einer Bild-Generator-Vorlage an. |
Core | Allgemein verfügbar |
az image builder trigger |
Verwalten des Bild-Generator-Vorlagentriggers. |
Core | Allgemein verfügbar |
az image builder trigger create |
Erstellen Sie einen Trigger für die angegebene Imagevorlage für virtuelle Computer. |
Core | Allgemein verfügbar |
az image builder trigger delete |
Löschen eines Triggers für die angegebene Imagevorlage für virtuelle Computer. |
Core | Allgemein verfügbar |
az image builder trigger list |
Listet alle Trigger für die angegebene Bildvorlagenressource auf. |
Core | Allgemein verfügbar |
az image builder trigger show |
Rufen Sie den angegebenen Trigger für die angegebene Bildvorlagenressource ab. |
Core | Allgemein verfügbar |
az image builder trigger wait |
Platzieren Sie die CLI in einem Wartezustand, bis eine Bedingung erfüllt ist. |
Core | Allgemein verfügbar |
az image builder update |
Aktualisieren sie eine Image Builder-Vorlage. |
Core | Allgemein verfügbar |
az image builder validator |
Verwalten sie die Überprüfung der Image Builder-Vorlage. |
Core | Allgemein verfügbar |
az image builder validator add |
Fügen Sie einer vorhandenen Image Builder-Vorlage Eine Überprüfung hinzu. |
Core | Allgemein verfügbar |
az image builder validator remove |
Entfernen Sie die Überprüfung aus einer vorhandenen Image Builder-Vorlage. |
Core | Allgemein verfügbar |
az image builder validator show |
Zeigen Sie die Überprüfung einer vorhandenen Image Builder-Vorlage an. |
Core | Allgemein verfügbar |
az image builder wait |
Platzieren Sie die CLI in einem Wartezustand, bis eine Bedingung der Vorlage erfüllt ist. |
Core | Allgemein verfügbar |
az image copy |
Kopieren Sie ein verwaltetes Image (oder einen virtuellen Computer) in andere Regionen. Er erfordert, dass der Quelldatenträger verfügbar ist. |
Erweiterung | Allgemein verfügbar |
az image create |
Erstellen Sie ein benutzerdefiniertes Image für virtuelle Computer von verwalteten Datenträgern oder Momentaufnahme. |
Core | Allgemein verfügbar |
az image delete |
Ein Bild löschen. |
Core | Allgemein verfügbar |
az image list |
Liste der Bilder unter einer Ressourcengruppe auf. |
Core | Allgemein verfügbar |
az image show |
Rufen Sie ein Bild ab. |
Core | Allgemein verfügbar |
az image update |
Aktualisieren sie benutzerdefinierte VM-Images. |
Core | Allgemein verfügbar |
az image wait |
Platzieren Sie die CLI in einem Wartezustand, bis eine Bedingung erfüllt ist. |
Core | Allgemein verfügbar |
az image copy
Kopieren Sie ein verwaltetes Image (oder einen virtuellen Computer) in andere Regionen. Er 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 in mehrere Bereiche, und sauber 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 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
Der Name der Image- oder VM-Ressource.
Name der Ressourcengruppe der Quellressource.
Raumtrennte Standortliste zum Erstellen des Bilds in (z. B. Westeurope usw.).
Name der Ressourcengruppe, in der Bilder erstellt werden sollen.
Optionale Parameter
Schließen Sie diesen Switch ein, um temporäre Ressourcen nach Abschluss zu löschen.
Fügen Sie diesen Schalter ein, um die Kopien als Momentaufnahme s anstelle von Bildern zu exportieren.
Anzahl der parallelen Kopiervorgänge.
Image oder vm.
Durch Leerzeichen getrennte Tags: key[=value] [key[=value] ...]. Verwenden Sie "", um vorhandene Tags zu löschen.
Der Name des endgültigen Bilds, das erstellt wird.
Name oder ID des Abonnements, in dem das endgültige Bild erstellt werden soll.
Ressourcengruppenname, unter dem das temporäre Speicherkonto erstellt wird.
Zeit in Sekunden, bis der Kopiervorgang abgeschlossen ist. Erhöhen Sie diese Zeit, wenn Sie große Bilder (Datenträger) wie 512 GB oder mehr kopieren möchten.
Globale Parameter
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID
konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.
az image create
Erstellen Sie ein benutzerdefiniertes Image für virtuelle Computer von verwalteten Datenträgern oder Momentaufnahme.
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
Neuer Bildname.
Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name>
konfigurieren.
Betriebssystemdatenträgerquelle aus derselben Region, einschließlich einer ID oder eines Namens eines virtuellen Computers, Betriebssystem-Blob-URI, verwalteter Betriebssystemdatenträger-ID oder -Name oder betriebssystem Momentaufnahme ID oder Name.
Optionale Parameter
Speicherzwischenspeicherungstyp für den Datenträger des Images.
Durch Leerzeichen getrennte Liste der Datenquellen, einschließlich nicht verwalteter BLOB-URI, verwalteter Datenträger-ID oder Name oder Momentaufnahme-ID oder -Name.
Der Name der Randzone.
Die Hypervisorgenerierung des virtuellen Computers, der aus dem Image erstellt wurde.
Standort. Werte aus: az account list-locations
. Sie können den standardmäßig verwendeten Standort mit az configure --defaults location=<location>
konfigurieren.
Speicherzwischenspeicherungstyp für den Betriebssystemdatenträger des Images.
Die SKU des Speicherkontos, mit dem das VM-Image erstellt werden soll. Nicht verwendet, wenn die Quell-VM angegeben ist.
Durch Leerzeichen getrennte Tags: key[=value] [key[=value] ...]. Verwenden Sie "", um vorhandene Tags zu löschen.
Gibt an, ob ein Bild widerstandsfähig ist oder nicht. Standardwert ist „falsch“. Zone resilient images can be created only in regions that provide Zone Redundant Storage.
Globale Parameter
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID
konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.
az image delete
Ein Bild löschen.
az image delete [--ids]
[--image-name]
[--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
[--resource-group]
[--subscription]
Optionale Parameter
Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Dabei sollte es sich um eine vollständige Ressourcen-ID mit allen Informationen der Argumente "Ressourcen-ID" sein. Sie sollten entweder --ids oder andere Argumente für die Ressourcen-ID angeben.
Der Name des Bildes.
Nicht auf den Abschluss lang andauernder Vorgänge warten
Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name>
konfigurieren.
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
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID
konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.
az image list
Liste der Bilder unter einer Ressourcengruppe auf.
az image list [--max-items]
[--next-token]
[--resource-group]
Optionale Parameter
Die Gesamtanzahl der Elemente, die in der Ausgabe des Befehls zurückgegeben werden sollen. Wenn die Gesamtanzahl der verfügbaren Elemente größer als der angegebene Wert ist, wird ein Token in der Ausgabe des Befehls bereitgestellt. Um die Paginierung fortzusetzen, geben Sie den Tokenwert im --next-token
Argument eines nachfolgenden Befehls an.
Token, das angibt, wo die Paginierung beginnen soll. Dies ist der Tokenwert aus einer zuvor abgeschnittenen Antwort.
Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name>
konfigurieren.
Globale Parameter
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID
konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.
az image show
Rufen Sie ein Bild ab.
az image show [--expand]
[--ids]
[--image-name]
[--resource-group]
[--subscription]
Optionale Parameter
Der erweiterungsausdruck, der für den Vorgang angewendet werden soll.
Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Dabei sollte es sich um eine vollständige Ressourcen-ID mit allen Informationen der Argumente "Ressourcen-ID" sein. Sie sollten entweder --ids oder andere Argumente für die Ressourcen-ID angeben.
Der Name des Bildes.
Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name>
konfigurieren.
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
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID
konfigurieren.
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
Alle Tags entfernen.
az image update -n ImageName -g resourceGroup --tags
Optionale Parameter
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>
.
Wenn Sie "set" oder "add" verwenden, behalten Sie Zeichenfolgenliterale bei, anstatt zu versuchen, in JSON zu konvertieren.
Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Dabei sollte es sich um eine vollständige Ressourcen-ID mit allen Informationen der Argumente "Ressourcen-ID" sein. Sie sollten entweder --ids oder andere Argumente für die Ressourcen-ID angeben.
Der Name des Bildes. Erforderlich.
Entfernen sie eine Eigenschaft oder ein Element aus einer Liste. Beispiel: --remove property.list <indexToRemove>
ODER --remove propertyToRemove
.
Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name>
konfigurieren.
Aktualisieren Sie ein Objekt, indem Sie einen festzulegenden Eigenschaftspfad und -wert angeben. Beispiel: --set property1.property2=<value>
.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID
konfigurieren.
Durch Leerzeichen getrennte Tags: key[=value] [key[=value] ...]. Verwenden Sie "", um vorhandene Tags zu löschen.
Globale Parameter
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID
konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.
az image wait
Platzieren Sie die CLI in einem Wartezustand, bis eine Bedingung erfüllt ist.
az image wait [--created]
[--custom]
[--deleted]
[--exists]
[--expand]
[--ids]
[--image-name]
[--interval]
[--resource-group]
[--subscription]
[--timeout]
[--updated]
Optionale Parameter
Warten Sie, bis sie mit 'provisioningState' unter 'Succeeded' erstellt wurde.
Warten Sie, bis die Bedingung eine benutzerdefinierte JMESPath-Abfrage erfüllt. Beispiel: provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].
Warten Sie, bis sie gelöscht wurde.
Warten Sie, bis die Ressource vorhanden ist.
Der erweiterungsausdruck, der für den Vorgang angewendet werden soll.
Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Dabei sollte es sich um eine vollständige Ressourcen-ID mit allen Informationen der Argumente "Ressourcen-ID" sein. Sie sollten entweder --ids oder andere Argumente für die Ressourcen-ID angeben.
Der Name des Bildes.
Abrufintervall in Sekunden.
Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name>
konfigurieren.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID
konfigurieren.
Maximale Wartezeit in Sekunden.
Warten Sie, bis sie mit provisioningState unter 'Succeeded' aktualisiert wurde.
Globale Parameter
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID
konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.