az iot central device

Note

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

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

명령

Name	Description	형식	상태
az iot central device attestation	IoT Central 디바이스 증명을 관리하고 구성합니다.	Extension	GA
az iot central device attestation create	개별 디바이스 증명을 만듭니다.	Extension	GA
az iot central device attestation delete	개별 디바이스 증명을 제거합니다.	Extension	GA
az iot central device attestation show	디바이스 증명을 가져옵니다.	Extension	GA
az iot central device attestation update	패치를 통해 개별 디바이스 증명을 업데이트합니다.	Extension	GA
az iot central device c2d-message	디바이스 클라우드-디바이스 메시징 명령을 실행합니다.	Extension	GA
az iot central device c2d-message purge	대상 디바이스에 대한 클라우드-디바이스 메시지 큐를 제거합니다.	Extension	GA
az iot central device command	디바이스 명령을 실행합니다.	Extension	GA
az iot central device command history	디바이스로 전송된 최신 명령 요청 및 응답에 대한 세부 정보를 가져옵니다.	Extension	GA
az iot central device command run	디바이스에서 명령을 실행하고 연결된 응답을 봅니다. 명령이 수행할 수 있는 속성 업데이트를 모니터링하지 않습니다.	Extension	GA
az iot central device compute-device-key	파생 디바이스 SAS 키를 생성합니다.	Extension	GA
az iot central device create	IoT Central에서 디바이스를 만듭니다.	Extension	GA
az iot central device delete	IoT Central에서 디바이스를 삭제합니다.	Extension	GA
az iot central device edge	IoT Central 에지 디바이스를 관리하고 구성합니다.	Extension	GA
az iot central device edge children	IoT Edge 디바이스 자식 디바이스를 관리합니다.	Extension	GA
az iot central device edge children add	대상 에지 디바이스에 디바이스를 자식으로 추가합니다.	Extension	Preview
az iot central device edge children list	IoT Edge 디바이스의 자식 목록을 가져옵니다.	Extension	GA
az iot central device edge children remove	대상 에지 디바이스에서 자식 디바이스를 제거합니다.	Extension	Preview
az iot central device edge manifest	IoT Edge 디바이스 매니페스트를 관리합니다.	Extension	Preview
az iot central device edge manifest show	지정된 IoT Edge 디바이스에 연결된 배포 매니페스트를 가져옵니다.	Extension	Preview
az iot central device edge module	IoT Edge 디바이스 모듈을 관리합니다.	Extension	Preview
az iot central device edge module list	IoT Edge 디바이스에서 모듈 목록을 가져옵니다.	Extension	Preview
az iot central device edge module restart	IoT Edge 디바이스에서 모듈을 다시 시작합니다.	Extension	Preview
az iot central device edge module show	IoT Edge 디바이스에서 모듈을 가져옵니다.	Extension	Preview
az iot central device list	IoT Central 애플리케이션에 대한 디바이스 목록을 가져옵니다.	Extension	GA
az iot central device list-components	디바이스에 있는 구성 요소를 나열합니다.	Extension	GA
az iot central device list-modules	디바이스에 있는 모듈을 나열합니다.	Extension	GA
az iot central device manual-failback	디바이스를 원래 IoT Hub로 다시 이동하여 이전에 실행한 장애 조치(failover) 명령을 되돌려줍니다.	Extension	GA
az iot central device manual-failover	여러 IoT Hub에서 디바이스의 수동 장애 조치(failover)를 실행하여 DPS를 사용하여 다른 IoT Hub에 다시 연결하는 디바이스 펌웨어의 기능의 유효성을 검사합니다.	Extension	GA
az iot central device registration-info	IoT Central에서 디바이스에 대한 등록 정보를 가져옵니다.	Extension	GA
az iot central device show	IoT Central에서 디바이스를 가져옵니다.	Extension	GA
az iot central device show-credentials	IoT Central에서 디바이스 자격 증명을 가져옵니다.	Extension	GA
az iot central device telemetry	IoT Central 디바이스 마지막 원격 분석 값을 쿼리합니다.	Extension	GA
az iot central device telemetry show	디바이스에서 마지막 원격 분석 값을 가져옵니다.	Extension	GA
az iot central device twin	IoT Central 디바이스 쌍을 관리합니다.	Extension	GA
az iot central device twin replace	디바이스, 디바이스 구성 요소 또는 디바이스 모듈 또는 디바이스 모듈 구성 요소의 쓰기 가능한 속성 값을 바꿉니다.	Extension	GA
az iot central device twin show	디바이스, 디바이스 구성 요소, 디바이스 모듈 또는 디바이스 모듈 구성 요소의 모든 속성 값을 가져옵니다.	Extension	GA
az iot central device twin update	디바이스, 디바이스 구성 요소, 디바이스 모듈 또는 디바이스 모듈 구성 요소의 쓰기 가능한 속성 값을 업데이트합니다.	Extension	GA
az iot central device update	IoT Central에서 디바이스를 업데이트합니다.	Extension	GA

