Feedback

az dt model

  • 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 beim ersten Ausführen eines Az dt-Modellbefehls automatisch installiert. Weitere Informationen zu Erweiterungen

Verwalten sie DTDL-Modelle und -Definitionen in einer Digital Twins-Instanz.

Befehle

az dt model create

Lädt ein oder mehrere Modelle hoch.
az dt model delete

Löschen Sie ein Modell. Ein Modell kann nur gelöscht werden, wenn keine anderen Modelle darauf verweisen.
az dt model delete-all

Löschen Sie alle Modelle in einer Digital Twins-Instanz. Zwillingskonfigurationen sind nicht betroffen, können aber ohne Modelldefinitionen unterbrochen werden.
az dt model list

Listenmodellmetadaten, Definitionen und Abhängigkeiten.
az dt model show

Abrufen eines Zielmodells oder einer Modelldefinition.
az dt model update

Aktualisierungen die Metadaten für ein Modell. Derzeit kann ein Modell nur dekommisioniert werden.

az dt model create

Lädt ein oder mehrere Modelle hoch.

--Models können inline json oder dateipfad sein. Die Größe des Eingabemodellsatzes (Ontologie) wird durch die maximale Anzahl von Modellen eingeschränkt, die die DT-Instanz speichern kann (Standard ist 10000 Modelle).

az dt model create --dt-name
                   [--failure-policy {None, Rollback}]
                   [--fd]
                   [--models]
                   [--resource-group]

Beispiele

Massenupload aller JSON- oder DTDL-Modelldateien aus einem Zielverzeichnis. Die Modellverarbeitung ist rekursiv.

az dt model create -n {instance_or_hostname} --from-directory {directory_path}

Laden Sie modell json inline oder aus dem Dateipfad hoch.

az dt model create -n {instance_or_hostname} --models {file_path_or_inline_json}

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.

Optionale Parameter

--failure-policy --fp

Gibt die Fehlerrichtlinie an, wenn beim Verarbeiten eines Modellbatches ein Fehler auftritt. Im Modus "Rollback" werden alle modelle, die in früheren Batches erstellt wurden, jeweils einzeln gelöscht. Wenn sie als "Keine" ausgewählt werden, werden die in früheren Batches erstellten Modelle nicht aus der DT-Instanz gelöscht.

Zulässige Werte: None, Rollback
Standardwert: Rollback
--fd --from-directory

Die JSON-Verzeichnismodelldateien werden analysiert. Bitte beachten Sie: Modelle werden atomisch erstellt, wenn das Verzeichnis 250 oder weniger Modelle enthält, daher wird bei einem Fehler keines der Modelle erstellt. Der Eingabemodellsatz wird & in Batches erstellt, wenn das Verzeichnis über mehr als 250 Modelle (API-Grenzwert) verfügt. Bei einer Fehlerverarbeitung eines Batches wird das Verhalten durch den Parameter "--failure-policy" bestimmt.

--models

Inlinemodell JSON oder Dateipfad zum Modell-JSON. Bitte beachten Sie: Modelle werden atomisch erstellt, wenn Modell-JSON 250 oder weniger Modelle enthält, daher wird im Falle eines Fehlers keines der Modelle erstellt. Der Eingabemodellsatz wird & in Batches erstellt, wenn Modell-JSON mehr als 250 Modelle (API-Grenzwert) aufweist. Bei einer Fehlerverarbeitung eines Batches wird das Verhalten durch den Parameter "--failure-policy" bestimmt.

--resource-group -g

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

az dt model delete

Löschen Sie ein Modell. Ein Modell kann nur gelöscht werden, wenn keine anderen Modelle darauf verweisen.

az dt model delete --dt-name
                   --dtmi
                   [--resource-group]

Beispiele

Löschen eines Zielmodells.

az dt model delete -n {instance_or_hostname} --dtmi "dtmi:com:example:Floor;1"

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.

Optionale Parameter

--resource-group -g

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

az dt model delete-all

Löschen Sie alle Modelle in einer Digital Twins-Instanz. Zwillingskonfigurationen sind nicht betroffen, können aber ohne Modelldefinitionen unterbrochen werden.

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

Beispiele

Alle Modelle löschen.

az dt model 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 abgefragt, um den Hostnamen abzurufen. Wenn ein Hostname angegeben wird, wird die Abonnementabfrage übersprungen, und der bereitgestellte Wert wird für nachfolgende Interaktionen verwendet.

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

az dt model list

Listenmodellmetadaten, Definitionen und Abhängigkeiten.

az dt model list --dt-name
                 [--def {false, true}]
                 [--dependencies-for]
                 [--resource-group]

Beispiele

Metadaten des Listenmodells

az dt model list -n {instance_or_hostname}

Listenmodelldefinitionen

az dt model list -n {instance_or_hostname} --definition

Listet Abhängigkeiten von bestimmten vordefinierten Modell(n) auf. Leerzeichen trennen dtmi-Werte.

az dt model list -n {instance_or_hostname} --dependencies-for {model_id0} {model_id1}

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.

Optionale Parameter

--def --definition

Der Vorgang ruft die Modelldefinition ab.

Zulässige Werte: false, true
--dependencies-for

Die Gruppe von Modellen, die ihre Abhängigkeiten abgerufen haben. Wenn nicht angegeben, werden alle Modelle abgerufen. Format ist eine durch Leerzeichen getrennte Liste.

--resource-group -g

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

az dt model show

Abrufen eines Zielmodells oder einer Modelldefinition.

az dt model show --dt-name
                 --dtmi
                 [--def {false, true}]
                 [--resource-group]

Beispiele

Modellmetadaten anzeigen

az dt model show -n {instance_or_hostname} --dtmi "dtmi:com:example:Floor;1"

Modellmetadaten und -definition anzeigen

az dt model show -n {instance_or_hostname} --dtmi "dtmi:com:example:Floor;1" --definition

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.

Optionale Parameter

--def --definition

Der Vorgang ruft die Modelldefinition ab.

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.

az dt model update

Aktualisierungen die Metadaten für ein Modell. Derzeit kann ein Modell nur dekommisioniert werden.

az dt model update --dt-name
                   --dtmi
                   [--decommission {false, true}]
                   [--resource-group]

Beispiele

Dekommision eines Zielmodells

az dt model update -n {instance_or_hostname} --dtmi "dtmi:com:example:Floor;1" --decommission

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.

Optionale Parameter

--decommission

Gibt die Absicht an, ein Zielmodell außer Betrieb zu setzen.

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.