az dt twin

Referenz

Hinweis

Diese Referenz 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 zum ersten Mal einen az dt twin-Befehl ausführen. Weitere Informationen zu Erweiterungen

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

Befehle

az dt twin component	Zeigen Und aktualisieren Sie die digitalen Twin-Komponenten einer Digital Twins-Instanz.
az dt twin component show	Details einer digitalen Zwillingskomponente anzeigen.
az dt twin component update	Aktualisieren Sie eine digitale Zwillingskomponente über die JSON-Patchspezifikation.
az dt twin create	Erstellen Sie einen digitalen Zwilling in einer Instanz.
az dt twin delete	Entfernen Sie einen digitalen Zwilling. Alle Beziehungen, die auf diesen Zwilling verweisen, müssen bereits gelöscht werden.
az dt twin delete-all	Löscht alle digitalen Zwillinge in einer Digital Twins-Instanz, einschließlich aller Beziehungen für diese Zwillinge.
az dt twin query	Fragen Sie die digitalen Zwillinge einer Instanz ab. Ermöglicht das Durchlaufen von Beziehungen und Filtern nach Eigenschaftenwerten.
az dt twin relationship	Verwalten und konfigurieren Sie die digitalen Zwillingsbeziehungen einer Digital Twins-Instanz.
az dt twin relationship create	Erstellen Sie eine Beziehung zwischen Quelle und Ziel digitaler Zwillinge.
az dt twin relationship delete	Löschen Sie eine digitale Zwillingsbeziehung auf einer Digital Twins-Instanz.
az dt twin relationship delete-all	Löscht alle digitalen Zwillingsbeziehungen innerhalb 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 zu einer digitalen Zwillingsbeziehung an.
az dt twin relationship update	Aktualisierungen die Eigenschaften einer Beziehung zwischen zwei digitalen Zwillingen über die JSON-Patchspezifikation.
az dt twin show	Zeigen Sie die Details eines digitalen Zwillings an.
az dt twin telemetry	Testen und überprüfen Sie die Ereignisrouten und Endpunkte einer Digital Twins-Instanz.
az dt twin telemetry send	Sendet Telemetrie im Auftrag eines digitalen Zwillings. Wenn der ausgelassene Komponentenpfad bereitgestellt wird, befindet sich die ausgelassene Telemetrie im Namen der Komponente.
az dt twin update	Aktualisieren Sie einen digitalen Zwilling einer Instanz über die JSON-Patchspezifikation.

az dt twin create

Erstellen Sie einen digitalen Zwilling in einer Instanz.

--Properties können inline JSON oder Dateipfad sein. Hinweis: --Eigenschaften sind für Zwillinge erforderlich, die Komponenten enthalten.

az dt twin create --dt-name
                  --dtmi
                  --twin-id
                  [--if-none-match]
                  [--properties]
                  [--resource-group]

Beispiele

Erstellen eines digitalen Zwillings anhand eines vorhandenen (zuvor erstellten) Modells:

az dt twin create -n {instance_or_hostname} --dtmi "dtmi:com:example:Room;1" --twin-id {twin_id}

Erstellen Sie einen digitalen Zwilling aus einem vorhandenen (zuvor erstellten) Modell mit dem Tag "if-none-match".

az dt twin create -n {instance_or_hostname} --dtmi "dtmi:com:example:Room;1" --twin-id {twin_id} --if-none-match

Erstellen eines digitalen Zwillings anhand eines vorhandenen (zuvor erstellten) Modells und Instanziieren mit Eigenschaftswerten: Instanziieren mit Eigenschaftswerten.

az dt twin create -n {instance_or_hostname} --dtmi "dtmi:com:example:DeviceInformation;1" --twin-id {twin_id} --properties '{"manufacturer": "Microsoft"}'

Erstellen Sie einen digitalen Zwilling mit Komponenten aus vorhandenen (zuvor erstellten) Modellen. Instanziierungskomponente mit minimalen Eigenschaften.

az dt twin create -n {instance_or_hostname} --dtmi "dtmi:com:example:TemperatureController;1" --twin-id {twin_id} --properties '{
    "Thermostat": {
        "$metadata": {},
    }
}'

Erstellen Sie einen digitalen Zwilling mit Komponenten aus vorhandenen (zuvor erstellten) Modellen. Instanziieren mit Eigenschaftswerten.

az dt twin create -n {instance_or_hostname} --dtmi "dtmi:com:example:TemperatureController;1" --twin-id {twin_id} --properties '{
    "Temperature": 10.2,
    "Thermostat": {
        "$metadata": {},
        "setPointTemp": 23.12
    }
}'

Erforderliche Parameter

--dt-name --dtn -n

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

--dtmi --model-id -m

Digital Twins Model Id. Beispiel: dtmi:com:example:Room;2.

--twin-id -t

Die digitale Zwillings-ID.

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 zum Instanziieren eines digitalen Zwillings oder verwandter Komponenten. Geben Sie Dateipfad oder Inline-JSON an. Eigenschaften sind für Zwillinge erforderlich, die Komponenten enthalten, mindestens müssen Sie für jede Komponente ein leeres $metadata-Objekt bereitstellen.

--resource-group -g

