Freigeben über


az iot hub message-route

Hinweis

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

Diese Befehlsgruppe befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Verwalten von Routen einer IoT Hub-Instanz.

Befehle

Name Beschreibung Typ Status
az iot hub message-route create

Fügen Sie eine Route für einen IoT-Hub hinzu.

Erweiterung Vorschau
az iot hub message-route delete

Löschen Sie alle Routen oder eine erwähnte Route in einem IoT Hub.

Erweiterung Vorschau
az iot hub message-route fallback

Verwalten Sie die Fallbackroute eines IoT-Hubs.

Erweiterung Vorschau
az iot hub message-route fallback set

Aktivieren oder deaktivieren Sie die Fallbackroute in einem IoT Hub.

Erweiterung Vorschau
az iot hub message-route fallback show

Zeigen Sie die Fallbackroute eines IoT Hub an.

Erweiterung Vorschau
az iot hub message-route list

Rufen Sie alle Routen in einem IoT Hub ab.

Erweiterung Vorschau
az iot hub message-route show

Rufen Sie Informationen zur Route in einem IoT Hub ab.

Erweiterung Vorschau
az iot hub message-route test

Testen Sie alle Routen oder eine erwähnte Route in einem IoT Hub.

Erweiterung Vorschau
az iot hub message-route update

Aktualisieren einer Route für einen IoT-Hub.

Erweiterung Vorschau

az iot hub message-route create

Vorschau

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

Fügen Sie eine Route für einen IoT-Hub hinzu.

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

Beispiele

Erstellen Sie eine Route für einen IoT-Hub mit dem angegebenen Endpunkt und dem Quelltyp "DeviceMessages".

az iot hub message-route create -n {iothub_name} --route-name {route_name} --endpoint-name {endpoint_name} --source DeviceMessages

Erstellen Sie eine Route für einen IoT-Hub mit dem integrierten Endpunkt und dem Quelltyp "DeviceMessages".

az iot hub message-route create -n {iothub_name} --route-name {route_name} --endpoint-name events --source DeviceMessages

Erstellen Sie eine deaktivierte Route für einen IoT Hub mit dem angegebenen Endpunkt, dem Quelltyp "DigitalTwinChangeEvents" und einer benutzerdefinierten Bedingung.

az iot hub message-route create -n {iothub_name} --route-name {route_name} --endpoint-name {endpoint_name} --source DigitalTwinChangeEvents --condition {condition} --enabled false

Erforderliche Parameter

--en --endpoint --endpoint-name

Name des Routingendpunkts. Verwenden Sie für den integrierten Endpunkt den Endpunktnamen "Events".

--hub-name -n

IoT Hub-Name.

--rn --route --route-name

Der Name der Route.

--source-type --type -t

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.

Standardwert: true
--enabled -e

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

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

Vorschau

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

Löschen Sie alle Routen oder eine erwähnte Route in einem IoT Hub.

az iot hub message-route delete --hub-name
                                [--resource-group]
                                [--rn]
                                [--source-type {deviceconnectionstateevents, devicejoblifecycleevents, devicelifecycleevents, devicemessages, digitaltwinchangeevents, invalid, twinchangeevents}]
                                [--yes {false, true}]

Beispiele

Löschen einer Route von einem IoT Hub.

az iot hub message-route delete -n {iothub_name} --route-name {route_name}

Löschen Sie alle Routen vom Quelltyp "DeviceMessages" aus einem IoT-Hub.

az iot hub message-route delete -n {iothub_name} --source DeviceMessages

Löschen Sie alle Routen von einem IoT Hub.

az iot hub message-route delete -n {iothub_name}

Erforderliche Parameter

--hub-name -n

IoT Hub-Name.

Optionale Parameter

--resource-group -g

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

--rn --route --route-name

Der Name der Route.

--source-type --type -t

Quelle der Route.

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

Benutzeraufforderungen überspringen. Gibt die Annahme der Aktion an. Wird hauptsächlich für Automatisierungsszenarien verwendet. Standardwert: false.

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

Vorschau

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

Rufen Sie alle Routen in einem IoT Hub ab.

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

Beispiele

Rufen Sie alle Routen von einem IoT Hub ab.

az iot hub message-route list -n {iothub_name}

Rufen Sie alle Routen des Quelltyps "DeviceMessages" aus einem IoT Hub ab.

az iot hub message-route list -n {iothub_name} --source DeviceMessages

Erforderliche Parameter

--hub-name -n

IoT Hub-Name.

Optionale Parameter

--resource-group -g

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

--source-type --type -t

Quelle der Route.

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

Vorschau

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

Rufen Sie Informationen zur Route in einem IoT Hub ab.

az iot hub message-route show --hub-name
                              --rn
                              [--resource-group]

Beispiele

Abrufen von Routeninformationen von einem IoT-Hub.

az iot hub message-route show -n {iothub_name} --route-name {route_name}

Erforderliche Parameter

--hub-name -n

IoT Hub-Name.

--rn --route --route-name

Der Name der Route.

Optionale Parameter

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

Vorschau

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

Testen Sie alle Routen oder eine erwähnte Route in einem IoT Hub.

Sie können eine Beispielnachricht bereitstellen, um Ihre Routen zu testen.

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

Beispiele

Testen Sie eine Route von einem IoT Hub.

az iot hub message-route test -n {iothub_name} --route-name {route_name}

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

az iot hub message-route test -n {iothub_name} --source DeviceMessages

Testen Sie alle Routen von einem IoT Hub mit einer benutzerdefinierten Nachricht, einschließlich Textkörper, App-Eigenschaften und Systemeigenschaften.

az iot hub message-route test -n {iothub_name} -b {body} --ap {app_properties} --sp {system_properties}

Erforderliche Parameter

--hub-name -n

IoT Hub-Name.

Optionale Parameter

--ap --app-properties

App-Eigenschaften der Route-Nachricht.

--body -b

Textkörper der Routennachricht.

--resource-group -g

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

--rn --route --route-name

Der Name der Route.

--source-type --type -t

Quelle der Route.

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

Systemeigenschaften der Route-Nachricht.

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

Vorschau

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

Aktualisieren einer Route für einen IoT-Hub.

Sie können den Quell-, Endpunkt-, Bedingungs- oder aktivierten Zustand auf der Route ändern.

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

Beispiele

Aktualisieren Sie eine Route zu einem bestimmten Endpunkt und dem Quelltyp "DeviceMessages".

az iot hub message-route update -n {iothub_name} --route-name {route_name} --endpoint-name {endpoint_name} --source DeviceMessages

Deaktivieren Sie eine Route.

az iot hub message-route update -n {iothub_name} --route-name {route_name} --enabled false

Ändern Sie die Bedingung einer Route.

az iot hub message-route update -n {iothub_name} --route-name {route_name} --condition {condition}

Erforderliche Parameter

--hub-name -n

IoT Hub-Name.

--rn --route --route-name

Der Name der Route.

Optionale Parameter

--condition -c

Bedingung, die ausgewertet wird, um die Routingregel anzuwenden.

--en --endpoint --endpoint-name

Name des Routingendpunkts. Verwenden Sie für den integrierten Endpunkt den Endpunktnamen "Events".

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

--source-type --type -t

Quelle der Route.

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