Freigeben über


az ml connection

Hinweis

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

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

Verwalten Sie die Azure ML-Arbeitsbereichsverbindung und ihre spezifischeren Ableitungen.

Die Azure ML-Verbindung bietet eine sichere Möglichkeit zum Speichern von Authentifizierungs- und Konfigurationsinformationen, die für die Verbindung und Interaktion mit den externen Ressourcen erforderlich sind.

Befehle

Name Beschreibung Typ Status
az ml connection create

Erstellen Sie eine Verbindung.

Erweiterung Vorschau
az ml connection delete

Löschen einer Verbindung.

Erweiterung Vorschau
az ml connection list

Alle Verbindungen auflisten.

Erweiterung Vorschau
az ml connection show

Details einer Verbindung anzeigen.

Erweiterung Vorschau
az ml connection update

Aktualisieren einer Verbindung.

Erweiterung Vorschau

az ml connection create

Vorschau

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

Erstellen Sie eine Verbindung.

Die Verbindung ermöglicht das Speichern von Authentifizierungs- und Konfigurationsinformationen, die für die Verbindung und Interaktion mit den externen Ressourcen erforderlich sind.

az ml connection create --file
                        --resource-group
                        --workspace-name
                        [--name]
                        [--populate-secrets]
                        [--set]

Beispiele

Erstellen Sie eine Verbindung aus einer YAML-Spezifikationsdatei.

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

Erstellen Sie eine Verbindung aus einer YAML-Spezifikationsdatei, und zeigen Sie den API-Schlüssel in der zurückgegebenen Verbindung zur Überprüfung an.

az ml connection create --file connection.yml --resource-group my-resource-group --workspace-name my-workspace --populate-secrets

Erforderliche Parameter

--file -f

Lokaler Pfad zur YAML-Datei, die die Azure ML-Verbindungsspezifikation enthält.

--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 den Standardarbeitsbereich mithilfe von az configure --defaults workspace=<name>.

Optionale Parameter

--name -n

Der Name der Umgebung.

--populate-secrets -p

Versuchen Sie bei schlüsselbasierten API-Verbindungen, die zurückgegebenen Anmeldeinformationen mit dem tatsächlichen geheimen Wert aufzufüllen. Führt nichts für nicht-API-schlüsselbasierte Verbindungen aus.

Standardwert: False
--set

Aktualisieren Sie ein Objekt, indem Sie einen festzulegenden Eigenschaftspfad und -wert angeben. Beispiel: --set property1.property2=.

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 ml connection delete

Vorschau

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

Löschen einer Verbindung.

az ml connection delete --name
                        --resource-group
                        --workspace-name
                        [--yes]

Erforderliche Parameter

--name -n

Der Name der Umgebung.

--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 den Standardarbeitsbereich mithilfe von az configure --defaults workspace=<name>.

Optionale Parameter

--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 ml connection list

Vorschau

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

Alle Verbindungen auflisten.

Die Liste der Verbindungen in einem Arbeitsbereich.

az ml connection list --resource-group
                      --workspace-name
                      [--max-results]
                      [--populate-secrets]
                      [--type]

Beispiele

Auflisten aller Verbindungen in einem Arbeitsbereich

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

Auflisten aller Verbindungen in einem Arbeitsbereich und Anzeigen des API-Schlüssels für anwendbare Verbindungen

az ml connection list --resource-group my-resource-group --workspace-name my-workspace --populate-secrets

Listet alle Verbindungen in einem Arbeitsbereich mithilfe des Arguments --query auf, um eine JMESPath-Abfrage für die Ergebnisse von Befehlen auszuführen.

az ml connection 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 den Standardarbeitsbereich mithilfe von az configure --defaults workspace=<name>.

Optionale Parameter

--max-results -r

Maximale Anzahl der zurückzugebenden Ergebnisse.

--populate-secrets -p

Versuchen Sie bei schlüsselbasierten API-Verbindungen, die zurückgegebenen Anmeldeinformationen mit dem tatsächlichen geheimen Wert aufzufüllen. Führt nichts für nicht-API-schlüsselbasierte Verbindungen aus.

Standardwert: False
--type -t

Der Typ der Azure ML-Verbindung zur Liste.

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 ml connection show

Vorschau

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

Details einer Verbindung anzeigen.

az ml connection show --name
                      --resource-group
                      --workspace-name
                      [--populate-secrets]

Beispiele

Zeigen Sie Details einer Verbindung an, einschließlich des API-Schlüssels.

az ml connection show --resource-group my-resource-group --name my-connection-name --workspace-name my-workspace --populate-secrets

Erforderliche Parameter

--name -n

Der Name der Umgebung.

--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 den Standardarbeitsbereich mithilfe von az configure --defaults workspace=<name>.

Optionale Parameter

--populate-secrets -p

Versuchen Sie bei schlüsselbasierten API-Verbindungen, die zurückgegebenen Anmeldeinformationen mit dem tatsächlichen geheimen Wert aufzufüllen. Führt nichts für nicht-API-schlüsselbasierte Verbindungen aus.

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 ml connection update

Vorschau

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

Aktualisieren einer Verbindung.

az ml connection update --name
                        --resource-group
                        --workspace-name
                        [--add]
                        [--force-string]
                        [--populate-secrets]
                        [--remove]
                        [--set]

Beispiele

Eine Verbindung aus einer YAML-Spezifikationsdatei aktualisieren.

az ml connection update --resource-group my-resource-group --name my-connection-name --workspace-name my-workspace

Erforderliche Parameter

--name -n

Der Name der Umgebung.

--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 den Standardarbeitsbereich mithilfe von az configure --defaults workspace=<name>.

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
--populate-secrets -p

Versuchen Sie bei schlüsselbasierten API-Verbindungen, die zurückgegebenen Anmeldeinformationen mit dem tatsächlichen geheimen Wert aufzufüllen. Führt nichts für nicht-API-schlüsselbasierte Verbindungen aus.

Standardwert: False
--remove

Entfernen sie eine Eigenschaft oder ein Element aus einer Liste. Beispiel: --remove property.list <indexToRemove> ODER --remove propertyToRemove.

Standardwert: []
--set

Aktualisieren Sie ein Objekt, indem Sie einen festzulegenden Eigenschaftspfad und -wert angeben. Beispiel: --set property1.property2=<value>.

Standardwert: []
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.