az dt
참고
이 참조는 Azure CLI 대한 azure-iot 확장의 일부이며 버전 2.17.1 이상이 필요합니다. az dt 명령을 처음 실행할 때 확장이 자동으로 설치됩니다. 확장에 대해 자세히 알아보세요.
Azure Digital Twins 솔루션 및 인프라를 관리합니다.
명령
| az dt create |
Digital Twins 인스턴스를 만들거나 업데이트합니다. |
| az dt delete |
기존 Digital Twins 인스턴스를 삭제합니다. |
| az dt endpoint |
디지털 Twins 인스턴스 끝점을 관리 하 고 구성 합니다. |
| az dt endpoint create |
디지털 쌍 인스턴스에 송신 끝점을 추가 합니다. |
| az dt endpoint create eventgrid |
EventGrid 토픽 끝점을 디지털 쌍 인스턴스에 추가 합니다. 미리 만든 리소스가 필요 합니다. |
| az dt endpoint create eventhub |
Digital Twins 인스턴스에 EventHub 끝점을 추가 합니다. 미리 만든 리소스가 필요 합니다. Id 기반 끝점 통합을 지원 하려면 관리 id를 사용 하 여 인스턴스를 만들어야 합니다. |
| az dt endpoint create servicebus |
디지털 쌍 인스턴스에 ServiceBus 토픽 끝점을 추가 합니다. 미리 만든 리소스가 필요 합니다. Id 기반 끝점 통합을 지원 하려면 관리 id를 사용 하 여 인스턴스를 만들어야 합니다. |
| az dt endpoint delete |
디지털 Twins 인스턴스에서 끝점을 제거 합니다. |
| az dt endpoint list |
디지털 쌍 인스턴스에 구성 된 모든 송신 끝점을 나열 합니다. |
| az dt endpoint show |
디지털 쌍 인스턴스에 구성 된 끝점에 대 한 세부 정보를 표시 합니다. |
| az dt endpoint wait |
끝점 작업이 완료 될 때까지 기다립니다. |
| az dt list |
구독 또는 리소스 그룹별로 Digital Twins 인스턴스의 컬렉션을 나열합니다. |
| az dt model |
Digital Twins 인스턴스에서 DTDL 모델 및 정의를 관리합니다. |
| az dt model create |
하나 이상의 모델을 업로드합니다. 오류가 발생하면 모델이 업로드되지 않습니다. |
| az dt model delete |
모델을 삭제합니다. 모델을 참조하는 다른 모델이 없는 경우에만 모델을 삭제할 수 있습니다. |
| az dt model delete-all |
Digital Twins 인스턴스 내의 모든 모델을 삭제합니다. 트윈 구성은 영향을 받지 않지만 모델 정의 없이는 손상될 수 있습니다. |
| az dt model list |
모델 메타데이터, 정의 및 dependencies를 나열합니다. |
| az dt model show |
대상 모델 또는 모델 정의를 검색합니다. |
| az dt model update |
모델의 메타데이터를 업데이트합니다. 현재 모델은 커밋 해제만 가능합니다. |
| az dt network |
프라이빗 링크 및 엔드포인트 연결을 포함하여 Digital Twins 네트워크 구성을 관리합니다. |
| az dt network private-endpoint |
Digital Twins 인스턴스 프라이빗 엔드포인트를 관리합니다. |
| az dt network private-endpoint connection |
Digital Twins 인스턴스 프라이빗 엔드포인트 연결을 관리합니다. |
| az dt network private-endpoint connection delete |
Digital Twins 인스턴스와 연결된 프라이빗 엔드포인트 연결을 삭제합니다. |
| az dt network private-endpoint connection list |
Digital Twins 인스턴스와 연결된 프라이빗 엔드포인트 연결을 나열합니다. |
| az dt network private-endpoint connection set |
Digital Twins 인스턴스와 연결된 프라이빗 엔드포인트 연결의 상태를 설정합니다. |
| az dt network private-endpoint connection show |
Digital Twins 인스턴스와 연결된 프라이빗 엔드포인트 연결을 표시합니다. |
| az dt network private-endpoint connection wait |
프라이빗 엔드포인트 연결에 대한 작업이 완료될 때까지 기다립니다. |
| az dt network private-link |
Digital Twins 인스턴스 개인 링크 작업을 관리 합니다. |
| az dt network private-link list |
Digital Twins 인스턴스와 연결 된 개인 링크를 나열 합니다. |
| az dt network private-link show |
인스턴스와 연결 된 개인 링크를 표시 합니다. |
| az dt reset |
연결된 자산을 삭제하여 기존 Digital Twins 인스턴스를 다시 설정합니다. 현재는 모델 및 트윈 삭제만 지원합니다. |
| az dt role-assignment |
Digital Twins 인스턴스에 대한 RBAC 역할 할당을 관리합니다. |
| az dt role-assignment create |
Digital Twins 인스턴스에 대한 역할에 사용자, 그룹 또는 서비스 주체를 할당합니다. |
| az dt role-assignment delete |
Digital Twins 인스턴스에서 사용자, 그룹 또는 서비스 주체 역할 할당을 제거합니다. |
| az dt role-assignment list |
Digital Twins 인스턴스의 기존 역할 할당을 나열합니다. |
| az dt route |
이벤트 경로를 관리 하 고 구성 합니다. |
| az dt route create |
디지털 쌍 인스턴스에 이벤트 경로를 추가 합니다. |
| az dt route delete |
디지털 Twins 인스턴스에서 이벤트 경로를 제거 합니다. |
| az dt route list |
디지털 쌍 인스턴스의 구성 된 이벤트 경로를 나열 합니다. |
| az dt route show |
디지털 쌍 인스턴스에 구성 된 이벤트 경로의 세부 정보를 표시 합니다. |
| az dt show |
기존 Digital Twins 인스턴스를 표시합니다. |
| az dt twin |
Digital Twins 인스턴스의 디지털 트윈을 관리하고 구성합니다. |
| az dt twin component |
Digital Twins 인스턴스의 디지털 트윈 구성 요소를 표시하고 업데이트합니다. |
| az dt twin component show |
디지털 트윈 구성 요소의 세부 정보를 표시합니다. |
| az dt twin component update |
JSON 패치 사양을 통해 디지털 트윈 구성 요소를 업데이트합니다. |
| az dt twin create |
인스턴스에 디지털 트윈을 만듭니다. |
| az dt twin delete |
디지털 트윈을 제거합니다. 이 트윈을 참조하는 모든 관계는 이미 삭제되어야 합니다. |
| az dt twin delete-all |
해당 트윈에 대한 모든 관계를 포함하여 Digital Twins 인스턴스 내의 모든 디지털 트윈을 삭제합니다. |
| az dt twin query |
인스턴스의 디지털 트윈을 쿼리합니다. 관계 트래버스 및 속성 값별 필터링을 허용합니다. |
| az dt twin relationship |
Digital Twins 인스턴스의 디지털 트윈 관계를 관리하고 구성합니다. |
| az dt twin relationship create |
원본 및 대상 디지털 트윈 간의 관계를 만듭니다. |
| az dt twin relationship delete |
Digital Twins 인스턴스에서 디지털 트윈 관계를 삭제합니다. |
| az dt twin relationship delete-all |
들어오는 관계를 포함하여 Digital Twins 인스턴스 내의 모든 디지털 트윈 관계를 삭제합니다. |
| az dt twin relationship list |
디지털 트윈의 관계를 나열합니다. |
| az dt twin relationship show |
디지털 트윈 관계의 세부 정보를 표시합니다. |
| az dt twin relationship update |
JSON 패치 사양을 통해 두 디지털 트윈 간의 관계 속성을 업데이트합니다. |
| az dt twin show |
디지털 트윈의 세부 정보를 표시합니다. |
| az dt twin telemetry |
디지털 쌍 인스턴스의 이벤트 경로 및 끝점을 테스트 하 고 유효성을 검사 합니다. |
| az dt twin telemetry send |
디지털 쌍을 대신 하 여 원격 분석을 보냅니다. 구성 요소 경로가 제공 되는 경우 내보낸 원격 분석은 구성 요소를 대신 합니다. |
| az dt twin update |
JSON 패치 사양을 통해 인스턴스 디지털 트윈을 업데이트합니다. |
| az dt wait |
Digital Twins 인스턴스에 대한 작업이 완료될 때까지 기다립니다. |
az dt create
Digital Twins 인스턴스를 만들거나 업데이트합니다.
az dt create --dt-name
--resource-group
[--assign-identity {false, true}]
[--location]
[--pna {Disabled, Enabled}]
[--role]
[--scopes]
[--tags]
예제
리소스 그룹 위치를 사용하여 대상 리소스 그룹에 인스턴스를 만듭니다.
az dt create -n {instance_name} -g {resouce_group}
지정된 위치와 태그를 사용하여 대상 리소스 그룹에 인스턴스를 만듭니다.
az dt create -n {instance_name} -g {resouce_group} -l westus --tags a=b c=d
시스템 관리 ID를 사용하여 대상 리소스 그룹에 인스턴스를 만듭니다.
az dt create -n {instance_name} -g {resouce_group} --assign-identity
시스템 관리 ID를 사용하여 대상 리소스 그룹에 인스턴스를 만든 다음 기여자 역할을 사용하여 하나 이상의 범위(공백으로 구분)에 ID를 할당합니다.
az dt create -n {instance_name} -g {resouce_group} --assign-identity --scopes "/subscriptions/a12345ea-bb21-994d-2263-c716348e32a1/resourceGroups/ProResourceGroup/providers/Microsoft.EventHub/namespaces/myEventHubNamespace/eventhubs/myEventHub" "/subscriptions/a12345ea-bb21-994d-2263-c716348e32a1/resourceGroups/ProResourceGroup/providers/Microsoft.ServiceBus/namespaces/myServiceBusNamespace/topics/myTopic"
시스템 관리 ID를 사용하여 대상 리소스 그룹에 인스턴스를 만든 다음, 사용자 지정 역할이 있는 하나 이상의 범위에 ID를 할당합니다.
az dt create -n {instance_name} -g {resouce_group} --assign-identity --scopes "/subscriptions/a12345ea-bb21-994d-2263-c716348e32a1/resourceGroups/ProResourceGroup/providers/Microsoft.EventHub/namespaces/myEventHubNamespace/eventhubs/myEventHub" "/subscriptions/a12345ea-bb21-994d-2263-c716348e32a1/resourceGroups/ProResourceGroup/providers/Microsoft.ServiceBus/namespaces/myServiceBusNamespace/topics/myTopic" --role MyCustomRole
대상 리소스 그룹의 인스턴스를 업데이트하여 시스템 관리 ID를 사용하도록 설정합니다.
az dt create -n {instance_name} -g {resouce_group} --assign-identity
대상 리소스 그룹의 인스턴스를 업데이트하여 시스템 관리 ID를 사용하지 않도록 설정합니다.
az dt create -n {instance_name} -g {resouce_group} --assign-identity false
대상 리소스 그룹의 인스턴스를 새 태그 값으로 업데이트하고 공용 네트워크 액세스를 사용하지 않도록 설정합니다.
az dt create -n {instance_name} -g {resouce_group} --tags env=prod --public-network-access Disabled
필수 매개 변수
인스턴스 이름을 Digital Twins.
인스턴스 리소스 그룹을 Digital Twins. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.
선택적 매개 변수
시스템 생성 ID를 Digital Twins 인스턴스에 할당합니다.
인스턴스 위치를 Digital Twins. 위치가 제공되지 않으면 리소스 그룹 위치가 사용됩니다. 를 사용하여 기본 위치를 구성할 수 az configure --defaults location=<name> 있습니다.
공용 네트워크에서 Digital Twins 인스턴스에 액세스할 수 있는지 여부를 결정합니다.
시스템 할당 ID에 부여할 역할 이름 또는 ID입니다.
시스템 할당 ID가 액세스할 수 있는 공간으로 분리된 범위입니다.
인스턴스 태그를 Digital Twins. a=b c=d 형식의 키-값 쌍의 속성 백입니다.
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
오류만 표시하고, 경고를 표시하지 않습니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/를 참조하세요.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
az dt delete
기존 Digital Twins 인스턴스를 삭제합니다.
az dt delete --dt-name
[--no-wait]
[--resource-group]
[--yes]
예제
확인 프롬프트를 표시하여 차단 방식으로 임의 인스턴스를 삭제합니다.
az dt delete -n {instance_name}
차단 또는 프롬프트 없이 임의의 인스턴스를 삭제합니다.
az dt delete -n {instance_name} -y --no-wait
필수 매개 변수
인스턴스 이름을 Digital Twins.
선택적 매개 변수
장기 실행 작업이 완료될 때까지 기다리지 마세요.
인스턴스 리소스 그룹을 Digital Twins. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.
확인을 묻는 메시지를 표시하지 마세요.
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
오류만 표시하고, 경고를 표시하지 않습니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/를 참조하세요.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
az dt list
구독 또는 리소스 그룹별로 Digital Twins 인스턴스의 컬렉션을 나열합니다.
az dt list [--resource-group]
예제
현재 구독의 모든 인스턴스를 나열합니다.
az dt list
대상 리소스 그룹의 모든 인스턴스와 출력을 테이블 형식으로 나열합니다.
az dt list -g {resource_group} --output table
조건을 충족하는 구독의 모든 인스턴스를 나열합니다.
az dt list --query "[?contains(name, 'Production')]"
조건을 충족하는 인스턴스 수를 계산합니다.
az dt list --query "length([?contains(name, 'Production')])"
선택적 매개 변수
인스턴스 리소스 그룹을 Digital Twins. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
오류만 표시하고, 경고를 표시하지 않습니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/를 참조하세요.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
az dt reset
연결된 자산을 삭제하여 기존 Digital Twins 인스턴스를 다시 설정합니다. 현재는 모델 및 트윈 삭제만 지원합니다.
az dt reset --dt-name
[--resource-group]
[--yes]
예제
Digital Twins 인스턴스에 대한 모든 자산을 다시 설정합니다.
az dt reset -n {instance_name}
필수 매개 변수
인스턴스 이름을 Digital Twins.
선택적 매개 변수
인스턴스 리소스 그룹을 Digital Twins. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.
확인을 묻는 메시지를 표시하지 마세요.
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
오류만 표시하고, 경고를 표시하지 않습니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/를 참조하세요.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
az dt show
기존 Digital Twins 인스턴스를 표시합니다.
az dt show --dt-name
[--resource-group]
예제
인스턴스를 표시합니다.
az dt show -n {instance_name}
인스턴스를 표시하고 특정 속성을 프로젝션합니다.
az dt show -n {instance_name} --query "{Endpoint:hostName, Location:location}"
필수 매개 변수
인스턴스 이름을 Digital Twins.
선택적 매개 변수
인스턴스 리소스 그룹을 Digital Twins. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
오류만 표시하고, 경고를 표시하지 않습니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/를 참조하세요.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
az dt wait
Digital Twins 인스턴스에 대한 작업이 완료될 때까지 기다립니다.
az dt wait --dt-name
[--created]
[--custom]
[--deleted]
[--exists]
[--interval]
[--resource-group]
[--timeout]
예제
임의의 인스턴스가 만들어질 때까지 기다립니다.
az dt wait -n {instance_name} --created
기존 인스턴스가 삭제될 때까지 기다립니다.
az dt wait -n {instance_name} --deleted
기존 인스턴스의 publicNetworkAccess 속성이 Enabled로 설정될 때까지 기다립니다.
az dt wait -n {instance_name} --custom "publicNetworkAccess=='Enabled'"
필수 매개 변수
인스턴스 이름을 Digital Twins.
선택적 매개 변수
'Succeeded'에서 'provisioningState'를 통해 생성될 때까지 기다립니다.
조건이 사용자 지정 JMESPath 쿼리를 충족할 때까지 기다립니다. 예를 들어 provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].
삭제될 때까지 기다립니다.
리소스가 존재할 때까지 기다립니다.
폴링 간격(초)입니다.
인스턴스 리소스 그룹을 Digital Twins. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.
최대 대기 시간(초)입니다.
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
오류만 표시하고, 경고를 표시하지 않습니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/를 참조하세요.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.