az iot device
참고
이 참조는 Azure CLI(버전 2.46.0 이상)에 대한 azure-iot 확장의 일부입니다. az iot device 명령을 처음 실행할 때 확장이 자동으로 설치됩니다. 확장 프로그램에 대해 자세히 알아보세요.
디바이스 시뮬레이션 및 디바이스-클라우드 또는 클라우드-디바이스 메시징 기능과 같은 기타 디바이스 중심 작업을 활용합니다.
Name | Description | 형식 | 상태 |
---|---|---|---|
az iot device c2d-message |
클라우드-디바이스 메시징 명령. |
내선 번호 | GA |
az iot device c2d-message abandon |
클라우드-디바이스 메시지를 중단합니다. |
내선 번호 | GA |
az iot device c2d-message complete |
클라우드-디바이스 메시지를 완료합니다. |
내선 번호 | GA |
az iot device c2d-message purge |
대상 디바이스에 대한 클라우드-디바이스 메시지 큐를 제거합니다. |
내선 번호 | GA |
az iot device c2d-message receive |
클라우드-디바이스 메시지를 받습니다. |
내선 번호 | GA |
az iot device c2d-message reject |
클라우드-디바이스 메시지를 거부하거나 배달 취소합니다. |
내선 번호 | GA |
az iot device c2d-message send |
클라우드-디바이스 메시지를 보냅니다. |
내선 번호 | GA |
az iot device registration |
IoT Device Provisioning Service에 대한 IoT 디바이스 등록을 관리합니다. |
내선 번호 | 프리뷰 |
az iot device registration create |
IoT Device Provisioning Service에 IoT 디바이스를 등록합니다. |
내선 번호 | 프리뷰 |
az iot device send-d2c-message |
mqtt 디바이스-클라우드 메시지를 보냅니다. |
내선 번호 | GA |
az iot device simulate |
Azure IoT Hub에서 디바이스를 시뮬레이션합니다. |
내선 번호 | Experimental |
az iot device upload-file |
미리 구성된 Blob Storage 컨테이너에 로컬 파일을 디바이스로 업로드합니다. |
내선 번호 | GA |
mqtt 디바이스-클라우드 메시지를 보냅니다.
이 명령은 유니코드 문자열 또는 이진 형식의 사용자 지정 페이로드가 있는 메시지 전송을 지원합니다. 이진 파일을 보내려는 경우 데이터는 파일에서 가져와야 하며(통해 --data-file-path
) 콘텐츠 형식을 으로 application/octet-stream
설정해야 합니다.
참고: 이 명령은 SAS(대칭 키 인증) 기반 디바이스에 대해서만 작동합니다. 메시지 라우팅에서 메시지 본문에서 쿼리를 사용하도록 설정하려면 contentType 시스템 속성이 application/JSON이어야 하며 contentEncoding 시스템 속성은 해당 시스템 속성(UTF-8, UTF-16 또는 UTF-32)에서 지원하는 UTF 인코딩 값 중 하나여야 합니다. Azure Storage를 라우팅 엔드포인트로 사용할 때 콘텐츠 인코딩이 설정되지 않은 경우 IoT Hub는 기본 64로 인코딩된 형식으로 메시지를 씁니다. x509 인증 방법을 사용하는 경우 인증서 및 키 파일(필요한 경우 암호)을 제공해야 합니다.
az iot device send-d2c-message --device-id
[--certificate-file-path]
[--da]
[--data-file-path]
[--dtmi]
[--hub-name]
[--key]
[--key-file-path]
[--login]
[--mc]
[--pass]
[--properties]
[--resource-group]
기본 사용법
az iot device send-d2c-message -n {iothub_name} -d {device_id}
'dtmi:com:example:Thermostat;의 모델 ID를 등록하는 디바이스에 대한 기본 사용 연결 시 1'
az iot device send-d2c-message -n {iothub_name} -d {device_id} --model-id 'dtmi:com:example:Thermostat;1'
x509 인증을 사용한 디바이스에 대한 기본 사용
az iot device send-d2c-message -n {iothub_name} -d {device_id} --cp {certificate_file_path} --kp {key_file_path}
키 파일에 암호가 있는 x509 인증을 사용하는 디바이스에 대한 기본 사용
az iot device send-d2c-message -n {iothub_name} -d {device_id} --cp {certificate_file_path} --kp {key_file_path} --pass {passphrase}
사용자 지정 데이터를 사용하는 기본 사용
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}'
시스템 속성에서 콘텐츠 형식 및 콘텐츠 인코딩을 지정하여 사용자 지정 데이터 보내기
az iot device send-d2c-message -n {iothub_name} -d {device_id} --props '$.ct={content-type};$.ce={content-encoding}' --data {message_body}
시스템 속성에서 콘텐츠 인코딩을 지정하여 이진 형식으로 사용자 지정 데이터 보내기
az iot device send-d2c-message -n {iothub_name} -d {device_id} --props '$.ct=application/octet-stream' --data-file-path {file_path}
시스템 속성에서 콘텐츠 형식 및 콘텐츠 인코딩을 지정하여 JSON 형식으로 사용자 지정 데이터 보내기
az iot device send-d2c-message -n {iothub_name} -d {device_id} --props '$.ct=application/json;$.ce=utf-8' --data-file-path {file_path}
대상 디바이스 ID입니다.
인증서 파일의 경로입니다.
메시지 본문입니다. 텍스트 또는 원시 json을 제공합니다.
메시지 본문 페이로드에 대한 파일 경로를 제공합니다. 페이로드를 이진 형식으로 보내야 하는 경우 콘텐츠 형식을 application/octet-stream으로 설정합니다.
허브에 연결할 때 디바이스가 보고하는 디지털 트윈 모델 ID입니다. 자세한 내용은 https://docs.microsoft.com/en-us/azure/iot-develop/overview-iot-plug-and-play를 참조하세요.
IoT Hub 이름 또는 호스트 이름입니다. --login이 제공되지 않은 경우 필요합니다.
디바이스에 사용할 대칭 키입니다. 대칭 키 및 기타 디바이스 인증 인수가 제공되면 대칭 키가 우선합니다.
키 파일의 경로입니다.
이 명령은 작업을 수행할 권한이 있는 엔터티 연결 문자열 지원합니다. "az login"을 통해 세션 로그인을 방지하는 데 사용합니다. 엔터티 연결 문자열 및 이름이 모두 제공되면 연결 문자열 우선 순위가 지정됩니다. --hub-name이 제공되지 않은 경우 필요합니다.
IoT Hub로 보낼 디바이스 메시지 수입니다.
키 파일의 암호입니다.
다음과 같은 형식의 키-값 쌍의 메시지 속성 모음: a=b; c=d. mqtt 메시징의 경우 $.=value를 사용하여 시스템 속성을 보낼 수 있습니다. 예를 들어 $.cid=12345는 시스템 상관 관계 ID 속성을 설정합니다. 다른 시스템 속성 식별자 예제에는 콘텐츠 형식의 경우 $.ct, 메시지 ID의 경우 $.mid, 콘텐츠 인코딩의 경우 $.ce가 있습니다.
리소스 그룹의 이름입니다. az configure --defaults group=<name>
을 사용하여 기본 그룹을 구성할 수 있습니다.
전역 매개 변수
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
오류만 표시하고, 경고를 표시하지 않습니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.
구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID
를 사용하여 기본 위치를 구성할 수 있습니다.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
이 명령은 실험적이며 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus
Azure IoT Hub에서 디바이스를 시뮬레이션합니다.
디바이스 시뮬레이션이 실행되는 동안 디바이스는 c2d(클라우드-디바이스) 메시지를 자동으로 수신하고 승인합니다. mqtt 시뮬레이션의 경우 완료 시 모든 c2d 메시지가 승인됩니다. http 시뮬레이션의 경우 c2d 승인은 완료, 거부 또는 포기할 수 있는 사용자 선택을 기반으로 합니다. mqtt 시뮬레이션은 응답 상태 코드 및 응답 페이로드에서 승인할 수 있는 직접 메서드 호출도 지원합니다. 참고: 기본적으로 명령은 content-type을 application/json으로 설정하고 콘텐츠 인코딩을 utf-8로 설정합니다. 재정의할 수 있습니다. 참고: x509 인증 방법을 사용하는 경우 인증서 및 키 파일(필요한 경우 암호)을 제공해야 합니다.
az iot device simulate --device-id
[--certificate-file-path]
[--da]
[--dtmi]
[--hub-name]
[--init-reported-properties]
[--key]
[--key-file-path]
[--login]
[--mc]
[--method-response-code]
[--method-response-payload]
[--mi]
[--pass]
[--properties]
[--proto {http, mqtt}]
[--receive-settle {abandon, complete, reject}]
[--resource-group]
기본 사용량(mqtt)
az iot device simulate -n {iothub_name} -d {device_id}
'dtmi:com:example:Thermostat;의 모델 ID를 등록하는 디바이스에 대한 기본 사용 연결 시 1'(mqtt)
az iot device simulate -n {iothub_name} -d {device_id} --model-id 'dtmi:com:example:Thermostat;1'
x509 인증을 사용한 디바이스의 기본 사용량(mqtt)
az iot device simulate -n {iothub_name} -d {device_id} --cp {certificate_file_path} --kp {key_file_path}
키 파일에 암호가 있는 x509 인증(mqtt)이 있는 디바이스에 대한 기본 사용
az iot device simulate -n {iothub_name} -d {device_id} --cp {certificate_file_path} --kp {key_file_path} --pass {passphrase}
혼합 속성 보내기(mqtt)
az iot device simulate -n {iothub_name} -d {device_id} --properties "myprop=myvalue;$.ct=application/json"
직접 메서드 응답 상태 코드 및 직접 메서드 응답 페이로드를 원시 json으로 보내기(mqtt에만 해당)
az iot device simulate -n {iothub_name} -d {device_id} --method-response-code 201 --method-response-payload '{"result":"Direct method successful"}'
직접 메서드 응답 상태 코드 및 직접 메서드 응답 페이로드를 로컬 파일에 대한 경로로 보내기(mqtt에만 해당)
az iot device simulate -n {iothub_name} -d {device_id} --method-response-code 201 --method-response-payload '../my_direct_method_payload.json'
디바이스 쌍 reported 속성의 초기 상태를 대상 디바이스에 대한 원시 json으로 보내기(mqtt에만 해당)
az iot device simulate -n {iothub_name} -d {device_id} --init-reported-properties '{"reported_prop_1":"val_1", "reported_prop_2":val_2}'
디바이스 쌍 reported 속성의 초기 상태를 대상 디바이스의 로컬 파일 경로로 보내기(mqtt에만 해당)
az iot device simulate -n {iothub_name} -d {device_id} --init-reported-properties '../my_device_twin_reported_properties.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
대상 디바이스 ID입니다.
인증서 파일의 경로입니다.
메시지 본문입니다. 텍스트 또는 원시 json을 제공합니다.
허브에 연결할 때 디바이스가 보고하는 디지털 트윈 모델 ID입니다. 자세한 내용은 https://docs.microsoft.com/en-us/azure/iot-develop/overview-iot-plug-and-play를 참조하세요.
IoT Hub 이름 또는 호스트 이름입니다. --login이 제공되지 않은 경우 필요합니다.
시뮬레이터를 실행할 때 대상 디바이스에 대해 보고된 쌍 속성의 초기 상태입니다. 선택적 매개 변수로, mqtt에 대해서만 지원됩니다.
디바이스에 사용할 대칭 키입니다. 대칭 키 및 기타 디바이스 인증 인수가 제공되면 대칭 키가 우선합니다.
키 파일의 경로입니다.
이 명령은 작업을 수행할 권한이 있는 엔터티 연결 문자열 지원합니다. "az login"을 통해 세션 로그인을 방지하는 데 사용합니다. 엔터티 연결 문자열 및 이름이 모두 제공되면 연결 문자열 우선 순위가 지정됩니다. --hub-name이 제공되지 않은 경우 필요합니다.
IoT Hub로 보낼 디바이스 메시지 수입니다.
디바이스에서 직접 메서드를 실행할 때 반환되는 상태 코드입니다. 선택적 매개 변수로, mqtt에 대해서만 지원됩니다.
직접 메서드가 디바이스에서 실행될 때 반환될 페이로드입니다. 파일 경로 또는 원시 json을 제공합니다. 선택적 매개 변수로, mqtt에 대해서만 지원됩니다.
디바이스-클라우드 메시지 간 지연 시간(초)입니다.
키 파일의 암호입니다.
다음과 같은 형식의 키-값 쌍의 메시지 속성 모음: a=b; c=d. mqtt 메시징의 경우 $.=value를 사용하여 시스템 속성을 보낼 수 있습니다. 예를 들어 $.cid=12345는 시스템 상관 관계 ID 속성을 설정합니다. 다른 시스템 속성 식별자 예제에는 콘텐츠 형식의 경우 $.ct, 메시지 ID의 경우 $.mid, 콘텐츠 인코딩의 경우 $.ce가 있습니다. http 메시징의 경우 - 애플리케이션 속성은 iothub-app-=value(예: iothub-app-myprop=myvalue)를 사용하여 전송됩니다. 시스템 속성은 일반적으로 iothub-correlationid와 같은 iothub 접두사를 사용하지만 콘텐츠 형식 및 콘텐츠 인코딩과 같은 예외가 있습니다.
디바이스-클라우드 메시지 프로토콜을 나타냅니다.
수신된 클라우드-디바이스 메시지를 해결하는 방법을 나타냅니다. HTTP에서만 지원됩니다.
리소스 그룹의 이름입니다. az configure --defaults group=<name>
을 사용하여 기본 그룹을 구성할 수 있습니다.
전역 매개 변수
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
오류만 표시하고, 경고를 표시하지 않습니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.
구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID
를 사용하여 기본 위치를 구성할 수 있습니다.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
미리 구성된 Blob Storage 컨테이너에 로컬 파일을 디바이스로 업로드합니다.
az iot device upload-file --content-type
--device-id
--file-path
[--hub-name]
[--login]
[--resource-group]
파일의 MIME 형식입니다.
대상 디바이스 ID입니다.
업로드할 파일 경로입니다.
IoT Hub 이름 또는 호스트 이름입니다. --login이 제공되지 않은 경우 필요합니다.
이 명령은 작업을 수행할 권한이 있는 엔터티 연결 문자열 지원합니다. "az login"을 통해 세션 로그인을 방지하는 데 사용합니다. 엔터티 연결 문자열 및 이름이 모두 제공되면 연결 문자열 우선 순위가 지정됩니다. --hub-name이 제공되지 않은 경우 필요합니다.
리소스 그룹의 이름입니다. az configure --defaults group=<name>
을 사용하여 기본 그룹을 구성할 수 있습니다.
전역 매개 변수
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
오류만 표시하고, 경고를 표시하지 않습니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.
구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID
를 사용하여 기본 위치를 구성할 수 있습니다.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
Azure CLI 피드백
Azure CLI은(는) 오픈 소스 프로젝트입니다. 다음 링크를 선택하여 피드백을 제공해 주세요.