Freigeben über

az stack-hci-vm image

  • Referenz

Hinweis

Diese Referenz ist Teil der Stack-hci-vm-Erweiterung für die Azure CLI (Version 2.15.0 oder höher). Die Erweiterung wird automatisch installiert, wenn Sie einen az stack-hci-vm-Imagebefehl zum ersten Mal ausführen. Weitere Informationen zu Erweiterungen

Verwalten von Images mit stack-hci-vm.

Befehle

Name Beschreibung Typ Status
az stack-hci-vm image create

Erstellen Sie ein Katalogbild.

 Erweiterung Allgemein verfügbar
az stack-hci-vm image delete

Löschen eines Images.

 Erweiterung Allgemein verfügbar
az stack-hci-vm image list

Listet alle Katalogbilder auf.

 Erweiterung Allgemein verfügbar
az stack-hci-vm image show

Rufen Sie die Details eines Bilds ab.

 Erweiterung Allgemein verfügbar
az stack-hci-vm image update

Aktualisieren eines Bilds.

 Erweiterung Allgemein verfügbar

az stack-hci-vm image create

Erstellen Sie ein Katalogbild.

az stack-hci-vm image create --custom-location
                             --name
                             --os-type
                             --resource-group
                             [--image-path]
                             [--location]
                             [--offer]
                             [--polling-interval]
                             [--publisher]
                             [--sku]
                             [--storage-path-id]
                             [--tags]
                             [--urn]
                             [--version]

Beispiele

PutGalleryImage

az stack-hci-vm image create --custom-location "/subscriptions/a95612cb-f1fa-4daa-a4fd-272844fa512c/resourceGroups/dogfoodarc/providers/Microsoft.ExtendedLocation/customLocations/dogfood-location" --location "West US2" --storage-path-id "/subscriptions/a95612cb-f1fa-4daa-a4fd-272844fa512c/resourceGroups/dogfoodarc/providers/Microsoft.AzureStackHCI/storagecontainers/test-storagepath" --image-path "C:\\test.vhdx" --name "test-gallery-image" --resource-group "test-rg" --os-type "Windows"

Erforderliche Parameter

--custom-location

Die ID des erweiterten Speicherorts.

--name

Name des Katalogbilds.

--os-type

Betriebssystemtyp [Windows, Linux].

--resource-group -g

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

Optionale Parameter

--image-path

Speicherort/Pfad des Bilds, aus dem das Katalogbild erstellt werden soll.

--location -l

Wenn kein Speicherort angegeben ist, wird der Speicherort der Ressourcengruppe verwendet.

--offer

Angebot für Marketplace-Image.

Nutzung: --angebot.

--polling-interval

ARM-Abrufintervall für Lange ausgeführte Vorgänge.

--publisher

Publisher für Marketplace-Bild.

Verwendung: --publisher.

--sku

Sku für Marketplace-Image.

Verwendung: --sku.

--storage-path-id

Azure-ID des Speicherpfads, der zum Speichern der Katalogbilder verwendet wird.

--tags

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

--urn

URN im Format "publisher:offer:sku:version". Wenn angegeben, können andere Argumentwerte weggelassen werden.

--version

Version für Marketplace-Image. (Dies wird ignoriert, wenn --urn übergeben wird).

Verwendung: --version.

Standardwert: latest
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.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--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 stack-hci-vm image delete

Löschen eines Images.

az stack-hci-vm image delete [--ids]
                             [--name]
                             [--polling-interval]
                             [--resource-group]
                             [--subscription]
                             [--yes]

Beispiele

DeleteGalleryImage

az stack-hci-vm image delete --name "test-gallery-image" --resource-group "test-rg"

Optionale Parameter

--ids

Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Dabei sollte es sich um eine vollständige Ressourcen-ID mit allen Informationen der „Ressource id“-Argumente handeln. Sie sollten entweder „--ids“ oder andere „Resource Id“-Argumente angeben.

--name

Name des Katalogbilds.

--polling-interval

ARM-Abrufintervall für Lange ausgeführte Vorgänge.

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

--yes -y

Nicht zur Bestätigung auffordern

Standardwert: False
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.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--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 stack-hci-vm image list

Listet alle Katalogbilder auf.

az stack-hci-vm image list [--resource-group]

Beispiele

ListGalleryImageByResourceGroup

az stack-hci-vm image list --resource-group "test-rg"

ListGalleryImageBySubscription

az stack-hci-vm image list

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.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--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 stack-hci-vm image show

Rufen Sie die Details eines Bilds ab.

az stack-hci-vm image show [--ids]
                           [--name]
                           [--resource-group]
                           [--subscription]

Beispiele

GetGalleryImage

az stack-hci-vm image show --name "test-gallery-image" --resource-group "test-rg"

Optionale Parameter

--ids

Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Dabei sollte es sich um eine vollständige Ressourcen-ID mit allen Informationen der „Ressource id“-Argumente handeln. Sie sollten entweder „--ids“ oder andere „Resource Id“-Argumente angeben.

--name

Name des Katalogbilds.

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

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--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 stack-hci-vm image update

Aktualisieren eines Bilds.

az stack-hci-vm image update [--ids]
                             [--name]
                             [--polling-interval]
                             [--resource-group]
                             [--subscription]
                             [--tags]

Beispiele

UpdateGalleryImage

az stack-hci-vm image update --tags additionalProperties="sample" --name "test-gallery-image" --resource-group "test-rg"

Optionale Parameter

--ids

Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Dabei sollte es sich um eine vollständige Ressourcen-ID mit allen Informationen der „Ressource id“-Argumente handeln. Sie sollten entweder „--ids“ oder andere „Resource Id“-Argumente angeben.

--name

Name des Katalogbilds.

--polling-interval

ARM-Abrufintervall für Lange ausgeführte Vorgänge.

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

--tags

Durch Leerzeichen getrennte 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.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--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.