Feedback

az dt

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

Verwalten der Azure Digital Twins-Lösungsinfrastruktur & .

Befehle

az dt create

Erstellen oder Aktualisieren einer Digital Twins-Instanz.
az dt data-history

Verwalten und Konfigurieren des Datenverlaufs.
az dt data-history connection

Verwalten und Konfigurieren von Datenverlaufsverbindungen.
az dt data-history connection create

Erstellt eine Datenverlaufsverbindung zwischen einer Digital Twins-Instanz und unterstützten Ressourcen.
az dt data-history connection create adx

Erstellt eine Datenverlaufsverbindung zwischen einer Digital Twins-Instanz und einer Azure-Data Explorer-Datenbank. Erfordert vorab erstellte Azure-Data Explorer- und Event Hub-Ressourcen.
az dt data-history connection delete

Löschen Sie eine Datenverlaufsverbindung, die in einer Digital Twins-Instanz konfiguriert ist.
az dt data-history connection list

Auflisten aller Datenverlaufsverbindungen, die in einer Digital Twins-Instanz konfiguriert sind.
az dt data-history connection show

Zeigen Sie Details einer Datenverlaufsverbindung an, die in einer Digital Twins-Instanz konfiguriert ist.
az dt data-history connection wait

Warten Sie, bis ein Vorgang für eine Datenverlaufsverbindung abgeschlossen ist.
az dt delete

Löschen Sie eine vorhandene Digital Twins-Instanz.
az dt endpoint

Verwalten und Konfigurieren von Digital Twins-Instanzendpunkten.
az dt endpoint create

Fügen Sie Endpunkte zu einer Digital Twins-Instanz hinzu.
az dt endpoint create eventgrid

Fügt einem Digital Twins-Instanz ein EventGrid-Thema-Endpunkt hinzu. Erfordert eine vorab erstellte Ressource.
az dt endpoint create eventhub

Fügt einen EventHub-Endpunkt zu einer Digital Twins-Instanz hinzu. Erfordert eine vorab erstellte Ressource. Die Instanz muss mit einer verwalteten Identität erstellt werden, um die Identitätsbasierte Endpunktintegration zu unterstützen.
az dt endpoint create servicebus

Fügt einen ServiceBus-Thema-Endpunkt zu einer Digital Twins-Instanz hinzu. Erfordert eine vorab erstellte Ressource. Die Instanz muss mit einer verwalteten Identität erstellt werden, um die Identitätsbasierte Endpunktintegration zu unterstützen.
az dt endpoint delete

Entfernen Sie einen Endpunkt aus einer Digital Twins-Instanz.
az dt endpoint list

Listet alle Endpunkte auf, die in einer Digital Twins-Instanz konfiguriert sind.
az dt endpoint show

Zeigen Sie Details eines Endpunkts an, der auf einer Digital Twins-Instanz konfiguriert ist.
az dt endpoint wait

Warten Sie, bis ein Endpunktvorgang abgeschlossen ist.
az dt job

Verwalten und Konfigurieren von Aufträgen für eine digitale Zwillingsinstanz.
az dt job import

Verwalten und Konfigurieren von Aufträgen zum Importieren von Modell-, Zwillings- und Beziehungensdaten in eine digitale Zwillingsinstanz.
az dt job import create

Erstellen und Ausführen eines Datenimportauftrags auf einer digitalen Twin-Instanz.
az dt job import delete

Löschen eines Datenimportauftrags, der auf einer digitalen Twins-Instanz ausgeführt wird.
az dt job import list

Auflisten aller Datenimportaufträge, die in einer digitalen Twins-Instanz ausgeführt werden.
az dt job import show

Zeigen Sie Details eines Datenimportauftrags an, der in einer digitalen Twins-Instanz ausgeführt wird.
az dt list

Listet die Auflistung von Digital Twins-Instanzen nach Abonnement oder Ressourcengruppe auf.
az dt model

Verwalten sie DTDL-Modelle und -Definitionen in einer Digital Twins-Instanz.
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 jedoch ohne Modelldefinitionen unterbrochen werden.
az dt model list

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

Abrufen einer Zielmodell- oder Modelldefinition.
az dt model update

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

Verwalten Sie die Netzwerkkonfiguration von Digital Twins, einschließlich privater Links und Endpunktverbindungen.
az dt network private-endpoint

Verwalten von Digital Twins-Instanzen private Endpunkte.
az dt network private-endpoint connection

Verwalten von Digital Twins-Instanzen-Private-Endpoint-Verbindungen.
az dt network private-endpoint connection delete

Löschen Sie eine private Endpunktverbindung, die der Digital Twins-Instanz zugeordnet ist.
az dt network private-endpoint connection list

Listen Sie private Endpunktverbindungen auf, die der Digital Twins-Instanz zugeordnet sind.
az dt network private-endpoint connection set

Legen Sie den Status einer privaten Endpunktverbindung fest, die der Digital Twins-Instanz zugeordnet ist.
az dt network private-endpoint connection show

Zeigen Sie eine private Endpunktverbindung an, die der Digital Twins-Instanz zugeordnet ist.
az dt network private-endpoint connection wait

