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)의 일부이므로 다음 단계에 따라 명령을 사용하여 최신 azure-iot 확장 az dt 이 있는지 확인합니다.
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 환경에 대해 이러한 특수 문자 팁을 사용합니다.
질의
많은 트윈 쿼리에서 $ 문자는 트윈의 $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 및 전체 명령 집합을 살펴봅니다.