Freigeben über


az iot hub route

Diese Befehlsgruppe ist veraltet und wird in einer zukünftigen Version entfernt. Verwenden Sie stattdessen die Befehlsgruppe "IoT-Erweiterung (azure-iot)" (az iot hub message-route).

Verwalten von Routen einer IoT Hub-Instanz.

Befehle

Name Beschreibung Typ Status
az iot hub route create

Erstellen Sie eine Route im IoT Hub.

Kernspeicher Als veraltet markiert
az iot hub route delete

Löschen Sie alle oder Erwähnung ed Route für Ihren IoT Hub.

Kernspeicher Als veraltet markiert
az iot hub route list

Rufen Sie alle Routen im IoT Hub ab.

Kernspeicher Als veraltet markiert
az iot hub route show

Rufen Sie Informationen zur Route im IoT Hub ab.

Kernspeicher Als veraltet markiert
az iot hub route test

Testen Sie alle Routen oder Erwähnung Route im IoT Hub.

Kernspeicher Als veraltet markiert
az iot hub route update

Aktualisieren einer Route im IoT Hub.

Kernspeicher Als veraltet markiert

az iot hub route create

Als veraltet markiert

Dieser Befehl ist implizit veraltet, da die Befehlsgruppe "iot hub route" veraltet ist und in einer zukünftigen Version entfernt wird. Verwenden Sie stattdessen die Befehlsgruppe "IoT-Erweiterung (azure-iot)" (az iot hub message-route).

Erstellen Sie eine Route im IoT Hub.

Erstellen Sie eine Route zum Senden bestimmter Datenquellen und Bedingungen an einen gewünschten Endpunkt.

az iot hub route create --en
                        --hub-name
                        --name
                        --source {deviceconnectionstateevents, devicejoblifecycleevents, devicelifecycleevents, devicemessages, digitaltwinchangeevents, invalid, twinchangeevents}
                        [--condition]
                        [--enabled {false, true}]
                        [--resource-group]

Beispiele

Erstellen Sie eine neue Route "R1".

az iot hub route create -g MyResourceGroup --hub-name MyIotHub --endpoint-name E2 --source DeviceMessages --route-name R1

Erstellen Sie eine neue Route "R1" mit allen Parametern.

az iot hub route create -g MyResourceGroup --hub-name MyIotHub --endpoint-name E2 --source DeviceMessages --route-name R1 --condition true --enabled true

Erforderliche Parameter

--en --endpoint --endpoint-name

Name des Routingendpunkts.

--hub-name

IoT Hub-Name.

--name --route-name -n

Name der Route.

--source --source-type --type -s

Quelle der Route.

Zulässige Werte: deviceconnectionstateevents, devicejoblifecycleevents, devicelifecycleevents, devicemessages, digitaltwinchangeevents, invalid, twinchangeevents

Optionale Parameter

--condition -c

Bedingung, die ausgewertet wird, um die Routingregel anzuwenden.

--enabled -e

Ein boolescher Wert, der angibt, ob die Route zum Iot-Hub aktiviert werden soll.

Zulässige Werte: false, true
--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 hub route delete

Als veraltet markiert

Dieser Befehl ist implizit veraltet, da die Befehlsgruppe "iot hub route" veraltet ist und in einer zukünftigen Version entfernt wird. Verwenden Sie stattdessen die Befehlsgruppe "IoT-Erweiterung (azure-iot)" (az iot hub message-route).

Löschen Sie alle oder Erwähnung ed Route für Ihren IoT Hub.

Löschen Sie eine Route oder alle Routen für Ihren IoT Hub.

az iot hub route delete [--hub-name]
                        [--ids]
                        [--name]
                        [--resource-group]
                        [--source {deviceconnectionstateevents, devicejoblifecycleevents, devicelifecycleevents, devicemessages, digitaltwinchangeevents, invalid, twinchangeevents}]
                        [--subscription]

Beispiele

Löschen Sie die Route "R1" aus "MyIotHub" IoT Hub.

az iot hub route delete -g MyResourceGroup --hub-name MyIotHub --route-name R1

