Feedback

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

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

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.

--resource-group -g

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

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.

az image show

Ruft ein Bild ab.

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

Optionale Parameter

--expand

Der erweiterungsausdruck, der auf 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 der Argumente "Resource Id" enthält. Sie sollten entweder --ids oder andere Argumente "Resource Id" 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.

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 einem Objekt eine Liste von Objekten 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 Zeichenfolgen literale beibehalten, anstatt zu versuchen, in JSON zu konvertieren.

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

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

--tags

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