Freigeben über

az iot ops asset endpoint create

  • Referenz

Hinweis

Diese Referenz ist Teil der Azure-iot-ops-Erweiterung für die Azure CLI (Version 2.53.0 oder höher). Die Erweiterung wird automatisch installiert, wenn Sie einen Az iot ops-Objektendpunkt zum Erstellen eines Befehls ausführen. Weitere Informationen zu Erweiterungen

Erstellen Sie Objektendpunktprofile.

Befehle

Name Beschreibung Typ Status
az iot ops asset endpoint create custom

Erstellen Sie ein Objektendpunktprofil für einen benutzerdefinierten Connector.

 Erweiterung Veraltet
az iot ops asset endpoint create onvif

Erstellen Sie ein Objektendpunktprofil für einen Onvif-Connector.

 Erweiterung Veraltet
az iot ops asset endpoint create opcua

Erstellen Sie ein Objektendpunktprofil für einen OPCUA-Connector.

 Erweiterung GA

az iot ops asset endpoint create custom

Als veraltet markiert

Dieser Befehl ist veraltet und wird in einer zukünftigen Version entfernt.

Erstellen Sie ein Objektendpunktprofil für einen benutzerdefinierten Connector.

az iot ops asset endpoint create custom --endpoint-type
                                        --instance
                                        --name
                                        --resource-group
                                        --ta
                                        [--ac]
                                        [--cert-ref]
                                        [--cr]
                                        [--ig]
                                        [--instance-subscription]
                                        [--location]
                                        [--pass-ref]
                                        [--pr]
                                        [--tags]
                                        [--ur]
                                        [--user-ref]

Beispiele

Erstellen Sie einen Objektendpunkt mit anonymer Benutzerauthentifizierung mithilfe der angegebenen Instanz in derselben Ressourcengruppe.

az iot ops asset endpoint create custom --name myprofile -g myresourcegroup --instance myinstance --target-address http://rest-server-service.azure-iot-operations.svc.cluster.local:80 --endpoint-type rest-thermostat

Erstellen Sie einen Objektendpunkt mit Benutzername-Kennwort-Benutzerauthentifizierung mithilfe der angegebenen Instanz in einer anderen Ressourcengruppe, jedoch mit demselben Abonnement. Die zusätzliche Konfiguration wird als Inline-JSON bereitgestellt.

az iot ops asset endpoint create custom --name myprofile -g myresourcegroup --instance myinstance --instance-resource-group myinstanceresourcegroup --target-address http://rest-server-service.azure-iot-operations.svc.cluster.local:80 --endpoint-type rest-thermostat --username-ref rest-server-auth-creds/username --password-ref rest-server-auth-creds/password --additional-config addition_configuration.json

Erstellen Sie einen Objektendpunkt mit Zertifikatauthentifizierung mithilfe der angegebenen Instanz in derselben Ressourcengruppe.

az iot ops asset endpoint create custom --name myprofile -g myresourcegroup --instance myinstance --target-address http://rest-server-service.azure-iot-operations.svc.cluster.local:80 --endpoint-type rest-thermostat --certificate-ref mycertificate.pem

Erstellen Sie einen Objektendpunkt mit anonymer Benutzerauthentifizierung mithilfe der angegebenen Instanz in derselben Ressourcengruppe. Der Inlineinhalt ist ein Bash-Syntaxbeispiel. Weitere Beispiele finden Sie unter https://aka.ms/inline-json-examples

az iot ops asset endpoint create custom --name myprofile -g myresourcegroup --instance myinstance --target-address http://rest-server-service.azure-iot-operations.svc.cluster.local:80 --endpoint-type rest-thermostat --additional-config '{"displayName": "myconnector", "maxItems": 100}'

Erforderliche Parameter

--endpoint-type --et

Endpunktprofiltyp für den Connector.

--instance

Instanzname, dem die erstellte Ressource zugeordnet werden soll.

--name -n

Name des Objektendpunktprofils.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

