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}

필수 매개 변수

--device-id -d

대상 장치의 ID 장치 세부 정보 페이지에서 커넥트 단추를 클릭 하 여 장치 Id를 찾을 수 있습니다.

--pk --primary-key

Base64 형식으로 저장 된 기본 대칭 공유 액세스 키입니다.

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

필수 매개 변수

--app-id -n

관리 하려는 IoT Central 앱의 앱 ID입니다. 응용 프로그램의 [정보] 페이지에서 [도움말] 메뉴 아래에 앱 ID를 찾을 수 있습니다.

--device-id -d

장치에 대 한 고유 식별자를 제공 합니다. ASCII 7 비트 영숫자 문자와 특정 특수 문자 (-)를 포함 하는 대/소문자를 구분 하는 문자열 (최대 128 자)입니다. + % _ # * ? ! ( ) , : = @ $ '.

선택적 매개 변수

--api-version --av

요청 된 작업에 대 한 API 버전입니다.

허용되는 값: 1.0, preview
기본값: 1.0
--central-api-uri --central-dns-suffix

응용 프로그램과 연결 된 IoT Central DNS 접미사입니다. 기본값은 azureiotcentral.com입니다.

기본값: azureiotcentral.com
--device-name

사람이 읽을 수 있는 장치 이름입니다. 예: 냉장고.

--simulated

이 플래그를 시뮬레이션 된 장치로 설정 하 IoT Central 하려는 경우이 플래그를 추가 합니다. --true 이면 템플릿이 필요 합니다.

허용되는 값: false, true
--template

중앙 템플릿 id입니다. 예: dtmi: ojpkindbz: modelDefinition: iild3tm_uo.

--token

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

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}

필수 매개 변수

--app-id -n

관리 하려는 IoT Central 앱의 앱 ID입니다. 응용 프로그램의 [정보] 페이지에서 [도움말] 메뉴 아래에 앱 ID를 찾을 수 있습니다.

--device-id -d

대상 장치의 ID 장치 세부 정보 페이지에서 커넥트 단추를 클릭 하 여 장치 Id를 찾을 수 있습니다.

선택적 매개 변수

--api-version --av

요청 된 작업에 대 한 API 버전입니다.

허용되는 값: 1.0, preview
기본값: 1.0
--central-api-uri --central-dns-suffix

응용 프로그램과 연결 된 IoT Central DNS 접미사입니다. 기본값은 azureiotcentral.com입니다.

기본값: azureiotcentral.com
--token

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

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}

필수 매개 변수

--app-id -n

관리 하려는 IoT Central 앱의 앱 ID입니다. 응용 프로그램의 [정보] 페이지에서 [도움말] 메뉴 아래에 앱 ID를 찾을 수 있습니다.

--device-id -d

대상 장치의 ID 장치 세부 정보 페이지에서 커넥트 단추를 클릭 하 여 장치 Id를 찾을 수 있습니다.

선택적 매개 변수

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

응용 프로그램과 연결 된 IoT Central DNS 접미사입니다. 기본값은 azureiotcentral.com입니다.

기본값: azureiotcentral.com
--token

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

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}

필수 매개 변수

--app-id -n

관리 하려는 IoT Central 앱의 앱 ID입니다. 응용 프로그램의 [정보] 페이지에서 [도움말] 메뉴 아래에 앱 ID를 찾을 수 있습니다.

--device-id -d

대상 장치의 ID 장치 세부 정보 페이지에서 커넥트 단추를 클릭 하 여 장치 Id를 찾을 수 있습니다.

선택적 매개 변수

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

응용 프로그램과 연결 된 IoT Central DNS 접미사입니다. 기본값은 azureiotcentral.com입니다.

기본값: azureiotcentral.com
--token

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

--ttl --ttl-minutes

양의 정수 장치를 원래 허브로 다시 이동 하는 TTL (분)입니다. 백 엔드에 기본값이 있습니다. 을 방문 하 여 최신 백엔드 기본 시간에 대 한 설명서를 참조 하세요 https://github.com/iot-for-all/iot-central-high-availability-clients#readme .

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}

필수 매개 변수

--app-id -n

관리 하려는 IoT Central 앱의 앱 ID입니다. 응용 프로그램의 [정보] 페이지에서 [도움말] 메뉴 아래에 앱 ID를 찾을 수 있습니다.

--device-id -d

대상 장치의 ID 장치 세부 정보 페이지에서 커넥트 단추를 클릭 하 여 장치 Id를 찾을 수 있습니다.

선택적 매개 변수

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

응용 프로그램과 연결 된 IoT Central DNS 접미사입니다. 기본값은 azureiotcentral.com입니다.

기본값: azureiotcentral.com
--token

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

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}

필수 매개 변수

--app-id -n

관리 하려는 IoT Central 앱의 앱 ID입니다. 응용 프로그램의 [정보] 페이지에서 [도움말] 메뉴 아래에 앱 ID를 찾을 수 있습니다.

--device-id -d

대상 장치의 ID 장치 세부 정보 페이지에서 커넥트 단추를 클릭 하 여 장치 Id를 찾을 수 있습니다.

선택적 매개 변수

--api-version --av

요청 된 작업에 대 한 API 버전입니다.

허용되는 값: 1.0, preview
기본값: 1.0
--central-api-uri --central-dns-suffix

응용 프로그램과 연결 된 IoT Central DNS 접미사입니다. 기본값은 azureiotcentral.com입니다.

기본값: azureiotcentral.com
--token

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

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}

필수 매개 변수

--app-id -n

관리 하려는 IoT Central 앱의 앱 ID입니다. 응용 프로그램의 [정보] 페이지에서 [도움말] 메뉴 아래에 앱 ID를 찾을 수 있습니다.

--device-id -d

대상 장치의 ID 장치 세부 정보 페이지에서 커넥트 단추를 클릭 하 여 장치 Id를 찾을 수 있습니다.

선택적 매개 변수

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

응용 프로그램과 연결 된 IoT Central DNS 접미사입니다. 기본값은 azureiotcentral.com입니다.

기본값: azureiotcentral.com
--token

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