Freigeben über

az dt endpoint create

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 einen az dt-Endpunkt zum erstellen Befehl ausführen. Erfahren Sie mehr über Erweiterungen.

Fügen Sie Endpunkte zu einer Digital Twins-Instanz hinzu.

Befehle

Name Beschreibung Typ Status
az dt endpoint create eventgrid

Fügt einer Digital Twins-Instanz einen EventGrid-Themenendpunkt hinzu. Erfordert eine zuvor erstellte Ressource.

 Extension GA
az dt endpoint create eventhub

Fügt einen EventHub-Endpunkt zu einer Digital Twins-Instanz hinzu.

 Extension GA
az dt endpoint create servicebus

Fügt einer Digital Twins-Instanz einen ServiceBus Topic-Endpunkt hinzu.

 Extension GA

az dt endpoint create eventgrid

Fügt einer Digital Twins-Instanz einen EventGrid-Themenendpunkt hinzu. Erfordert eine zuvor erstellte Ressource.

EventGrid-Themenendpunkte unterstützen keine identitätsbasierte Endpunktintegration.

az dt endpoint create eventgrid --dt-name --dtn
                                --egt --eventgrid-topic
                                --en --endpoint-name
                                [--deadletter-sas-uri --dsu]
                                [--deadletter-uri --du]
                                [--egg --eventgrid-resource-group]
                                [--egs --eventgrid-subscription]
                                [--no-wait]
                                [--resource-group]

Beispiele

Fügt einer Zielinstanz einen EventGrid-Themenendpunkt hinzu.

az dt endpoint create eventgrid --endpoint-name {endpoint_name} --eventgrid-resource-group {eventgrid_resource_group} --eventgrid-topic {eventgrid_topic_name} -n {instance_name}

Erforderliche Parameter

--dt-name --dtn -n

Name der Digital Twins-Instanz.

--egt --eventgrid-topic

Name des EventGrid-Themas, in das integriert werden soll.

Eigenschaft Wert
Parametergruppe: Event Grid Topic Arguments
--en --endpoint-name

Endpunktname.

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.

--deadletter-sas-uri --dsu

Container-URL für Speichercontainer mit Inaktiven Buchstaben mit SAS-Token für die schlüsselbasierte Authentifizierung.

Eigenschaft Wert
Parametergruppe: Dead-letter Endpoint Arguments
--deadletter-uri --du

Speichercontainer-URL für Den inaktiven Buchstaben für die identitätsbasierte Authentifizierung.

Eigenschaft Wert
Parametergruppe: Dead-letter Endpoint Arguments
--egg --eventgrid-resource-group

Name der EventGrid-Themenressourcengruppe. Falls nicht angegeben, wird die Ressourcengruppe der Digital Twin-Instanz verwendet.

Eigenschaft Wert
Parametergruppe: Event Grid Topic Arguments
--egs --eventgrid-subscription

Name oder ID des Abonnements, in dem die Endpunktressource vorhanden ist. Wenn kein Abonnement bereitgestellt wird, wird das Standardabonnement verwendet.

Eigenschaft Wert
Parametergruppe: Event Grid Topic Arguments
--no-wait

Warten Sie nicht, bis der lange ausgeführte Vorgang abgeschlossen ist.

Eigenschaft Wert
Standardwert: False
--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 endpoint create eventhub

Fügt einen EventHub-Endpunkt zu einer Digital Twins-Instanz hinzu.

Erfordert eine zuvor erstellte Ressource.

Die Instanz muss über eine vom System zugewiesene Identität verfügen, um die Integration von vom System zugewiesenen identitätsbasierten Endpunkten zu unterstützen. Die Instanz muss der vom Benutzer zugewiesenen Identität zugeordnet sein, um die integration des vom Benutzer zugewiesenen identitätsbasierten Endpunkts zu unterstützen.

az dt endpoint create eventhub --dt-name --dtn
                               --eh --eventhub
                               --ehn --eventhub-namespace
                               --en --endpoint-name
                               [--auth-type {IdentityBased, KeyBased}]
                               [--deadletter-sas-uri --dsu]
                               [--deadletter-uri --du]
                               [--ehg --eventhub-resource-group]
                               [--ehp --eventhub-policy]
                               [--ehs --eventhub-subscription]
                               [--mi-system-assigned --system {false, true}]
                               [--mi-user-assigned --user]
                               [--no-wait]
                               [--resource-group]

Beispiele

Fügt einer Zielinstanz mithilfe der schlüsselbasierten Authentifizierung einen EventHub-Endpunkt hinzu.

