Share via

az iot ops asset endpoint

  • Vorschau
  • Referenz

Hinweis

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

Die Befehlsgruppe "iot ops" befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Verwalten von Objektendpunktprofilen.

Befehle

Name Beschreibung Typ Status
az iot ops asset endpoint certificate

Verwalten von zertifikateigenen Zertifikaten in einem Objektendpunkt.

 Erweiterung Vorschau
az iot ops asset endpoint certificate add

Fügen Sie einem Objektendpunkt ein eigenes Zertifikat hinzu.

 Erweiterung Vorschau
az iot ops asset endpoint certificate list

Auflisten von zertifikateigenen Zertifikaten in einem Objektendpunkt.

 Erweiterung Vorschau
az iot ops asset endpoint certificate remove

Entfernen Eines eigenen Zertifikats in einem Objektendpunkt.

 Erweiterung Vorschau
az iot ops asset endpoint create

Erstellen Sie einen Objektendpunkt.

 Erweiterung Vorschau
az iot ops asset endpoint delete

Löschen sie einen Objektendpunkt.

 Erweiterung Vorschau
az iot ops asset endpoint query

Abfragen des Ressourcendiagramms für Ressourcenendpunkte.

 Erweiterung Vorschau
az iot ops asset endpoint show

Anzeigen eines Objektendpunkts.

 Erweiterung Vorschau
az iot ops asset endpoint update

Aktualisieren eines Objektendpunkts.

 Erweiterung Vorschau

az iot ops asset endpoint create

Vorschau

Die Befehlsgruppe "iot ops" befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Erstellen Sie einen Objektendpunkt.

Entweder benutzerdefinierter Speicherort oder Clustername muss angegeben werden. Dieser Befehl sucht nach dem Vorhandensein des zugeordneten benutzerdefinierten Speicherorts und Clusters und stellt sicher, dass beide ordnungsgemäß mit der Erweiterung "microsoft.deviceregistry.assets" eingerichtet sind.

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

az iot ops asset endpoint create --name
                                 --resource-group
                                 --ta
                                 [--ac]
                                 [--cert]
                                 [--cert-ref]
                                 [--cl]
                                 [--clrg]
                                 [--cls]
                                 [--cluster]
                                 [--cluster-resource-group]
                                 [--cluster-subscription]
                                 [--location]
                                 [--password-ref]
                                 [--tags]
                                 [--ur]

Beispiele

Erstellen Sie einen Objektendpunkt mit anonymer Benutzerauthentifizierung mithilfe des angegebenen benutzerdefinierten Speicherorts.

az iot ops asset endpoint create --name {asset_endpoint} -g {resource_group} --custom-location {custom_location} --target-address {target_address}

Erstellen Sie einen Objektendpunkt mit anonymer Benutzerauthentifizierung mithilfe des angegebenen benutzerdefinierten Speicherorts und der Ressourcengruppe für den benutzerdefinierten Speicherort. Die Ressourcengruppe muss einbezogen werden, wenn mehrere benutzerdefinierte Speicherorte mit demselben Namen innerhalb eines Abonnements vorhanden sind.

az iot ops asset endpoint create --name {asset_endpoint} -g {resource_group} --custom-location {custom_location} --custom-location-resource-group {custom_location_resource_group} --target-address {target_address}

Erstellen Sie einen Objektendpunkt mit Benutzername-Kennwort-Benutzerauthentifizierung und vorkonfigurierten Zertifikaten mit vorgefüllten Werten. Die Benutzernamen- und Kennwortverweise werden über den Azure Keyvault Container Storage Interface-Treiber festgelegt.

az iot ops asset endpoint create --name myAssetEndpoint -g myRG --cluster myCluster --target-address "opc.tcp://opcplc-000000:50000" --username-ref "aio-opc-ua-broker-user-authentication/opc-plc-username" --password-ref "aio-opc-ua-broker-user-authentication/opc-plc-password" --cert secret=aio-opc-ua-broker-client-certificate thumbprint=000000000000000000 password=aio-opc-ua-broker-client-certificate-password

Erstellen Sie einen Objektendpunkt mit Benutzername-Kennwort-Benutzerauthentifizierung und zusätzlicher Konfiguration mit vorgefüllten Werten (PowerShell-Syntaxbeispiel).

az iot ops asset endpoint create --name myAssetEndpoint -g myRG --cluster myCluster --target-address "opc.tcp://opcplc-000000:50000" --username-ref "aio-opc-ua-broker-user-authentication/opc-plc-username" --password-ref "aio-opc-ua-broker-user-authentication/opc-plc-password" --additional-config '{\"applicationName\": \"opcua-connector\", \"defaults\": { \"publishingIntervalMilliseconds\": 100,  \"samplingIntervalMilliseconds\": 500,  \"queueSize\": 15,}, \"session\": {\"timeout\": 60000}, \"subscription\": {\"maxItems\": 1000}, \"security\": { \"autoAcceptUntrustedServerCertificates\": true}}'