--ta --target-address

Zieladresse. Muss eine gültige lokale Adresse sein, die dem opc.tcp-Protokoll folgt.

Optionale Parameter

--ac --additional-config

Dateipfad mit oder Inline-JSON für die zusätzliche Konfiguration.

--cert-ref --certificate-ref

Referenz für das zertifikat, das in der Authentifizierung verwendet wird. Diese Methode der Benutzerauthentifizierung wird noch nicht unterstützt.

--cr
Als veraltet markiert

Option "--cr" ist veraltet und wird in einer zukünftigen Version entfernt. Verwenden Sie stattdessen "--cert-ref".

Referenz für das zertifikat, das in der Authentifizierung verwendet wird. Diese Methode der Benutzerauthentifizierung wird noch nicht unterstützt.

--ig --instance-resource-group

Instanzressourcengruppe. Wenn diese Option nicht angegeben wird, wird die Ressourcengruppe der Ressourcengruppe "Ressourcenendpunkt" verwendet.

--instance-subscription --is
Als veraltet markiert

Das Argument "instance_subscription" ist veraltet und wird in einer zukünftigen Version entfernt.

Instanzabonnement-ID. Wenn nicht angegeben, wird die Abonnement-ID des Objektendpunktprofils verwendet.

--location -l

Standort. Werte aus: az account list-locations. Sie können den standardmäßig verwendeten Standort mit az configure --defaults location=<location> konfigurieren.

--pass-ref --password-ref

Referenz für das kennwort, das in der Authentifizierung verwendet wird.

--pr
Als veraltet markiert

Option "--pr" ist veraltet und wird in einer zukünftigen Version entfernt. Verwenden Sie stattdessen "--pass-ref".

Referenz für das kennwort, das in der Authentifizierung verwendet wird.

--tags

Ressourcentags des Asset Endpoint Profile. Eigenschaftenbehälter in Schlüsselwertpaaren mit dem folgenden Format: a=b c=d.

--ur --username-reference
Als veraltet markiert

Option "--username-reference" ist veraltet und wird in einer zukünftigen Version entfernt. Verwenden Sie stattdessen "--user-ref".

Referenz für den Benutzernamen, der bei der Authentifizierung verwendet wird.

--user-ref --username-ref

Referenz für den Benutzernamen, der bei der Authentifizierung verwendet wird.

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.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--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 iot ops asset endpoint create onvif

Als veraltet markiert

Dieser Befehl ist veraltet und wird in einer zukünftigen Version entfernt.

Erstellen Sie ein Objektendpunktprofil für einen Onvif-Connector.

Die Zertifikatauthentifizierung wird für Onvif-Connectors noch nicht unterstützt.

Weitere Informationen zum Erstellen eines Onvif-Connectors finden Sie unter https://aka.ms/onvif-quickstart.

az iot ops asset endpoint create onvif --instance
                                       --name
                                       --resource-group
                                       --ta
                                       [--cert-ref]
                                       [--cr]
                                       [--ig]
                                       [--instance-subscription]
                                       [--location]
                                       [--pass-ref]
                                       [--pr]
                                       [--tags]
                                       [--ur]
                                       [--user-ref]

Beispiele

Erstellen Sie einen Objektendpunkt mit anonymer Benutzerauthentifizierung mithilfe der angegebenen Instanz in derselben Ressourcengruppe.

az iot ops asset endpoint create onvif --name myprofile -g myresourcegroup --instance myinstance --target-address http://onvif-rtsp-simulator:8000

Erstellen Sie einen Objektendpunkt mit Benutzername-Kennwort-Benutzerauthentifizierung mithilfe der angegebenen Instanz in einer anderen Ressourcengruppe, jedoch mit demselben Abonnement.

az iot ops asset endpoint create onvif --name myprofile -g myresourcegroup --instance myinstance --instance-resource-group myinstanceresourcegroup --target-address http://onvif-rtsp-simulator:8000 --username-ref rest-server-auth-creds/username --password-ref rest-server-auth-creds/password

