az iot hub device-twin
참고
이 참조는 Azure CLI 대한 azure-iot 확장의 일부이며 버전 2.17.1 이상이 필요합니다. az iot hub device-twin 명령을 처음 실행할 때 확장이 자동으로 설치됩니다. 확장에 대해 자세히 알아보세요.
IoT 디바이스 쌍 구성을 관리합니다.
명령
| az iot hub device-twin replace |
디바이스 쌍 정의를 대상 json으로 대체합니다. |
| az iot hub device-twin show |
디바이스 쌍 정의를 얻습니다. |
| az iot hub device-twin update |
디바이스 쌍 desired 속성 및 태그를 업데이트합니다. |
az iot hub device-twin replace
디바이스 쌍 정의를 대상 json으로 대체합니다.
json을 직접 입력하거나 파일 경로를 사용합니다.
az iot hub device-twin replace --device-id
--json
[--auth-type {key, login}]
[--etag]
[--hub-name]
[--login]
[--resource-group]
예제
디바이스 쌍을 파일 콘텐츠로 대체합니다.
az iot hub device-twin replace -d {device_id} -n {iothub_name} -j ../mydevicetwin.json
필수 매개 변수
대상 디바이스.
기존 트윈을 대체할 Json입니다. 파일 경로 또는 원시 json을 제공합니다.
선택적 매개 변수
작업에서 정책 키를 자동으로 파생할지 또는 현재 Azure AD 세션을 사용해야 하는지를 나타냅니다. 를 사용하여 기본값을 구성할 수 az configure --defaults iothub-data-auth-type=<auth-type-value> 있습니다.
리소스의 마지막 상태에 해당하는 Etag 또는 엔터티 태그입니다. etag가 제공되지 않으면 ' * ' 값이 사용됩니다.
IoT Hub 이름입니다.
이 명령은 작업을 수행할 수 있는 권한이 있는 엔터티 연결 문자열을 지원합니다. "az login"을 통해 세션 로그인을 방지하려면 를 사용합니다. 엔터티 연결 문자열과 이름이 둘 다 제공되면 연결 문자열이 우선합니다.
리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
오류만 표시하고, 경고를 표시하지 않습니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/를 참조하세요.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
az iot hub device-twin show
디바이스 쌍 정의를 얻습니다.
az iot hub device-twin show --device-id
[--auth-type {key, login}]
[--hub-name]
[--login]
[--resource-group]
필수 매개 변수
대상 디바이스.
선택적 매개 변수
작업에서 정책 키를 자동으로 파생할지 또는 현재 Azure AD 세션을 사용해야 하는지를 나타냅니다. 를 사용하여 기본값을 구성할 수 az configure --defaults iothub-data-auth-type=<auth-type-value> 있습니다.
IoT Hub 이름입니다.
이 명령은 작업을 수행할 수 있는 권한이 있는 엔터티 연결 문자열을 지원합니다. "az login"을 통해 세션 로그인을 방지하려면 를 사용합니다. 엔터티 연결 문자열과 이름이 둘 다 제공되면 연결 문자열이 우선합니다.
리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
오류만 표시하고, 경고를 표시하지 않습니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/를 참조하세요.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
az iot hub device-twin update
디바이스 쌍 desired 속성 및 태그를 업데이트합니다.
PATCH 동작에 대해 --desired 또는 --tags 인수를 제공합니다. 제네릭 업데이트 args(예: --set)를 사용하면 PUT 동작이 반영되며 더 이상 사용되지 않습니다.
az iot hub device-twin update --device-id
[--add]
[--auth-type {key, login}]
[--desired]
[--etag]
[--force-string]
[--hub-name]
[--login]
[--remove]
[--resource-group]
[--set]
[--tags]
예제
디바이스 쌍 desired 속성을 패치합니다.
az iot hub device-twin update -n {iothub_name} -d {device_id} --desired '{"conditions":{"temperature":{"warning":70, "critical":100}}}'
디바이스 쌍 태그를 패치합니다.
az iot hub device-twin update -n {iothub_name} -d {device_id} --tags '{"country": "USA"}'
부모 '온도'에서 '위험' desired 속성의 패치 제거
az iot hub device-twin update -n {iothub_name} -d {device_id} --desired '{"condition":{"temperature":{"critical": null}}}'
필수 매개 변수
대상 디바이스.
선택적 매개 변수
경로 및 키 값 쌍을 지정하여 개체를 개체 목록에 추가합니다. 예: --add property.listProperty <key=value, string 또는 JSON string>.
작업에서 정책 키를 자동으로 파생할지 또는 현재 Azure AD 세션을 사용해야 하는지를 나타냅니다. 를 사용하여 기본값을 구성할 수 az configure --defaults iothub-data-auth-type=<auth-type-value> 있습니다.
쌍 desired 속성입니다.
리소스의 마지막 상태에 해당하는 Etag 또는 엔터티 태그입니다. etag가 제공되지 않으면 ' * ' 값이 사용됩니다.
'set' 또는 'add'를 사용하는 경우 JSON으로 변환하는 대신 문자열 리터럴을 유지합니다.
IoT Hub 이름입니다.
이 명령은 작업을 수행할 수 있는 권한이 있는 엔터티 연결 문자열을 지원합니다. "az login"을 통해 세션 로그인을 방지하려면 를 사용합니다. 엔터티 연결 문자열과 이름이 둘 다 제공되면 연결 문자열이 우선합니다.
목록에서 속성 또는 요소를 제거합니다. 예: --remove property.list OR --remove propertyToRemove.
리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.
설정할 속성 경로와 값을 지정하여 개체를 업데이트합니다. 예: --set property1.property2=.
쌍 태그입니다.
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
오류만 표시하고, 경고를 표시하지 않습니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/를 참조하세요.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.