az iot central device command

참고 항목

이 참조는 Azure CLI(버전 2.37.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

기본값: 2022-07-31

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

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

기본값: 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

기본값: 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' 인수는 더 이상 사용되지 않으며 향후 릴리스에서 제거될 예정입니다.

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

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

기본값: 2022-07-31

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

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

기본값: 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

기본값: json

--query

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

--subscription

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

--verbose

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