Erforderliche Parameter

--instance

Instanzname, dem die erstellte Ressource zugeordnet werden soll.

--name -n

Name des Objektendpunktprofils.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

--ta --target-address

Zieladresse. Muss eine gültige lokale Adresse sein, die dem opc.tcp-Protokoll folgt.

Optionale Parameter

--cert-ref --certificate-ref

Referenz für das zertifikat, das in der Authentifizierung verwendet wird. Diese Methode der Benutzerauthentifizierung wird noch nicht unterstützt.

--cr
Als veraltet markiert

Option "--cr" ist veraltet und wird in einer zukünftigen Version entfernt. Verwenden Sie stattdessen "--cert-ref".

Referenz für das zertifikat, das in der Authentifizierung verwendet wird. Diese Methode der Benutzerauthentifizierung wird noch nicht unterstützt.

--ig --instance-resource-group

Instanzressourcengruppe. Wenn diese Option nicht angegeben wird, wird die Ressourcengruppe der Ressourcengruppe "Ressourcenendpunkt" verwendet.

--instance-subscription --is
Als veraltet markiert

Das Argument "instance_subscription" ist veraltet und wird in einer zukünftigen Version entfernt.

Instanzabonnement-ID. Wenn nicht angegeben, wird die Abonnement-ID des Objektendpunktprofils verwendet.

--location -l

Standort. Werte aus: az account list-locations. Sie können den standardmäßig verwendeten Standort mit az configure --defaults location=<location> konfigurieren.

--pass-ref --password-ref

Referenz für das kennwort, das in der Authentifizierung verwendet wird.

--pr
Als veraltet markiert

Option "--pr" ist veraltet und wird in einer zukünftigen Version entfernt. Verwenden Sie stattdessen "--pass-ref".

Referenz für das kennwort, das in der Authentifizierung verwendet wird.

--tags

Ressourcentags des Asset Endpoint Profile. Eigenschaftenbehälter in Schlüsselwertpaaren mit dem folgenden Format: a=b c=d.

--ur --username-reference
Als veraltet markiert

Option "--username-reference" ist veraltet und wird in einer zukünftigen Version entfernt. Verwenden Sie stattdessen "--user-ref".

Referenz für den Benutzernamen, der bei der Authentifizierung verwendet wird.

--user-ref --username-ref

Referenz für den Benutzernamen, der bei der Authentifizierung verwendet wird.

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.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--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 iot ops asset endpoint create opcua

Erstellen Sie ein Objektendpunktprofil für einen OPCUA-Connector.

Azure IoT OPC UA Connector (Vorschau) verwendet dasselbe Clientzertifikat für alle sicheren Kanäle zwischen sich selbst und den OPC UA-Servern, mit denen es eine Verbindung herstellt.

Bei OPC UA-Verbinderargumenten bedeutet der Wert -1, dass der Parameter nicht verwendet wird (z. B. --session-reconnect-backoff -1 bedeutet, dass kein exponentieller Backoff verwendet werden soll). Ein Wert von 0 bedeutet, dass die schnellste praktische Rate verwendet wird (z. B. --default-sampling-int 0 bedeutet, dass für den Server das schnellste Samplingintervall verwendet wird).

Weitere Informationen zum Konfigurieren von Objektendpunkten für den OPC UA-Connector finden Sie unter https://aka.ms/opcua-quickstart.

az iot ops asset endpoint create opcua --instance
                                       --name
                                       --resource-group
                                       --ta
                                       [--accept-untrusted-certs {false, true}]
                                       [--app]
                                       [--cert-ref]
                                       [--default-publishing-int]
                                       [--default-queue-size]
                                       [--default-sampling-int]
                                       [--ig]
                                       [--instance-subscription]
                                       [--ka]
                                       [--location]
                                       [--pass-ref]
                                       [--pr]
                                       [--rad {false, true}]
                                       [--security-mode {none, sign, signAndEncrypt}]
                                       [--security-policy {Aes128_Sha256_RsaOaep, Aes256_Sha256_RsaPss, Basic128Rsa15, Basic256, Basic256Sha256, none}]
                                       [--session-keep-alive]
                                       [--session-reconnect-backoff]
                                       [--session-reconnect-period]
                                       [--session-timeout]
                                       [--slt]
                                       [--smi]
                                       [--tags]
                                       [--ur]
                                       [--user-ref]

