az iot hub device-twin

참고

이 참조는 Azure CLI에 대 한 azure iot 확장의 일부 이며 버전 2.0.70 이상 이어야 합니다. Az iot hub 장치 쌍 명령을 처음 실행할 때 확장이 자동으로 설치 됩니다. 확장에 대해 자세히 알아보세요 .

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
                               [--etag]
                               [--hub-name]
                               [--login]
                               [--resource-group]

예제

장치 쌍을 파일 내용으로 바꿉니다.

az iot hub device-twin replace -d {device_id} -n {iothub_name} -j ../mydevicetwin.json

필수 매개 변수

--device-id -d

대상 장치.

--json -j

기존 쌍을 대체 하는 Json입니다. 파일 경로 또는 원시 json을 제공 합니다.

선택적 매개 변수

--etag -e

리소스의 마지막 상태에 해당 하는 Etag 또는 엔터티 태그입니다. Etag를 제공 하지 않으면 ' ' 값 * 이 사용 됩니다.

--hub-name -n

IoT Hub 이름입니다.

--login -l

이 명령은 작업을 수행할 수 있는 권한이 있는 엔터티 연결 문자열을 지원 합니다. "Az login"을 통해 세션 로그인을 방지 하는 데 사용 합니다. 엔터티 연결 문자열과 이름을 모두 제공 하는 경우 연결 문자열에 우선 순위가 적용 됩니다.

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

az iot hub device-twin show

장치 쌍 정의를 가져옵니다.

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

필수 매개 변수

--device-id -d

대상 장치.

선택적 매개 변수

--hub-name -n

IoT Hub 이름입니다.

--login -l

이 명령은 작업을 수행할 수 있는 권한이 있는 엔터티 연결 문자열을 지원 합니다. "Az login"을 통해 세션 로그인을 방지 하는 데 사용 합니다. 엔터티 연결 문자열과 이름을 모두 제공 하는 경우 연결 문자열에 우선 순위가 적용 됩니다.

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

az iot hub device-twin update

장치 쌍 desired 속성 및 태그를 업데이트 합니다.

패치 동작에 대 한 desired 또는--tags 인수를 제공 합니다. 제네릭 업데이트 args 사용 (즉,--set)은 PUT 동작을 반영 하 고 사용 되지 않습니다.

az iot hub device-twin update --device-id
                              [--add]
                              [--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}}}'

필수 매개 변수

--device-id -d

대상 장치.

선택적 매개 변수

--add

경로 및 키 값 쌍을 지정 하 여 개체 목록에 개체를 추가 합니다. 예:--속성을 추가 합니다. listProperty <key = value, string 또는 JSON string>.

--desired

쌍 desired 속성입니다.

--etag -e

리소스의 마지막 상태에 해당 하는 Etag 또는 엔터티 태그입니다. Etag를 제공 하지 않으면 ' ' 값 * 이 사용 됩니다.

--force-string

' Set ' 또는 ' a l l '을 사용 하는 경우 JSON으로 변환 하는 대신 문자열 리터럴을 유지 합니다.

--hub-name -n

IoT Hub 이름입니다.

--login -l

이 명령은 작업을 수행할 수 있는 권한이 있는 엔터티 연결 문자열을 지원 합니다. "Az login"을 통해 세션 로그인을 방지 하는 데 사용 합니다. 엔터티 연결 문자열과 이름을 모두 제공 하는 경우 연결 문자열에 우선 순위가 적용 됩니다.

--remove

목록에서 속성이 나 요소를 제거 합니다. 예:--속성을 제거 합니다. 목록 또는--propertyToRemove을 제거 합니다.

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

--set

설정할 속성 경로 및 값을 지정 하 여 개체를 업데이트 합니다. 예:--set property1 property2 =.

--tags

쌍 태그.