Azure Digital Twins CLI 명령 집합

Azure Portal에서 Azure Digital Twins 인스턴스를 관리하는 것 외에도 Azure Digital Twins에는 서비스를 통해 대부분의 주요 작업을 수행하는 데 사용할 수 있는 Azure CLI에 대한 명령 집합도 있습니다. 이 문서에서는 Azure Digital Twins에 대한 Azure CLI 명령 집합의 용도, 가져오기 방법 및 사용 요구 사항을 다룹니다.

명령 집합을 사용하여 수행할 수 있는 작업 중 일부는 다음과 같습니다.

• Azure Digital Twins 인스턴스 관리
• 모델 관리
• 디지털 트윈 관리
• 트윈 관계 관리
• 엔드포인트 구성
• 경로 관리
• Azure RBAC(Azure 역할 기반 액세스 제어)를 통해 보안 구성

명령 집합은 az dt라고 하며 Azure CLI용 Azure IoT 확장의 일부입니다. az iot 명령 집합: az dt 명령 참조에 대한 참조 설명서의 일부로 명령 및 사용법의 전체 목록을 볼 수 있습니다.

사용(배포 및 유효성 검사)

CLI는 일반적으로 인스턴스를 관리하는 것 외에도 배포 및 유효성 검사에 유용한 도구입니다.

• 제어 평면 명령을 사용하여 새 인스턴스의 배포를 반복하거나 자동화할 수 있습니다.
• 데이터 평면 명령을 사용하여 인스턴스의 값을 신속하게 확인하고 작업이 예상대로 완료되었는지 확인할 수 있습니다.

명령 집합 가져오기

Azure Digital Twins 명령은 Azure CLI용 Azure IoT 확장(azure-iot)의 일부이므로 다음 단계에 따라 az dt 명령을 사용하여 최신 azure-iot 확장이 있는지 확인합니다.

CLI 버전 요구 사항

PowerShell과 함께 Azure CLI를 사용하는 경우 확장 패키지의 요구 사항으로 Azure CLI 버전이 2.3.1 이상이어야 합니다.

다음 CLI 명령을 사용하여 Azure CLI의 버전을 확인할 수 있습니다.

az --version

Azure CLI를 최신 버전으로 설치하거나 업데이트하는 방법에 대한 지침은 Azure CLI 설치를 참조하세요.

확장 가져오기

Azure CLI는 필요한 명령을 처음 사용할 때 확장을 설치하라는 메시지를 자동으로 표시합니다.

아니면 다음 명령을 사용하여 언제든지 확장을 직접 설치하거나 이전 버전이 이미 있는 경우에는 해당 확장을 업데이트할 수 있습니다. 이 명령은 Azure Cloud Shell 또는 로컬 Azure CLI에서 실행할 수 있습니다.

az extension add --upgrade --name azure-iot

다른 셸에서 특수 문자 사용

일부 az dt 명령은 특정 셸 환경에서 적절한 구문 분석을 위해 이스케이프해야 할 수 있는 특수 문자를 사용합니다. 이 섹션의 팁을 사용하면 선택한 셸에서 이 작업을 수행할 시기를 알 수 있습니다.

Bash

Bash 환경에 이러한 특수 문자 팁을 사용합니다.

쿼리

많은 트윈 쿼리에서 $ 문자는 트윈의 $dtId 속성을 참조하는 데 사용됩니다. az dt twin query 명령을 사용하여 Cloud Shell Bash 환경에서 쿼리하는 경우 백슬래시(\)를 사용하여 $ 문자를 이스케이프합니다.

다음은 Cloud Shell Bash 환경에서 CLI 명령을 사용하여 트윈을 쿼리하는 예제입니다.

az dt twin query --dt-name <instance-hostname-or-name> --query-command "SELECT * FROM DigitalTwins T Where T.\$dtId = 'room0'"

PowerShell

PowerShell 환경에 이러한 특수 문자 팁을 사용합니다.

인라인 JSON

az dt twin create와 같은 일부 명령을 사용하면 인라인 JSON 형식으로 트윈 정보를 입력할 수 있습니다. PowerShell 환경에서 인라인 JSON을 입력할 때 백슬래시(\)를 사용하여 JSON 내의 큰따옴표 문자(")를 이스케이프합니다.

다음은 PowerShell에서 CLI 명령을 사용하여 트윈을 만드는 예제입니다.

az dt twin create --dt-name <instance-hostname-or-name> --dtmi "dtmi:contosocom:DigitalTwins:Thermostat;1" --twin-id thermostat67 --properties '{\"Temperature\": 0.0}'

팁

인라인 JSON을 지원하는 대부분의 명령은 입력을 파일 경로로 지원하므로 셸별 텍스트 요구 사항을 방지하는 데 도움이 될 수 있습니다.

쿼리

많은 트윈 쿼리에서 $ 문자는 트윈의 $dtId 속성을 참조하는 데 사용됩니다. az dt twin query 명령을 사용하여 PowerShell 환경에서 쿼리하는 경우 백틱 문자를 사용하여 $ 문자를 이스케이프합니다.

다음은 PowerShell에서 CLI 명령을 사용하여 트윈을 쿼리하는 예제입니다.

az dt twin query --dt-name <instance-hostname-or-name> --query-command "SELECT * FROM DigitalTwins T Where T.`$dtId = 'room0'"

Windows CMD

로컬 Windows CMD에 이러한 특수 문자 팁을 사용합니다.

인라인 JSON

az dt twin create와 같은 일부 명령을 사용하면 인라인 JSON 형식으로 트윈 정보를 입력할 수 있습니다. 로컬 Windows CMD 창에 인라인 JSON을 입력할 때 매개 변수 값을 작은따옴표(') 대신 큰따옴표(")로 묶고 JSON 내의 큰따옴표 문자를 백슬래시(\)로 이스케이프합니다.

다음은 로컬 Windows CMD에서 CLI 명령을 사용하여 트윈을 만드는 예제입니다.

az dt twin create --dt-name <instance-hostname-or-name> --dtmi "dtmi:contosocom:DigitalTwins:Thermostat;1" --twin-id thermostat67 --properties "{\"Temperature\": 0.0}"

팁

인라인 JSON을 지원하는 대부분의 명령은 입력을 파일 경로로 지원하므로 셸별 텍스트 요구 사항을 방지하는 데 도움이 될 수 있습니다.

다음 단계

참조 문서를 통해 CLI 및 전체 명령 세트를 탐색합니다.

• az dt 명령 참조