Beispiele

Erstellen Sie einen Objektendpunkt mit anonymer Benutzerauthentifizierung mithilfe der angegebenen Instanz in derselben Ressourcengruppe.

az iot ops asset endpoint create opcua --name myprofile -g myresourcegroup --instance myinstance --target-address opc.tcp://opcplc-000000:50000

Erstellen Sie einen Objektendpunkt mit anonymer Benutzerauthentifizierung mithilfe der angegebenen Instanz in einer anderen Ressourcengruppe, jedoch mit demselben Abonnement. Beachten Sie, dass die digital Operations Experience das Objektendpunktprofil möglicherweise nicht anzeigt, wenn es sich in einem anderen Abonnement als die Instanz befindet.

az iot ops asset endpoint create opcua --name myprofile -g myresourcegroup --instance myinstance --instance-resource-group myinstanceresourcegroup --target-address opc.tcp://opcplc-000000:50000

Erstellen Sie einen Objektendpunkt mit Benutzername-Kennwort-Benutzerauthentifizierung mithilfe der angegebenen Instanz in derselben Ressourcengruppe.

az iot ops asset endpoint create opcua --name myprofile -g myresourcegroup --instance myinstance --target-address opc.tcp://opcplc-000000:50000 --username-ref myusername --password-ref mypassword

Erstellen Sie einen Objektendpunkt mit anonymer Benutzerauthentifizierung und empfohlenen Werten für die OPCUA-Konfiguration mithilfe der angegebenen Instanz in derselben Ressourcengruppe. Beachten Sie, dass Sie für die erfolgreiche Verwendung des Connectors den OPC PLC-Dienst bereitgestellt haben müssen und die Zieladresse auf den Dienst verweisen muss. Wenn sich der OPC PLC-Dienst im selben Cluster und Namespace wie IoT Ops befindet, sollte die Zieladresse als "opc.tcp://{opc-plc-service-name}:{service-port}" formatiert werden, wenn sich der OPC PLC-Dienst im selben Cluster befindet, aber einen anderen Namespace wie IoT Ops hat, schließen Sie den Dienstnamespace wie "opc.tcp://{opc-plc-service-name}" ein. {service-namespace}:{service-port}' Weitere Informationen finden Sie unter aka.ms/opcua-quickstart

az iot ops asset endpoint create opcua --name myprofile -g myresourcegroup --instance myinstance --target-address opc.tcp://opcplc-000000:50000 --accept-untrusted-certs --application myopcuaconnector --default-publishing-int 1000 --default-queue-size 1 --default-sampling-int 1000 --keep-alive 10000 --run-asset-discovery --security-mode sign --security-policy Basic256 --session-keep-alive 10000 --session-reconnect-backoff 10000 --session-reconnect-period 2000 --session-timeout 60000 --subscription-life-time 60000 --subscription-max-items 1000

Erforderliche Parameter

--instance

Instanzname, dem die erstellte Ressource zugeordnet werden soll.

--name -n

Name des Objektendpunktprofils.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

--ta --target-address

Zieladresse. Muss eine gültige lokale Adresse sein, die dem opc.tcp-Protokoll folgt.

Optionale Parameter

--accept-untrusted-certs --auc

Flag zum Aktivieren der automatischen Annahme nicht vertrauenswürdiger Serverzertifikate.

Zulässige Werte: false, true
--app --application

Der Anwendungsname. Wird als Betreff für alle Zertifikate verwendet, die vom Connector generiert werden.

--cert-ref --cert-ref --certificate-ref --cr
Als veraltet markiert

