Feedback

az ml component

  • Referenz

Hinweis

Dieser Verweis 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-Komponentenbefehls automatisch installiert. Weitere Informationen zu Erweiterungen

Verwalten von Azure ML-Komponenten.

Azure ML-Komponente definiert die Konfiguration der Komponente für Pipelineaufträge. Sie können die Eingabe-/Ausgabeports, die Ausführungsumgebung und den Befehl der Komponente konfigurieren. Nachdem die Komponente erstellt wurde, können Sie auf die Komponenten im Pipelineauftrag verweisen, um sie in Docker-Containern auszuführen.

Befehle

az ml component archive

Archiven sie eine Komponente.
az ml component create

Erstellen einer Komponente.
az ml component list

Listen von Komponenten in einem Arbeitsbereich auf.
az ml component restore

Wiederherstellen einer archivierten Komponente.
az ml component show

Details für eine Komponente anzeigen.
az ml component update

Aktualisieren einer Komponente. Derzeit nur einige Felder(Beschreibung, display_name) unterstützen das Update.

az ml component archive

Archiven sie eine Komponente.

Die Archivierung einer Komponente wird standardmäßig aus Listenabfragen (az ml component list) ausgeblendet. Sie können weiterhin auf eine archivierte Komponente in Ihren Pipelines verweisen und verwenden. Sie können entweder einen Komponentencontainer oder eine bestimmte Komponentenversion archiven. Das Archivieren eines Komponentencontainers archiviert alle Versionen der Komponente unter diesem Angegebenen Namen. Sie können eine archivierte Komponente mithilfe az ml component restorevon . Wenn der gesamte Komponentencontainer archiviert wird, können Sie keine einzelnen Versionen der Komponente wiederherstellen – Sie müssen den Komponentencontainer wiederherstellen.

az ml component archive --name
                        --resource-group
                        --workspace-name
                        [--label]
                        [--version]

Beispiele

Archivieren eines Komponentencontainers (archiviert alle Versionen dieser Komponente)

az ml component archive --name my-component --resource-group my-resource-group --workspace-name my-workspace

Archiven einer bestimmten Komponentenversion

az ml component archive --name my-component --version 1 --resource-group my-resource-group --workspace-name my-workspace

Erforderliche Parameter

--name -n

Der Name der Komponente.

--resource-group -g

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

--workspace-name -w

Name des Azure ML-Arbeitsbereichs. Sie können die Standardgruppe mit az configure --defaults workspace=<name> konfigurieren.

Optionale Parameter

--label -l

Bezeichnung der Komponente.

--version -v

Version der Komponente.

az ml component create

Erstellen einer Komponente.

az ml component create --file
                       --resource-group
                       --workspace-name
                       [--name]
                       [--set]
                       [--version]

Beispiele

Erstellen einer Komponente aus einer YAML-Spezifikationsdatei

az ml component create --file my_component.yml --resource-group my-resource-group --workspace-name my-workspace

Erstellen einer Komponente aus einer YAML-Spezifikationsdatei mit angegebener Version

az ml component create --file my_component.yml --version 1 --resource-group my-resource-group --workspace-name my-workspace

Erforderliche Parameter

--file -f

Lokaler Pfad zur YAML-Datei, die die Azure ML-Komponentenspezifikation enthält. Die YAML-Referenzdokumente für Komponenten finden Sie unter: https://aka.ms/ml-cli-v2-component-command-yaml-reference.

--resource-group -g

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

--workspace-name -w

Name des Azure ML-Arbeitsbereichs. Sie können die Standardgruppe mit az configure --defaults workspace=<name> konfigurieren.

Optionale Parameter

--name -n

Der Name der Komponente.

--set

Aktualisieren Sie ein Objekt, indem Sie einen Eigenschaftenpfad und einen wert angeben, der festgelegt werden soll. Beispiel: --set-property1.property2=.

--version -v

Version der Komponente.

az ml component list

Listen von Komponenten in einem Arbeitsbereich auf.

az ml component list --resource-group
                     --workspace-name
                     [--archived-only]
                     [--include-archived]
                     [--max-results]
                     [--name]

Beispiele

Alle Komponenten in einem Arbeitsbereich auflisten

az ml component list --resource-group my-resource-group --workspace-name my-workspace

Alle Komponentenversionen für den angegebenen Namen in einem Arbeitsbereich auflisten