az iot central device compute-device-key

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

그룹 수준 SAS 키에서 파생된 디바이스 키를 생성합니다.

az iot central device compute-device-key --device-id
                                         --pk --primary-key

예제

기본 사용법

az iot central device compute-device-key --pk {primaryKey} --device-id {deviceid}

필수 매개 변수

--device-id -d

대상 디바이스의 디바이스 ID입니다. 디바이스 세부 정보 페이지에서 연결 단추를 클릭하여 디바이스 ID를 찾을 수 있습니다.

--pk --primary-key

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

전역 매개 변수

--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성	값
Default value:	False

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

속성	값
Default value:	False

--output -o

출력 형식

속성	값
Default value:	json
허용되는 값:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

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

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성	값
Default value:	False

az iot central device create

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

az iot central device create --app-id
                             --device-id
                             [--api-version --av {2022-06-30-preview, 2022-07-31}]
                             [--central-api-uri --central-dns-suffix]
                             [--device-name]
                             [--organizations --orgs]
                             [--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가 아닌 경우 최신 미리 보기 버전을 호출합니다.

속성	값
Default value:	2022-07-31
허용되는 값:	2022-06-30-preview, 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인 경우 필요합니다.

속성	값
Default value:	False
허용되는 값:	false, true

--template

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

--token

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

전역 매개 변수

--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성	값
Default value:	False

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

속성	값
Default value:	False

--output -o

출력 형식

속성	값
Default value:	json
허용되는 값:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

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

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성	값
Default value:	False

az iot central device delete

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

az iot central device delete --app-id
                             --device-id
                             [--api-version --av {2022-06-30-preview, 2022-07-31}]
                             [--central-api-uri --central-dns-suffix]
                             [--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' 인수는 더 이상 사용되지 않으며 향후 릴리스에서 제거될 예정입니다.

속성	값
Default value:	2022-07-31
허용되는 값:	2022-06-30-preview, 2022-07-31

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

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

속성	값
Default value:	azureiotcentral.com

--token

전역 매개 변수

--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성	값
Default value:	False

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

속성	값
Default value:	False

--output -o

출력 형식

속성	값
Default value:	json
허용되는 값:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

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

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성	값
Default value:	False

az iot central device list

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

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

예제

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

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

필수 매개 변수

--app-id -n

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

선택적 매개 변수

다음 매개 변수는 선택 사항이지만 컨텍스트에 따라 명령이 성공적으로 실행되려면 하나 이상의 매개 변수가 필요할 수 있습니다.

--api-version --av

사용되지 않음

'api_version' 인수는 더 이상 사용되지 않으며 향후 릴리스에서 제거될 예정입니다.

속성	값
Default value:	2022-07-31
허용되는 값:	2022-06-30-preview, 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

전역 매개 변수

--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성	값
Default value:	False

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

속성	값
Default value:	False

--output -o

출력 형식

속성	값
Default value:	json
허용되는 값:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

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

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성	값
Default value:	False

az iot central device list-components

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

az iot central device list-components --app-id
                                      --device-id
                                      [--api-version --av {2022-06-30-preview, 2022-07-31}]
                                      [--central-api-uri --central-dns-suffix]
                                      [--mn --module-name]
                                      [--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' 인수는 더 이상 사용되지 않으며 향후 릴리스에서 제거될 예정입니다.

속성	값
Default value:	2022-07-31
허용되는 값:	2022-06-30-preview, 2022-07-31

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

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

속성	값
Default value:	azureiotcentral.com

--mn --module-name

디바이스 모듈의 이름입니다.

--token

전역 매개 변수

--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성	값
Default value:	False

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

속성	값
Default value:	False

--output -o

출력 형식

속성	값
Default value:	json
허용되는 값:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

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

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성	값
Default value:	False

az iot central device list-modules

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

az iot central device list-modules --app-id
                                   --device-id
                                   [--api-version --av {2022-06-30-preview, 2022-07-31}]
                                   [--central-api-uri --central-dns-suffix]
                                   [--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' 인수는 더 이상 사용되지 않으며 향후 릴리스에서 제거될 예정입니다.

속성	값
Default value:	2022-07-31
허용되는 값:	2022-06-30-preview, 2022-07-31

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

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

속성	값
Default value:	azureiotcentral.com

--token

전역 매개 변수

--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성	값
Default value:	False

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

속성	값
Default value:	False

--output -o

출력 형식

속성	값
Default value:	json
허용되는 값:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

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

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성	값
Default value:	False

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 --av {2022-06-30-preview, 2022-07-31}]
                                      [--central-api-uri --central-dns-suffix]
                                      [--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' 인수는 더 이상 사용되지 않으며 향후 릴리스에서 제거될 예정입니다.

속성	값
Default value:	2022-07-31
허용되는 값:	2022-06-30-preview, 2022-07-31

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

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

속성	값
Default value:	azureiotcentral.com

--token

전역 매개 변수

--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성	값
Default value:	False

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

속성	값
Default value:	False

--output -o

출력 형식

속성	값
Default value:	json
허용되는 값:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

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

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성	값
Default value:	False

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 --av {2022-06-30-preview, 2022-07-31}]
                                      [--central-api-uri --central-dns-suffix]
                                      [--token]
                                      [--ttl --ttl-minutes]

예제

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

속성	값
Default value:	2022-07-31
허용되는 값:	2022-06-30-preview, 2022-07-31

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

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

속성	값
Default value:	azureiotcentral.com

--token

--ttl --ttl-minutes

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

전역 매개 변수

--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성	값
Default value:	False

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

속성	값
Default value:	False

--output -o

출력 형식

속성	값
Default value:	json
허용되는 값:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

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

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성	값
Default value:	False

az iot central device registration-info

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

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

az iot central device registration-info --app-id
                                        --device-id
                                        [--api-version --av {2022-06-30-preview, 2022-07-31}]
                                        [--central-api-uri --central-dns-suffix]
                                        [--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' 인수는 더 이상 사용되지 않으며 향후 릴리스에서 제거될 예정입니다.

속성	값
Default value:	2022-07-31
허용되는 값:	2022-06-30-preview, 2022-07-31

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

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

속성	값
Default value:	azureiotcentral.com

--token

전역 매개 변수

--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성	값
Default value:	False

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

속성	값
Default value:	False

--output -o

출력 형식

속성	값
Default value:	json
허용되는 값:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

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

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성	값
Default value:	False

az iot central device show

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

az iot central device show --app-id
                           --device-id
                           [--api-version --av {2022-06-30-preview, 2022-07-31}]
                           [--central-api-uri --central-dns-suffix]
                           [--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' 인수는 더 이상 사용되지 않으며 향후 릴리스에서 제거될 예정입니다.

속성	값
Default value:	2022-07-31
허용되는 값:	2022-06-30-preview, 2022-07-31

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

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

속성	값
Default value:	azureiotcentral.com

--token

전역 매개 변수

--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성	값
Default value:	False

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

속성	값
Default value:	False

--output -o

출력 형식

속성	값
Default value:	json
허용되는 값:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

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

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성	값
Default value:	False

az iot central device show-credentials

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

az iot central device show-credentials --app-id
                                       --device-id
                                       [--api-version --av {2022-06-30-preview, 2022-07-31}]
                                       [--central-api-uri --central-dns-suffix]
                                       [--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' 인수는 더 이상 사용되지 않으며 향후 릴리스에서 제거될 예정입니다.

속성	값
Default value:	2022-07-31
허용되는 값:	2022-06-30-preview, 2022-07-31

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

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

속성	값
Default value:	azureiotcentral.com

--token

전역 매개 변수

--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성	값
Default value:	False

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

속성	값
Default value:	False

--output -o

출력 형식

속성	값
Default value:	json
허용되는 값:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

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

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성	값
Default value:	False

az iot central device update

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

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

az iot central device update --app-id
                             --device-id
                             [--api-version --av {2022-06-30-preview, 2022-07-31}]
                             [--central-api-uri --central-dns-suffix]
                             [--device-name]
                             [--enable {false, true}]
                             [--organizations --orgs]
                             [--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' 인수는 더 이상 사용되지 않으며 향후 릴리스에서 제거될 예정입니다.

속성	값
Default value:	2022-07-31
허용되는 값:	2022-06-30-preview, 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

전역 매개 변수

--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성	값
Default value:	False

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

속성	값
Default value:	False

--output -o

출력 형식

속성	값
Default value:	json
허용되는 값:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

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

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성	값
Default value:	False

피드백

이 페이지가 도움이 되었나요?

다음을 통해 공유

az iot central device

명령

az iot central device compute-device-key

예제

필수 매개 변수

az iot central device create

예제

필수 매개 변수

선택적 매개 변수

az iot central device delete

예제

필수 매개 변수

선택적 매개 변수

az iot central device list

예제

필수 매개 변수

선택적 매개 변수

az iot central device list-components

예제

필수 매개 변수

선택적 매개 변수

az iot central device list-modules

예제

필수 매개 변수

선택적 매개 변수

az iot central device manual-failback

예제

필수 매개 변수

선택적 매개 변수

az iot central device manual-failover

예제

필수 매개 변수

선택적 매개 변수

az iot central device registration-info

예제

필수 매개 변수

선택적 매개 변수

az iot central device show

예제

필수 매개 변수

선택적 매개 변수

az iot central device show-credentials

예제

필수 매개 변수

선택적 매개 변수

az iot central device update

예제

필수 매개 변수

선택적 매개 변수

피드백