Das Argument "certificate_reference" ist veraltet und wird in einer zukünftigen Version entfernt.

Referenz für das zertifikat, das in der Authentifizierung verwendet wird. Diese Methode der Benutzerauthentifizierung wird noch nicht unterstützt.

--default-publishing-int --dpi

Standardveröffentlichungsintervall in Millisekunden. Minimum: -1. Empfohlen: 1000.

--default-queue-size --dqs

Standardwarteschlangengröße. Mindestwert: 0 Empfohlen: 1.

--default-sampling-int --dsi

Standard-Samplingintervall in Millisekunden. Minimum: -1. Empfohlen: 1000.

--ig --instance-resource-group

Instanzressourcengruppe. Wenn diese Option nicht angegeben wird, wird die Ressourcengruppe der Ressourcengruppe "Ressourcenendpunkt" verwendet.

--instance-subscription --is
Als veraltet markiert

Das Argument "instance_subscription" ist veraltet und wird in einer zukünftigen Version entfernt.

Instanzabonnement-ID. Wenn nicht angegeben, wird die Abonnement-ID des Objektendpunktprofils verwendet.

--ka --keep-alive

Zeit in Millisekunden, nach der eine Keep Alive-Veröffentlichungsantwort gesendet wird. Mindestwert: 0 Empfohlen: 10000.

--location -l

Standort. Werte aus: az account list-locations. Sie können den standardmäßig verwendeten Standort mit az configure --defaults location=<location> konfigurieren.

--pass-ref --password-ref

Referenz für das kennwort, das in der Authentifizierung verwendet wird.

--pr
Als veraltet markiert

Option "--pr" ist veraltet und wird in einer zukünftigen Version entfernt. Verwenden Sie stattdessen "--pass-ref".

Referenz für das kennwort, das in der Authentifizierung verwendet wird.

--rad --run-asset-discovery

Kennzeichnen Sie, um zu ermitteln, ob die Ressourcenermittlung ausgeführt werden soll.

Zulässige Werte: false, true
--security-mode --sm

Sicherheitsmodus

Zulässige Werte: none, sign, signAndEncrypt
--security-policy --sp

Sicherheitsrichtlinie.

Zulässige Werte: Aes128_Sha256_RsaOaep, Aes256_Sha256_RsaPss, Basic128Rsa15, Basic256, Basic256Sha256, none
--session-keep-alive --ska

Die Zeit in Millisekunden, nach der eine Sitzung aktiv bleibt, wird gesendet, um Verbindungsprobleme zu erkennen. Mindestwert: 0 Empfohlen: 10000.

--session-reconnect-backoff --srb

Sitzung wieder exponentielle Verbindung in Millisekunden herstellen. Minimum: -1. Empfohlen: 10000.

--session-reconnect-period --srp

Sitzungsverknüpfungszeitraum in Millisekunden. Mindestwert: 0 Empfohlen: 2000.

--session-timeout --st

Sitzungstimeout in Millisekunden. Mindestwert: 0 Empfohlen: 60000.

--slt --subscription-life-time

Lebenszeit in Millisekunden der vom Connector für das Abonnement erstellten Elemente. Mindestwert: 0 Empfohlen: 60000.

--smi --subscription-max-items

Maximale Anzahl von Elementen, die der Connector für das Abonnement erstellen kann. Minimum: 1. Empfohlen: 1000.

--tags

Ressourcentags des Asset Endpoint Profile. Eigenschaftenbehälter in Schlüsselwertpaaren mit dem folgenden Format: a=b c=d.

--ur --username-reference
Als veraltet markiert

Option "--username-reference" ist veraltet und wird in einer zukünftigen Version entfernt. Verwenden Sie stattdessen "--user-ref".

Referenz für den Benutzernamen, der bei der Authentifizierung verwendet wird.

--user-ref --username-ref

Referenz für den Benutzernamen, der bei der Authentifizierung verwendet wird.

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.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--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.