az iot device

Polecenia

Nazwa	Opis	Typ	Stan
az iot device c2d-message	Polecenia obsługi komunikatów z chmury do urządzenia.	Extension	ogólna dostępność
az iot device c2d-message abandon	Porzucanie komunikatu chmura-urządzenie.	Extension	ogólna dostępność
az iot device c2d-message complete	Ukończ komunikat chmura-urządzenie.	Extension	ogólna dostępność
az iot device c2d-message purge	Przeczyść kolejkę komunikatów z chmury do urządzenia docelowego.	Extension	ogólna dostępność
az iot device c2d-message receive	Odbieranie komunikatu z chmury do urządzenia.	Extension	ogólna dostępność
az iot device c2d-message reject	Odrzucanie lub zakleszczanie komunikatu z chmury do urządzenia.	Extension	ogólna dostępność
az iot device c2d-message send	Wyślij komunikat z chmury do urządzenia.	Extension	ogólna dostępność
az iot device registration	Zarządzanie rejestracjami urządzeń IoT dla usługi IoT Device Provisioning.	Extension	Preview
az iot device registration create	Zarejestruj urządzenie IoT w usłudze IoT Device Provisioning Service.	Extension	Preview
az iot device send-d2c-message	Wyślij komunikat z urządzenia do chmury mqtt.	Extension	ogólna dostępność
az iot device simulate	Symulowanie urządzenia w usłudze Azure IoT Hub.	Extension	Experimental
az iot device upload-file	Przekaż plik lokalny jako urządzenie do wstępnie skonfigurowanego kontenera magazynu obiektów blob.	Extension	ogólna dostępność

az iot device send-d2c-message --device-id
                               [--certificate-file-path --cp]
                               [--da --data]
                               [--data-file-path --dfp]
                               [--dtmi --model-id]
                               [--hub-name]
                               [--key --symmetric-key]
                               [--key-file-path --kp]
                               [--login]
                               [--mc --msg-count]
                               [--pass --passphrase]
                               [--properties --props]
                               [--resource-group]

Przykłady

Podstawowy sposób użycia

az iot device send-d2c-message -n {iothub_name} -d {device_id}

Podstawowe użycie urządzenia rejestrującego identyfikator modelu "dtmi:com:example:Termostat; 1' po połączeniu

az iot device send-d2c-message -n {iothub_name} -d {device_id} --model-id 'dtmi:com:example:Thermostat;1'

Podstawowe użycie urządzenia z uwierzytelnianiem x509

az iot device send-d2c-message -n {iothub_name} -d {device_id} --cp {certificate_file_path} --kp {key_file_path}

Podstawowe użycie urządzenia z uwierzytelnianiem x509, w którym plik klucza ma hasło

az iot device send-d2c-message -n {iothub_name} -d {device_id} --cp {certificate_file_path} --kp {key_file_path} --pass {passphrase}

Podstawowe użycie z danymi niestandardowymi

az iot device send-d2c-message -n {iothub_name} -d {device_id} --data {message_body}

Wysyłanie właściwości aplikacji

az iot device send-d2c-message -n {iothub_name} -d {device_id} --props 'key0=value0;key1=value1'

Wysyłanie właściwości systemu (identyfikator komunikatu i identyfikator korelacji)

az iot device send-d2c-message -n {iothub_name} -d {device_id} --props '$.mid={id};$.cid={id}'

Wysyłanie danych niestandardowych przez określenie typu zawartości i kodowania zawartości we właściwościach systemu

az iot device send-d2c-message -n {iothub_name} -d {device_id} --props '$.ct={content-type};$.ce={content-encoding}' --data {message_body}

Wysyłanie niestandardowych danych w formacie binarnym przez określenie kodowania zawartości we właściwościach systemu

az iot device send-d2c-message -n {iothub_name} -d {device_id} --props '$.ct=application/octet-stream' --data-file-path {file_path}

Wysyłanie danych niestandardowych w formacie JSON przez określenie typu zawartości i kodowania zawartości we właściwościach systemu

az iot device send-d2c-message -n {iothub_name} -d {device_id} --props '$.ct=application/json;$.ce=utf-8' --data-file-path {file_path}

Parametry wymagane

Parametry opcjonalne

Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.

Parametry globalne

--debug

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

Właściwość	Wartość
Domyślna wartość:	False

--help -h

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

--only-show-errors

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

Właściwość	Wartość
Domyślna wartość:	False

--output -o

Format danych wyjściowych.

Właściwość	Wartość
Domyślna wartość:	json
Dopuszczalne wartości:	json, jsonc, none, table, tsv, yaml, yamlc

--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 az account set -s NAME_OR_ID.

--verbose

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

Właściwość	Wartość
Domyślna wartość:	False