Erstellen Sie einen Objektendpunkt mit Benutzername-Kennwort-Benutzerauthentifizierung und zusätzlicher Konfiguration mit vorgefüllten Werten (Beispiel für cmd-Syntax).

az iot ops asset endpoint create --name myAssetEndpoint -g myRG --cluster myCluster --target-address "opc.tcp://opcplc-000000:50000" --username-ref "aio-opc-ua-broker-user-authentication/opc-plc-username" --password-ref "aio-opc-ua-broker-user-authentication/opc-plc-password" --additional-config "{\"applicationName\": \"opcua-connector\", \"defaults\": { \"publishingIntervalMilliseconds\": 100,  \"samplingIntervalMilliseconds\": 500,  \"queueSize\": 15,}, \"session\": {\"timeout\": 60000}, \"subscription\": {\"maxItems\": 1000}, \"security\": { \"autoAcceptUntrustedServerCertificates\": true}}"

Erstellen Sie einen Objektendpunkt mit Benutzername-Kennwort-Benutzerauthentifizierung und zusätzlicher Konfiguration mit vorgefüllten Werten (Bash-Syntaxbeispiel).

az iot ops asset endpoint create --name myAssetEndpoint -g myRG --cluster myCluster --target-address "opc.tcp://opcplc-000000:50000" --username-ref "aio-opc-ua-broker-user-authentication/opc-plc-username" --password-ref "aio-opc-ua-broker-user-authentication/opc-plc-password" --additional-config '{"applicationName": "opcua-connector", "defaults": { "publishingIntervalMilliseconds": 100,  "samplingIntervalMilliseconds": 500,  "queueSize": 15,}, "session": {"timeout": 60000}, "subscription": {"maxItems": 1000}, "security": { "autoAcceptUntrustedServerCertificates": true}}'

Erforderliche Parameter

--name -n

Name des Objektendpunkts.

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

Optionale Parameter

--ac --additional-config

Zusätzliche Konfiguration für den Verbindungstyp (z. B. OPC UA, Benchmarking, ONVIF).

--cert

Leerzeichentrennte Schlüssel=Wertpaare, die Zertifikaten entsprechen, die dem Endpunkt zugeordnet sind. Die folgenden Schlüsselwerte werden unterstützt: secret (erforderlich), thumbprint (erforderlich), password.-cert kann 1 oder mehr verwendet werden. Überprüfen Sie Die Hilfebeispiele für die vollständige Parameterverwendung.

--cert-ref --certificate-ref --cr

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

--cl --custom-location

Benutzerdefinierter Speicherort, der zum Zuordnen des Objektendpunkts zum Cluster verwendet wird.

--clrg --custom-location-resource-group

Ressourcengruppe für benutzerdefinierte Position.

--cls --custom-location-subscription

Abonnement-ID für benutzerdefinierten Speicherort.

--cluster -c

Cluster, dem die Ressource zugeordnet werden soll.

--cluster-resource-group --crg

Ressourcengruppe für Cluster.

--cluster-subscription --cs

Abonnement-ID für Cluster.

--location -l

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

--password-ref --pr

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

--tags

Ressourcentags des Ressourcenendpunkts für Ressourcen. Eigenschaftenbehälter in Schlüsselwertpaaren mit dem folgenden Format: a=b c=d.

--ur --username-reference

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 delete

Vorschau

Die Befehlsgruppe "iot ops" befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Löschen sie einen Objektendpunkt.

az iot ops asset endpoint delete --name
                                 --resource-group

Beispiele

Löschen sie einen Objektendpunkt.

az iot ops asset endpoint delete --name {asset_endpoint} -g {resource_group}

Erforderliche Parameter

--name -n

Name des Objektendpunkts.

--resource-group -g

Name der Ressourcengruppe 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.

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 query

Vorschau

Die Befehlsgruppe "iot ops" befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Abfragen des Ressourcendiagramms für Ressourcenendpunkte.

az iot ops asset endpoint query [--ac]
                                [--am]
                                [--cl]
                                [--location]
                                [--resource-group]
                                [--ta]

Beispiele

Fragen Sie nach Objektendpunkten ab, die anonyme Authentifizierung erhalten.

az iot ops asset endpoint query --authentication-mode Anonymous

Fragen Sie nach Objektendpunkten ab, die die angegebene Zieladresse und den benutzerdefinierten Speicherort aufweisen.

az iot ops asset endpoint query --target-address {target_address} --custom-location {custom_location}

Optionale Parameter

--ac --additional-config

