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

필수 매개 변수

--dt-name --dtn -n

인스턴스 이름을 Digital Twins.

--resource-group -g

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

선택적 매개 변수

--assign-identity

시스템 생성 ID를 Digital Twins 인스턴스에 할당합니다.

허용되는 값: false, true
--location -l

인스턴스 위치를 Digital Twins. 위치가 제공되지 않으면 리소스 그룹 위치가 사용됩니다. 를 사용하여 기본 위치를 구성할 수 az configure --defaults location=<name> 있습니다.

--pna --public-network-access

공용 네트워크에서 Digital Twins 인스턴스에 액세스할 수 있는지 여부를 결정합니다.

허용되는 값: Disabled, Enabled
기본값: Enabled
--role

시스템 할당 ID에 부여할 역할 이름 또는 ID입니다.

기본값: Contributor
--scopes

시스템 할당 ID가 액세스할 수 있는 공간으로 분리된 범위입니다.

--tags

인스턴스 태그를 Digital Twins. a=b c=d 형식의 키-값 쌍의 속성 백입니다.

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

필수 매개 변수

--dt-name --dtn -n

인스턴스 이름을 Digital Twins.

선택적 매개 변수

--no-wait

장기 실행 작업이 완료될 때까지 기다리지 마세요.

--resource-group -g

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

--yes -y

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

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')])"

선택적 매개 변수

--resource-group -g

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

az dt reset

연결된 자산을 삭제하여 기존 Digital Twins 인스턴스를 다시 설정합니다. 현재는 모델 및 트윈 삭제만 지원합니다.

az dt reset --dt-name
            [--resource-group]
            [--yes]

예제

Digital Twins 인스턴스에 대한 모든 자산을 다시 설정합니다.

az dt reset -n {instance_name}

필수 매개 변수

--dt-name --dtn -n

인스턴스 이름을 Digital Twins.

선택적 매개 변수

--resource-group -g

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

--yes -y

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

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}"

필수 매개 변수

--dt-name --dtn -n

인스턴스 이름을 Digital Twins.

선택적 매개 변수

--resource-group -g

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

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'"

필수 매개 변수

--dt-name --dtn -n

인스턴스 이름을 Digital Twins.

선택적 매개 변수

--created

'Succeeded'에서 'provisioningState'를 통해 생성될 때까지 기다립니다.

--custom

조건이 사용자 지정 JMESPath 쿼리를 충족할 때까지 기다립니다. 예를 들어 provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

삭제될 때까지 기다립니다.

--exists

리소스가 존재할 때까지 기다립니다.

--interval

폴링 간격(초)입니다.

기본값: 30
--resource-group -g

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

--timeout

최대 대기 시간(초)입니다.

기본값: 3600