다음을 통해 공유

az dt twin component

  • 참조

참고 항목

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

Digital Twins 인스턴스의 디지털 트윈 구성 요소를 표시하고 업데이트합니다.

명령

Name Description 형식 상태
az dt twin component show

디지털 트윈 구성 요소의 세부 정보를 표시합니다.

 내선 번호 GA
az dt twin component update

JSON 패치 사양을 통해 디지털 트윈 구성 요소를 업데이트합니다.

 내선 번호 GA

az dt twin component show

디지털 트윈 구성 요소의 세부 정보를 표시합니다.

az dt twin component show --component
                          --dt-name
                          --twin-id
                          [--resource-group]

예제

디지털 트윈 구성 요소의 세부 정보 표시

az dt twin component show -n {instance_or_hostname} --twin-id {twin_id} --component Thermostat

필수 매개 변수

--component

DTDL 구성 요소의 경로입니다.

--dt-name --dtn -n

Digital Twins 인스턴스 이름 또는 호스트 이름입니다. 인스턴스 이름이 제공되면 먼저 대상 인스턴스에 대한 사용자 구독을 쿼리하여 호스트 이름을 검색합니다. 호스트 이름이 제공되면 구독 쿼리를 건너뛰고 제공된 값이 후속 상호 작용에 사용됩니다.

--twin-id -t

디지털 트윈 ID입니다.

선택적 매개 변수

--resource-group -g

Digital Twins 인스턴스 리소스 그룹입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

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

--only-show-errors

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

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
기본값: json
--query

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

--subscription

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

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az dt twin component update

JSON 패치 사양을 통해 디지털 트윈 구성 요소를 업데이트합니다.

속성 값 및 $model 요소에 대한 업데이트는 동일한 요청에서 발생할 수 있습니다. 작업은 추가, 바꾸기 및 제거로 제한됩니다.

az dt twin component update --component
                            --dt-name
                            --json-patch
                            --twin-id
                            [--etag]
                            [--resource-group]

예제

JSON 패치 사양을 통해 디지털 트윈 구성 요소를 업데이트합니다.

az dt twin component update -n {instance_or_hostname} --twin-id {twin_id} --component {component_path} --json-patch '{"op":"replace", "path":"/Temperature", "value": 20.5}'

JSON 패치 사양을 통해 디지털 트윈 구성 요소를 업데이트합니다.

az dt twin component update -n {instance_or_hostname} --twin-id {twin_id} --component {component_path} --json-patch '[
  {"op":"replace", "path":"/Temperature", "value": 20.5},
  {"op":"add", "path":"/Areas", "value": ["ControlSystem"]}
]'

파일에 정의된 JSON 패치 사양을 통해 디지털 트윈 구성 요소를 업데이트합니다.

az dt twin component update -n {instance_or_hostname} --twin-id {twin_id} --component {component_path} --json-patch ./my/patch/document.json

필수 매개 변수

--component

DTDL 구성 요소의 경로입니다.

--dt-name --dtn -n

Digital Twins 인스턴스 이름 또는 호스트 이름입니다. 인스턴스 이름이 제공되면 먼저 대상 인스턴스에 대한 사용자 구독을 쿼리하여 호스트 이름을 검색합니다. 호스트 이름이 제공되면 구독 쿼리를 건너뛰고 제공된 값이 후속 상호 작용에 사용됩니다.

--json-patch --patch

JSON 패치에서 설명하는 업데이트 사양입니다. 속성 값 및 $model 요소에 대한 업데이트는 동일한 요청에서 발생할 수 있습니다. 작업은 추가, 바꾸기 및 제거로 제한됩니다. 파일 경로 또는 인라인 JSON을 제공합니다.

--twin-id -t

디지털 트윈 ID입니다.

선택적 매개 변수

--etag -e

엔터티 태그 값입니다. etag가 리소스의 현재 etag와 일치하면 명령이 성공합니다.

--resource-group -g

Digital Twins 인스턴스 리소스 그룹입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

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

--only-show-errors

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

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
기본값: json
--query

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

--subscription

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

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.