az iot central device command

  • Reference

Poznámka

Tento odkaz je součástí rozšíření azure-iot pro Azure CLI (verze 2.37.0 nebo vyšší). Rozšíření se automaticky nainstaluje při prvním spuštění příkazu az iot central device command . Přečtěte si další informace o rozšířeních.

Spusťte příkazy zařízení.

Příkazy

Name Description Typ Stav
az iot central device command history

Získejte podrobnosti o nejnovějším požadavku na příkaz a odpověď odeslané na zařízení.

 Rozšíření GA
az iot central device command run

Spusťte příkaz na zařízení a zobrazte přidruženou odpověď. Nemonitoruje aktualizace vlastností, které může příkaz provést.

 Rozšíření GA

az iot central device command history

Získejte podrobnosti o nejnovějším požadavku na příkaz a odpověď odeslané na zařízení.

Zobrazí seznam nejnovějších požadavků na příkaz a odpověď odesílaných do zařízení ze služby IoT Central. Každá aktualizace, kterou zařízení provádí ve vlastnostech zařízení v důsledku provedení příkazu, nejsou zahrnuté v odpovědi.

az iot central device command history --app-id
                                      --cn
                                      --device-id
                                      [--api-version {2022-06-30-preview, 2022-07-31}]
                                      [--central-api-uri]
                                      [--co]
                                      [--interface-id]
                                      [--mn]
                                      [--token]

Příklady

Zobrazit odpověď příkazu

az iot central device command history --app-id {appid} --device-id {deviceid} --interface-id {interfaceid} --command-name {commandname}

Zobrazit odpověď příkazu komponenty

az iot central device command history --app-id {appid} --device-id {deviceid} --component-name {componentname} --command-name {commandname}

Zobrazit odpověď příkazu komponenty modulu

az iot central device command history --app-id {appid} --device-id {deviceid} --module-name {modulename} --component-name {componentname} --command-name {commandname}

Povinné parametry

--app-id -n

ID aplikace IoT Central, kterou chcete spravovat. ID aplikace najdete na stránce O aplikaci v nabídce nápovědy.

--cn --command-name

Název příkazu zadaný v šabloně zařízení. Název příkazu se může lišit od zobrazovaného názvu příkazu.

--device-id -d

ID zařízení cílového zařízení. ID zařízení najdete kliknutím na tlačítko Připojení na stránce Podrobnosti o zařízení.

Volitelné parametry

--api-version --av
Zastaralé

Argument api_version je zastaralý a v budoucí verzi se odebere.

Tento parametr příkazu je zastaralý a bude ignorován. V budoucí verzi budeme podporovat pouze rozhraní API IoT Central z nejnovější verze GA. Pokud ještě některé rozhraní API není obecně dostupné, zavoláme nejnovější verzi Preview.

přijímané hodnoty: 2022-06-30-preview, 2022-07-31
výchozí hodnota: 2022-07-31
--central-api-uri --central-dns-suffix

Přípona DNS IoT Central přidružená k vaší aplikaci.

výchozí hodnota: azureiotcentral.com
--co --component-name

Název komponenty zařízení.

--interface-id -i

Název rozhraní nebo komponenty, jak je uvedeno v šabloně zařízení. Najdete ho tak, že přejdete do šablony zařízení a zobrazíte identitu rozhraní nebo komponenty v odpovídajících možnostech zařízení.

--mn --module-name

Název modulu zařízení.

--token

Pokud chcete žádost odeslat bez ověřování v Azure CLI, můžete zadat platný token uživatele pro ověření vaší žádosti. Jako součást požadavku musíte zadat typ klíče. Další informace najdete na adrese https://aka.ms/iotcentraldocsapi.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

přijímané hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
výchozí hodnota: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az iot central device command run

Spusťte příkaz na zařízení a zobrazte přidruženou odpověď. Nemonitoruje aktualizace vlastností, které může příkaz provést.

--content může být vložený json nebo cesta k souboru.

az iot central device command run --app-id
                                  --cn
                                  --content
                                  --device-id
                                  [--api-version {2022-06-30-preview, 2022-07-31}]
                                  [--central-api-uri]
                                  [--co]
                                  [--interface-id]
                                  [--mn]
                                  [--token]

Příklady

Spusťte příkaz s vloženou datovou částí. Datová část by měla být v řetězci JSON pod položkou request

az iot central device command run --app-id {appid} --device-id {deviceid} --interface-id {interfaceid} --command-name {commandname} --content '{"request": {payload}}'

Krátký příkaz run s cestou datové části JSON.

az iot central device command run -n {appid} -d {deviceid} -i {interfaceid} --cn {commandname} -k {payload_file_path}

Spusťte příkaz komponenty.

az iot central device command run -n {appid} -d {deviceid} --co {componentname} --cn {commandname} -k {payload}

Spusťte příkaz komponenty modulu.

az iot central device command run -n {appid} -d {deviceid} --mn {modulename} --co {componentname} --cn {commandname} -k {payload}

Povinné parametry

--app-id -n

ID aplikace IoT Central, kterou chcete spravovat. ID aplikace najdete na stránce O aplikaci v nabídce nápovědy.

--cn --command-name

Název příkazu zadaný v šabloně zařízení. Název příkazu se může lišit od zobrazovaného názvu příkazu.

--content -k

Konfigurace pro požadavek. Zadejte cestu k souboru JSON nebo nezpracovaného řetězci JSON. [Příklad cesty k souboru: ./path/to/file.json] [Příklad json s řetězci: {'a': 'b'}].

--device-id -d

ID zařízení cílového zařízení. ID zařízení najdete kliknutím na tlačítko Připojení na stránce Podrobnosti o zařízení.

Volitelné parametry

--api-version --av
Zastaralé

Argument api_version je zastaralý a v budoucí verzi se odebere.

Tento parametr příkazu je zastaralý a bude ignorován. V budoucí verzi budeme podporovat pouze rozhraní API IoT Central z nejnovější verze GA. Pokud ještě některé rozhraní API není obecně dostupné, zavoláme nejnovější verzi Preview.

přijímané hodnoty: 2022-06-30-preview, 2022-07-31
výchozí hodnota: 2022-07-31
--central-api-uri --central-dns-suffix

Přípona DNS IoT Central přidružená k vaší aplikaci.

výchozí hodnota: azureiotcentral.com
--co --component-name

Název komponenty zařízení.

--interface-id -i

Název rozhraní nebo komponenty, jak je uvedeno v šabloně zařízení. Najdete ho tak, že přejdete do šablony zařízení a zobrazíte identitu rozhraní nebo komponenty v odpovídajících možnostech zařízení.

--mn --module-name

Název modulu zařízení.

--token

Pokud chcete žádost odeslat bez ověřování v Azure CLI, můžete zadat platný token uživatele pro ověření vaší žádosti. Jako součást požadavku musíte zadat typ klíče. Další informace najdete na adrese https://aka.ms/iotcentraldocsapi.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

přijímané hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
výchozí hodnota: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.