Warten Sie, bis ein Vorgang für eine private Endpunktverbindung abgeschlossen ist.
az dt network private-link

Verwalten von Digital Twins-Instanzen-Private-Link-Vorgängen.
az dt network private-link list

Listen Sie private Links auf, die der Digital Twins-Instanz zugeordnet sind.
az dt network private-link show

Zeigen Sie einen privaten Link an, der der Instanz zugeordnet ist.
az dt reset

Zurücksetzen einer vorhandenen Digital Twins-Instanz durch Löschen zugeordneter Ressourcen. Derzeit unterstützt nur das Löschen von Modellen und Zwillingen.
az dt role-assignment

Verwalten von RBAC-Rollenzuweisungen für eine Digital Twins-Instanz.
az dt role-assignment create

Weisen Sie einem Benutzer, einer Gruppe oder einem Dienstprinzipal eine Rolle für eine Digital Twins-Instanz zu.
az dt role-assignment delete

Entfernen Sie eine Benutzer-, Gruppen- oder Dienstprinzipalrollenzuweisung aus einer Digital Twins-Instanz.
az dt role-assignment list

Listet die vorhandenen Rollenzuweisungen einer Digital Twins-Instanz auf.
az dt route

Verwalten und Konfigurieren von Ereignisrouten.
az dt route create

Fügen Sie eine Ereignisroute zu einer Digital Twins-Instanz hinzu.
az dt route delete

Entfernen Sie eine Ereignisroute aus einer Digital Twins-Instanz.
az dt route list

Listet die konfigurierten Ereignisrouten einer Digital Twins-Instanz auf.
az dt route show

Zeigen Sie Details einer Ereignisroute an, die in einer Digital Twins-Instanz konfiguriert ist.
az dt show

Zeigen Sie eine vorhandene Digital Twins-Instanz an.
az dt twin

Verwalten und Konfigurieren der digitalen Zwillinge einer Digital Twins-Instanz.
az dt twin component

Anzeigen und Aktualisieren der digitalen Twin-Komponenten einer Digital Twins-Instanz.
az dt twin component show

Zeigen Sie Details einer digitalen Twin-Komponente an.
az dt twin component update

Aktualisieren Sie eine digitale Twin-Komponente über 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 wait

Warten Sie, bis ein Vorgang für eine Digital Twins-Instanz abgeschlossen ist.

az dt create

Erstellen oder Aktualisieren einer Digital Twins-Instanz.

az dt create --dt-name
             --resource-group
             [--assign-identity {false, true}]
             [--location]
             [--no-wait]
             [--pna {Disabled, Enabled}]
             [--role]
             [--scopes]
             [--tags]

Beispiele

Erstellen Sie eine Instanz in der Zielressourcegruppe mithilfe des Ressourcengruppenspeicherorts.

az dt create -n {instance_name} -g {resouce_group}

Erstellen Sie instanz in der Zielressourcengruppe mit angegebenen Speicherorten und Tags.

az dt create -n {instance_name} -g {resouce_group} -l westus --tags a=b c=d

Erstellen Sie eine Instanz in der Zielressourcengruppe mit einer vom System verwalteten Identität.

az dt create -n {instance_name} -g {resouce_group} --assign-identity

Erstellen Sie eine Instanz in der Zielressourcengruppe mit einer vom System verwalteten Identität, und weisen Sie dann der Identität einen oder mehrere Bereiche (leer getrennt) mit der Rolle "Mitwirkender" zu.

az dt create -n {instance_name} -g {resouce_group} --assign-identity --scopes "/subscriptions/a12345ea-bb21-994d-2263-c716348e32a1/resourceGroups/ProResourceGroup/providers/Microsoft.EventHub/namespaces/myEventHubNamespace/eventhubs/myEventHub" "/subscriptions/a12345ea-bb21-994d-2263-c716348e32a1/resourceGroups/ProResourceGroup/providers/Microsoft.ServiceBus/namespaces/myServiceBusNamespace/topics/myTopic"

Erstellen Sie eine Instanz in der Zielressourcengruppe mit einer vom System verwalteten Identität, und weisen Sie die Identität einem oder mehreren Bereichen mit einer benutzerdefinierten angegebenen Rolle zu.

az dt create -n {instance_name} -g {resouce_group} --assign-identity --scopes "/subscriptions/a12345ea-bb21-994d-2263-c716348e32a1/resourceGroups/ProResourceGroup/providers/Microsoft.EventHub/namespaces/myEventHubNamespace/eventhubs/myEventHub" "/subscriptions/a12345ea-bb21-994d-2263-c716348e32a1/resourceGroups/ProResourceGroup/providers/Microsoft.ServiceBus/namespaces/myServiceBusNamespace/topics/myTopic" --role MyCustomRole

Aktualisieren Sie eine Instanz in der Zielressourcengruppe, um die vom System verwaltete Identität zu aktivieren.

az dt create -n {instance_name} -g {resouce_group} --assign-identity

Aktualisieren Sie eine Instanz in der Zielressourcengruppe, um die vom System verwaltete Identität zu deaktivieren.