az iot device simulate --device-id
                       [--certificate-file-path --cp]
                       [--da --data]
                       [--dtmi --model-id]
                       [--hub-name]
                       [--init-reported-properties --irp]
                       [--key --symmetric-key]
                       [--key-file-path --kp]
                       [--login]
                       [--mc --msg-count]
                       [--method-response-code --mrc]
                       [--method-response-payload --mrp]
                       [--mi --msg-interval]
                       [--pass --passphrase]
                       [--properties --props]
                       [--proto --protocol {http, mqtt}]
                       [--receive-settle --rs {abandon, complete, reject}]
                       [--resource-group]

Przykłady

Użycie podstawowe (mqtt)

az iot device simulate -n {iothub_name} -d {device_id}

Podstawowe użycie urządzenia rejestrującego identyfikator modelu "dtmi:com:example:Termostat; 1' po połączeniu (mqtt)

az iot device simulate -n {iothub_name} -d {device_id} --model-id 'dtmi:com:example:Thermostat;1'

Podstawowe użycie urządzenia z uwierzytelnianiem x509 (mqtt)

az iot device simulate -n {iothub_name} -d {device_id} --cp {certificate_file_path} --kp {key_file_path}

Podstawowe użycie urządzenia z uwierzytelnianiem x509 (mqtt), w którym plik klucza ma hasło

az iot device simulate -n {iothub_name} -d {device_id} --cp {certificate_file_path} --kp {key_file_path} --pass {passphrase}

Wysyłanie właściwości mieszanych (mqtt)

az iot device simulate -n {iothub_name} -d {device_id} --properties "myprop=myvalue;$.ct=application/json"

Wysyłanie kodu stanu odpowiedzi metody bezpośredniej i ładunku odpowiedzi metody bezpośredniej jako nieprzetworzonego kodu json (tylko mqtt)

az iot device simulate -n {iothub_name} -d {device_id} --method-response-code 201 --method-response-payload '{"result":"Direct method successful"}'

Wyślij kod stanu odpowiedzi metody bezpośredniej i ładunek odpowiedzi metody bezpośredniej jako ścieżkę do pliku lokalnego (tylko mqtt)

az iot device simulate -n {iothub_name} -d {device_id} --method-response-code 201 --method-response-payload '../my_direct_method_payload.json'

Wyślij początkowy stan zgłoszonych właściwości bliźniaczej reprezentacji urządzenia jako nieprzetworzone dane json dla urządzenia docelowego (tylko mqtt)

az iot device simulate -n {iothub_name} -d {device_id} --init-reported-properties '{"reported_prop_1":"val_1", "reported_prop_2":val_2}'

Wyślij początkowy stan zgłoszonych właściwości bliźniaczej reprezentacji urządzenia jako ścieżkę do pliku lokalnego dla urządzenia docelowego (tylko mqtt)

az iot device simulate -n {iothub_name} -d {device_id} --init-reported-properties '../my_device_twin_reported_properties.json'

Podstawowe użycie (http)

az iot device simulate -n {iothub_name} -d {device_id} --protocol http

Wysyłanie właściwości mieszanych (http)

az iot device simulate -n {iothub_name} -d {device_id} --protocol http --properties "iothub-app-myprop=myvalue;content-type=application/json;iothub-correlationid=12345"

Wybierz łączną liczbę komunikatów i interwał między komunikatami

az iot device simulate -n {iothub_name} -d {device_id} --msg-count 1000 --msg-interval 5

Odrzuć komunikaty c2d (tylko http)

az iot device simulate -n {iothub_name} -d {device_id} --rs reject --protocol http

Porzucanie komunikatów c2d (tylko http)

az iot device simulate -n {iothub_name} -d {device_id} --rs abandon --protocol http

Parametry wymagane

Parametry opcjonalne

Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.

Parametry globalne

--debug

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

Właściwość	Wartość
Domyślna wartość:	False

--help -h

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

--only-show-errors

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

Właściwość	Wartość
Domyślna wartość:	False

--output -o

Format danych wyjściowych.

Właściwość	Wartość
Domyślna wartość:	json
Dopuszczalne wartości:	json, jsonc, none, table, tsv, yaml, yamlc

--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 az account set -s NAME_OR_ID.

--verbose

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

Właściwość	Wartość
Domyślna wartość:	False

az iot device upload-file --content-type --ct
                          --device-id
                          --file-path --fp
                          [--hub-name]
                          [--login]
                          [--resource-group]

Parametry wymagane

Parametry opcjonalne

Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.

Parametry globalne

--debug

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

Właściwość	Wartość
Domyślna wartość:	False

--help -h

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

--only-show-errors

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

Właściwość	Wartość
Domyślna wartość:	False

--output -o

Format danych wyjściowych.

Właściwość	Wartość
Domyślna wartość:	json
Dopuszczalne wartości:	json, jsonc, none, table, tsv, yaml, yamlc

--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 az account set -s NAME_OR_ID.

--verbose

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

Właściwość	Wartość
Domyślna wartość:	False