az iot hub digital-twin

Примечание

Эта ссылка является частью расширения azure-iot для Azure CLI (версия 2.30.0 или более поздняя). Расширение автоматически установит команду az iot hub digital-twin при первом запуске. Подробнее о расширениях.

Управление цифровым двойником устройства Центр Интернета вещей и взаимодействие с ним.

Команды

az iot hub digital-twin invoke-command

Вызов команды корневого или компонента на уровне устройства цифрового двойника.

az iot hub digital-twin show

Отображение цифрового двойника устройства Центр Интернета вещей.

az iot hub digital-twin update

Обновление свойств устройства цифрового двойника с помощью спецификации исправления JSON.

az iot hub digital-twin invoke-command

Вызов команды корневого или компонента на уровне устройства цифрового двойника.

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

Примеры

Вызов команды "перезагрузка" корневого уровня, которая принимает полезные данные, которые включают свойство delay.

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

Вызовите команду getMaxMinReport для компонента thermostat1, который не принимает входных данных.

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

Обязательные параметры

--cn --command-name

Имя команды цифрового двойника.

--device-id -d

Целевое устройство.

Необязательные параметры

--component-path

Путь к компоненту цифрового двойника. Например: thermostat1.

--connect-timeout --cto

Максимальный интервал времени (в секундах), который Центр Интернета вещей попытается подключиться к устройству.

--hub-name -n

Центр Интернета вещей имя. Требуется, если параметр --login не указан.

--login -l

Эта команда поддерживает строку подключения сущности с правами на выполнение действия. Используйте, чтобы избежать входа в сеанс с помощью az login. Если указана строка подключения сущности и имя, строка подключения имеет приоритет. Требуется, если параметр --hub-name не указан.

--payload

Входные данные полезных данных JSON для команды. Укажите путь к файлу или встроенный КОД JSON.

значение по умолчанию: {}
--resource-group -g

Имя группы ресурсов. Вы можете настроить расположение по умолчанию с помощью az configure --defaults group=<name>.

--response-timeout --rto

Максимальный интервал времени (в секундах), который команда цифрового двойника ожидает результата.

az iot hub digital-twin show

Отображение цифрового двойника устройства Центр Интернета вещей.

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

Примеры

Отображение цифрового двойника целевого устройства.

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

Обязательные параметры

--device-id -d

Целевое устройство.

Необязательные параметры

--hub-name -n

Центр Интернета вещей имя. Требуется, если параметр --login не указан.

--login -l

Эта команда поддерживает строку подключения сущности с правами на выполнение действия. Используйте, чтобы избежать входа в сеанс с помощью az login. Если указана строка подключения сущности и имя, строка подключения имеет приоритет. Требуется, если параметр --hub-name не указан.

--resource-group -g

Имя группы ресурсов. Вы можете настроить расположение по умолчанию с помощью az configure --defaults group=<name>.

az iot hub digital-twin update

Обновление свойств устройства цифрового двойника с помощью спецификации исправления JSON.

В настоящее время операции ограничены добавлением, заменой и удалением.

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

Примеры

Обновление цифрового двойника с помощью спецификации исправления JSON.

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

Обновление цифрового двойника с помощью спецификации исправления 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}
]'

Обновление свойства цифрового двойника с помощью спецификации исправления JSON, определенной в файле.

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

Обязательные параметры

--device-id -d

Целевое устройство.

--json-patch --patch

Спецификация обновления, описанная json-patch. Операции ограничены добавлением, заменой и удалением. Укажите путь к файлу или встроенный КОД JSON.

Необязательные параметры

--etag -e

Тег Etag или тег сущности, соответствующий последнему состоянию ресурса. Если etag не указан, используется значение "*".

--hub-name -n

Центр Интернета вещей имя. Требуется, если параметр --login не указан.

--login -l

Эта команда поддерживает строку подключения сущности с правами на выполнение действия. Используйте, чтобы избежать входа в сеанс с помощью az login. Если указана строка подключения сущности и имя, строка подключения имеет приоритет. Требуется, если параметр --hub-name не указан.

--resource-group -g

Имя группы ресурсов. Вы можете настроить расположение по умолчанию с помощью az configure --defaults group=<name>.