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>'

필수 매개 변수

--device-id -d

대상 장치.

선택적 매개 변수

--da --data

메시지 본문.

기본값: Ping from Az CLI IoT Extension
--hub-name -n

IoT Hub 이름입니다.

--login -l

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

--mc --msg-count

IoT Hub 보낼 장치 메시지 수입니다.

기본값: 1
--properties --props -p

다음 형식의 키-값 쌍의 메시지 속성 모음: a = b, c = d. Mqtt messaging-$를 사용 하 여 시스템 속성을 보낼 수 있습니다. = 값 예를 들어, cid = 12345는 시스템 상관 관계 Id 속성을 설정 합니다. 다른 시스템 속성 식별자의 예로는 콘텐츠 형식의 $. ct, 메시지 Id의 경우 $. mid, 콘텐츠 인코딩에는 $. ce 등이 있습니다.

--qos

서비스 품질. 0 = 한 번 이상, 1 = 한 번 이상 2 (정확히 한 번)는 지원 되지 않습니다. 이 명령 매개 변수는 더 이상 사용 되지 않으며 다음 릴리스에서 제거 될 예정입니다.

허용되는 값: 0, 1
기본값: 1
--resource-group -g

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

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

필수 매개 변수

--device-id -d

대상 장치.

선택적 매개 변수

--da --data

메시지 본문.

기본값: Ping from Az CLI IoT Extension
--hub-name -n

IoT Hub 이름입니다.

--login -l

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

--mc --msg-count

IoT Hub 보낼 장치 메시지 수입니다.

기본값: 100
--mi --msg-interval

장치-클라우드 메시지 간의 지연 시간 (초)입니다.

기본값: 3
--properties --props -p

다음 형식의 키-값 쌍의 메시지 속성 모음: 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 및 콘텐츠 인코딩과 같은 예외가 있습니다.

--proto --protocol

장치-클라우드 메시지 프로토콜을 나타냅니다.

허용되는 값: http, mqtt
기본값: mqtt
--receive-settle --rs

수신 되는 클라우드-장치 메시지를 결정 하는 방법을 나타냅니다. HTTP만 지원 됩니다.

허용되는 값: abandon, complete, reject
기본값: complete
--resource-group -g

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

az iot device upload-file

미리 구성 된 blob 저장소 컨테이너에 대 한 장치로 로컬 파일을 업로드 합니다.

az iot device upload-file --content-type
                          --device-id
                          --file-path
                          [--hub-name]
                          [--login]
                          [--resource-group]

필수 매개 변수

--content-type --ct

파일의 MIME 형식입니다.

--device-id -d

대상 장치.

--file-path --fp

업로드할 파일의 경로입니다.

선택적 매개 변수

--hub-name -n

IoT Hub 이름입니다.

--login -l

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

--resource-group -g

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