Udostępnij za pośrednictwem

az iot hub message-route

  • Wersja zapoznawcza
  • Odwołanie

Uwaga

Ta dokumentacja jest częścią rozszerzenia azure-iot dla interfejsu wiersza polecenia platformy Azure (wersja 2.46.0 lub nowsza). Rozszerzenie zostanie automatycznie zainstalowane przy pierwszym uruchomieniu polecenia az iot hub message-route . Dowiedz się więcej o rozszerzeniach.

Ta grupa poleceń jest w wersji zapoznawczej i jest opracowywana. Poziomy odwołań i pomocy technicznej: https://aka.ms/CLI_refstatus

Zarządzanie trasami centrum IoT Hub.

Polecenia

Nazwa Opis Typ Stan
az iot hub message-route create

Dodaj trasę dla usługi IoT Hub.

 Numer wewnętrzny Wersja Preview
az iot hub message-route delete

Usuń wszystkie trasy lub wymienioną trasę w usłudze IoT Hub.

 Numer wewnętrzny Wersja Preview
az iot hub message-route fallback

Zarządzanie trasą rezerwową centrum IoT Hub.

 Numer wewnętrzny Wersja Preview
az iot hub message-route fallback set

Włącz lub wyłącz trasę rezerwową w usłudze IoT Hub.

 Numer wewnętrzny Wersja Preview
az iot hub message-route fallback show

Pokaż trasę rezerwową usługi IoT Hub.

 Numer wewnętrzny Wersja Preview
az iot hub message-route list

Pobierz wszystkie trasy w usłudze IoT Hub.

 Numer wewnętrzny Wersja Preview
az iot hub message-route show

Uzyskaj informacje o trasie w usłudze IoT Hub.

 Numer wewnętrzny Wersja Preview
az iot hub message-route test

Przetestuj wszystkie trasy lub wymienioną trasę w usłudze IoT Hub.

 Numer wewnętrzny Wersja Preview
az iot hub message-route update

Aktualizowanie trasy dla usługi IoT Hub.

 Numer wewnętrzny Wersja Preview

az iot hub message-route create

Wersja zapoznawcza

Grupa poleceń "iot hub message-route" jest w wersji zapoznawczej i jest opracowywana. Poziomy odwołań i pomocy technicznej: https://aka.ms/CLI_refstatus

Dodaj trasę dla usługi IoT Hub.

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]

Przykłady

Utwórz trasę dla usługi IoT Hub z danym punktem końcowym i typem źródłowym "DeviceMessages".

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

Utwórz trasę dla usługi IoT Hub z wbudowanym punktem końcowym i typem źródłowym "DeviceMessages".

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

Utwórz trasę wyłączoną dla usługi IoT Hub z danym punktem końcowym, typem źródłowym "DigitalTwinChangeEvents" i warunkiem niestandardowym.

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

Parametry wymagane

--en --endpoint --endpoint-name

Nazwa punktu końcowego routingu. W przypadku wbudowanego punktu końcowego użyj nazwy punktu końcowego "events".

--hub-name -n

Nazwa centrum IoT Hub.

--rn --route --route-name

Nazwa trasy.

--source-type --type -t

Źródło trasy.

Dopuszczalne wartości: deviceconnectionstateevents, devicejoblifecycleevents, devicelifecycleevents, devicemessages, digitaltwinchangeevents, invalid, twinchangeevents

Parametry opcjonalne

--condition -c

Warunek, który jest oceniany w celu zastosowania reguły routingu.

Domyślna wartość: true
--enabled -e

Wartość logiczna wskazująca, czy włączyć trasę do usługi IoT Hub.

Dopuszczalne wartości: false, true
Domyślna wartość: True
--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
Domyślna wartość: json
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az iot hub message-route delete

Wersja zapoznawcza

Grupa poleceń "iot hub message-route" jest w wersji zapoznawczej i jest opracowywana. Poziomy odwołań i pomocy technicznej: https://aka.ms/CLI_refstatus

Usuń wszystkie trasy lub wymienioną trasę w usłudze 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}]

Przykłady

Usuwanie trasy z usługi IoT Hub.

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

Usuń wszystkie trasy typu źródłowego "DeviceMessages" z usługi IoT Hub.

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

Usuń wszystkie trasy z usługi IoT Hub.

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

Parametry wymagane

--hub-name -n

Nazwa centrum IoT Hub.

Parametry opcjonalne

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.

--rn --route --route-name

Nazwa trasy.

--source-type --type -t

Źródło trasy.

Dopuszczalne wartości: deviceconnectionstateevents, devicejoblifecycleevents, devicelifecycleevents, devicemessages, digitaltwinchangeevents, invalid, twinchangeevents
--yes -y