Löschen Sie alle Routen des Quelltyps "DeviceMessages" aus "MyIotHub" IoT Hub.

az iot hub route delete -g MyResourceGroup --hub-name MyIotHub --source DeviceMessages

Löschen Sie alle Routen von "MyIotHub" IoT Hub.

az iot hub route delete -g MyResourceGroup --hub-name MyIotHub

Optionale Parameter

--hub-name

IoT Hub-Name.

--ids

Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Dabei sollte es sich um eine vollständige Ressourcen-ID mit allen Informationen der Argumente "Ressourcen-ID" sein. Sie sollten entweder --ids oder andere Argumente für die Ressourcen-ID angeben.

--name --route-name -n

Name der Route.

--resource-group -g

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

--source --source-type --type -s

Quelle der Route.

Zulässige Werte: deviceconnectionstateevents, devicejoblifecycleevents, devicelifecycleevents, devicemessages, digitaltwinchangeevents, invalid, twinchangeevents
--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.

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

Als veraltet markiert

Dieser Befehl ist implizit veraltet, da die Befehlsgruppe "iot hub route" veraltet ist und in einer zukünftigen Version entfernt wird. Verwenden Sie stattdessen die Befehlsgruppe "IoT-Erweiterung (azure-iot)" (az iot hub message-route).

Rufen Sie alle Routen im IoT Hub ab.

Erhalten Sie Informationen zu allen Routen von einem IoT Hub.

az iot hub route list [--hub-name]
                      [--ids]
                      [--resource-group]
                      [--source {deviceconnectionstateevents, devicejoblifecycleevents, devicelifecycleevents, devicemessages, digitaltwinchangeevents, invalid, twinchangeevents}]
                      [--subscription]

Beispiele

Rufen Sie alle Routen von "MyIotHub" IoT Hub ab.

az iot hub route list -g MyResourceGroup --hub-name MyIotHub

Rufen Sie alle Routen des Quelltyps "DeviceMessages" von "MyIotHub" IoT Hub ab.

az iot hub route list -g MyResourceGroup --hub-name MyIotHub --source DeviceMessages

Optionale Parameter

--hub-name

IoT Hub-Name.

--ids

Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Dabei sollte es sich um eine vollständige Ressourcen-ID mit allen Informationen der Argumente "Ressourcen-ID" sein. Sie sollten entweder --ids oder andere Argumente für die Ressourcen-ID angeben.

--resource-group -g

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

--source --source-type --type -s

Quelle der Route.

Zulässige Werte: deviceconnectionstateevents, devicejoblifecycleevents, devicelifecycleevents, devicemessages, digitaltwinchangeevents, invalid, twinchangeevents
--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.

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 hub route show

Als veraltet markiert

Dieser Befehl ist implizit veraltet, da die Befehlsgruppe "iot hub route" veraltet ist und in einer zukünftigen Version entfernt wird. Verwenden Sie stattdessen die Befehlsgruppe "IoT-Erweiterung (azure-iot)" (az iot hub message-route).

Rufen Sie Informationen zur Route im IoT Hub ab.

Erhalten Sie Informationen zu einer bestimmten Route in Ihrem IoT Hub.

az iot hub route show --name
                      [--hub-name]
                      [--ids]
                      [--resource-group]
                      [--subscription]

Beispiele

Abrufen einer Routeninformationen von "MyIotHub" IoT Hub.

az iot hub route show -g MyResourceGroup --hub-name MyIotHub --route-name {routeName}

Erforderliche Parameter

--name --route-name -n

Name der Route.

Optionale Parameter

--hub-name

IoT Hub-Name.

--ids

Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Dabei sollte es sich um eine vollständige Ressourcen-ID mit allen Informationen der Argumente "Ressourcen-ID" sein. Sie sollten entweder --ids oder andere Argumente für die Ressourcen-ID angeben.

--resource-group -g

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

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

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 hub route test

Als veraltet markiert

