az iot device
참고
이 참조는 Azure CLI에 대 한 azure iot 확장의 일부 이며 버전 2.17.1 이상 이어야 합니다. Az iot device 명령을 처음 실행할 때 확장이 자동으로 설치 됩니다. 확장에 대해 자세히 알아보세요.
디바이스-클라우드 및 클라우드-디바이스 메시징 기능을 활용합니다.
명령
| az iot device c2d-message |
클라우드-디바이스 메시징 명령. |
| az iot device c2d-message abandon |
클라우드-디바이스 메시지를 중단합니다. |
| az iot device c2d-message complete |
클라우드-디바이스 메시지를 완료합니다. |
| az iot device c2d-message purge |
대상 디바이스에 대한 클라우드-디바이스 메시지 큐를 제거합니다. |
| az iot device c2d-message receive |
클라우드-디바이스 메시지를 받습니다. |
| az iot device c2d-message reject |
클라우드-디바이스 메시지를 거부하거나 전달하지 않습니다. |
| az iot device c2d-message send |
클라우드-디바이스 메시지를 보냅니다. |
| az iot device send-d2c-message |
Mqtt 장치-클라우드 메시지를 보냅니다. 명령은 응용 프로그램 및 시스템 속성을 사용 하 여 메시지 보내기를 지원 합니다. 참고: 명령은 SAS (대칭 키 인증) 기반 장치에 대해서만 작동 합니다. |
| az iot device simulate |
Azure IoT 허브에서 장치를 시뮬레이트합니다. 장치 시뮬레이션이 실행 되는 동안 장치는 클라우드-장치 (c2d) 메시지를 자동으로 수신 하 고 승인 합니다. Mqtt 시뮬레이션의 경우 모든 c2d 메시지가 완료 될 때 승인 됩니다. Http 시뮬레이션의 경우 c2d 승인은 완료, 거부 또는 중단할 수 있는 사용자 선택에 따라 결정 됩니다. 또한 mqtt 시뮬레이션은 SAS (대칭 키 인증) 기반 장치에 대해서만 지원 됩니다. 참고: 기본적으로이 명령은 content-type을 application/json으로 설정 하 고 콘텐츠 인코딩을 u t f-8로 설정 합니다. 이는 재정의 될 수 있습니다. |
| az iot device upload-file |
미리 구성 된 blob 저장소 컨테이너에 대 한 장치로 로컬 파일을 업로드 합니다. |
az iot device send-d2c-message
Mqtt 장치-클라우드 메시지를 보냅니다. 명령은 응용 프로그램 및 시스템 속성을 사용 하 여 메시지 보내기를 지원 합니다.
참고: 명령은 SAS (대칭 키 인증) 기반 장치에 대해서만 작동 합니다.
az iot device send-d2c-message --device-id
[--da]
[--hub-name]
[--login]
[--mc]
[--properties]
[--qos {0, 1}]
[--resource-group]
예제
기본적인 사용 방법
az iot device send-d2c-message -n {iothub_name} -d {device_id}
사용자 지정 데이터를 사용 하는 기본 사용법
az iot device send-d2c-message -n {iothub_name} -d {device_id} --data {message_body}
응용 프로그램 속성 보내기
az iot device send-d2c-message -n {iothub_name} -d {device_id} --props 'key0=value0;key1=value1'
송신 시스템 속성 (메시지 Id 및 상관 관계 Id)
az iot device send-d2c-message -n {iothub_name} -d {device_id} --props '$.mid=<id>;$.cid=<id>'
필수 매개 변수
대상 장치.
선택적 매개 변수
메시지 본문.
IoT Hub 이름입니다.
이 명령은 작업을 수행할 수 있는 권한이 있는 엔터티 연결 문자열을 지원 합니다. "Az login"을 통해 세션 로그인을 방지 하는 데 사용 합니다. 엔터티 연결 문자열과 이름을 모두 제공 하는 경우 연결 문자열에 우선 순위가 적용 됩니다.
IoT Hub 보낼 장치 메시지 수입니다.
다음 형식의 키-값 쌍의 메시지 속성 모음: a = b, c = d. Mqtt messaging-$를 사용 하 여 시스템 속성을 보낼 수 있습니다. = 값 예를 들어, cid = 12345는 시스템 상관 관계 Id 속성을 설정 합니다. 다른 시스템 속성 식별자의 예로는 콘텐츠 형식의 $. ct, 메시지 Id의 경우 $. mid, 콘텐츠 인코딩에는 $. ce 등이 있습니다.
서비스 품질. 0 = 한 번 이상, 1 = 한 번 이상 2 (정확히 한 번)는 지원 되지 않습니다. 이 명령 매개 변수는 더 이상 사용 되지 않으며 다음 릴리스에서 제거 될 예정입니다.
리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
오류만 표시하고, 경고를 표시하지 않습니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/를 참조하세요.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
az iot device simulate
Azure IoT 허브에서 장치를 시뮬레이트합니다.
장치 시뮬레이션이 실행 되는 동안 장치는 클라우드-장치 (c2d) 메시지를 자동으로 수신 하 고 승인 합니다. Mqtt 시뮬레이션의 경우 모든 c2d 메시지가 완료 될 때 승인 됩니다. Http 시뮬레이션의 경우 c2d 승인은 완료, 거부 또는 중단할 수 있는 사용자 선택에 따라 결정 됩니다. 또한 mqtt 시뮬레이션은 SAS (대칭 키 인증) 기반 장치에 대해서만 지원 됩니다.
참고: 기본적으로이 명령은 content-type을 application/json으로 설정 하 고 콘텐츠 인코딩을 u t f-8로 설정 합니다. 이는 재정의 될 수 있습니다.
az iot device simulate --device-id
[--da]
[--hub-name]
[--login]
[--mc]
[--mi]
[--properties]
[--proto {http, mqtt}]
[--receive-settle {abandon, complete, reject}]
[--resource-group]
예제
기본 사용법 (mqtt)
az iot device simulate -n {iothub_name} -d {device_id}
혼합 속성을 보내는 기본 사용 (mqtt)
az iot device simulate -n {iothub_name} -d {device_id} --properties "myprop=myvalue;$.ct=application/json"
기본 사용 (http)
az iot device simulate -n {iothub_name} -d {device_id} --protocol http
혼합 속성을 보내는 기본 사용 (http)
az iot device simulate -n {iothub_name} -d {device_id} --protocol http --properties "iothub-app-myprop=myvalue;content-type=application/json;iothub-correlationid=12345"
메시지 간 전체 메시지 수 및 간격 선택
az iot device simulate -n {iothub_name} -d {device_id} --msg-count 1000 --msg-interval 5
C2d 메시지 거부 (http 전용)
az iot device simulate -n {iothub_name} -d {device_id} --rs reject --protocol http
C2d 메시지 중단 (http 전용)
az iot device simulate -n {iothub_name} -d {device_id} --rs abandon --protocol http
필수 매개 변수
대상 장치.
선택적 매개 변수
메시지 본문.
IoT Hub 이름입니다.
이 명령은 작업을 수행할 수 있는 권한이 있는 엔터티 연결 문자열을 지원 합니다. "Az login"을 통해 세션 로그인을 방지 하는 데 사용 합니다. 엔터티 연결 문자열과 이름을 모두 제공 하는 경우 연결 문자열에 우선 순위가 적용 됩니다.
IoT Hub 보낼 장치 메시지 수입니다.
장치-클라우드 메시지 간의 지연 시간 (초)입니다.
다음 형식의 키-값 쌍의 메시지 속성 모음: a = b, c = d. Mqtt messaging-$를 사용 하 여 시스템 속성을 보낼 수 있습니다. = 값 예를 들어, cid = 12345는 시스템 상관 관계 Id 속성을 설정 합니다. 다른 시스템 속성 식별자의 예로는 콘텐츠 형식의 $. ct, 메시지 Id의 경우 $. mid, 콘텐츠 인코딩에는 $. ce 등이 있습니다. Http 메시징의 경우 응용 프로그램 속성은 iothub-= value를 사용 하 여 전송 됩니다 . 예를 들면 iothub-app-myprop = myvalue입니다. 시스템 속성에는 일반적으로 iothub와 같은 iothub-correlationid 접두사가 있지만 content-type 및 콘텐츠 인코딩과 같은 예외가 있습니다.
장치-클라우드 메시지 프로토콜을 나타냅니다.
수신 되는 클라우드-장치 메시지를 결정 하는 방법을 나타냅니다. HTTP만 지원 됩니다.
리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
오류만 표시하고, 경고를 표시하지 않습니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/를 참조하세요.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
az iot device upload-file
미리 구성 된 blob 저장소 컨테이너에 대 한 장치로 로컬 파일을 업로드 합니다.
az iot device upload-file --content-type
--device-id
--file-path
[--hub-name]
[--login]
[--resource-group]
필수 매개 변수
파일의 MIME 형식입니다.
대상 장치.
업로드할 파일의 경로입니다.
선택적 매개 변수
IoT Hub 이름입니다.
이 명령은 작업을 수행할 수 있는 권한이 있는 엔터티 연결 문자열을 지원 합니다. "Az login"을 통해 세션 로그인을 방지 하는 데 사용 합니다. 엔터티 연결 문자열과 이름을 모두 제공 하는 경우 연결 문자열에 우선 순위가 적용 됩니다.
리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
오류만 표시하고, 경고를 표시하지 않습니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/를 참조하세요.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.