az iot central device command
Uwaga
Ta dokumentacja jest częścią rozszerzenia azure-iot dla interfejsu wiersza polecenia platformy Azure (wersja 2.30.0 lub nowsza). Rozszerzenie automatycznie zainstaluje polecenie az iot central device . Dowiedz się więcej o rozszerzeniach.
Uruchom polecenia urządzenia.
Polecenia
| az iot central device command history |
Uzyskaj szczegółowe informacje o najnowszym żądaniu polecenia i odpowiedzi wysłanej na urządzenie. |
| az iot central device command run |
Uruchom polecenie na urządzeniu i wyświetl skojarzona odpowiedź. Nie monitoruje aktualizacji właściwości, które może wykonać polecenie. |
az iot central device command history
Uzyskaj szczegółowe informacje o najnowszym żądaniu polecenia i odpowiedzi wysłanej na urządzenie.
Wyświetla listę najnowszych żądań poleceń i odpowiedzi wysłanych do urządzenia z usługi IoT Central. Każda aktualizacja wykonywana przez urządzenie we właściwościach urządzenia w wyniku wykonania polecenia nie jest uwzględniana w odpowiedzi.
az iot central device command history --app-id
--cn
--device-id
[--api-version {1.0, 1.1-preview, preview}]
[--central-api-uri]
[--interface-id]
[--token]
Przykłady
Pokaż odpowiedź polecenia
az iot central device command history --app-id {appid} --device-id {deviceid} --interface-id {interfaceid} --command-name {commandname}
Parametry wymagane
Identyfikator aplikacji usługi IoT Central, którą chcesz zarządzać. Identyfikator aplikacji można znaleźć na stronie "Informacje" dla aplikacji w menu pomocy.
Nazwa polecenia określona w szablonie urządzenia. Nazwa polecenia może być inna niż nazwa wyświetlana polecenia.
Identyfikator urządzenia docelowego. Identyfikator urządzenia można znaleźć, klikając przycisk Połącz na stronie Szczegóły urządzenia.
Parametry opcjonalne
Wersja interfejsu API dla żądanej operacji.
Sufiks DNS usługi IoT Central skojarzony z aplikacją.
Nazwa interfejsu/składnika określona w szablonie urządzenia. Możesz go znaleźć, przechodząc do szablonu urządzenia i wyświetlając tożsamość interfejsu/składnika w ramach odpowiedniej możliwości urządzenia.
Jeśli chcesz przesłać żądanie bez uwierzytelniania względem interfejsu wiersza polecenia platformy Azure, możesz określić prawidłowy token użytkownika do uwierzytelnienia żądania. Musisz określić typ klucza w ramach żądania. Dowiedz się więcej na stronie https://aka.ms/iotcentraldocsapi.
Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
Pokaż ten komunikat pomocy i zakończ pracę.
Pokaż tylko błędy, pomijając ostrzeżenia.
Format danych wyjściowych.
Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.
Nazwa lub identyfikator subskrypcji. Możesz skonfigurować domyślną subskrypcję przy użyciu polecenia az account set -s NAME_OR_ID.
Zwiększ szczegółowość rejestrowania. Użyj polecenia --debug, aby uzyskać pełne dzienniki debugowania.
az iot central device command run
Uruchom polecenie na urządzeniu i wyświetl skojarzona odpowiedź. Nie monitoruje aktualizacji właściwości, które może wykonać polecenie.
Uwaga: ładunek powinien być zagnieżdżony w obszarze "żądanie". tj. jeśli urządzenie oczekuje ładunku w kształcie {"key": "value"} ładunek powinien mieć wartość {"request": {"key": "value"}}. --content można również wskazać na ścieżkę pliku w następujący sposób (.../path/to/payload.json).
az iot central device command run --app-id
--cn
--content
--device-id
[--api-version {1.0, 1.1-preview, preview}]
[--central-api-uri]
[--interface-id]
[--token]
Przykłady
Uruchom odpowiedź polecenia
az iot central device command run --app-id {appid} --device-id {deviceid} --interface-id {interfaceid} --command-name {commandname} --content {payload}
Krótka odpowiedź polecenia
az iot central device command run -n {appid} -d {deviceid} -i {interfaceid} --cn {commandname} -k {payload}
Parametry wymagane
Identyfikator aplikacji usługi IoT Central, którą chcesz zarządzać. Identyfikator aplikacji można znaleźć na stronie "Informacje" dla aplikacji w menu pomocy.
Nazwa polecenia określona w szablonie urządzenia. Nazwa polecenia może być inna niż nazwa wyświetlana polecenia.
Konfiguracja żądania. Podaj ścieżkę do pliku JSON lub nieprzetworzonego kodu JSON. [Przykład ścieżki pliku: ./path/to/file.json] [Przykład JSON z powiadomieniem o ciągu: {'a': 'b'}].
Identyfikator urządzenia docelowego. Identyfikator urządzenia można znaleźć, klikając przycisk Połącz na stronie Szczegóły urządzenia.
Parametry opcjonalne
Wersja interfejsu API dla żądanej operacji.
Sufiks DNS usługi IoT Central skojarzony z aplikacją.
Nazwa interfejsu/składnika określona w szablonie urządzenia. Możesz go znaleźć, przechodząc do szablonu urządzenia i wyświetlając tożsamość interfejsu/składnika w ramach odpowiedniej możliwości urządzenia.
Jeśli chcesz przesłać żądanie bez uwierzytelniania względem interfejsu wiersza polecenia platformy Azure, możesz określić prawidłowy token użytkownika do uwierzytelnienia żądania. Musisz określić typ klucza w ramach żądania. Dowiedz się więcej na stronie https://aka.ms/iotcentraldocsapi.
Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
Pokaż ten komunikat pomocy i zakończ pracę.
Pokaż tylko błędy, pomijając ostrzeżenia.
Format danych wyjściowych.
Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.
Nazwa lub identyfikator subskrypcji. Możesz skonfigurować domyślną subskrypcję przy użyciu polecenia az account set -s NAME_OR_ID.
Zwiększ szczegółowość rejestrowania. Użyj polecenia --debug, aby uzyskać pełne dzienniki debugowania.