az iot central device-template

참고 항목

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

IoT Central 디바이스 템플릿을 관리하고 구성합니다.

명령

Name	Description	형식	상태
az iot central device-template create	IoT Central에서 디바이스 템플릿을 만듭니다.	내선 번호	GA
az iot central device-template delete	IoT Central에서 디바이스 템플릿을 삭제합니다.	내선 번호	GA
az iot central device-template list	IoT Central 애플리케이션에 대한 디바이스 템플릿 목록을 가져옵니다.	내선 번호	GA
az iot central device-template show	IoT Central에서 디바이스 템플릿을 가져옵니다.	내선 번호	GA
az iot central device-template update	IoT Central에서 디바이스 템플릿을 업데이트합니다.	내선 번호	GA

az iot central device-template create

IoT Central에서 디바이스 템플릿을 만듭니다.

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

예제

파일에서 읽은 페이로드가 있는 디바이스 템플릿 만들기

az iot central device-template create --app-id {appid} --content {pathtofile} --device-template-id {devicetemplateid}

원시 json에서 읽은 페이로드를 사용하여 디바이스 템플릿 만들기

az iot central device-template create --app-id {appid} --content {json} --device-template-id {devicetemplateid}

필수 매개 변수

--app-id -n

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

--content -k

디바이스 템플릿 정의입니다. JSON 파일 또는 원시 문자열화된 JSON에 대한 경로를 제공합니다. [파일 경로 예제: ./path/to/file.json] [문자열화된 JSON의 예: {}]. 요청 본문에는 CapabilityModel이 포함되어야 합니다.

--device-template-id --dtid

디바이스 템플릿의 디지털 트윈 모델 식별자입니다. https://aka.ms/iotcentraldtmi에서 자세히 알아보세요.

선택적 매개 변수

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

IoT Central에서 디바이스 템플릿을 삭제합니다.

참고: 이 템플릿에 연결된 디바이스가 있으면 실패할 것으로 예상됩니다.

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

예제

IoT Central에서 디바이스 템플릿 삭제

az iot central device-template delete --app-id {appid} --device-template-id {devicetemplateid}

필수 매개 변수

--app-id -n

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

--device-template-id --dtid

대상 디바이스 템플릿의 ID입니다. 예: somedevicetemplate.

선택적 매개 변수

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

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

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

예제

템플릿 ID(기본값)로 정렬된 애플리케이션의 모든 디바이스 템플릿 나열

az iot central device-template 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

--compact -c

압축 모드로 템플릿을 표시합니다. 각 템플릿에 대해 ID, 이름 및 모델 형식만 표시됩니다.

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

IoT Central에서 디바이스 템플릿을 가져옵니다.

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

예제

디바이스 템플릿 가져오기

az iot central device-template show --app-id {appid} --device-template-id {devicetemplateid}

필수 매개 변수

--app-id -n

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

--device-template-id --dtid

대상 디바이스 템플릿의 ID입니다. 예: somedevicetemplate.

선택적 매개 변수

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

IoT Central에서 디바이스 템플릿을 업데이트합니다.

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

예제

파일에서 읽은 페이로드를 사용하여 디바이스 템플릿 업데이트

az iot central device-template update --app-id {appid} --content {pathtofile} --device-template-id {devicetemplateid}

원시 json에서 읽은 페이로드로 디바이스 템플릿 업데이트

az iot central device-template update --app-id {appid} --content {json} --device-template-id {devicetemplateid}

필수 매개 변수

--app-id -n

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

--content -k

디바이스 템플릿 정의입니다. JSON 파일 또는 원시 문자열화된 JSON에 대한 경로를 제공합니다. [파일 경로 예제: ./path/to/file.json] [문자열화된 JSON의 예: {}]. 요청 본문에는 CapabilityModel이 포함되어야 합니다.

--device-template-id --dtid

대상 디바이스 템플릿의 ID입니다. 예: somedevicetemplate.

선택적 매개 변수

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