Azure Digital Twins CLI komut kümesi

  • Makale

Azure Digital Twins örneğinizi Azure portal yönetmenin yanı sıra Azure CLI için hizmetle ilgili en önemli eylemleri gerçekleştirmek için kullanabileceğiniz bir komut kümesi de vardır. Bu makale, kullanımları, nasıl edinecekleri ve kullanma gereksinimleri dahil olmak üzere Azure Digital Twins için Azure CLI komut kümesini kapsar.

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 bunların kullanımı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 için Azure IoT uzantısının (azure-iot) bir parçasıdır, bu nedenle komutları içeren 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ı yükleme veya daha yeni bir sürüme 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 veya yerel bir Azure CLI'da çalıştırılabilir.

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

Farklı kabuklarda özel karakterler kullanma

Bazı az dt komutlar, belirli kabuk ortamlarında uygun ayrıştırma için kaçış karakteri kullanılması gerekebilecek özel karakterler kullanır. Bunu tercih ettiğiniz kabukta ne zaman yapacağınızı bilmenize yardımcı olması için bu bölümdeki ipuçlarını kullanın.

Bash

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

Sorgular

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

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 çizgiyle (" ) çift tırnak karakterinden (\) kaçış karakteri kullanın.

PowerShell'de CLI komutuyla ikiz oluşturma örneği aşağıda 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}'

İpucu

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

Sorgular

Birçok ikiz sorgusunda $ karakteri bir ikizin özelliğine $dtId başvurmak için kullanılır. PowerShell ortamında sorgulamak için az dt twin query komutunu kullanırken, karakteri bir ters köşe karakteriyle bırakı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. 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çinde ters eğik çizgi (\ ile kaçış çift tırnak karakterleri).

Aşağıda, yerel Windows CMD'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}"

İpucu

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

Sonraki adımlar

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