다음을 통해 공유


az iot central device

참고 항목

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

IoT Central 디바이스를 관리하고 구성합니다.

명령

Name Description 형식 상태
az iot central device attestation

IoT Central 디바이스 증명을 관리하고 구성합니다.

내선 번호 GA
az iot central device attestation create

개별 디바이스 증명을 만듭니다.

내선 번호 GA
az iot central device attestation delete

개별 디바이스 증명을 제거합니다.

내선 번호 GA
az iot central device attestation show

디바이스 증명을 가져옵니다.

내선 번호 GA
az iot central device attestation update

패치를 통해 개별 디바이스 증명을 업데이트합니다.

내선 번호 GA
az iot central device c2d-message

디바이스 클라우드-디바이스 메시징 명령을 실행합니다.

내선 번호 GA
az iot central device c2d-message purge

대상 디바이스에 대한 클라우드-디바이스 메시지 큐를 제거합니다.

내선 번호 GA
az iot central device command

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

내선 번호 GA
az iot central device command history

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

내선 번호 GA
az iot central device command run

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

내선 번호 GA
az iot central device compute-device-key

파생 디바이스 SAS 키를 생성합니다.

내선 번호 GA
az iot central device create

IoT Central에서 디바이스를 만듭니다.

내선 번호 GA
az iot central device delete

IoT Central에서 디바이스를 삭제합니다.

내선 번호 GA
az iot central device edge

IoT Central 에지 디바이스를 관리하고 구성합니다.

내선 번호 GA
az iot central device edge children

IoT Edge 디바이스 자식 디바이스를 관리합니다.

내선 번호 GA
az iot central device edge children add

대상 에지 디바이스에 디바이스를 자식으로 추가합니다.

내선 번호 프리뷰
az iot central device edge children list

IoT Edge 디바이스의 자식 목록을 가져옵니다.

내선 번호 GA
az iot central device edge children remove

대상 에지 디바이스에서 자식 디바이스를 제거합니다.

내선 번호 프리뷰
az iot central device edge manifest

IoT Edge 디바이스 매니페스트를 관리합니다.

내선 번호 프리뷰
az iot central device edge manifest show

지정된 IoT Edge 디바이스에 연결된 배포 매니페스트를 가져옵니다.

내선 번호 프리뷰
az iot central device edge module

IoT Edge 디바이스 모듈을 관리합니다.

내선 번호 프리뷰
az iot central device edge module list

IoT Edge 디바이스에서 모듈 목록을 가져옵니다.

내선 번호 프리뷰
az iot central device edge module restart

IoT Edge 디바이스에서 모듈을 다시 시작합니다.

내선 번호 프리뷰
az iot central device edge module show

IoT Edge 디바이스에서 모듈을 가져옵니다.

내선 번호 프리뷰
az iot central device list

IoT Central 애플리케이션에 대한 디바이스 목록을 가져옵니다.

내선 번호 GA
az iot central device list-components

디바이스에 있는 구성 요소를 나열합니다.

내선 번호 GA
az iot central device list-modules

디바이스에 있는 모듈을 나열합니다.

내선 번호 GA
az iot central device manual-failback

디바이스를 원래 IoT Hub로 다시 이동하여 이전에 실행한 장애 조치(failover) 명령을 되돌려줍니다.

내선 번호 GA
az iot central device manual-failover

여러 IoT Hub에서 디바이스의 수동 장애 조치(failover)를 실행하여 DPS를 사용하여 다른 IoT Hub에 다시 연결하는 디바이스 펌웨어의 기능의 유효성을 검사합니다.

내선 번호 GA
az iot central device registration-info

IoT Central에서 디바이스에 대한 등록 정보를 가져옵니다.

내선 번호 GA
az iot central device show

IoT Central에서 디바이스를 가져옵니다.

내선 번호 GA
az iot central device show-credentials

IoT Central에서 디바이스 자격 증명을 가져옵니다.

내선 번호 GA
az iot central device telemetry

IoT Central 디바이스 마지막 원격 분석 값을 쿼리합니다.

내선 번호 GA
az iot central device telemetry show

디바이스에서 마지막 원격 분석 값을 가져옵니다.

내선 번호 GA
az iot central device twin

IoT Central 디바이스 쌍을 관리합니다.

내선 번호 GA
az iot central device twin replace

디바이스, 디바이스 구성 요소 또는 디바이스 모듈 또는 디바이스 모듈 구성 요소의 쓰기 가능한 속성 값을 바꿉니다.

내선 번호 GA
az iot central device twin show

디바이스, 디바이스 구성 요소, 디바이스 모듈 또는 디바이스 모듈 구성 요소의 모든 속성 값을 가져옵니다.

내선 번호 GA
az iot central device twin update

디바이스, 디바이스 구성 요소, 디바이스 모듈 또는 디바이스 모듈 구성 요소의 쓰기 가능한 속성 값을 업데이트합니다.

내선 번호 GA
az iot central device update

IoT Central에서 디바이스를 업데이트합니다.

내선 번호 GA

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 형식으로 저장된 기본 대칭 공유 액세스 키입니다.

전역 매개 변수
--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 create

IoT Central에서 디바이스를 만듭니다.

