az iot hub digital-twin
참고
이 참조는 Azure CLI에 대 한 azure iot 확장의 일부 이며 버전 2.17.1 이상 이어야 합니다. 확장은 az iot hub digital 쌍 명령을 처음 실행할 때 자동으로 설치 됩니다. 확장에 대해 자세히 알아보세요.
IoT Hub 장치의 디지털 쌍을 조작 하 고 상호 작용 합니다.
명령
| az iot hub digital-twin invoke-command |
디지털 쌍 장치의 루트 또는 구성 요소 수준 명령을 호출 합니다. |
| az iot hub digital-twin show |
IoT Hub 장치의 디지털 쌍을 표시 합니다. |
| 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}'
입력을 사용 하지 않는 "thermostat1" 구성 요소에서 명령 "getMaxMinReport"를 호출 합니다.
az iot hub digital-twin invoke-command --cn getMaxMinReport -n {iothub_name} -d {device_id} --component-path thermostat1
필수 매개 변수
디지털 쌍 명령 이름입니다.
대상 장치.
선택적 매개 변수
디지털 쌍 구성 요소 경로입니다. 예: thermostat1.
IoT Hub에서 장치에 대 한 연결을 시도 하는 최대 시간 간격 (초)입니다.
IoT Hub 이름입니다.
이 명령은 작업을 수행할 수 있는 권한이 있는 엔터티 연결 문자열을 지원 합니다. "Az login"을 통해 세션 로그인을 방지 하는 데 사용 합니다. 엔터티 연결 문자열과 이름을 모두 제공 하는 경우 연결 문자열에 우선 순위가 적용 됩니다.
명령에 대 한 JSON 페이로드 입력입니다. 파일 경로 또는 인라인 JSON을 제공 합니다.
리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.
디지털 쌍 명령이 결과를 대기 하는 최대 시간 간격 (초)입니다.
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
오류만 표시하고, 경고를 표시하지 않습니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/를 참조하세요.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
az iot hub digital-twin show
IoT Hub 장치의 디지털 쌍을 표시 합니다.
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}
필수 매개 변수
대상 장치.
선택적 매개 변수
IoT Hub 이름입니다.
이 명령은 작업을 수행할 수 있는 권한이 있는 엔터티 연결 문자열을 지원 합니다. "Az login"을 통해 세션 로그인을 방지 하는 데 사용 합니다. 엔터티 연결 문자열과 이름을 모두 제공 하는 경우 연결 문자열에 우선 순위가 적용 됩니다.
리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
오류만 표시하고, 경고를 표시하지 않습니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/를 참조하세요.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
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
필수 매개 변수
대상 장치.
JSON 패치에서 설명 하는 업데이트 사양입니다. 작업은 추가, 바꾸기 및 제거로 제한 됩니다. 파일 경로 또는 인라인 JSON을 제공 합니다.
선택적 매개 변수
리소스의 마지막 상태에 해당 하는 Etag 또는 엔터티 태그입니다. Etag를 제공 하지 않으면 ' ' 값 * 이 사용 됩니다.
IoT Hub 이름입니다.
이 명령은 작업을 수행할 수 있는 권한이 있는 엔터티 연결 문자열을 지원 합니다. "Az login"을 통해 세션 로그인을 방지 하는 데 사용 합니다. 엔터티 연결 문자열과 이름을 모두 제공 하는 경우 연결 문자열에 우선 순위가 적용 됩니다.
리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
오류만 표시하고, 경고를 표시하지 않습니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/를 참조하세요.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.