Ressourcengruppe für digitale Twins-Instanzen. 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 delete

Entfernen Sie einen digitalen Zwilling. Alle Beziehungen, die auf diesen Zwilling verweisen, müssen bereits gelöscht werden.

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

Beispiele

Entfernen Sie einen digitalen Zwilling durch ID.

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

Entfernen Sie einen digitalen Zwilling mithilfe des etags.

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

Erforderliche Parameter

--dt-name --dtn -n

--twin-id -t

Die digitale Zwillings-ID.

Optionale Parameter

--etag -e

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

--resource-group -g

Ressourcengruppe für digitale Twins-Instanzen. 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 delete-all

Löscht alle digitalen Zwillinge in einer Digital Twins-Instanz, einschließlich aller Beziehungen für diese Zwillinge.

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

Beispiele

Alle digitalen Zwillinge löschen. Alle Beziehungen, die auf die Zwillinge verweisen, werden ebenfalls gelöscht.

az dt twin delete-all -n {instance_or_hostname}

Erforderliche Parameter

--dt-name --dtn -n

Optionale Parameter

--resource-group -g

Ressourcengruppe für digitale Twins-Instanzen. Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

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

Fragen Sie die digitalen Zwillinge einer Instanz ab. Ermöglicht das Durchlaufen von Beziehungen und Filtern nach Eigenschaftenwerten.

In vielen Zwillingsabfragen wird das $-Zeichen verwendet, um auf die $dtId-Eigenschaft eines Zwillings zu verweisen. In bash-ähnlichen Shells oder Powershells hat das $ Zeichen funktionale Bedeutung und muss als Teil der Abfrageeingabe escapet werden. Weitere Informationen finden Sie im Dokument https://docs.microsoft.com/en-us/azure/digital-twins/concepts-cli "Digital Twins CLI-Konzepte".

az dt twin query --dt-name
                 --query-command
                 [--cost {false, true}]
                 [--resource-group]

Beispiele

Abfragen aller digitalen Zwillinge in der Zielinstanz und Projizieren aller Attribute. Auch Zeigen von Kosten in Abfrageeinheiten.

az dt twin query -n {instance_or_hostname} -q "select * from digitaltwins" --show-cost

Abfragen nach Modell und Projizieren aller Attribute.

az dt twin query -n {instance_or_hostname} -q "select * from digitaltwins T where IS_OF_MODEL(T, 'dtmi:com:example:Room;2')"

Abfrage, die "$dtId" mit bashkompatibler Syntax nutzt

az dt twin query -n {instance_or_hostname} --query-command "SELECT * FROM DigitalTwins T Where T.\$dtId = 'room0'"

Abfrage, die "$dtId" mit einer powershell-kompatiblen Syntax nutzt

az dt twin query -n {instance_or_hostname} --query-command "SELECT * FROM DigitalTwins T Where T.`$dtId = 'room0'"

Erforderliche Parameter

--dt-name --dtn -n

--query-command -q

Benutzerabfrage, die ausgeführt werden soll.

Optionale Parameter

--cost --show-cost

Berechnet und zeigt die Abfragegebühr an.

Zulässige Werte: false, true

--resource-group -g

Ressourcengruppe für digitale Twins-Instanzen. 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 show

Zeigen Sie die Details eines digitalen Zwillings an.

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

Beispiele

Zeigen Sie die Details eines digitalen Zwillings an.

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

Erforderliche Parameter

--dt-name --dtn -n

--twin-id -t

Die digitale Zwillings-ID.

Optionale Parameter

--resource-group -g

Ressourcengruppe für digitale Twins-Instanzen. 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 update

Aktualisieren Sie einen digitalen Zwilling einer Instanz über die JSON-Patchspezifikation.

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

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

Beispiele

Aktualisieren Sie einen digitalen Zwilling über die JSON-Patchspezifikation.

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

Aktualisieren Sie einen digitalen Zwilling über die JSON-Patchspezifikation und die Verwendung von etag.

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

Aktualisieren Sie einen digitalen Zwilling über die JSON-Patchspezifikation.

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

Aktualisieren Sie einen digitalen Zwilling über die JSON-Patchspezifikation, die in einer Datei definiert ist.

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

Erforderliche Parameter

--dt-name --dtn -n

--json-patch --patch

Eine von JSON-Patch beschriebene Updatespezifikation. Aktualisierungen zu Eigenschaftswerten und $model Elementen kann 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ätstagswert. Der Befehl wird erfolgreich ausgeführt, wenn das etag mit dem aktuellen etag für die Ressource übereinstimmt.

--resource-group -g

Ressourcengruppe für digitale Twins-Instanzen. 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

Befehle

az dt twin create

Beispiele

Erforderliche Parameter

Optionale Parameter

az dt twin delete

Beispiele

Erforderliche Parameter

Optionale Parameter

az dt twin delete-all

Beispiele

Erforderliche Parameter

Optionale Parameter

az dt twin query

Beispiele

Erforderliche Parameter

Optionale Parameter

az dt twin show

Beispiele

Erforderliche Parameter

Optionale Parameter

az dt twin update

Beispiele

Erforderliche Parameter

Optionale Parameter

Feedback