az image

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

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

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.

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.

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.

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

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.

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