az ml component list --name my-component --resource-group my-resource-group --workspace-name my-workspace

Listet alle Komponenten in einem Arbeitsbereich mit dem Argument --query auf, um eine JMESPath-Abfrage auf den Ergebnissen von Befehlen auszuführen.

az ml component list --query "[].{Name:name}"  --output table --resource-group my-resource-group --workspace-name my-workspace

Erforderliche Parameter

--resource-group -g

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

--workspace-name -w

Name des Azure ML-Arbeitsbereichs. Sie können die Standardgruppe mit az configure --defaults workspace=<name> konfigurieren.

Optionale Parameter

--archived-only

Nur archivierte Komponenten auflisten.

--include-archived

Listet archivierte Komponenten und aktive Komponenten auf.

--max-results -r

Maximale Anzahl von Ergebnissen, die zurückgegeben werden sollen.

--name -n

Der Name der Komponente.

az ml component restore

Wiederherstellen einer archivierten Komponente.

Wenn eine archivierte Komponente wiederhergestellt wird, wird sie nicht mehr von Listenabfragen ausgeblendet (az ml component list). Wenn ein gesamtes Komponentencontainer archiviert wird, können Sie diesen archivierten Container wiederherstellen. Dadurch werden alle Versionen der Komponente unter diesem Angegebenen Namen wiederhergestellt. Sie können nur eine bestimmte Komponentenversion wiederherstellen, wenn der gesamte Komponentencontainer archiviert wird – Sie müssen den gesamten Container wiederherstellen. Wenn nur eine einzelne Komponentenversion archiviert wurde, können Sie diese bestimmte Version wiederherstellen.

az ml component restore --name
                        --resource-group
                        --workspace-name
                        [--label]
                        [--version]

Beispiele

Wiederherstellen eines archivierten Komponentencontainers (wiederherstellen alle Versionen dieser Komponente)

az ml component restore --name my-component --resource-group my-resource-group --workspace-name my-workspace

Wiederherstellen einer bestimmten archivierten Komponentenversion

az ml component restore --name my-component --version 1 --resource-group my-resource-group --workspace-name my-workspace

Erforderliche Parameter

--name -n

Der Name der Komponente.

--resource-group -g

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

--workspace-name -w

Name des Azure ML-Arbeitsbereichs. Sie können die Standardgruppe mit az configure --defaults workspace=<name> konfigurieren.

Optionale Parameter

--label -l

Bezeichnung der Komponente.

--version -v

Version der Komponente.

az ml component show

Details für eine Komponente anzeigen.

az ml component show --name
                     --resource-group
                     --workspace-name
                     [--label]
                     [--version]

Beispiele

Detail für eine Komponente mit dem angegebenen Namen und der angegebenen Version anzeigen

az ml component show --name my-component --version 1 --resource-group my-resource-group --workspace-name my-workspace

Erforderliche Parameter

--name -n

Der Name der Komponente.

--resource-group -g

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

--workspace-name -w

Name des Azure ML-Arbeitsbereichs. Sie können die Standardgruppe mit az configure --defaults workspace=<name> konfigurieren.

Optionale Parameter

--label -l

Bezeichnung der Komponente.

--version -v

Version der Komponente.

az ml component update

Aktualisieren einer Komponente. Derzeit nur einige Felder(Beschreibung, display_name) unterstützen das Update.

az ml component update --name
                       --resource-group
                       --workspace-name
                       [--add]
                       [--force-string]
                       [--label]
                       [--remove]
                       [--set]
                       [--version]

Beispiele

Aktualisieren der Beschreibung einer Komponente

az ml component update -n my_component -v 1 --set description="new description" -g my-resource-group -w my-workspace

Erforderliche Parameter

--name -n

Der Name der Komponente.

--resource-group -g

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

--workspace-name -w

Name des Azure ML-Arbeitsbereichs. Sie können die Standardgruppe mit az configure --defaults workspace=<name> konfigurieren.

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.

--label -l

Bezeichnung der Komponente.

--remove

Entfernen Sie eine Eigenschaft oder ein Element aus einer Liste. Beispiel: --remove property.list OR --remove propertyToRemove.

--set

Aktualisieren Sie ein Objekt, indem Sie einen Eigenschaftenpfad und einen wert angeben, der festgelegt werden soll. Beispiel: --set-property1.property2=.

--version -v

Version der Komponente.