az iot central device
참고
이 참조는 Azure CLI에 대 한 azure iot 확장의 일부 이며 버전 2.17.1 이상 이어야 합니다. Az iot central device 명령을 처음 실행할 때 확장이 자동으로 설치 됩니다. 확장에 대해 자세히 알아보세요.
IoT Central 장치를 관리 하 고 구성 합니다.
명령
| az iot central device command |
장치 명령을 실행 합니다. |
| az iot central device command history |
장치에 전송 된 최신 명령 요청 및 응답에 대 한 세부 정보를 가져옵니다. |
| az iot central device command run |
장치에서 명령을 실행 하 고 관련 된 응답을 확인 합니다. 는 명령이 수행할 수 있는 속성 업데이트를 모니터링 하지 않습니다. |
| az iot central device compute-device-key |
파생 된 장치 SAS 키를 생성 합니다. |
| az iot central device create |
IoT Central에서 장치를 만듭니다. |
| az iot central device delete |
IoT Central에서 장치를 삭제 합니다. |
| az iot central device manual-failback |
장치를 원래 IoT Hub로 다시 이동 하 여 이전에 실행 한 장애 조치 (failover) 명령을 되돌립니다. |
| az iot central device manual-failover |
여러 IoT Hub에서 장치의 수동 장애 조치 (failover)를 실행 하 여 장치 펌웨어에서 DPS를 사용 하 여 다른 IoT Hub에 다시 연결 하는 기능을 확인 합니다. |
| az iot central device registration-info |
IoT Central에서 장치에 대 한 등록 정보를 가져옵니다. |
| az iot central device show |
IoT Central에서 장치를 가져옵니다. |
| az iot central device show-credentials |
IoT Central에서 장치 자격 증명을 가져옵니다. |
| az iot central device twin |
IoT Central 장치 쌍 관리. |
| az iot central device twin show |
IoT Hub에서 장치 쌍을 가져옵니다. |
az iot central device compute-device-key
파생 된 장치 SAS 키를 생성 합니다.
그룹 수준 SAS 키에서 파생 된 장치 키를 생성 합니다.
az iot central device compute-device-key --device-id
--pk
예제
기본적인 사용 방법
az iot central device compute-device-key --pk {primaryKey} --device-id {deviceid}
필수 매개 변수
대상 장치의 ID 장치 세부 정보 페이지에서 커넥트 단추를 클릭 하 여 장치 Id를 찾을 수 있습니다.
Base64 형식으로 저장 된 기본 대칭 공유 액세스 키입니다.
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
오류만 표시하고, 경고를 표시하지 않습니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/를 참조하세요.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
az iot central device create
IoT Central에서 장치를 만듭니다.
az iot central device create --app-id
--device-id
[--api-version {1.0, preview}]
[--central-api-uri]
[--device-name]
[--simulated {false, true}]
[--template]
[--token]
예제
디바이스 만들기
az iot central device create --app-id {appid} --device-id {deviceid}
시뮬레이션된 디바이스 만들기
az iot central device create --app-id {appid} --device-id {deviceid} --template {devicetemplateid} --simulated
필수 매개 변수
관리 하려는 IoT Central 앱의 앱 ID입니다. 응용 프로그램의 [정보] 페이지에서 [도움말] 메뉴 아래에 앱 ID를 찾을 수 있습니다.
장치에 대 한 고유 식별자를 제공 합니다. ASCII 7 비트 영숫자 문자와 특정 특수 문자 (-)를 포함 하는 대/소문자를 구분 하는 문자열 (최대 128 자)입니다. + % _ # * ? ! ( ) , : = @ $ '.
선택적 매개 변수
요청 된 작업에 대 한 API 버전입니다.
응용 프로그램과 연결 된 IoT Central DNS 접미사입니다. 기본값은 azureiotcentral.com입니다.
사람이 읽을 수 있는 장치 이름입니다. 예: 냉장고.
이 플래그를 시뮬레이션 된 장치로 설정 하 IoT Central 하려는 경우이 플래그를 추가 합니다. --true 이면 템플릿이 필요 합니다.
중앙 템플릿 id입니다. 예: dtmi: ojpkindbz: modelDefinition: iild3tm_uo.
Azure CLI에 대해 인증 하지 않고 요청을 제출 하려면 올바른 사용자 토큰을 지정 하 여 요청을 인증할 수 있습니다. 요청의 일부로 키 유형을 지정 해야 합니다. https://aka.ms/iotcentraldocsapi에서 자세히 알아보세요.
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
오류만 표시하고, 경고를 표시하지 않습니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/를 참조하세요.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
az iot central device delete
IoT Central에서 장치를 삭제 합니다.
az iot central device delete --app-id
--device-id
[--api-version {1.0, preview}]
[--central-api-uri]
[--token]
예제
디바이스 삭제
az iot central device delete --app-id {appid} --device-id {deviceid}
필수 매개 변수
관리 하려는 IoT Central 앱의 앱 ID입니다. 응용 프로그램의 [정보] 페이지에서 [도움말] 메뉴 아래에 앱 ID를 찾을 수 있습니다.
대상 장치의 ID 장치 세부 정보 페이지에서 커넥트 단추를 클릭 하 여 장치 Id를 찾을 수 있습니다.
선택적 매개 변수
요청 된 작업에 대 한 API 버전입니다.
응용 프로그램과 연결 된 IoT Central DNS 접미사입니다. 기본값은 azureiotcentral.com입니다.
Azure CLI에 대해 인증 하지 않고 요청을 제출 하려면 올바른 사용자 토큰을 지정 하 여 요청을 인증할 수 있습니다. 요청의 일부로 키 유형을 지정 해야 합니다. https://aka.ms/iotcentraldocsapi에서 자세히 알아보세요.
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
오류만 표시하고, 경고를 표시하지 않습니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/를 참조하세요.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
az iot central device manual-failback
장치를 원래 IoT Hub로 다시 이동 하 여 이전에 실행 한 장애 조치 (failover) 명령을 되돌립니다.
고가용성에 대 한 자세한 내용은을 참조 https://github.com/iot-for-all/iot-central-high-availability-clients#readme 하세요.
az iot central device manual-failback --app-id
--device-id
[--central-api-uri]
[--token]
예제
장치를 원래 상태로 다시 전환 하 여 이전에 실행 한 장애 조치 (failover) 명령을 되돌립니다 IoT Hub
az iot central device manual-failback --app-id {appid} --device-id {deviceid}
필수 매개 변수
관리 하려는 IoT Central 앱의 앱 ID입니다. 응용 프로그램의 [정보] 페이지에서 [도움말] 메뉴 아래에 앱 ID를 찾을 수 있습니다.
대상 장치의 ID 장치 세부 정보 페이지에서 커넥트 단추를 클릭 하 여 장치 Id를 찾을 수 있습니다.
선택적 매개 변수
응용 프로그램과 연결 된 IoT Central DNS 접미사입니다. 기본값은 azureiotcentral.com입니다.
Azure CLI에 대해 인증 하지 않고 요청을 제출 하려면 올바른 사용자 토큰을 지정 하 여 요청을 인증할 수 있습니다. 요청의 일부로 키 유형을 지정 해야 합니다. https://aka.ms/iotcentraldocsapi에서 자세히 알아보세요.
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
오류만 표시하고, 경고를 표시하지 않습니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/를 참조하세요.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
az iot central device manual-failover
여러 IoT Hub에서 장치의 수동 장애 조치 (failover)를 실행 하 여 장치 펌웨어에서 DPS를 사용 하 여 다른 IoT Hub에 다시 연결 하는 기능을 확인 합니다.
고가용성 및 ttl (분)의 기본값에 대 한 자세한 내용은을 참조 https://github.com/iot-for-all/iot-central-high-availability-clients#readme 하세요.
az iot central device manual-failover --app-id
--device-id
[--central-api-uri]
[--token]
[--ttl]
예제
여러 IoT Hub에서 장치의 수동 장애 조치 (failover)를 실행 하 여 장치 펌웨어에서 DPS를 사용 하 여 다른 IoT Hub에 다시 연결 하는 기능을 확인 합니다.
az iot central device manual-failover --app-id {appid} --device-id {deviceid} --ttl-minutes {ttl_minutes}
필수 매개 변수
관리 하려는 IoT Central 앱의 앱 ID입니다. 응용 프로그램의 [정보] 페이지에서 [도움말] 메뉴 아래에 앱 ID를 찾을 수 있습니다.
대상 장치의 ID 장치 세부 정보 페이지에서 커넥트 단추를 클릭 하 여 장치 Id를 찾을 수 있습니다.
선택적 매개 변수
응용 프로그램과 연결 된 IoT Central DNS 접미사입니다. 기본값은 azureiotcentral.com입니다.
Azure CLI에 대해 인증 하지 않고 요청을 제출 하려면 올바른 사용자 토큰을 지정 하 여 요청을 인증할 수 있습니다. 요청의 일부로 키 유형을 지정 해야 합니다. https://aka.ms/iotcentraldocsapi에서 자세히 알아보세요.
양의 정수 장치를 원래 허브로 다시 이동 하는 TTL (분)입니다. 백 엔드에 기본값이 있습니다. 을 방문 하 여 최신 백엔드 기본 시간에 대 한 설명서를 참조 하세요 https://github.com/iot-for-all/iot-central-high-availability-clients#readme .
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
오류만 표시하고, 경고를 표시하지 않습니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/를 참조하세요.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
az iot central device registration-info
IoT Central에서 장치에 대 한 등록 정보를 가져옵니다.
참고: 장치 id를 지정 하지 않은 경우 앱에 많은 장치가 포함 되어 있으면이 명령을 반환 하는 데 상당한 시간이 걸릴 수 있습니다.
az iot central device registration-info --app-id
--device-id
[--central-api-uri]
[--token]
예제
지정 된 장치에서 등록 정보 가져오기
az iot central device registration-info --app-id {appid} --device-id {deviceid}
필수 매개 변수
관리 하려는 IoT Central 앱의 앱 ID입니다. 응용 프로그램의 [정보] 페이지에서 [도움말] 메뉴 아래에 앱 ID를 찾을 수 있습니다.
대상 장치의 ID 장치 세부 정보 페이지에서 커넥트 단추를 클릭 하 여 장치 Id를 찾을 수 있습니다.
선택적 매개 변수
응용 프로그램과 연결 된 IoT Central DNS 접미사입니다. 기본값은 azureiotcentral.com입니다.
Azure CLI에 대해 인증 하지 않고 요청을 제출 하려면 올바른 사용자 토큰을 지정 하 여 요청을 인증할 수 있습니다. 요청의 일부로 키 유형을 지정 해야 합니다. https://aka.ms/iotcentraldocsapi에서 자세히 알아보세요.
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
오류만 표시하고, 경고를 표시하지 않습니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/를 참조하세요.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
az iot central device show
IoT Central에서 장치를 가져옵니다.
az iot central device show --app-id
--device-id
[--api-version {1.0, preview}]
[--central-api-uri]
[--token]
예제
장치 가져오기
az iot central device show --app-id {appid} --device-id {deviceid}
필수 매개 변수
관리 하려는 IoT Central 앱의 앱 ID입니다. 응용 프로그램의 [정보] 페이지에서 [도움말] 메뉴 아래에 앱 ID를 찾을 수 있습니다.
대상 장치의 ID 장치 세부 정보 페이지에서 커넥트 단추를 클릭 하 여 장치 Id를 찾을 수 있습니다.
선택적 매개 변수
요청 된 작업에 대 한 API 버전입니다.
응용 프로그램과 연결 된 IoT Central DNS 접미사입니다. 기본값은 azureiotcentral.com입니다.
Azure CLI에 대해 인증 하지 않고 요청을 제출 하려면 올바른 사용자 토큰을 지정 하 여 요청을 인증할 수 있습니다. 요청의 일부로 키 유형을 지정 해야 합니다. https://aka.ms/iotcentraldocsapi에서 자세히 알아보세요.
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
오류만 표시하고, 경고를 표시하지 않습니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/를 참조하세요.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
az iot central device show-credentials
IoT Central에서 장치 자격 증명을 가져옵니다.
az iot central device show-credentials --app-id
--device-id
[--central-api-uri]
[--token]
예제
장치에 대 한 장치 자격 증명 가져오기
az iot central device show-credentials --app-id {appid} --device-id {deviceid}
필수 매개 변수
관리 하려는 IoT Central 앱의 앱 ID입니다. 응용 프로그램의 [정보] 페이지에서 [도움말] 메뉴 아래에 앱 ID를 찾을 수 있습니다.
대상 장치의 ID 장치 세부 정보 페이지에서 커넥트 단추를 클릭 하 여 장치 Id를 찾을 수 있습니다.
선택적 매개 변수
응용 프로그램과 연결 된 IoT Central DNS 접미사입니다. 기본값은 azureiotcentral.com입니다.
Azure CLI에 대해 인증 하지 않고 요청을 제출 하려면 올바른 사용자 토큰을 지정 하 여 요청을 인증할 수 있습니다. 요청의 일부로 키 유형을 지정 해야 합니다. https://aka.ms/iotcentraldocsapi에서 자세히 알아보세요.
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
오류만 표시하고, 경고를 표시하지 않습니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/를 참조하세요.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.