az dt endpoint create eventhub --endpoint-name {endpoint_name} --eventhub-resource-group {eventhub_resource_group} --eventhub-namespace {eventhub_namespace} --eventhub {eventhub_name} --eventhub-policy {eventhub_policy} -n {instance_name}

Fügt einer Zielinstanz einen EventHub-Endpunkt mithilfe der vom System zugewiesenen Identität für die Authentifizierung hinzu.

az dt endpoint create eventhub --endpoint-name {endpoint_name} --eventhub-resource-group {eventhub_resource_group} --eventhub-namespace {eventhub_namespace} --eventhub {eventhub_name} --mi-system-assigned -n {instance_name}

Fügt einer Zielinstanz einen EventHub-Endpunkt mithilfe einer vom Benutzer zugewiesenen Identität für die Authentifizierung hinzu.

az dt endpoint create eventhub --endpoint-name {endpoint_name} --eventhub-resource-group {eventhub_resource_group} --eventhub-namespace {eventhub_namespace} --eventhub {eventhub_name} --mi-user-assigned {resource_id} -n {instance_name}

Erforderliche Parameter

--dt-name --dtn -n

Name der Digital Twins-Instanz.

--eh --eventhub

Name von EventHub zur Integration in.

Eigenschaft Wert
Parametergruppe: Event Hub Arguments
--ehn --eventhub-namespace

EventHub-Namespacebezeichner.

Eigenschaft Wert
Parametergruppe: Event Hub Arguments
--en --endpoint-name

Endpunktname.

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.

--auth-type
Als veraltet markiert

Das Argument "auth_type" ist veraltet und wird in einer zukünftigen Version entfernt. Verwenden Sie stattdessen "Identity".

Endpunktauthentifizierungstyp.

Eigenschaft Wert
Standardwert: KeyBased
Zulässige Werte: IdentityBased, KeyBased
--deadletter-sas-uri --dsu

Container-URL für Speichercontainer mit Inaktiven Buchstaben mit SAS-Token für die schlüsselbasierte Authentifizierung.

Eigenschaft Wert
Parametergruppe: Dead-letter Endpoint Arguments
--deadletter-uri --du

Speichercontainer-URL für Den inaktiven Buchstaben für die identitätsbasierte Authentifizierung.

Eigenschaft Wert
Parametergruppe: Dead-letter Endpoint Arguments
--ehg --eventhub-resource-group

Name der EventHub-Ressourcengruppe. Falls nicht angegeben, wird die Ressourcengruppe der Digital Twin-Instanz verwendet.

Eigenschaft Wert
Parametergruppe: Event Hub Arguments
--ehp --eventhub-policy

EventHub-Richtlinie, die für die Endpunktkonfiguration verwendet werden soll. Erforderlich, wenn "-auth"-Typ "KeyBased" ist.

Eigenschaft Wert
Parametergruppe: Event Hub Arguments
--ehs --eventhub-subscription

Name oder ID des Abonnements, in dem die Endpunktressource vorhanden ist. Wenn kein Abonnement bereitgestellt wird, wird das Standardabonnement verwendet.

Eigenschaft Wert
Parametergruppe: Event Hub Arguments
--mi-system-assigned --system

Verwenden Sie die vom System zugewiesene verwaltete Identität für die Endpunktauthentifizierung.

Eigenschaft Wert
Zulässige Werte: false, true
--mi-user-assigned --user

Verwenden Sie eine vom Benutzer zugewiesene verwaltete Identität für die Endpunktauthentifizierung. Akzeptiert die Identitätsressourcen-ID.

--no-wait

Warten Sie nicht, bis der lange ausgeführte Vorgang abgeschlossen ist.

Eigenschaft Wert
Standardwert: False
--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 endpoint create servicebus

Fügt einer Digital Twins-Instanz einen ServiceBus Topic-Endpunkt hinzu.

Erfordert eine zuvor erstellte Ressource.

Die Instanz muss über eine vom System zugewiesene Identität verfügen, um die Integration von vom System zugewiesenen identitätsbasierten Endpunkten zu unterstützen. Die Instanz muss der vom Benutzer zugewiesenen Identität zugeordnet sein, um die integration des vom Benutzer zugewiesenen identitätsbasierten Endpunkts zu unterstützen.

