az dt twin

참고 항목

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

Digital Twins 인스턴스의 디지털 트윈을 관리하고 구성합니다.

명령

Name	Description	형식	상태
az dt twin component	Digital Twins 인스턴스의 디지털 트윈 구성 요소를 표시하고 업데이트합니다.	내선 번호	GA
az dt twin component show	디지털 트윈 구성 요소의 세부 정보를 표시합니다.	내선 번호	GA
az dt twin component update	JSON 패치 사양을 통해 디지털 트윈 구성 요소를 업데이트합니다.	내선 번호	GA
az dt twin create	인스턴스에 디지털 트윈을 만듭니다.	내선 번호	GA
az dt twin delete	디지털 트윈을 제거합니다. 이 트윈을 참조하는 모든 관계는 이미 삭제되어야 합니다.	내선 번호	GA
az dt twin delete-all	해당 트윈에 대한 모든 관계를 포함하여 Digital Twins 인스턴스 내의 모든 디지털 트윈을 삭제합니다.	내선 번호	GA
az dt twin query	인스턴스의 디지털 트윈을 쿼리합니다. 관계를 트래버스하고 속성 값별로 필터링할 수 있습니다.	내선 번호	GA
az dt twin relationship	Digital Twins 인스턴스의 디지털 트윈 관계를 관리하고 구성합니다.	내선 번호	GA
az dt twin relationship create	원본 및 대상 디지털 트윈 간의 관계를 만듭니다.	내선 번호	GA
az dt twin relationship delete	Digital Twins 인스턴스에서 디지털 트윈 관계를 삭제합니다.	내선 번호	GA
az dt twin relationship delete-all	들어오는 관계를 포함하여 Digital Twins 인스턴스 내의 모든 디지털 트윈 관계를 삭제합니다.	내선 번호	GA
az dt twin relationship list	디지털 트윈의 관계를 나열합니다.	내선 번호	GA
az dt twin relationship show	디지털 트윈 관계의 세부 정보를 표시합니다.	내선 번호	GA
az dt twin relationship update	JSON 패치 사양을 통해 두 디지털 트윈 간의 관계 속성을 업데이트합니다.	내선 번호	GA
az dt twin show	디지털 트윈의 세부 정보를 표시합니다.	내선 번호	GA
az dt twin telemetry	Digital Twins 인스턴스의 이벤트 경로 및 엔드포인트를 테스트하고 유효성을 검사합니다.	내선 번호	GA
az dt twin telemetry send	디지털 트윈을 대신하여 원격 분석을 보냅니다. 구성 요소 경로가 제공되면 내보낸 원격 분석이 구성 요소를 대신합니다.	내선 번호	GA
az dt twin update	JSON 패치 사양을 통해 인스턴스 디지털 트윈을 업데이트합니다.	내선 번호	GA

az dt twin create

인스턴스에 디지털 트윈을 만듭니다.

--properties는 인라인 JSON 또는 파일 경로일 수 있습니다. 참고: --properties는 구성 요소가 포함된 트윈에 필요합니다.

az dt twin create --dt-name
                  --dtmi
                  --twin-id
                  [--if-none-match]
                  [--properties]
                  [--resource-group]

예제

이전에 만든 기존 모델에서 디지털 트윈을 만듭니다.

az dt twin create -n {instance_or_hostname} --dtmi "dtmi:com:example:Room;1" --twin-id {twin_id}

if-none 일치 태그를 사용하여 기존(이전에 만든) 모델에서 디지털 트윈을 만듭니다.

az dt twin create -n {instance_or_hostname} --dtmi "dtmi:com:example:Room;1" --twin-id {twin_id} --if-none-match

이전에 만든 기존 모델에서 디지털 트윈을 만듭니다. 속성 값으로 인스턴스화합니다.

az dt twin create -n {instance_or_hostname} --dtmi "dtmi:com:example:DeviceInformation;1" --twin-id {twin_id} --properties '{"manufacturer": "Microsoft"}'

기존(이전에 만든) 모델의 구성 요소를 사용하여 디지털 트윈을 만듭니다. 최소 속성을 사용하여 구성 요소를 인스턴스화합니다.

az dt twin create -n {instance_or_hostname} --dtmi "dtmi:com:example:TemperatureController;1" --twin-id {twin_id} --properties '{
    "Thermostat": {
        "$metadata": {},
    }
}'

기존(이전에 만든) 모델의 구성 요소를 사용하여 디지털 트윈을 만듭니다. 속성 값으로 인스턴스화합니다.

