az dt twin component

  • Referenz

Hinweis

Diese Referenz ist Teil der Azure-iot-Erweiterung für die Azure CLI (Version 2.37.0 oder höher). Die Erweiterung wird automatisch installiert, wenn Sie einen Az dt Twin-Komponentenbefehl zum ersten Mal ausführen. Weitere Informationen zu Erweiterungen

Zeigen und aktualisieren Sie die digitalen Zwillingskomponenten einer Digital Twins-Instanz.

Befehle

Name Beschreibung Typ Status
az dt twin component show

Zeigen Sie Details einer digitalen Zwillingskomponente an.

 Durchwahl Allgemein verfügbar
az dt twin component update

Aktualisieren Sie eine digitale Twin-Komponente über die JSON-Patchspezifikation.

 Durchwahl Allgemein verfügbar

az dt twin component show

Zeigen Sie Details einer digitalen Zwillingskomponente an.

az dt twin component show --component
                          --dt-name
                          --twin-id
                          [--resource-group]

Beispiele

Details einer digitalen Zwillingskomponente anzeigen

az dt twin component show -n {instance_or_hostname} --twin-id {twin_id} --component Thermostat

Erforderliche Parameter

--component

Der Pfad zur DTDL-Komponente.

--dt-name --dtn -n

Name oder Hostname der Digital Twins-Instanz. Wenn ein Instanzname angegeben wird, wird das Benutzerabonnement zuerst für die Zielinstanz abgefragt, um den Hostnamen abzurufen. Wenn ein Hostname angegeben wird, wird die Abonnementabfrage übersprungen und der bereitgestellte Wert für nachfolgende Interaktionen verwendet.

--twin-id -t

Die digitale Zwillings-ID.

Optionale Parameter

--resource-group -g

Ressourcengruppe der Digital Twins-Instanz. 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 dt twin component update

Aktualisieren Sie eine digitale Twin-Komponente über die JSON-Patchspezifikation.

Aktualisierungen von Eigenschaftswerten und $model Elementen können in derselben Anforderung auftreten. Vorgänge sind auf das Hinzufügen, Ersetzen und Entfernen beschränkt.

az dt twin component update --component
                            --dt-name
                            --json-patch
                            --twin-id
                            [--etag]
                            [--resource-group]

Beispiele

Aktualisieren Sie eine digitale Twin-Komponente über die JSON-Patchspezifikation.

az dt twin component update -n {instance_or_hostname} --twin-id {twin_id} --component {component_path} --json-patch '{"op":"replace", "path":"/Temperature", "value": 20.5}'

Aktualisieren Sie eine digitale Twin-Komponente über die JSON-Patchspezifikation.

az dt twin component update -n {instance_or_hostname} --twin-id {twin_id} --component {component_path} --json-patch '[
  {"op":"replace", "path":"/Temperature", "value": 20.5},
  {"op":"add", "path":"/Areas", "value": ["ControlSystem"]}
]'

Aktualisieren Sie eine digitale Twin-Komponente über die JSON-Patchspezifikation, die in einer Datei definiert ist.

az dt twin component update -n {instance_or_hostname} --twin-id {twin_id} --component {component_path} --json-patch ./my/patch/document.json

Erforderliche Parameter

--component

Der Pfad zur DTDL-Komponente.

--dt-name --dtn -n

Name oder Hostname der Digital Twins-Instanz. Wenn ein Instanzname angegeben wird, wird das Benutzerabonnement zuerst für die Zielinstanz abgefragt, um den Hostnamen abzurufen. Wenn ein Hostname angegeben wird, wird die Abonnementabfrage übersprungen und der bereitgestellte Wert für nachfolgende Interaktionen verwendet.

--json-patch --patch

Eine vom JSON-Patch beschriebene Updatespezifikation. Aktualisierungen von Eigenschaftswerten und $model Elementen können in derselben Anforderung auftreten. Vorgänge sind auf das Hinzufügen, Ersetzen und Entfernen beschränkt. Geben Sie dateipfad oder inline JSON an.

--twin-id -t

Die digitale Zwillings-ID.

Optionale Parameter

--etag -e

Entitätstag-Wert. Der Befehl wird erfolgreich ausgeführt, wenn das etag mit dem aktuellen Etag für die Ressource übereinstimmt.

--resource-group -g

Ressourcengruppe der Digital Twins-Instanz. 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.