Freigeben über


az dt twin relationship

Hinweis

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

Verwalten und konfigurieren Sie die digitalen Zwillingsbeziehungen einer Digital Twins-Instanz.

Befehle

Name Beschreibung Typ Status
az dt twin relationship create

Erstellen Sie eine Beziehung zwischen Quell- und Ziel-digitalen Zwillingen.

Erweiterung Allgemein verfügbar
az dt twin relationship delete

Löschen Einer digitalen Zwillingsbeziehung auf einer Digital Twins-Instanz.

Erweiterung Allgemein verfügbar
az dt twin relationship delete-all

Löscht alle digitalen Zwillingsbeziehungen innerhalb einer Digital Twins-Instanz, einschließlich eingehender Beziehungen.

Erweiterung Allgemein verfügbar
az dt twin relationship list

Auflisten der Beziehungen eines digitalen Zwillings.

Erweiterung Allgemein verfügbar
az dt twin relationship show

Zeigen Sie Details einer digitalen Zwillingsbeziehung an.

Erweiterung Allgemein verfügbar
az dt twin relationship update

Aktualisiert die Eigenschaften einer Beziehung zwischen zwei digitalen Zwillingen über die JSON-Patchspezifikation.

Erweiterung Allgemein verfügbar

az dt twin relationship create

Erstellen Sie eine Beziehung zwischen Quell- und Ziel-digitalen Zwillingen.

--properties kann Inline-JSON oder ein Dateipfad sein.

az dt twin relationship create --dt-name
                               --kind
                               --relationship-id
                               --source
                               --target
                               [--if-none-match]
                               [--properties]
                               [--resource-group]

Beispiele

Erstellen Sie eine Beziehung zwischen zwei digitalen Zwillingen.

az dt twin relationship create -n {instance_or_hostname} --relationship-id {relationship_id} --relationship contains --twin-id {source_twin_id} --target {target_twin_id}

Erstellen einer Beziehung zwischen zwei digitalen Zwillingen mit if-none-match-Tag

az dt twin relationship create -n {instance_or_hostname} --relationship-id {relationship_id} --relationship contains --twin-id {source_twin_id} --target {target_twin_id} --if-none-match

Erstellen Sie eine Beziehung mit initialisierten Eigenschaften zwischen zwei digitalen Zwillingen.

az dt twin relationship create -n {instance_or_hostname} --relationship-id {relationship_id} --relationship contains --twin-id {source_twin_id} --target {target_twin_id} --properties '{"ownershipUser": "me", "ownershipDepartment": "Computer Science"}'

Erforderliche Parameter

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

--kind --relationship

Beziehungsname oder -art. Beispiel: "contains".

--relationship-id -r

Beziehungs-ID.

--source --twin-id -t

Die Quell-Twin-ID für eine Beziehung.

--target --target-twin-id

Die Ziel-Twin-ID für eine Beziehung.

Optionale Parameter

--if-none-match

Gibt an, dass der Erstellungsvorgang fehlschlägt, wenn ein vorhandener Zwilling mit derselben ID vorhanden ist.

Standardwert: False
--properties -p

Anfängliche Eigenschaftswerte zum Instanziieren einer digitalen Zwillingsbeziehung. Geben Sie dateipfad oder inline JSON an.

--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 relationship delete

Löschen Einer digitalen Zwillingsbeziehung auf einer Digital Twins-Instanz.

az dt twin relationship delete --dt-name
                               --relationship-id
                               --source
                               [--etag]
                               [--resource-group]

Beispiele

Löschen Sie eine digitale Zwillingsbeziehung.

az dt twin relationship delete -n {instance_or_hostname} --twin-id {twin_id} --relationship-id {relationship_id}

Löschen Sie eine digitale Zwillingsbeziehung mithilfe des etags.

az dt twin relationship delete -n {instance_or_hostname} --twin-id {twin_id} --relationship-id {relationship_id} --etag {etag}

