az iot edge devices
Not
Bu başvuru, Azure CLI (sürüm 2.46.0 veya üzeri) için azure-iot uzantısının bir parçasıdır. Uzantı, bir az iot edge devices komutunu ilk kez çalıştırdığınızda otomatik olarak yüklenir. Uzantılar hakkında daha fazla bilgi edinin.
IoT Edge cihazlarını yönetme komutları.
Komutlar
Name | Description | Tür | Durum |
---|---|---|---|
az iot edge devices create |
IoT Hub'da birden çok uç cihazı oluşturma ve yapılandırma. |
Dahili | Deneysel |
az iot edge devices create
Bu komut deneysel ve geliştirme aşamasındadır. Başvuru ve destek düzeyleri: https://aka.ms/CLI_refstatus
IoT Hub'da birden çok uç cihazı oluşturma ve yapılandırma.
Bu işlem, YAML veya JSON biçiminde satır içi cihaz bağımsız değişkenlerini veya bir uç cihaz yapılandırma dosyasını kabul eder. Satır içi komut args ('--device-auth' gibi) öncelik kazanır ve sağlanırsa yapılandırma dosyası özelliklerini geçersiz kılar. Burada örnek bir yapılandırma dosyası bulunabilir: https://aka.ms/aziotcli-edge-devices-config Bu işlemin tam olarak nasıl kullanıldığına ilişkin ayrıntılar için örnekleri ve parametre açıklamalarını gözden geçirin.
az iot edge devices create [--auth-type {key, login}]
[--cfg]
[--clean {false, true}]
[--dct]
[--dea]
[--device]
[--device-auth {shared_private_key, x509_thumbprint}]
[--hub-name]
[--login]
[--out]
[--rc]
[--resource-group]
[--rk]
[--root-pass]
[--vis {false, true}]
[--yes {false, true}]
Örnekler
Simetrik anahtar kimlik doğrulamasını kullanarak birkaç uç cihaz oluşturma (varsayılan)
az iot edge devices create -n {hub_name} --device id=device_1 --device id=device_2
Satır içi bağımsız değişkenleri kullanarak çeşitli uç özellik yapılandırmalarıyla otomatik olarak imzalanan sertifika kimlik doğrulaması kullanarak uç cihazların düz bir listesini oluşturun.
az iot edge devices create -n {hub_name} --device-auth x509_thumbprint --default-edge-agent "mcr.microsoft.com/azureiotedge-agent:1.4"
--device id=device_1 hostname={FQDN}
--device id=device_2 edge_agent={agent_image}
--device id=parent hostname={FQDN} edge_agent={agent_image} container_auth={path_or_json_string}
Bir hub'daki tüm mevcut cihaz kimliklerini silin ve bir yapılandırma dosyasını temel alan yeni cihazlar oluşturun (ilerleme çubukları ve görselleştirme çıkışı ile).
az iot edge devices create -n {hub_name} --cfg path/to/config_yml_or_json -c -v
Satır içi bağımsız değişkenleri kullanarak her biri 1 alt cihaza sahip 2 üst cihaz içeren özel modül dağıtımlarıyla iç içe uç cihazları grubu oluşturun. Ayrıca cihaz sertifika paketleri için çıkış yolunu belirtir.
az iot edge devices create -n {hub_name} --out {device_bundle_path}
--device id=parent_1 deployment=/path/to/parentDeployment_1.json
--device id=child_1 parent=parent_1 deployment=/path/to/child_deployment_1.json
--device id=parent_2 deployment=/path/to/parentDeployment_2.json
--device id=child_2 parent=parent_2 deployment=/path/to/child_deployment_2.json
x509 kimlik doğrulamasını kullanarak var olan bir kök CA ile basit bir iç içe uç cihaz yapılandırması oluşturun ve özel bir cihaz paketi çıkış yolu belirtin.
az iot edge devices create -n {hub_name} --out {device_bundle_path}
--root-cert "root_cert.pem" --root-key "root_key.pem" --device-auth x509_thumbprint
--device id=parent1
--device id=child1 parent=parent1
İsteğe Bağlı Parametreler
İşlemin bir ilke anahtarını otomatik olarak türetmesi mi yoksa geçerli Azure AD oturumunu mu kullanması gerektiğini gösterir. Kimlik doğrulama türü oturum açma bilgisiyse ve kaynak ana bilgisayar adı sağlanmışsa, gerekmedikçe kaynak araması atlanır. kullanarak varsayılanı az configure --defaults iothub-data-auth-type=<auth-type-value>
yapılandırabilirsiniz.
Cihaz yapılandırma dosyasının yolu. Örnek yapılandırma dosyası: https://aka.ms/aziotcli-edge-devices-config.
Yeni cihaz oluşturmadan önce hedef hub'daki tüm cihazları siler.
Uç cihaz yapılandırmaları için temel olarak kullanılacak IoT Edge config.toml dosyasının yolu.
Ayrı olarak belirtilmezse, oluşturulan Edge cihazları için varsayılan edge aracısı.
Oluşturulacak kenar cihazının özelliklerine karşılık gelen boşlukla ayrılmış anahtar=değer çiftleri. Aşağıdaki anahtar değerler desteklenir: id
(device_id), deployment
(satır içi json veya dosya yolu), hostname
, parent
(device_id), edge_agent
(görüntü URL'si) ve container_auth
(satır içi json veya dosya yolu). --cihaz 1 veya daha fazla kez kullanılabilir. Tam parametre kullanımı için yardım örneklerini gözden geçirin. Bu parametreler, örnek yapılandırma dosyamızda karşılık gelen değerlerine de başvurur: https://aka.ms/aziotcli-edge-devices-config.
Cihazdan hub'a yetkilendirme mekanizması.
IoT Hub adı veya ana bilgisayar adı. --login sağlanmadıysa gereklidir.
Bu komut, eylem gerçekleştirme haklarına sahip bir varlık bağlantı dizesi destekler. "az login" aracılığıyla oturum açmaktan kaçınmak için kullanın. Hem varlık bağlantı dizesi hem de ad sağlanırsa, bağlantı dizesi öncelik alır. --hub-name sağlanmadıysa gereklidir.
Cihaz yapılandırma paketlerinin çıkış yolu. Bu değer belirtilmezse, hiçbir dosya çıkışı oluşturulmaz.
İç içe uç cihaz sertifikalarını imzalamak için kök ortak anahtar sertifikası yolu.
Kaynak grubunun adı. kullanarak varsayılan grubu az configure --defaults group=<name>
yapılandırabilirsiniz.
İç içe uç cihaz sertifikalarını imzalamak için kök özel anahtarın yolu.
Kök anahtar parolası.
Cihazların görselleştirmelerini ve çeşitli görevlerin ilerleme durumunu gösterir (cihaz oluşturma, ana öğeleri ayarlama, yapılandırmaları güncelleştirme vb.).
Mevcut hub cihazlarını silmek için --clean anahtarı kullanıldığında onay istemde bulunmayın.
Global Parametreler
Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.
Bu yardım iletisini göster ve çık.
Yalnızca hataları gösterir ve uyarıları gizler.
Çıkış biçimi.
JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz http://jmespath.org/ .
Aboneliğin adı veya kimliği. kullanarak az account set -s NAME_OR_ID
varsayılan aboneliği yapılandırabilirsiniz.
Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.