az ml environment
Hinweis
Diese Referenz ist Teil der ml-Erweiterung für die Azure CLI (Version 2.15.0 oder höher). Die Erweiterung wird beim ersten Ausführen eines Az ml-Umgebungsbefehls automatisch installiert. Weitere Informationen zu Erweiterungen
Verwalten von Azure ML-Umgebungen.
Azure ML-Umgebungen definieren die Ausführungsumgebung für Aufträge und Endpunktbereitstellungen, Kapseln der Abhängigkeiten für Schulungen und Rückschlüsse. Diese Umgebungsdefinitionen sind in Docker-Images integriert.
Befehle
| Name | Beschreibung | Typ | Status |
|---|---|---|---|
| az ml environment archive |
Archiven einer Umgebung. |
Erweiterung | Allgemein verfügbar |
| az ml environment create |
Umgebung erstellen |
Erweiterung | Allgemein verfügbar |
| az ml environment list |
Listen von Umgebungen in einem Arbeitsbereich auf. |
Erweiterung | Allgemein verfügbar |
| az ml environment restore |
Stellen Sie eine archivierte Umgebung wieder her. |
Erweiterung | Allgemein verfügbar |
| az ml environment share |
Teilen Sie eine bestimmte Umgebung von Arbeitsbereich zu Registrierung. |
Erweiterung | Allgemein verfügbar |
| az ml environment show |
Details für eine Umgebung anzeigen. |
Erweiterung | Allgemein verfügbar |
| az ml environment update |
Aktualisieren sie eine Umgebung. |
Erweiterung | Allgemein verfügbar |
az ml environment archive
Archiven einer Umgebung.
Beim Archivieren einer Umgebung wird sie standardmäßig in Listenabfragen (az ml environment list) angezeigt. Sie können weiterhin auf eine archivierte Umgebung in Ihren Workflows verweisen und diese verwenden. Sie können entweder einen Umgebungscontainer oder eine bestimmte Umgebungsversion archivieren. Beim Archivieren eines Umgebungscontainers werden alle Versionen der Umgebung unter diesem angegebenen Namen archiviert. Sie können eine archivierte Umgebung mithilfe von az ml environment restore. Wenn der gesamte Umgebungscontainer archiviert wird, können Sie einzelne Versionen der Umgebung nicht wiederherstellen . Sie müssen den Umgebungscontainer wiederherstellen.
az ml environment archive --name
[--label]
[--registry-name]
[--resource-group]
[--version]
[--workspace-name]Beispiele
Archivieren eines Umgebungscontainers (archiviert alle Versionen dieser Umgebung)
az ml environment archive --name my-env --resource-group my-resource-group --workspace-name my-workspaceArchiv a specific environment version
az ml environment archive --name my-env --version 1 --resource-group my-resource-group --workspace-name my-workspaceErforderliche Parameter
Der Name der Umgebung.
Optionale Parameter
Bezeichnung der Umgebung.
Wenn angegeben, zielt der Befehl auf die Registrierung anstelle eines Arbeitsbereichs ab. Daher sind Ressourcengruppen und Arbeitsbereiche nicht erforderlich.
Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.
Die Version der Umgebung.
Name des Azure ML-Arbeitsbereichs. Sie können den Standardarbeitsbereich mithilfe von az configure --defaults workspace=<name>.
Globale Parameter
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.
az ml environment create
Umgebung erstellen
Umgebungen können aus einer Docker-Image-, Dockerfile- oder Conda-Datei definiert werden. Azure ML Standard enthält eine Reihe von CPU- und GPU-Docker-Images, die Sie als Basisimages verwenden können. Informationen zu diesen Bildern finden Sie unter https://github.com/Azure/AzureML-Containers.
Die erstellte Umgebung wird im Arbeitsbereich unter dem angegebenen Namen und der angegebenen Version nachverfolgt.
az ml environment create [--build-context]
[--conda-file]
[--datastore]
[--description]
[--dockerfile-path]
[--file]
[--image]
[--name]
[--no-wait]
[--os-type]
[--registry-name]
[--resource-group]
[--set]
[--tags]
[--version]
[--workspace-name]Beispiele
Erstellen einer Umgebung aus einer YAML-Spezifikationsdatei
az ml environment create --file my_env.yml --resource-group my-resource-group --workspace-name my-workspaceErstellen einer Umgebung aus einem Docker-Image
az ml environment create --name my-env --version 1 --file my_env.yml --image pytorch/pytorch --resource-group my-resource-group --workspace-name my-workspaceErstellen einer Umgebung aus einem Buildkontext
az ml environment create --name my-env --version 1 --file my_env.yml --build-context envs/context/ --dockerfile-path Dockerfile --resource-group my-resource-group --workspace-name my-workspaceErstellen einer Umgebung aus einer Conda-Spezifikation
az ml environment create --name my-env --version 1 --file my_env.yml --conda-file conda_dep.yml --image mcr.microsoft.com/azureml/openmpi3.1.2-ubuntu18.04 --resource-group my-resource-group --workspace-name my-workspaceErstellen einer Umgebung in der Registrierung aus einer YAML-Spezifikationsdatei
az ml environment create --file my_env.yml --registry-name my-registry-name --resource-group my-resource-groupOptionale Parameter
Lokaler Pfad zum Verzeichnis, das als Docker-Buildkontext verwendet werden soll. --build-context/-b und --image/-i sind sich gegenseitig ausschließende Argumente.
Lokaler Pfad zu einer Conda-Spezifikationsdatei. --image/-i muss auch angegeben werden, wenn dieses Argument verwendet wird.
Der Datenspeicher, in den das lokale Artefakt hochgeladen werden soll.
Die Beschreibung der Umgebung.
Relativer Pfad zur Dockerfile-Datei innerhalb des durch --build-context/-b angegebenen Verzeichnisses. Wenn nicht angegeben, wird "./Dockerfile" verwendet.
Lokaler Pfad zur YAML-Datei, die die Azure ML-Umgebungsspezifikation enthält. Die YAML-Referenzdokumente für Die Umgebung finden Sie unter: https://aka.ms/ml-cli-v2-environment-yaml-reference.
Docker-Image. --image/-i und --build-context/-b sind sich gegenseitig ausschließende Argumente.
Der Name der Umgebung.
Nicht auf den Abschluss lang andauernder Vorgänge warten
Typ des Betriebssystems. Zulässige Werte: Linux, Fenster. Standard: linux.
Wenn angegeben, zielt der Befehl auf die Registrierung anstelle eines Arbeitsbereichs ab. Daher sind Ressourcengruppen und Arbeitsbereiche nicht erforderlich.
Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.
Aktualisieren Sie ein Objekt, indem Sie einen festzulegenden Eigenschaftspfad und -wert angeben. Beispiel: --set property1.property2=.
Leerzeichentrennte Schlüssel-Wert-Paare für die Tags des Objekts.
Die Version der Umgebung.
Name des Azure ML-Arbeitsbereichs. Sie können den Standardarbeitsbereich mithilfe von az configure --defaults workspace=<name>.
Globale Parameter
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.
az ml environment list
Listen von Umgebungen in einem Arbeitsbereich auf.
az ml environment list [--archived-only]
[--include-archived]
[--max-results]
[--name]
[--registry-name]
[--resource-group]
[--workspace-name]Beispiele
Auflisten aller Umgebungen in einem Arbeitsbereich
az ml environment list --resource-group my-resource-group --workspace-name my-workspaceAuflisten aller Umgebungsversionen für den angegebenen Namen in einem Arbeitsbereich
az ml environment list --name my-env --resource-group my-resource-group --workspace-name my-workspaceAuflisten aller Umgebungen in einem Arbeitsbereich mithilfe des Arguments --query zum Ausführen einer JMESPath-Abfrage für die Ergebnisse von Befehlen.
az ml environment list --query "[].{Name:name}" --output table --resource-group my-resource-group --workspace-name my-workspaceAuflisten aller Umgebungen in einer Registrierung
az ml environment list --registry-name my-registry-name --resource-group my-resource-groupAuflisten aller Umgebungsversionen für den angegebenen Namen in einer Registrierung
az ml environment list --name my-env --registry-name my-registry-name --resource-group my-resource-groupOptionale Parameter
Nur archivierte Umgebungen auflisten.
Auflisten archivierter Umgebungen und aktiver Umgebungen.
Maximale Anzahl der zurückzugebenden Ergebnisse.
Der Name der Umgebung. Wenn angegeben, werden alle Umgebungsversionen unter diesem Namen zurückgegeben.
Wenn angegeben, zielt der Befehl auf die Registrierung anstelle eines Arbeitsbereichs ab. Daher sind Ressourcengruppen und Arbeitsbereiche nicht erforderlich.
Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.
Name des Azure ML-Arbeitsbereichs. Sie können den Standardarbeitsbereich mithilfe von az configure --defaults workspace=<name>.
Globale Parameter
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.
az ml environment restore
Stellen Sie eine archivierte Umgebung wieder her.
Wenn eine archivierte Umgebung wiederhergestellt wird, wird sie nicht mehr in Listenabfragen (az ml environment list) ausgeblendet. Wenn ein gesamter Umgebungscontainer archiviert wird, können Sie diesen archivierten Container wiederherstellen. Dadurch werden alle Versionen der Umgebung unter diesem angegebenen Namen wiederhergestellt. Sie können nur eine bestimmte Umgebungsversion wiederherstellen, wenn der gesamte Umgebungscontainer archiviert ist - Sie müssen den gesamten Container wiederherstellen. Wenn nur eine einzelne Umgebungsversion archiviert wurde, können Sie diese bestimmte Version wiederherstellen.
az ml environment restore --name
[--label]
[--registry-name]
[--resource-group]
[--version]
[--workspace-name]Beispiele
Wiederherstellen eines archivierten Umgebungscontainers (stellt alle Versionen dieser Umgebung wieder her)
az ml environment restore --name my-env --resource-group my-resource-group --workspace-name my-workspaceWiederherstellen einer bestimmten archivierten Umgebungsversion
az ml environment restore --name my-env --version 1 --resource-group my-resource-group --workspace-name my-workspaceErforderliche Parameter
Der Name der Umgebung.
Optionale Parameter
Bezeichnung der Umgebung.
Wenn angegeben, zielt der Befehl auf die Registrierung anstelle eines Arbeitsbereichs ab. Daher sind Ressourcengruppen und Arbeitsbereiche nicht erforderlich.
Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.
Die Version der Umgebung.
Name des Azure ML-Arbeitsbereichs. Sie können den Standardarbeitsbereich mithilfe von az configure --defaults workspace=<name>.
Globale Parameter
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.
az ml environment share
Teilen Sie eine bestimmte Umgebung von Arbeitsbereich zu Registrierung.
Kopieren Sie eine vorhandene Umgebung aus einem Arbeitsbereich in eine Registrierung für die Wiederverwendung von Arbeitsbereichen.
az ml environment share --name
--registry-name
--share-with-name
--share-with-version
--version
[--resource-group]
[--workspace-name]Beispiele
Freigeben einer vorhandenen Umgebung von Arbeitsbereich zu Registrierung
az ml environment share --name my-environment --version my-version --resource-group my-resource-group --workspace-name my-workspace --share-with-name new-name-in-registry --share-with-version new-version-in-registry --registry-name my-registryErforderliche Parameter
Der Name der Umgebung.
Zielregistrierung.
Name der Umgebung, mit der erstellt werden soll.
Version der Umgebung, mit der erstellt werden soll.
Die Version der Umgebung.
Optionale Parameter
Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.
Name des Azure ML-Arbeitsbereichs. Sie können den Standardarbeitsbereich mithilfe von az configure --defaults workspace=<name>.
Globale Parameter
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.
az ml environment show
Details für eine Umgebung anzeigen.
az ml environment show --name
[--label]
[--registry-name]
[--resource-group]
[--version]
[--workspace-name]Beispiele
Anzeigen von Details für eine Umgebung mit dem angegebenen Namen und der angegebenen Version
az ml environment show --name my-env --version 1 --resource-group my-resource-group --workspace-name my-workspaceAnzeigen von Details zu einer Umgebung in der Registrierung mit dem angegebenen Namen und der angegebenen Version
az ml environment show --name my-env --version 1 --registry-name my-registry-name --resource-group my-resource-groupErforderliche Parameter
Der Name der Umgebung.
Optionale Parameter
Bezeichnung der Umgebung.
Wenn angegeben, zielt der Befehl auf die Registrierung anstelle eines Arbeitsbereichs ab. Daher sind Ressourcengruppen und Arbeitsbereiche nicht erforderlich.
Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.
Die Version der Umgebung.
Name des Azure ML-Arbeitsbereichs. Sie können den Standardarbeitsbereich mithilfe von az configure --defaults workspace=<name>.
Globale Parameter
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.
az ml environment update
Aktualisieren sie eine Umgebung.
Nur die Eigenschaften "description" und "tags" können aktualisiert werden.
az ml environment update --name
[--add]
[--force-string]
[--label]
[--registry-name]
[--remove]
[--resource-group]
[--set]
[--version]
[--workspace-name]Erforderliche Parameter
Der Name der Umgebung.
Optionale Parameter
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>.
Wenn Sie "set" oder "add" verwenden, behalten Sie Zeichenfolgenliterale bei, anstatt zu versuchen, in JSON zu konvertieren.
Bezeichnung der Umgebung.
Wenn angegeben, zielt der Befehl auf die Registrierung anstelle eines Arbeitsbereichs ab. Daher sind Ressourcengruppen und Arbeitsbereiche nicht erforderlich.
Entfernen sie eine Eigenschaft oder ein Element aus einer Liste. Beispiel: --remove property.list <indexToRemove> ODER --remove propertyToRemove.
Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.
Aktualisieren Sie ein Objekt, indem Sie einen festzulegenden Eigenschaftspfad und -wert angeben. Beispiel: --set property1.property2=<value>.
Die Version der Umgebung.
Name des Azure ML-Arbeitsbereichs. Sie können den Standardarbeitsbereich mithilfe von az configure --defaults workspace=<name>.
Globale Parameter
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für