Azure Digital Twins CLI komut kümesi

Azure portalda Azure Digital Twins örneğinizi yönetmenin yanı sıra, Azure Digital Twins'in Azure CLI için hizmetle ilgili en önemli eylemleri gerçekleştirmek için kullanabileceğiniz bir komut kümesi de vardır. Azure Digital Twins için Azure CLI komut kümesinin kullanımları, nasıl edinileceği ve kullanma gereksinimleri de dahil olmak üzere ele alınmaktadır.

Komut kümesini kullanarak gerçekleştirebileceğiniz eylemlerden bazıları şunlardır:

  • Azure Digital Twins örneğini yönetme
  • Modelleri yönetme
  • Dijital ikizleri yönetme
  • İkiz ilişkilerini yönetme
  • Uç noktaları yapılandırma
  • Yolları yönetme
  • Azure rol tabanlı erişim denetimi (Azure RBAC) aracılığıyla güvenliği yapılandırma

Komut kümesi olarak adlandırılır az dtve Azure CLI için Azure IoT uzantısının bir parçasıdır. Komut kümesinin başvuru belgelerinin az iot bir parçası olarak komutların tam listesini ve kullanımlarını görüntüleyebilirsiniz: az dt command reference.

Kullanır (dağıtma ve doğrulama)

CLI, örneğinizi genel olarak yönetmenin dışında dağıtım ve doğrulama için de kullanışlı bir araçtır.

  • Denetim düzlemi komutları, yeni bir örneğin dağıtımını yinelenebilir veya otomatik hale getirmek için kullanılabilir.
  • Veri düzlemi komutları örneğinizdeki değerleri hızla denetlemek ve işlemlerin beklendiği gibi tamamlandığını doğrulamak için kullanılabilir.

Komut kümesini alma

Azure Digital Twins komutları, Azure CLI (azure-iot) için Azure IoT uzantısının bir parçasıdır, bu nedenle komutlarla birlikte en son azure-iot uzantıya sahip olduğunuzdan az dt emin olmak için bu adımları izleyin.

CLI sürüm gereksinimleri

Azure CLI'yi PowerShell ile kullanıyorsanız, uzantı paketinin bir gereksinimi olarak Azure CLI sürümünüz 2.3.1 veya üzeri olmalıdır.

Şu CLI komutuyla Azure CLI sürümünüzü de kontrol edebilirsiniz:

az --version

Azure CLI'yı daha yeni bir sürüme yükleme veya güncelleştirme yönergeleri için bkz. Azure CLI'yi yükleme.

Uzantıyı alma

Azure CLI, uzantıyı gerektiren bir komutun ilk kullanımında otomatik olarak yüklemenizi ister.

Aksi takdirde, uzantıyı istediğiniz zaman kendiniz yüklemek için aşağıdaki komutu kullanabilirsiniz (veya daha eski bir sürüme sahip olduğunuz ortaya çıkarsa bu uzantıyı güncelleştirebilirsiniz). Komut , Azure Cloud Shell'de veya yerel bir Azure CLI'da çalıştırılabilir.

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

Farklı kabuklarda özel karakterler kullanın

Bazı az dt komutlar, belirli kabuk ortamlarında düzgün bir şekilde ayrıştırılabilmesi için kaçınılması gerekebilecek özel karakterler kullanır. Bu bölümdeki ipuçlarını, tercih ettiğiniz kabuktaki özel karakterlerden ne zaman kaçabileceğinizi bilmenize yardımcı olması için kullanın.

Bash

Bash ortamları için bu özel karakter ipuçlarını kullanın.

Sorular

Birçok ikiz sorgusunda, ikizin $ özelliğine başvurmak için $dtId karakteri kullanılır. Cloud Shell Bash ortamında sorgulamak için az dt twin query komutunu kullanırken karakterden $ ters eğik çizgi (\ ) ile kurtulabilirsiniz.

Cloud Shell Bash ortamında CLI komutuyla ikiz sorgulama örneği aşağıda verilmiştir:

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

PowerShell

PowerShell ortamları için bu özel karakter ipuçlarını kullanın.

Satır içi JSON

az dt twin create gibi bazı komutlar, satır içi JSON biçiminde ikiz bilgilerini girmenize olanak sağlar. PowerShell ortamına satır içi JSON girerken, JSON içinde ters eğik çizgi (") ile çift tırnak karakterlerinden (\) kaçabilirsiniz.

Aşağıda PowerShell'de CLI komutuyla ikiz oluşturma örneği verilmiştir:

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

Tavsiye

Satır içi JSON'ı destekleyen komutların çoğu, dosya yolu olarak girişi de destekler ve bu da kabuğa özgü metin gereksinimlerinden kaçınmanıza yardımcı olabilir.

Sorular

Birçok ikiz sorgusunda, ikizin $ özelliğine başvurmak için $dtId karakteri kullanılır. PowerShell ortamında sorgulama yapmak için az dt twin query komutunu kullanırken, $ karakterini bir backtick işaretiyle kaçışa alın.

PowerShell'de CLI komutuyla ikiz sorgulama örneği aşağıda verilmiştir:

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

Windows CMD

Yerel Windows CMD için bu özel karakter ipuçlarını kullanın.

Satır içi JSON

az dt twin create gibi bazı komutlar, satır içi JSON biçiminde ikiz bilgilerini girmenize olanak sağlar. tr-TR: Yerel bir Windows CMD penceresine satır içi JSON girerken, parametre değerini tek tırnak (") yerine çift tırnak (') içine alın ve JSON içindeki çift tırnak karakterlerini ters eğik çizgi (\) ile kaçış karakteri haline getirin.

Aşağıda, yerel Windows CMD'de CLI komutuyla ikiz oluşturma örneği verilmişti:

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

Tavsiye

Satır içi JSON'ı destekleyen komutların çoğu, dosya yolu olarak girişi de destekler ve bu da kabuğa özgü metin gereksinimlerinden kaçınmanıza yardımcı olabilir.

Sonraki adımlar

Başvuru belgeleri aracılığıyla CLI'yı ve komut kümesinin tamamını keşfedin:

  • Last updated on