Teilen über

az lab custom-image

  • Vorschau
  • Referenz

Befehlsgruppe "Lab" befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Verwalten von benutzerdefinierten Images eines Devtest Lab.

Befehle

Name Beschreibung Typ Status
az lab custom-image create

Erstellen Sie ein vorhandenes benutzerdefiniertes Bild. Dieser Vorgang kann eine Weile dauern.

 Kern Vorschau
az lab custom-image delete

Benutzerdefiniertes Bild löschen. Dieser Vorgang kann eine Weile dauern.

 Kern Vorschau
az lab custom-image list

Auflisten benutzerdefinierter Bilder in einer bestimmten Übung.

 Kern Vorschau
az lab custom-image show

Benutzerdefiniertes Bild abrufen.

 Kern Vorschau
az lab custom-image wait

Platzieren Sie die CLI in einem Wartezustand, bis eine Bedingung erfüllt ist.

 Kern Vorschau

az lab custom-image create

Bearbeiten
Vorschau

Befehlsgruppe "Lab" befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Erstellen Sie ein vorhandenes benutzerdefiniertes Bild. Dieser Vorgang kann eine Weile dauern.

az lab custom-image create --lab-name
                           --name
                           --os-state
                           --os-type {Linux, Windows}
                           --resource-group
                           --source-vm-id
                           [--author]
                           [--description]
                           [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]

Beispiele

Erstellen Sie ein benutzerdefiniertes Image in der Übung von einem ausgeführten virtuellen Windows-Computer, ohne sysprep anzuwenden.

az lab custom-image create --lab-name {LabName} -g {ResourceGroup} --name {VMName} --os-type Windows --os-state NonSysprepped --source-vm-id "/subscriptions/{SubID}/resourcegroups/{ResourceGroup}/providers/microsoft.devtestlab/labs/{LabName}/virtualmachines/{VMName}"

Erforderliche Parameter

--lab-name

Der Name des Labors.

--name -n

Der Name des benutzerdefinierten Bilds.

--os-state

Der aktuelle Zustand des virtuellen Computers. Für virtuelle Windows-Computer: NonSysprepped, SysprepRequested, SysprepApplied. Für virtuelle Linux-Computer: NonDeprovisioned, DeprovisionRequested, DeprovisionApplied.

--os-type

Typ des Betriebssystems, auf dem das benutzerdefinierte Image basiert.

Zulässige Werte: Linux, Windows
--resource-group -g

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

--source-vm-id

Die Ressourcen-ID eines virtuellen Computers in der bereitgestellten Übung.

Optionale Parameter

--author

Der Autor des benutzerdefinierten Bilds.

--description

Die Beschreibung des benutzerdefinierten Bilds.

--no-wait

Warten Sie nicht, bis der lange ausgeführte Vorgang abgeschlossen ist.

Zulässige Werte: 0, 1, f, false, n, no, t, true, y, yes
Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, 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

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

az lab custom-image delete

Bearbeiten
Vorschau

Befehlsgruppe "Lab" befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Benutzerdefiniertes Bild löschen. Dieser Vorgang kann eine Weile dauern.

az lab custom-image delete --lab-name
                           --name
                           --resource-group
                           [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                           [--yes]

Erforderliche Parameter

--lab-name

Der Name des Labors.

--name

Der Name des benutzerdefinierten Bilds.

--resource-group -g

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

Optionale Parameter

--no-wait

Warten Sie nicht, bis der lange ausgeführte Vorgang abgeschlossen ist.

Zulässige Werte: 0, 1, f, false, n, no, t, true, y, yes
--yes -y

Zur Bestätigung nicht auffordern.

Standardwert: False
Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, 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

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

az lab custom-image list

Bearbeiten
Vorschau

Befehlsgruppe "Lab" befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Auflisten benutzerdefinierter Bilder in einer bestimmten Übung.

az lab custom-image list --lab-name
                         --resource-group
                         [--expand]
                         [--filter]
                         [--max-items]
                         [--next-token]
                         [--orderby]
                         [--top]

Erforderliche Parameter

--lab-name

Der Name des Labors.

--resource-group -g

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

Optionale Parameter

--expand

Geben Sie die $expand Abfrage an. Beispiel: "properties($select=vm)".

--filter

Der Filter, der auf den Vorgang angewendet werden soll. Beispiel: '$filter=contains(name,'myName').

--max-items

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 in --next-token Argument eines nachfolgenden Befehls an.

--next-token

Token, das angibt, wo die Paginierung beginnen soll. Dies ist der Tokenwert aus einer zuvor abgeschnittenen Antwort.

--orderby

Der Sortierausdruck für die Ergebnisse unter Verwendung der OData-Schreibweise. Beispiel: '$orderby=name desc'.

--top

Die maximale Anzahl von Ressourcen, die vom Vorgang zurückgegeben werden sollen. Beispiel: '$top=10'.

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, 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

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

az lab custom-image show

Bearbeiten
Vorschau

Befehlsgruppe "Lab" befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Benutzerdefiniertes Bild abrufen.

az lab custom-image show --lab-name
                         --name
                         --resource-group
                         [--expand]

Erforderliche Parameter

--lab-name

Der Name des Labors.

--name

Der Name des benutzerdefinierten Bilds.

--resource-group -g

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

Optionale Parameter

--expand

Geben Sie die $expand Abfrage an. Beispiel: "properties($select=vm)".

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, 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

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

az lab custom-image wait

Bearbeiten
Vorschau

Befehlsgruppe "Lab" befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Platzieren Sie die CLI in einem Wartezustand, bis eine Bedingung erfüllt ist.

az lab custom-image wait [--created]
                         [--custom]
                         [--deleted]
                         [--exists]
                         [--expand]
                         [--ids]
                         [--interval]
                         [--lab-name]
                         [--name]
                         [--resource-group]
                         [--subscription]
                         [--timeout]
                         [--updated]

Optionale Parameter

--created

Warten Sie, bis sie mit 'provisioningState' unter 'Succeeded' erstellt wurde.

Standardwert: False
--custom

Warten Sie, bis die Bedingung eine benutzerdefinierte JMESPath-Abfrage erfüllt. Beispiel: provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Warten Sie, bis sie gelöscht wurde.

Standardwert: False
--exists

Warten Sie, bis die Ressource vorhanden ist.

Standardwert: False
--expand

Geben Sie die $expand Abfrage an. Beispiel: "properties($select=vm)".

--ids

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

--interval

Abrufintervall in Sekunden.

Standardwert: 30
--lab-name

Der Name des Labors.

--name

Der Name des benutzerdefinierten Bilds.

--resource-group -g

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

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--timeout

Maximale Wartezeit in Sekunden.

Standardwert: 3600
--updated

Warten Sie, bis sie mit provisioningState unter 'Succeeded' aktualisiert wurde.

Standardwert: False
Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, 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

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.