az image

Verwalten benutzerdefinierter VM-Images.

Befehle

az image builder

Verwalten und Erstellen von Image Builder-Vorlagen.

az image builder cancel

Brechen Sie die Imageerstellung mit langer Laufzeit basierend auf der Imagevorlage ab.

az image builder create

Erstellen Sie eine Image Builder-Vorlage.

az image builder customizer

Verwalten von Vorlagenanpassern für Image Builder

az image builder customizer add

Fügen Sie einer Image Builder-Vorlage einen Image Builder-Benutzerdefinierter hinzu.

az image builder customizer clear

Entfernen Sie alle Anpasser für Image Builder aus einer Image Builder-Vorlage.

az image builder customizer remove

Entfernen Sie einen Image Builder-Anpasser aus einer Image Builder-Vorlage.

az image builder delete

Löschen Sie die Image Builder-Vorlage.

az image builder list

Auflisten von Image Builder-Vorlagen.

az image builder output

Verwalten von Image Builder-Vorlagenausgabeverteilern.

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 eines Image Builder-Ausgabeverteilers 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

Anzeigen der Ausführungsausgabe einer Image Builder-Vorlage.

az image builder update

Aktualisieren einer Image Builder-Vorlage.

az image builder wait

Platzieren Sie die CLI in einen Wartezustand, bis eine Bedingung der Vorlage erfüllt ist.

az image copy

Kopieren Sie ein verwaltetes Image (oder einen virtuellen Computer) in andere Regionen. Der Quelldatenträger muss verfügbar sein.

az image create

Erstellen Sie ein benutzerdefiniertes VM-Image 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 sie benutzerdefinierte VM-Images.

az image copy

Kopieren Sie ein verwaltetes Image (oder einen virtuellen Computer) in andere Regionen. Der Quelldatenträger muss verfügbar sein.

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 Image in mehrere Regionen, und bereinigen Sie es 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

Durch Leerzeichen getrennte Standortliste zum Erstellen des Images 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.

--export-as-snapshot

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

--parallel-degree

Anzahl paralleler Kopiervorgänge.

Standardwert: -1
--source-type

Image oder VM.

Zulässige Werte: image, vm
Standardwert: image
--tags

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

--target-name

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 das temporäre Speicherkonto erstellt wird. --temporary_resource_group_name ist in 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) kopieren möchten, z. B. 512 GB oder mehr.

Standardwert: 3600

az image create

Erstellen Sie ein benutzerdefiniertes VM-Image 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 {Premium_LRS, Premium_ZRS, StandardSSD_LRS, StandardSSD_ZRS, Standard_LRS, UltraSSD_LRS}]
                [--subscription]
                [--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 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 Virtuellen Computers, eines Betriebssystemdatenträger-Blob-URI, einer verwalteten Betriebssystemdatenträger-ID oder eines verwalteten Betriebssystem-Datenträgernamens oder einer Betriebssystemmomentaufnahme-ID oder eines Betriebssystem-Momentaufnahmenamens.

Optionale Parameter

--data-disk-caching

Storage Cachetyp für den Datenträger des Images.

Zulässige Werte: None, ReadOnly, ReadWrite
--data-disk-sources

Durch Leerzeichen getrennte Liste von Datenträgerquellen, 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

Storage Cachetyp 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. Nicht verwendet, wenn die Quell-VM angegeben ist.

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

Der Name oder die ID des Abonnements. Sie können das Standardabonnement mit az account set -s NAME_OR_ID konfigurieren.

--tags

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

--zone-resilient

Gibt an, ob ein Image zonenresilient ist oder nicht. Der Standardwert ist "false". Zonenresilienzimages können nur in Regionen erstellt werden, die zonenredundante Storage bereitstellen.

Zulässige Werte: false, true

az image delete

Löscht ein Bild.

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

Optionale Parameter

--ids

Mindestens eine Ressourcen-IDs (durch Leerzeichen getrennt). Dabei sollte es sich um eine vollständige Ressourcen-ID mit allen Informationen von "Resource Id"-Argumenten sein. Sie sollten entweder --ids oder andere "Resource Id"-Argumente angeben.

--name -n

Der Name des Bildes.

--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 Standardabonnement mit az account set -s NAME_OR_ID konfigurieren.

az image list

Listet benutzerdefinierte VM-Images auf.

az image list [--query-examples]
              [--resource-group]
              [--subscription]

Optionale Parameter

--query-examples

Empfehlen Sie die JMESPath-Zeichenfolge für Sie. Sie können eine der Abfragen kopieren und nach dem Parameter --query in doppelte Anführungszeichen einfügen, um die Ergebnisse anzuzeigen. Sie können ein oder mehrere Positionsschlüsselwörter hinzufügen, damit wir basierend auf diesen Schlüsselwörtern Vorschläge geben können.

--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 Standardabonnement mit az account set -s NAME_OR_ID konfigurieren.

az image show

Ruft ein Bild ab.

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

Optionale Parameter

--expand

Der erweiterungsausdruck, der auf den Vorgang angewendet werden soll.

--ids

Mindestens eine Ressourcen-IDs (durch Leerzeichen getrennt). Dabei sollte es sich um eine vollständige Ressourcen-ID mit allen Informationen von "Resource Id"-Argumenten sein. Sie sollten entweder --ids oder andere "Resource Id"-Argumente angeben.

--name -n

Der Name des Bildes.

--query-examples

Empfehlen Sie die JMESPath-Zeichenfolge für Sie. Sie können eine der Abfragen kopieren und nach dem Parameter --query in doppelte Anführungszeichen einfügen, um die Ergebnisse anzuzeigen. Sie können ein oder mehrere Positionsschlüsselwörter hinzufügen, damit wir basierend auf diesen Schlüsselwörtern Vorschläge geben können.

--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 Standardabonnement mit az account set -s NAME_OR_ID konfigurieren.

az image update

Aktualisieren sie benutzerdefinierte VM-Images.

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

Beispiele

Fügen Sie Tags hinzu, oder aktualisieren Sie sie.

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 oder JSON string>.

--force-string

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

--ids

Mindestens eine Ressourcen-IDs (durch Leerzeichen getrennt). Dabei sollte es sich um eine vollständige Ressourcen-ID mit allen Informationen von "Resource Id"-Argumenten sein. Sie sollten entweder --ids oder andere "Resource Id"-Argumente angeben.

--name -n

Der Name des Bildes.

--remove

Entfernen sie eine Eigenschaft oder ein Element 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 festzulegenden Eigenschaftenpfad und -wert angeben. Beispiel: --set property1.property2=.

--subscription

Der Name oder die ID des Abonnements. Sie können das Standardabonnement mit az account set -s NAME_OR_ID konfigurieren.

--tags

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