az iot central device

참고

이 참조는 Azure CLI 대한 azure-iot 확장의 일부이며 버전 2.0.70 이상이 필요합니다. 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
                             [--central-api-uri]
                             [--device-name]
                             [--instance-of]
                             [--simulated {false, true}]
                             [--token]

예제

디바이스 만들기

az iot central device create --app-id {appid} --device-id {deviceid}

시뮬레이션된 디바이스 만들기

az iot central device create --app-id {appid} --device-id {deviceid} --instance-of {devicetemplateid} --simulated

필수 매개 변수

--app-id -n

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

--device-id -d

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

선택적 매개 변수

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

애플리케이션과 연결된 IoT Central DNS 접미사입니다. 기본값은 azureiotcentral.com.

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

사람이 읽을 수 있는 디바이스 이름입니다. 예: 2018년 10월

--instance-of

중앙 템플릿 ID. 예: urn:o jpkindbz:modelDefinition:iild3tm_uo.

--simulated

IoT Central 시뮬레이션된 디바이스로 설정하려면 이 플래그를 추가합니다. --true 인 경우에는 instance가 필요 합니다.

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

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

az iot central device delete

IoT Central에서 장치를 삭제 합니다.

az iot central device delete --app-id
                             --device-id
                             [--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를 찾을 수 있습니다.

선택적 매개 변수

--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-minutes의 고가용성 및 기본값에 대한 자세한 내용은 를 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
                           [--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를 찾을 수 있습니다.

선택적 매개 변수

--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에서 자세히 알아보세요.