az dt twin create -n {instance_or_hostname} --dtmi "dtmi:com:example:TemperatureController;1" --twin-id {twin_id} --properties '{
    "Temperature": 10.2,
    "Thermostat": {
        "$metadata": {},
        "setPointTemp": 23.12
    }
}'

필수 매개 변수

--dt-name --dtn -n

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

--dtmi --model-id -m

Digital Twins 모델 ID입니다. 예: dtmi:com:example:Room;2.

--twin-id -t

디지털 트윈 ID입니다.

선택적 매개 변수

--if-none-match

ID가 동일한 기존 트윈이 있는 경우 만들기 작업이 실패했음을 나타냅니다.

기본값: False

--properties -p

디지털 트윈 또는 관련 구성 요소를 인스턴스화하기 위한 초기 속성 값입니다. 파일 경로 또는 인라인 JSON을 제공합니다. 속성은 구성 요소를 포함하는 트윈에 필요하며, 최소한 각 구성 요소에 대해 빈 $metadata 개체를 제공해야 합니다.

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

디지털 트윈을 제거합니다. 이 트윈을 참조하는 모든 관계는 이미 삭제되어야 합니다.

az dt twin delete --dt-name
                  --twin-id
                  [--etag]
                  [--resource-group]

예제

ID로 디지털 트윈을 제거합니다.

az dt twin delete -n {instance_or_hostname} --twin-id {twin_id}

etag를 사용하여 ID별 디지털 트윈을 제거합니다.

az dt twin delete -n {instance_or_hostname} --twin-id {twin_id} --etag {etag}

필수 매개 변수

--dt-name --dtn -n

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

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

az dt twin delete-all

해당 트윈에 대한 모든 관계를 포함하여 Digital Twins 인스턴스 내의 모든 디지털 트윈을 삭제합니다.

az dt twin delete-all --dt-name
                      [--resource-group]
                      [--yes]

예제

모든 디지털 트윈을 삭제합니다. 트윈을 참조하는 모든 관계도 삭제됩니다.

az dt twin delete-all -n {instance_or_hostname}

필수 매개 변수

--dt-name --dtn -n

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

선택적 매개 변수

--resource-group -g

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

--yes -y

확인을 묻는 메시지를 표시하지 마세요.

기본값: False

전역 매개 변수

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

인스턴스의 디지털 트윈을 쿼리합니다. 관계를 트래버스하고 속성 값별로 필터링할 수 있습니다.

많은 트윈 쿼리에서 $ 문자는 트윈의 $dtId 속성을 참조하는 데 사용됩니다. bash와 유사한 셸 또는 powershell $ 에서 문자는 기능적 의미를 가지며 쿼리 입력의 일부로 이스케이프되어야 합니다. 자세한 내용은 Digital Twins CLI 개념 문서를 https://docs.microsoft.com/en-us/azure/digital-twins/concepts-cli 검토하세요.

az dt twin query --dt-name
                 --query-command
                 [--cost {false, true}]
                 [--resource-group]

예제

대상 인스턴스의 모든 디지털 트윈을 쿼리하고 모든 특성을 프로젝션합니다. 또한 쿼리 단위로 비용을 표시합니다.

az dt twin query -n {instance_or_hostname} -q "select * from digitaltwins" --show-cost

모델별로 쿼리하고 모든 특성을 프로젝션합니다.

az dt twin query -n {instance_or_hostname} -q "select * from digitaltwins T where IS_OF_MODEL(T, 'dtmi:com:example:Room;2')"

bash 호환 구문을 사용하여 '$dtId'을 활용하는 쿼리

az dt twin query -n {instance_or_hostname} --query-command "SELECT * FROM DigitalTwins T Where T.\$dtId = 'room0'"

powershell 호환 구문을 사용하여 '$dtId'을 활용하는 쿼리

az dt twin query -n {instance_or_hostname} --query-command "SELECT * FROM DigitalTwins T Where T.`$dtId = 'room0'"

필수 매개 변수

--dt-name --dtn -n

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

--query-command -q

실행할 사용자 쿼리입니다.

선택적 매개 변수

--cost --show-cost

쿼리 요금을 계산하고 표시합니다.

허용되는 값: false, true

기본값: False

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

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

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

예제

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

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

필수 매개 변수

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

JSON 패치 사양을 통해 인스턴스 디지털 트윈을 업데이트합니다.

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

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

예제

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

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

JSON 패치 사양 및 etag를 사용하여 디지털 트윈을 업데이트합니다.

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

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

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

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

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

필수 매개 변수

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