az iot hub digital-twin

  • Odwołanie

Uwaga

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

Manipulowanie cyfrowymi reprezentacjami bliźniaczymi urządzenia IoT Hub i interakcja z nimi.

Polecenia

az iot hub digital-twin invoke-command

Wywołaj polecenie na poziomie katalogu głównego lub składnika urządzenia cyfrowej reprezentacji bliźniaczej.
az iot hub digital-twin show

Pokaż cyfrową reprezentację bliźniaczą urządzenia IoT Hub.
az iot hub digital-twin update

Zaktualizuj właściwości odczytu i zapisu urządzenia cyfrowej reprezentacji bliźniaczej za pomocą specyfikacji poprawek JSON.

az iot hub digital-twin invoke-command

Wywołaj polecenie na poziomie katalogu głównego lub składnika urządzenia cyfrowej reprezentacji bliźniaczej.

az iot hub digital-twin invoke-command --cn
                                       --device-id
                                       [--component-path]
                                       [--connect-timeout]
                                       [--hub-name]
                                       [--login]
                                       [--payload]
                                       [--resource-group]
                                       [--response-timeout]

Przykłady

Wywołaj polecenie poziomu głównego "reboot", które przyjmuje ładunek zawierający właściwość "delay".

az iot hub digital-twin invoke-command --command-name reboot -n {iothub_name} -d {device_id} --payload '{"delay":5}'

Wywołaj polecenie "getMaxMinReport" w składniku "termostat1", które nie przyjmuje żadnych danych wejściowych.

az iot hub digital-twin invoke-command --cn getMaxMinReport -n {iothub_name} -d {device_id} --component-path thermostat1

Parametry wymagane

--cn --command-name

Nazwa polecenia cyfrowej reprezentacji bliźniaczej.

--device-id -d

Urządzenie docelowe.

Parametry opcjonalne

--component-path

Ścieżka składnika cyfrowej reprezentacji bliźniaczej. Na przykład: termostat1.

--connect-timeout --cto

Maksymalny interwał czasu (w sekundach), który IoT Hub spróbuje nawiązać połączenie z urządzeniem.

--hub-name -n

IoT Hub nazwę. Wymagane, jeśli nie podano opcji --login.

--login -l

To polecenie obsługuje parametry połączenia jednostki z uprawnieniami do wykonania akcji. Użyj polecenia , aby uniknąć logowania do sesji za pomocą polecenia "az login". Jeśli parametry połączenia jednostki i nazwa są podane parametry połączenia mają priorytet. Wymagane, jeśli nie podano --hub-name.

--payload

Dane wejściowe ładunku JSON dla polecenia. Podaj ścieżkę pliku lub wbudowany kod JSON.

wartość domyślna: {}
--resource-group -g

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

--response-timeout --rto

Maksymalny interwał czasu (w sekundach) oczekiwania na wynik polecenia cyfrowej reprezentacji bliźniaczej.

az iot hub digital-twin show

Pokaż cyfrową reprezentację bliźniaczą urządzenia IoT Hub.

az iot hub digital-twin show --device-id
                             [--hub-name]
                             [--login]
                             [--resource-group]

Przykłady

Pokaż cyfrową reprezentację bliźniaczą urządzenia docelowego.

az iot hub digital-twin show -n {iothub_name} -d {device_id}

Parametry wymagane

--device-id -d

Urządzenie docelowe.

Parametry opcjonalne

--hub-name -n

IoT Hub nazwę. Wymagane, jeśli nie podano opcji --login.

--login -l

To polecenie obsługuje parametry połączenia jednostki z uprawnieniami do wykonania akcji. Użyj polecenia , aby uniknąć logowania do sesji za pomocą polecenia "az login". Jeśli parametry połączenia jednostki i nazwa są podane parametry połączenia mają priorytet. Wymagane, jeśli nie podano --hub-name.

--resource-group -g

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

az iot hub digital-twin update

Zaktualizuj właściwości odczytu i zapisu urządzenia cyfrowej reprezentacji bliźniaczej za pomocą specyfikacji poprawek JSON.

Obecnie operacje są ograniczone do dodawania, zastępowania i usuwania.

az iot hub digital-twin update --device-id
                               --json-patch
                               [--etag]
                               [--hub-name]
                               [--login]
                               [--resource-group]

Przykłady

Aktualizowanie cyfrowej reprezentacji bliźniaczej za pomocą specyfikacji poprawek JSON.

az iot hub digital-twin update --hub-name {iothub_name} --device-id {device_id} --json-patch '{"op":"add", "path":"/thermostat1/targetTemperature", "value": 54}'

Aktualizowanie cyfrowej reprezentacji bliźniaczej za pomocą specyfikacji poprawek JSON.

az iot hub digital-twin update -n {iothub_name} -d {device_id} --json-patch '[
  {"op":"remove", "path":"/thermostat1/targetTemperature"},
  {"op":"add", "path":"/thermostat2/targetTemperature", "value": 22}
]'

Zaktualizuj właściwość cyfrowej reprezentacji bliźniaczej za pomocą specyfikacji poprawek JSON zdefiniowanej w pliku.

az iot hub digital-twin update -n {iothub_name} -d {device_id} --json-patch ./my/patch/document.json

Parametry wymagane

--device-id -d

Urządzenie docelowe.

--json-patch --patch

Specyfikacja aktualizacji opisana przez JSON-patch. Operacje są ograniczone do dodawania, zastępowania i usuwania. Podaj ścieżkę pliku lub wbudowany kod JSON.

Parametry opcjonalne

--etag -e

Etag lub tag jednostki odpowiadający ostatniemu stanowi zasobu. Jeśli nie podano elementu etag, zostanie użyta wartość "*".

--hub-name -n

IoT Hub nazwę. Wymagane, jeśli nie podano opcji --login.

--login -l

To polecenie obsługuje parametry połączenia jednostki z uprawnieniami do wykonania akcji. Użyj polecenia , aby uniknąć logowania do sesji za pomocą polecenia "az login". Jeśli parametry połączenia jednostki i nazwa są podane parametry połączenia mają priorytet. Wymagane, jeśli nie podano --hub-name.

--resource-group -g

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