Zusätzliche Konfiguration für den Verbindungstyp (z. B. OPC UA, Benchmarking, ONVIF).

--am --authentication-mode

Authentifizierungsmodus.

--cl --custom-location

Benutzerdefinierter Speicherort, der zum Zuordnen des Objektendpunkts zum Cluster verwendet wird.

--location -l

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

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

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 show

Vorschau

Die Befehlsgruppe "iot ops" befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Anzeigen eines Objektendpunkts.

az iot ops asset endpoint show --name
                               --resource-group

Beispiele

Zeigen Sie die Details eines Objektendpunkts an.

az iot ops asset endpoint show --name {asset_endpoint} -g {resource_group}

Erforderliche Parameter

--name -n

Name des Objektendpunkts.

--resource-group -g

Name der Ressourcengruppe 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.

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 update

Vorschau

Die Befehlsgruppe "iot ops" befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Aktualisieren eines Objektendpunkts.

Verwenden Sie die Befehlsgruppe az iot ops asset endpoint certificate, um eigene Zertifikate zu aktualisieren.

az iot ops asset endpoint update --name
                                 --resource-group
                                 [--ac]
                                 [--am]
                                 [--cert-ref]
                                 [--password-ref]
                                 [--ta]
                                 [--tags]
                                 [--ur]

Beispiele

Aktualisieren Sie den Authentifizierungsmodus eines Objektendpunkts, um die anonyme Benutzerauthentifizierung zu verwenden.

az iot ops asset endpoint update --name {asset_endpoint} -g {resource_group} --authentication-mode Anonymous

Aktualisieren Sie den Benutzernamen- und Kennwortverweis eines Objektendpunkts mit vorgefüllten Werten. Dadurch wird der Authentifizierungsmodus in "Benutzername-Kennwort" umgewandelt, sofern dies noch nicht der Fall ist.

az iot ops asset endpoint update --name myAssetEndpoint -g myRG --username-ref "aio-opc-ua-broker-user-authentication/opc-plc-username" --password-ref "aio-opc-ua-broker-user-authentication/opc-plc-password"

Aktualisieren Sie die Zieladresse eines Objektendpunkts und zusätzliche Konfiguration mit vorgefüllten Werten (PowerShell-Syntaxbeispiel).

az iot ops asset endpoint update --name myAssetEndpoint -g myRG --target-address "opc.tcp://opcplc-000000:50000" --additional-config '{\"applicationName\": \"opcua-connector\", \"defaults\": { \"publishingIntervalMilliseconds\": 100,  \"samplingIntervalMilliseconds\": 500,  \"queueSize\": 15,}, \"session\": {\"timeout\": 60000}, \"subscription\": {\"maxItems\": 1000}, \"security\": { \"autoAcceptUntrustedServerCertificates\": true}}'

Aktualisieren Sie die Zieladresse eines Objektendpunkts und zusätzliche Konfiguration mit vorgefüllten Werten (beispiel für cmd-Syntax).

az iot ops asset endpoint update --name myAssetEndpoint -g myRG --target-address "opc.tcp://opcplc-000000:50000" --additional-config "{\"applicationName\": \"opcua-connector\", \"defaults\": { \"publishingIntervalMilliseconds\": 100,  \"samplingIntervalMilliseconds\": 500,  \"queueSize\": 15,}, \"session\": {\"timeout\": 60000}, \"subscription\": {\"maxItems\": 1000}, \"security\": { \"autoAcceptUntrustedServerCertificates\": true}}"

Aktualisieren Sie die Zieladresse eines Objektendpunkts und zusätzliche Konfiguration mit vorgefüllten Werten (Bash-Syntaxbeispiel).

az iot ops asset endpoint update --name myAssetEndpoint -g myRG --target-address "opc.tcp://opcplc-000000:50000" --additional-config '{"applicationName": "opcua-connector", "defaults": { "publishingIntervalMilliseconds": 100,  "samplingIntervalMilliseconds": 500,  "queueSize": 15,}, "session": {"timeout": 60000}, "subscription": {"maxItems": 1000}, "security": { "autoAcceptUntrustedServerCertificates": true}}'

Erforderliche Parameter

--name -n

Name des Objektendpunkts.

--resource-group -g

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

Optionale Parameter

--ac --additional-config

Zusätzliche Konfiguration für den Verbindungstyp (z. B. OPC UA, Benchmarking, ONVIF).

--am --authentication-mode

Authentifizierungsmodus.

--cert-ref --certificate-ref --cr

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

--password-ref --pr

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

--ta --target-address

Zieladresse. Muss eine gültige lokale Adresse sein.

--tags

Ressourcentags des Ressourcenendpunkts für Ressourcen. Eigenschaftenbehälter in Schlüsselwertpaaren mit dem folgenden Format: a=b c=d.

--ur --username-reference

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.