Erforderliche Parameter

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

--relationship-id -r

Beziehungs-ID.

--source --twin-id -t

Die Quell-Twin-ID für eine Beziehung.

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.

az dt twin relationship delete-all

Löscht alle digitalen Zwillingsbeziehungen innerhalb einer Digital Twins-Instanz, einschließlich eingehender Beziehungen.

az dt twin relationship delete-all --dt-name
                                   [--resource-group]
                                   [--source]
                                   [--yes]

Beispiele

Löschen Sie alle digitalen Zwillingsbeziehungen, die mit dem Zwilling verbunden sind.

az dt twin relationship delete-all -n {instance_or_hostname} --twin-id {twin_id}

Löschen Sie alle digitalen Zwillingsbeziehungen innerhalb der Digital Twins instace.

az dt twin relationship delete-all -n {instance_or_hostname}

Erforderliche Parameter

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

Optionale Parameter

--resource-group -g

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

--source --twin-id -t

Die Quell-Twin-ID für eine Beziehung.

--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 dt twin relationship list

Auflisten der Beziehungen eines digitalen Zwillings.

az dt twin relationship list --dt-name
                             --source
                             [--incoming {false, true}]
                             [--kind]
                             [--resource-group]

Beispiele

Auflisten ausgehender Beziehungen eines digitalen Zwillings.

az dt twin relationship list -n {instance_or_hostname} --twin-id {twin_id}

Auflisten ausgehender Beziehungen eines digitalen Zwillings und Filtern nach Beziehung "contains"

az dt twin relationship list -n {instance_or_hostname} --twin-id {twin_id} --relationship contains

Auflisten eingehender Beziehungen eines digitalen Zwillings.

az dt twin relationship list -n {instance_or_hostname} --twin-id {twin_id} --incoming

Auflisten eingehender Beziehungen eines digitalen Zwillings und Filtern nach Beziehung "contains".

az dt twin relationship list -n {instance_or_hostname} --twin-id {twin_id} --relationship contains --incoming

Erforderliche Parameter

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

--source --twin-id -t

Die Quell-Twin-ID für eine Beziehung.

Optionale Parameter

--incoming

Ruft alle eingehenden Beziehungen für einen digitalen Zwilling ab.

Zulässige Werte: false, true
Standardwert: False
--kind --relationship

Filterergebnis nach der Art der Beziehung.

--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 relationship show

Zeigen Sie Details einer digitalen Zwillingsbeziehung an.

az dt twin relationship show --dt-name
                             --relationship-id
                             --source
                             [--resource-group]

Beispiele

Zeigen Sie Details einer digitalen Zwillingsbeziehung an.

az dt twin relationship show -n {instance_or_hostname} --twin-id {twin_id} --relationship-id {relationship_id}

Erforderliche Parameter

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

--relationship-id -r

Beziehungs-ID.

--source --twin-id -t

Die Quell-Twin-ID für eine Beziehung.

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 relationship update

Aktualisiert die Eigenschaften einer Beziehung zwischen zwei digitalen Zwillingen über die JSON-Patchspezifikation.

Vorgänge sind auf das Hinzufügen, Ersetzen und Entfernen beschränkt.

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

Beispiele

Aktualisieren Sie eine digitale Zwillingsbeziehung über die JSON-Patchspezifikation.

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

Aktualisieren Sie eine digitale Zwillingsbeziehung über die JSON-Patchspezifikation und die Verwendung von etag.

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

Aktualisieren Sie eine digitale Zwillingsbeziehung über die JSON-Patchspezifikation.

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

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

az dt twin relationship update -n {instance_or_hostname} --twin-id {twin_id} --relationship-id {relationship_id} --relationship contains --json-patch ./my/patch/document.json

Erforderliche Parameter

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

--relationship-id -r

Beziehungs-ID.

--source --twin-id -t

Die Quell-Twin-ID für eine Beziehung.

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.