az dt create -n {instance_name} -g {resouce_group} --assign-identity false

Aktualisieren Sie eine Instanz in der Zielressourcengruppe mit neuen Tagwerten, und deaktivieren Sie den öffentlichen Netzwerkzugriff.

az dt create -n {instance_name} -g {resouce_group} --tags env=prod --public-network-access Disabled

Erforderliche Parameter

--dt-name --dtn -n

Name der Digital Twins-Instanz.

--resource-group -g

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

Optionale Parameter

--assign-identity

Weisen Sie der Digital Twins-Instanz eine systemgenerierte Identität zu.

Zulässige Werte: false, true
--location -l

Standort der Digital Twins-Instanz. Wenn kein Speicherort bereitgestellt wird, wird der Ressourcengruppenspeicherort verwendet. Sie können den Standardspeicherort mithilfe von az configure --defaults location=<name>.

--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

--pna --public-network-access

Bestimmt, ob auf die Digital Twins-Instanz über ein öffentliches Netzwerk zugegriffen werden kann.

Zulässige Werte: Disabled, Enabled
Standardwert: Enabled
--role

Der Rollenname oder die ID der zugewiesenen Systemidentität hat.

Standardwert: Contributor
--scopes

Leertrennte Bereiche, auf die die system zugewiesene Identität zugreifen kann. Kann nicht mit --no-wait verwendet werden.

--tags

Digitale Twins-Instanztags. Eigenschaftenbehälter in Schlüsselwertpaaren mit dem folgenden Format: a=b c=d.

az dt delete

Löschen einer vorhandenen Digital Twins-Instanz.

az dt delete --dt-name
             [--no-wait]
             [--resource-group]
             [--yes]

Beispiele

Löschen Sie eine beliebige Instanz im Blockieren der Mode mit einer Bestätigungsaufforderung.

az dt delete -n {instance_name}

Löschen Sie eine beliebige Instanz ohne Sperrung oder Eingabeaufforderung.

az dt delete -n {instance_name} -y --no-wait

Erforderliche Parameter

--dt-name --dtn -n

Name der Digital Twins-Instanz.

Optionale Parameter

--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

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

Listet die Sammlung von Digital Twins-Instanzen nach Abonnement oder Ressourcengruppe auf.

az dt list [--resource-group]

Beispiele

Alle Instanzen im aktuellen Abonnement auflisten.

az dt list

Alle Instanzen in der Zielressourcengruppe und -ausgabe im Tabellenformat auflisten.

az dt list -g {resource_group} --output table

Listet alle Instanzen im Abonnement auf, die eine Bedingung erfüllen.

az dt list --query "[?contains(name, 'Production')]"

Zählen Sie Instanzen, die die Bedingung erfüllen.

az dt list --query "length([?contains(name, 'Production')])"

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 reset

Setzen Sie eine vorhandene Digital Twins-Instanz zurück, indem Sie zugeordnete Ressourcen löschen. Derzeit werden nur das Löschen von Modellen und Zwillingen unterstützt.

az dt reset --dt-name
            [--resource-group]
            [--yes]

Beispiele

Setzen Sie alle Ressourcen für eine Digital Twins-Instanz zurück.

az dt reset -n {instance_name}

Erforderliche Parameter

--dt-name --dtn -n

Name der Digital Twins-Instanz.

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 show

Zeigen Sie eine vorhandene Digital Twins-Instanz an.

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

Beispiele

Eine Instanz anzeigen.

az dt show -n {instance_name}

Zeigen Sie eine Instanz und bestimmte Eigenschaften an.

az dt show -n {instance_name} --query "{Endpoint:hostName, Location:location}"

Erforderliche Parameter

--dt-name --dtn -n

Name der Digital Twins-Instanz.

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 wait

Warten Sie, bis ein Vorgang für eine Digital Twins-Instanz abgeschlossen ist.

az dt wait --dt-name
           [--created]
           [--custom]
           [--deleted]
           [--exists]
           [--interval]
           [--resource-group]
           [--timeout]

Beispiele

Warten Sie, bis eine beliebige Instanz erstellt wird.

az dt wait -n {instance_name} --created

Warten Sie, bis eine vorhandene Instanz gelöscht wird.

az dt wait -n {instance_name} --deleted

Warten Sie, bis die publicNetworkAccess-Eigenschaft einer vorhandenen Instanz auf "Enabled" festgelegt ist.

az dt wait -n {instance_name} --custom "publicNetworkAccess=='Enabled'"

Erforderliche Parameter

--dt-name --dtn -n

Name der Digital Twins-Instanz.

Optionale Parameter

--created

Warten Sie, bis Sie mit "provisioningState" unter "Erfolgreich" erstellt wurden.

--custom

Warten Sie, bis die Bedingung eine benutzerdefinierte JMESPath-Abfrage erfüllt. Beispiel: provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Warten Sie, bis sie gelöscht wurde.

--exists

Warten Sie, bis die Ressource vorhanden ist.

--interval

Abfrageintervall in Sekunden.

Standardwert: 30
--resource-group -g

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

--timeout

Maximale Wartezeit in Sekunden.

Standardwert: 3600