az iot central device create --app-id
                             --device-id
                             [--api-version {2022-06-30-preview, 2022-07-31}]
                             [--central-api-uri]
                             [--device-name]
                             [--organizations]
                             [--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_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
--device-name

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

--organizations --orgs

지정된 조직에 디바이스를 할당합니다. 조직 ID의 쉼표로 구분된 목록입니다. 지원되는 최소 버전: 1.1-preview.

--simulated

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

허용되는 값: false, true
Default value: False
--template

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

--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 delete

IoT Central에서 디바이스를 삭제합니다.

az iot central device delete --app-id
                             --device-id
                             [--api-version {2022-06-30-preview, 2022-07-31}]
                             [--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_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
--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 list

IoT Central 애플리케이션에 대한 디바이스 목록을 가져옵니다.

az iot central device list --app-id
                           [--api-version {2022-06-30-preview, 2022-07-31}]
                           [--central-api-uri]
                           [--edge-only]
                           [--token]

예제

애플리케이션의 모든 디바이스를 디바이스 ID별로 정렬하여 나열(기본값)

az iot central device list --app-id {appid}

필수 매개 변수

--app-id -n

관리하려는 IoT Central 앱의 앱 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
--edge-only -e

IoT Edge 디바이스만 나열합니다.

Default value: False
--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 list-components

디바이스에 있는 구성 요소를 나열합니다.

az iot central device list-components --app-id
                                      --device-id
                                      [--api-version {2022-06-30-preview, 2022-07-31}]
                                      [--central-api-uri]
                                      [--mn]
                                      [--token]

예제

디바이스에 있는 구성 요소 나열

az iot central device list-components --app-id {appid} --device-id {deviceid}

디바이스 모듈에 있는 구성 요소 나열

az iot central device list-components --app-id {appid} --module-name {modulename} --device-id {deviceid}

필수 매개 변수

--app-id -n

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

--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
--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 list-modules

디바이스에 있는 모듈을 나열합니다.

az iot central device list-modules --app-id
                                   --device-id
                                   [--api-version {2022-06-30-preview, 2022-07-31}]
                                   [--central-api-uri]
                                   [--token]

예제

디바이스에 있는 모듈 나열

az iot central device list-modules --app-id {appid} --device-id {deviceid}

필수 매개 변수

--app-id -n

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

--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
--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 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
                                      [--api-version {2022-06-30-preview, 2022-07-31}]
                                      [--central-api-uri]
                                      [--token]

예제

디바이스를 원래 IoT Hub로 다시 이동하여 이전에 실행한 장애 조치(failover) 명령을 되돌려줍니다.

az iot central device manual-failback --app-id {appid} --device-id {deviceid}

필수 매개 변수

--app-id -n

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

--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
--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 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
                                      [--api-version {2022-06-30-preview, 2022-07-31}]
                                      [--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를 찾을 수 있습니다.

선택적 매개 변수

--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
--token

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

--ttl --ttl-minutes

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

전역 매개 변수
--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 registration-info

IoT Central에서 디바이스에 대한 등록 정보를 가져옵니다.

참고: 이 명령은 디바이스 ID가 지정되지 않고 앱에 많은 디바이스가 포함된 경우 반환하는 데 상당한 시간이 걸릴 수 있습니다.

az iot central device registration-info --app-id
                                        --device-id
                                        [--api-version {2022-06-30-preview, 2022-07-31}]
                                        [--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를 찾을 수 있습니다.

선택적 매개 변수

--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
--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 show

IoT Central에서 디바이스를 가져옵니다.

az iot central device show --app-id
                           --device-id
                           [--api-version {2022-06-30-preview, 2022-07-31}]
                           [--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_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
--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 show-credentials

IoT Central에서 디바이스 자격 증명을 가져옵니다.

az iot central device show-credentials --app-id
                                       --device-id
                                       [--api-version {2022-06-30-preview, 2022-07-31}]
                                       [--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를 찾을 수 있습니다.

선택적 매개 변수

--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
--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 update

IoT Central에서 디바이스를 업데이트합니다.

디바이스의 속성을 변경할 수 있습니다. "displayName", "template", "simulated", "enabled" 및 "organizations". 디바이스 ID는 변경할 수 없습니다.

az iot central device update --app-id
                             --device-id
                             [--api-version {2022-06-30-preview, 2022-07-31}]
                             [--central-api-uri]
                             [--device-name]
                             [--enable {false, true}]
                             [--organizations]
                             [--simulated {false, true}]
                             [--template]
                             [--token]

예제

디바이스 표시 이름 업데이트

az iot central device update --app-id {appid} --device-id {deviceid} --device-name {deviceName}

시뮬레이션된 디바이스를 실제 디바이스로 전환

az iot central device update --app-id {appid} --device-id {deviceid} --simulated false

디바이스에 대한 조직 업데이트

az iot central device update --app-id {appid} --device-id {deviceid} --organizations {organizations}

디바이스 사용 안 함

az iot central device update --app-id {appid} --device-id {deviceid} --enable false

필수 매개 변수

--app-id -n

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

--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
--device-name

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

--enable

IoT Central에서 디바이스를 사용하거나 사용하지 않도록 설정하려면 이 플래그를 추가합니다.

허용되는 값: false, true
--organizations --orgs

지정된 조직에 디바이스를 할당합니다. 조직 ID의 쉼표로 구분된 목록입니다. 지원되는 최소 버전: 1.1-preview.

--simulated

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

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

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

--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를 사용합니다.