az iot central device command

참조

참고 항목

이 참조는 Azure CLI(버전 2.46.0 이상)에 대한 azure-iot 확장의 일부입니다. az iot central device command 명령을 처음 실행할 때 확장이 자동으로 설치됩니다. 확장 프로그램에 대해 자세히 알아보세요.

디바이스 명령을 실행합니다.

명령

Name	Description	형식	상태
az iot central device command history	디바이스로 전송된 최신 명령 요청 및 응답에 대한 세부 정보를 가져옵니다.	내선 번호	GA
az iot central device command run	디바이스에서 명령을 실행하고 연결된 응답을 봅니다. 명령이 수행할 수 있는 속성 업데이트를 모니터링하지 않습니다.	내선 번호	GA

az iot central device command history

디바이스로 전송된 최신 명령 요청 및 응답에 대한 세부 정보를 가져옵니다.

IoT Central에서 디바이스로 전송된 가장 최근의 명령 요청 및 응답을 나열합니다. 명령 실행의 결과로 디바이스 속성에 대해 디바이스가 수행하는 모든 업데이트는 응답에 포함되지 않습니다.

az iot central device command history --app-id
                                      --cn
                                      --device-id
                                      [--api-version {2022-06-30-preview, 2022-07-31}]
                                      [--central-api-uri]
                                      [--co]
                                      [--interface-id]
                                      [--mn]
                                      [--token]

예제

명령 응답 표시

az iot central device command history --app-id {appid} --device-id {deviceid} --interface-id {interfaceid} --command-name {commandname}

구성 요소 명령 응답 표시

az iot central device command history --app-id {appid} --device-id {deviceid} --component-name {componentname} --command-name {commandname}

모듈 구성 요소 명령 응답 표시

az iot central device command history --app-id {appid} --device-id {deviceid} --module-name {modulename} --component-name {componentname} --command-name {commandname}

필수 매개 변수

--app-id -n

관리하려는 IoT Central 앱의 앱 ID입니다. 도움말 메뉴 아래의 애플리케이션에 대한 "정보" 페이지에서 앱 ID를 찾을 수 있습니다.

--cn --command-name

디바이스 템플릿에 지정된 명령 이름입니다. 명령 이름은 명령의 표시 이름과 다를 수 있습니다.

--device-id -d

대상 디바이스의 디바이스 ID입니다. 디바이스 세부 정보 페이지에서 연결 단추를 클릭하여 디바이스 ID를 찾을 수 있습니다.

선택적 매개 변수

--api-version --av

사용되지 않음

'api_version' 인수는 더 이상 사용되지 않으며 향후 릴리스에서 제거될 예정입니다.

이 명령 매개 변수는 더 이상 사용되지 않으며 무시됩니다. 이후 릴리스에서는 최신 GA 버전의 IoT Central API만 지원합니다. API가 아직 GA가 아닌 경우 최신 미리 보기 버전을 호출합니다.

허용되는 값: 2022-06-30-preview, 2022-07-31

Default value: 2022-07-31

--central-api-uri --central-dns-suffix

애플리케이션과 연결된 IoT Central DNS 접미사입니다.

Default value: azureiotcentral.com

--co --component-name

디바이스 구성 요소의 이름입니다.

--interface-id -i

디바이스 템플릿에 지정된 인터페이스/구성 요소의 이름입니다. 디바이스 템플릿으로 이동하여 해당 디바이스 기능에서 인터페이스/구성 요소 ID를 확인하여 찾을 수 있습니다.

--mn --module-name

디바이스 모듈의 이름입니다.

--token

Azure CLI에 대해 인증하지 않고 요청을 제출하려는 경우 유효한 사용자 토큰을 지정하여 요청을 인증할 수 있습니다. 요청의 일부로 키 유형을 지정해야 합니다. https://aka.ms/iotcentraldocsapi에서 자세히 알아보세요.

전역 매개 변수

--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc

Default value: json

--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 위치를 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az iot central device command run

디바이스에서 명령을 실행하고 연결된 응답을 봅니다. 명령이 수행할 수 있는 속성 업데이트를 모니터링하지 않습니다.

--content는 인라인 json 또는 파일 경로일 수 있습니다.

az iot central device command run --app-id
                                  --cn
                                  --content
                                  --device-id
                                  [--api-version {2022-06-30-preview, 2022-07-31}]
                                  [--central-api-uri]
                                  [--co]
                                  [--interface-id]
                                  [--mn]
                                  [--token]

예제

인라인 페이로드를 사용하여 명령을 실행합니다. 페이로드는 json 문자열의 "요청" 아래에 있어야 합니다.

az iot central device command run --app-id {appid} --device-id {deviceid} --interface-id {interfaceid} --command-name {commandname} --content '{"request": {payload}}'

json 페이로드 경로가 있는 짧은 실행 명령입니다.

az iot central device command run -n {appid} -d {deviceid} -i {interfaceid} --cn {commandname} -k {payload_file_path}

구성 요소 명령을 실행합니다.

az iot central device command run -n {appid} -d {deviceid} --co {componentname} --cn {commandname} -k {payload}

모듈 구성 요소 명령을 실행합니다.

az iot central device command run -n {appid} -d {deviceid} --mn {modulename} --co {componentname} --cn {commandname} -k {payload}

필수 매개 변수

--app-id -n

관리하려는 IoT Central 앱의 앱 ID입니다. 도움말 메뉴 아래의 애플리케이션에 대한 "정보" 페이지에서 앱 ID를 찾을 수 있습니다.

--cn --command-name

디바이스 템플릿에 지정된 명령 이름입니다. 명령 이름은 명령의 표시 이름과 다를 수 있습니다.

--content -k

요청에 대한 구성입니다. JSON 파일 또는 원시 문자열화된 JSON에 대한 경로를 제공합니다. [파일 경로 예제: ./path/to/file.json] [Stringified JSON 예제: {'a': 'b'}].

--device-id -d

대상 디바이스의 디바이스 ID입니다. 디바이스 세부 정보 페이지에서 연결 단추를 클릭하여 디바이스 ID를 찾을 수 있습니다.

선택적 매개 변수

--api-version --av

사용되지 않음

'api_version' 인수는 더 이상 사용되지 않으며 향후 릴리스에서 제거될 예정입니다.

허용되는 값: 2022-06-30-preview, 2022-07-31

Default value: 2022-07-31

--central-api-uri --central-dns-suffix

애플리케이션과 연결된 IoT Central DNS 접미사입니다.

Default value: azureiotcentral.com

--co --component-name

디바이스 구성 요소의 이름입니다.

--interface-id -i

--mn --module-name

디바이스 모듈의 이름입니다.

--token

전역 매개 변수

--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc

Default value: json

--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 위치를 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

다음을 통해 공유

az iot central device command

명령

az iot central device command history

예제

필수 매개 변수

선택적 매개 변수

az iot central device command run

예제

필수 매개 변수

선택적 매개 변수

추가 리소스