Dieser Befehl ist implizit veraltet, da die Befehlsgruppe "iot hub route" veraltet ist und in einer zukünftigen Version entfernt wird. Verwenden Sie stattdessen die Befehlsgruppe "IoT-Erweiterung (azure-iot)" (az iot hub message-route).

Testen Sie alle Routen oder Erwähnung Route im IoT Hub.

Testen Sie alle vorhandenen Routen oder Erwähnung Route in Ihrem IoT Hub. Sie können eine Beispielnachricht bereitstellen, um Ihre Routen zu testen.

az iot hub route test [--ap]
                      [--body]
                      [--hub-name]
                      [--ids]
                      [--name]
                      [--resource-group]
                      [--source {deviceconnectionstateevents, devicejoblifecycleevents, devicelifecycleevents, devicemessages, digitaltwinchangeevents, invalid, twinchangeevents}]
                      [--sp]
                      [--subscription]

Beispiele

Testen Sie die Route "R1" von "MyIotHub" IoT Hub.

az iot hub route test -g MyResourceGroup --hub-name MyIotHub --route-name R1

Testen Sie alle Routen des Quelltyps "DeviceMessages" von "MyIotHub" IoT Hub.

az iot hub route test -g MyResourceGroup --hub-name MyIotHub --source DeviceMessages

Optionale Parameter

--ap --app-properties

App-Eigenschaften der Route-Nachricht.

--body -b

Textkörper der Routennachricht.

--hub-name

IoT Hub-Name.

--ids

Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Dabei sollte es sich um eine vollständige Ressourcen-ID mit allen Informationen der Argumente "Ressourcen-ID" sein. Sie sollten entweder --ids oder andere Argumente für die Ressourcen-ID angeben.

--name --route-name -n

Name der Route.

--resource-group -g

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

--source --source-type --type -s

Quelle der Route.

Zulässige Werte: deviceconnectionstateevents, devicejoblifecycleevents, devicelifecycleevents, devicemessages, digitaltwinchangeevents, invalid, twinchangeevents
--sp --system-properties

Systemeigenschaften der Route-Nachricht.

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

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 hub route update

Als veraltet markiert

Dieser Befehl ist implizit veraltet, da die Befehlsgruppe "iot hub route" veraltet ist und in einer zukünftigen Version entfernt wird. Verwenden Sie stattdessen die Befehlsgruppe "IoT-Erweiterung (azure-iot)" (az iot hub message-route).

Aktualisieren einer Route im IoT Hub.

Aktualisiert eine Route im IoT Hub. Sie können die Quelle, den Endpunkt oder die Abfrage auf der Route ändern.

az iot hub route update --name
                        [--condition]
                        [--en]
                        [--enabled {false, true}]
                        [--hub-name]
                        [--ids]
                        [--resource-group]
                        [--source {deviceconnectionstateevents, devicejoblifecycleevents, devicelifecycleevents, devicemessages, digitaltwinchangeevents, invalid, twinchangeevents}]
                        [--subscription]

Beispiele

Aktualisieren Sie den Quelltyp der Route "R1" von "MyIotHub" IoT Hub.

az iot hub route update -g MyResourceGroup --hub-name MyIotHub --source DeviceMessages --route-name R1

Erforderliche Parameter

--name --route-name -n

Name der Route.

Optionale Parameter

--condition -c

Bedingung, die ausgewertet wird, um die Routingregel anzuwenden.

--en --endpoint --endpoint-name

Name des Routingendpunkts.

--enabled -e

Ein boolescher Wert, der angibt, ob die Route zum Iot-Hub aktiviert werden soll.

Zulässige Werte: false, true
--hub-name

IoT Hub-Name.

--ids

Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Dabei sollte es sich um eine vollständige Ressourcen-ID mit allen Informationen der Argumente "Ressourcen-ID" sein. Sie sollten entweder --ids oder andere Argumente für die Ressourcen-ID angeben.

--resource-group -g

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

--source --source-type --type -s

Quelle der Route.

Zulässige Werte: deviceconnectionstateevents, devicejoblifecycleevents, devicelifecycleevents, devicemessages, digitaltwinchangeevents, invalid, twinchangeevents
--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.

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.