az dt endpoint create servicebus --dt-name --dtn
                                 --en --endpoint-name
                                 --sbn --servicebus-namespace
                                 --sbt --servicebus-topic
                                 [--auth-type {IdentityBased, KeyBased}]
                                 [--deadletter-sas-uri --dsu]
                                 [--deadletter-uri --du]
                                 [--mi-system-assigned --system {false, true}]
                                 [--mi-user-assigned --user]
                                 [--no-wait]
                                 [--resource-group]
                                 [--sbg --servicebus-resource-group]
                                 [--sbp --servicebus-policy]
                                 [--sbs --servicebus-subscription]

Beispiele

Fügt einer Zielinstanz mithilfe der schlüsselbasierten Authentifizierung einen ServiceBus-Themenendpunkt hinzu.

az dt endpoint create servicebus --endpoint-name {endpoint_name} --servicebus-resource-group {servicebus_resource_group} --servicebus-namespace {servicebus_namespace} --servicebus-topic {servicebus_topic_name} --servicebus-policy {servicebus_policy} -n {instance_name}

Fügt einer Zielinstanz einen ServiceBus-Themenendpunkt mithilfe der vom System zugewiesenen Identität für die Authentifizierung hinzu.

az dt endpoint create servicebus --endpoint-name {endpoint_name} --servicebus-resource-group {servicebus_resource_group} --servicebus-namespace {servicebus_namespace} --servicebus-topic {servicebus_topic_name} --mi-system-assigned -n {instance_name}

Fügt einer Zielinstanz einen ServiceBus-Themenendpunkt mithilfe einer vom Benutzer zugewiesenen Identität für die Authentifizierung hinzu.

az dt endpoint create servicebus --endpoint-name {endpoint_name} --servicebus-resource-group {servicebus_resource_group} --servicebus-namespace {servicebus_namespace} --servicebus-topic {servicebus_topic_name} --mi-user-assigned {resource_id} -n {instance_name}

Erforderliche Parameter

--dt-name --dtn -n

Name der Digital Twins-Instanz.

--en --endpoint-name

Endpunktname.

--sbn --servicebus-namespace

ServiceBus-Namespacebezeichner.

Eigenschaft Wert
Parametergruppe: Service Bus Topic Arguments
--sbt --servicebus-topic

Name des ServiceBus-Themas, in das integriert werden soll.

Eigenschaft Wert
Parametergruppe: Service Bus Topic Arguments

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.

--auth-type
Als veraltet markiert

Das Argument "auth_type" ist veraltet und wird in einer zukünftigen Version entfernt. Verwenden Sie stattdessen "Identity".

Endpunktauthentifizierungstyp.

Eigenschaft Wert
Standardwert: KeyBased
Zulässige Werte: IdentityBased, KeyBased
--deadletter-sas-uri --dsu

Container-URL für Speichercontainer mit Inaktiven Buchstaben mit SAS-Token für die schlüsselbasierte Authentifizierung.

Eigenschaft Wert
Parametergruppe: Dead-letter Endpoint Arguments
--deadletter-uri --du

Speichercontainer-URL für Den inaktiven Buchstaben für die identitätsbasierte Authentifizierung.

Eigenschaft Wert
Parametergruppe: Dead-letter Endpoint Arguments
--mi-system-assigned --system

Verwenden Sie die vom System zugewiesene verwaltete Identität für die Endpunktauthentifizierung.

Eigenschaft Wert
Zulässige Werte: false, true
--mi-user-assigned --user

Verwenden Sie eine vom Benutzer zugewiesene verwaltete Identität für die Endpunktauthentifizierung. Akzeptiert die Identitätsressourcen-ID.

--no-wait

Warten Sie nicht, bis der lange ausgeführte Vorgang abgeschlossen ist.

Eigenschaft Wert
Standardwert: False
--resource-group -g

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

--sbg --servicebus-resource-group

Name der ServiceBus-Ressourcengruppe. Falls nicht angegeben, wird die Ressourcengruppe der Digital Twin-Instanz verwendet.

Eigenschaft Wert
Parametergruppe: Service Bus Topic Arguments
--sbp --servicebus-policy

ServiceBus-Themenrichtlinie, die für die Endpunktkonfiguration verwendet werden soll. Erforderlich, wenn "-auth"-Typ "KeyBased" ist.

Eigenschaft Wert
Parametergruppe: Service Bus Topic Arguments
--sbs --servicebus-subscription

Name oder ID des Abonnements, in dem die Endpunktressource vorhanden ist. Wenn kein Abonnement bereitgestellt wird, wird das Standardabonnement verwendet.

Eigenschaft Wert
Parametergruppe: Service Bus Topic Arguments
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