az dt twin relationship

Hinweis

Dieser Verweis ist Teil der Azure-iot-Erweiterung für die Azure CLI (Version 2.30.0 oder höher). Die Erweiterung wird automatisch installiert, wenn Sie einen az dt twin relationship-Befehl ausführen. Weitere Informationen zu Erweiterungen

Verwalten und Konfigurieren der digitalen Zwillingsbeziehungen einer Digital Twins-Instanz.

Befehle

az dt twin relationship create	Erstellen Sie eine Beziehung zwischen Quell- und Ziel-digitalen Zwillingen.
az dt twin relationship delete	Löschen Sie eine digitale Zwillingsbeziehung in einer Digital Twins-Instanz.
az dt twin relationship delete-all	Löscht alle digitalen Zwillingsbeziehungen in einer Digital Twins-Instanz, einschließlich eingehender Beziehungen.
az dt twin relationship list	Listet die Beziehungen eines digitalen Zwillings auf.
az dt twin relationship show	Zeigen Sie Details einer digitalen Zwillingsbeziehung an.
az dt twin relationship update	Aktualisierungen die Eigenschaften einer Beziehung zwischen zwei digitalen Zwillingen über JSON-Patchspezifikation.

az dt twin relationship create

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

--Eigenschaften können inline JSON oder 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 von Digital Twins. Wenn ein Instanzname bereitgestellt wird, wird das Benutzerabonnement zuerst für die Zielinstanz abgefragt, um den Hostnamen abzurufen. Wenn ein Hostname bereitgestellt wird, wird die Abonnementabfrage übersprungen und der angegebene Wert wird für die nachfolgende Interaktion verwendet.

--kind --relationship

Beziehungsname oder Art. Beispiel: "enthält".

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

--properties -p

Anfängliche Eigenschaftswerte für die Instanziierung einer digitalen Zwillingsbeziehung. Bereitstellen des Dateipfads oder inline-JSON.

--resource-group -g

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

--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 Sie eine digitale Zwillingsbeziehung in 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 von Digital Twins. Wenn ein Instanzname bereitgestellt wird, wird das Benutzerabonnement zuerst für die Zielinstanz abgefragt, um den Hostnamen abzurufen. Wenn ein Hostname bereitgestellt wird, wird die Abonnementabfrage übersprungen und der angegebene Wert wird für die nachfolgende Interaktion verwendet.

--relationship-id -r

Beziehungs-ID.

--source --twin-id -t

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

Optionale Parameter

--etag -e

Entitätstagwert. Der Befehl wird erfolgreich ausgeführt, wenn das etag dem aktuellen Etag für die Ressource entspricht.

--resource-group -g

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

--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 in 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 dem Zwilling zugeordnet 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 von Digital Twins. Wenn ein Instanzname bereitgestellt wird, wird das Benutzerabonnement zuerst für die Zielinstanz abgefragt, um den Hostnamen abzurufen. Wenn ein Hostname bereitgestellt wird, wird die Abonnementabfrage übersprungen und der angegebene Wert wird für die nachfolgende Interaktion verwendet.

Optionale Parameter

--resource-group -g

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

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.

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

Listet die Beziehungen eines digitalen Zwillings auf.

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

Beispiele

Listet ausgehende Beziehungen eines digitalen Zwillings auf.

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

Auflisten ausgehender Beziehungen eines digitalen Zwillings und Filter auf Beziehung 'enthält'

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

Listen Sie eingehende Beziehungen eines digitalen Zwillings auf.

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

Listen Sie eingehende Beziehungen eines digitalen Zwillings auf, und filtern Sie auf die Beziehung 'enthält'.

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 von Digital Twins. Wenn ein Instanzname bereitgestellt wird, wird das Benutzerabonnement zuerst für die Zielinstanz abgefragt, um den Hostnamen abzurufen. Wenn ein Hostname bereitgestellt wird, wird die Abonnementabfrage übersprungen und der angegebene Wert wird für die nachfolgende Interaktion 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

--kind --relationship

Filtern Sie das Ergebnis nach der Art der Beziehung.

--resource-group -g

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

--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 von Digital Twins. Wenn ein Instanzname bereitgestellt wird, wird das Benutzerabonnement zuerst für die Zielinstanz abgefragt, um den Hostnamen abzurufen. Wenn ein Hostname bereitgestellt wird, wird die Abonnementabfrage übersprungen und der angegebene Wert wird für die nachfolgende Interaktion verwendet.

--relationship-id -r

Beziehungs-ID.

--source --twin-id -t

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

Optionale Parameter

--resource-group -g

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

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

Aktualisierungen die Eigenschaften einer Beziehung zwischen zwei digitalen Zwillingen über 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 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 Twin-Beziehung über JSON-Patchspezifikation und verwenden Sie 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 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 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 von Digital Twins. Wenn ein Instanzname bereitgestellt wird, wird das Benutzerabonnement zuerst für die Zielinstanz abgefragt, um den Hostnamen abzurufen. Wenn ein Hostname bereitgestellt wird, wird die Abonnementabfrage übersprungen und der angegebene Wert wird für die nachfolgende Interaktion verwendet.

--json-patch --patch

Eine Updatespezifikation, die von JSON-Patch beschrieben wird. Aktualisierungen zu Eigenschaftenwerten und $model Elementen können in derselben Anforderung auftreten. Vorgänge sind auf das Hinzufügen, Ersetzen und Entfernen beschränkt. Bereitstellen des Dateipfads oder inline-JSON.

--relationship-id -r

Beziehungs-ID.

--source --twin-id -t

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

Optionale Parameter

--etag -e

Entitätstagwert. Der Befehl wird erfolgreich ausgeführt, wenn das etag dem aktuellen Etag für die Ressource entspricht.

--resource-group -g

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

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