az dt twin relationship

Note

Diese Referenz ist Teil der Azure-iot-Erweiterung für die Azure CLI (Version 2.67.0 oder höher). Die Erweiterung wird automatisch installiert, wenn Sie ein az dt twin relationship Befehl ausführen. Erfahren Sie mehr über 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.	Extension	GA
az dt twin relationship delete	Löschen Einer digitalen Zwillingsbeziehung auf einer Digital Twins-Instanz.	Extension	GA
az dt twin relationship delete-all	Löscht alle digitalen Zwillingsbeziehungen innerhalb einer Digital Twins-Instanz, einschließlich eingehender Beziehungen.	Extension	GA
az dt twin relationship list	Auflisten der Beziehungen eines digitalen Zwillings.	Extension	GA
az dt twin relationship show	Zeigen Sie Details einer digitalen Zwillingsbeziehung an.	Extension	GA
az dt twin relationship update	Aktualisiert die Eigenschaften einer Beziehung zwischen zwei digitalen Zwillingen über die JSON-Patchspezifikation.	Extension	GA

az dt twin relationship create

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

--properties can be inline JSON or file path.

az dt twin relationship create --dt-name --dtn
                               --kind --relationship
                               --relationship-id
                               --source --twin-id
                               --target --target-twin-id
                               [--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

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--if-none-match

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

Eigenschaft	Wert
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

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft	Wert
Standardwert:	False

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft	Wert
Standardwert:	False

--output -o

Ausgabeformat.

Eigenschaft	Wert
Standardwert:	json
Zulässige Werte:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft	Wert
Standardwert:	False

az dt twin relationship delete

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

az dt twin relationship delete --dt-name --dtn
                               --relationship-id
                               --source --twin-id
                               [--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

--relationship-id -r

Beziehungs-ID.

--source --twin-id -t

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

Optionale Parameter

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

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

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft	Wert
Standardwert:	False

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft	Wert
Standardwert:	False

--output -o

Ausgabeformat.

Eigenschaft	Wert
Standardwert:	json
Zulässige Werte:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft	Wert
Standardwert:	False

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 --dtn
                                   [--resource-group]
                                   [--source --twin-id]
                                   [--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

Optionale Parameter

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

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

Zur Bestätigung nicht auffordern.

Eigenschaft	Wert
Standardwert:	False

Globale Parameter

--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft	Wert
Standardwert:	False

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft	Wert
Standardwert:	False

--output -o

Ausgabeformat.

Eigenschaft	Wert
Standardwert:	json
Zulässige Werte:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft	Wert
Standardwert:	False

az dt twin relationship list

Auflisten der Beziehungen eines digitalen Zwillings.

az dt twin relationship list --dt-name --dtn
                             --source --twin-id
                             [--incoming {false, true}]
                             [--kind --relationship]
                             [--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

--source --twin-id -t

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

Optionale Parameter

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--incoming

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

Eigenschaft	Wert
Standardwert:	False
Zulässige Werte:	false, true

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

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft	Wert
Standardwert:	False

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft	Wert
Standardwert:	False

--output -o

Ausgabeformat.

Eigenschaft	Wert
Standardwert:	json
Zulässige Werte:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft	Wert
Standardwert:	False

az dt twin relationship show

Zeigen Sie Details einer digitalen Zwillingsbeziehung an.

az dt twin relationship show --dt-name --dtn
                             --relationship-id
                             --source --twin-id
                             [--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

--relationship-id -r

Beziehungs-ID.

--source --twin-id -t

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

Optionale Parameter

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--resource-group -g

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

Globale Parameter

--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft	Wert
Standardwert:	False

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft	Wert
Standardwert:	False

--output -o

Ausgabeformat.

Eigenschaft	Wert
Standardwert:	json
Zulässige Werte:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft	Wert
Standardwert:	False

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 --dtn
                               --json-patch --patch
                               --relationship-id
                               --source --twin-id
                               [--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

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

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

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

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft	Wert
Standardwert:	False

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft	Wert
Standardwert:	False

--output -o

Ausgabeformat.

Eigenschaft	Wert
Standardwert:	json
Zulässige Werte:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft	Wert
Standardwert:	False

Feedback

War diese Seite hilfreich?

Freigeben über

az dt twin relationship

Befehle

az dt twin relationship create

Beispiele

Erforderliche Parameter

Optionale Parameter

az dt twin relationship delete

Beispiele

Erforderliche Parameter

Optionale Parameter

az dt twin relationship delete-all

Beispiele

Erforderliche Parameter

Optionale Parameter

az dt twin relationship list

Beispiele

Erforderliche Parameter

Optionale Parameter

az dt twin relationship show

Beispiele

Erforderliche Parameter

Optionale Parameter

az dt twin relationship update

Beispiele

Erforderliche Parameter

Optionale Parameter

Feedback