Pomiń monity użytkownika. Wskazuje akceptację akcji. Używane głównie w scenariuszach automatyzacji. Wartość domyślna: false.

Dopuszczalne wartości: false, true
Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
Domyślna wartość: json
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az iot hub message-route list

Wersja zapoznawcza

Grupa poleceń "iot hub message-route" jest w wersji zapoznawczej i jest opracowywana. Poziomy odwołań i pomocy technicznej: https://aka.ms/CLI_refstatus

Pobierz wszystkie trasy w usłudze IoT Hub.

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

Przykłady

Pobierz wszystkie trasy z usługi IoT Hub.

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

Pobierz wszystkie trasy typu źródłowego "DeviceMessages" z usługi IoT Hub.

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

Parametry wymagane

--hub-name -n

Nazwa centrum IoT Hub.

Parametry opcjonalne

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.

--source-type --type -t

Źródło trasy.

Dopuszczalne wartości: deviceconnectionstateevents, devicejoblifecycleevents, devicelifecycleevents, devicemessages, digitaltwinchangeevents, invalid, twinchangeevents
Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
Domyślna wartość: json
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az iot hub message-route show

Wersja zapoznawcza

Grupa poleceń "iot hub message-route" jest w wersji zapoznawczej i jest opracowywana. Poziomy odwołań i pomocy technicznej: https://aka.ms/CLI_refstatus

Uzyskaj informacje o trasie w usłudze IoT Hub.

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

Przykłady

Uzyskiwanie informacji o trasach z usługi IoT Hub.

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

Parametry wymagane

--hub-name -n

Nazwa centrum IoT Hub.

--rn --route --route-name

Nazwa trasy.

Parametry opcjonalne

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
Domyślna wartość: json
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az iot hub message-route test

Wersja zapoznawcza

Grupa poleceń "iot hub message-route" jest w wersji zapoznawczej i jest opracowywana. Poziomy odwołań i pomocy technicznej: https://aka.ms/CLI_refstatus

Przetestuj wszystkie trasy lub wymienioną trasę w usłudze IoT Hub.

Aby przetestować trasy, możesz podać przykładowy komunikat.

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

Przykłady

Przetestuj trasę z usługi IoT Hub.

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

Przetestuj wszystkie trasy typu źródłowego "DeviceMessages" z usługi IoT Hub.

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

Przetestuj całą trasę z usługi IoT Hub przy użyciu niestandardowego komunikatu, w tym treści, właściwości aplikacji i właściwości systemu.

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

Parametry wymagane

--hub-name -n

Nazwa centrum IoT Hub.

Parametry opcjonalne

--ap --app-properties

Właściwości aplikacji komunikatu trasy.

--body -b

Treść komunikatu trasy.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.

--rn --route --route-name

Nazwa trasy.

--source-type --type -t

Źródło trasy.

Dopuszczalne wartości: deviceconnectionstateevents, devicejoblifecycleevents, devicelifecycleevents, devicemessages, digitaltwinchangeevents, invalid, twinchangeevents
--sp --system-properties

Właściwości systemowe komunikatu trasy.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
Domyślna wartość: json
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az iot hub message-route update

Wersja zapoznawcza

Grupa poleceń "iot hub message-route" jest w wersji zapoznawczej i jest opracowywana. Poziomy odwołań i pomocy technicznej: https://aka.ms/CLI_refstatus

Aktualizowanie trasy dla usługi IoT Hub.

Możesz zmienić stan źródła, punktu końcowego, warunku lub włączonego na trasie.

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}]

Przykłady

Zaktualizuj trasę do danego punktu końcowego i typu źródła "DeviceMessages".

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

Wyłącz trasę.

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

Zmień warunek trasy.

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

Parametry wymagane

--hub-name -n

Nazwa centrum IoT Hub.

--rn --route --route-name

Nazwa trasy.

Parametry opcjonalne

--condition -c

Warunek, który jest oceniany w celu zastosowania reguły routingu.

--en --endpoint --endpoint-name

Nazwa punktu końcowego routingu. W przypadku wbudowanego punktu końcowego użyj nazwy punktu końcowego "events".

--enabled -e

Wartość logiczna wskazująca, czy włączyć trasę do usługi IoT Hub.

Dopuszczalne wartości: false, true
--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.

--source-type --type -t

Źródło trasy.

Dopuszczalne wartości: deviceconnectionstateevents, devicejoblifecycleevents, devicelifecycleevents, devicemessages, digitaltwinchangeevents, invalid, twinchangeevents
Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
Domyślna wartość: json
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.