az iot edge devices

Dekont

Bu başvuru, Azure CLI (sürüm 2.37.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

Deneysel

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

--auth-type

İş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.

kabul edilen değerler: key, login

varsayılan değer: key

--cfg --config --config-file

Cihaz yapılandırma dosyasının yolu. Örnek yapılandırma dosyası: https://aka.ms/aziotcli-edge-devices-config.

--clean -c

Yeni cihaz oluşturmadan önce hedef hub'daki tüm cihazları siler.

kabul edilen değerler: false, true

varsayılan değer: False

--dct --device-config-template

Uç cihaz yapılandırmaları için temel olarak kullanılacak IoT Edge config.toml dosyasının yolu.

--dea --default-agent --default-edge-agent

Ayrı olarak belirtilmezse, oluşturulan Edge cihazları için varsayılan edge aracısı.

--device -d

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.

--device-auth --device-auth-type

Cihazdan hub'a yetkilendirme mekanizması.

kabul edilen değerler: shared_private_key, x509_thumbprint

--hub-name -n

IoT Hub adı veya ana bilgisayar adı. --login sağlanmadıysa gereklidir.

--login -l

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.

--out --output-path

Cihaz yapılandırma paketlerinin çıkış yolu. Bu değer belirtilmezse, hiçbir dosya çıkışı oluşturulmaz.

--rc --root-cert

İç içe uç cihaz sertifikalarını imzalamak için kök ortak anahtar sertifikası yolu.

--resource-group -g

Kaynak grubunun adı. kullanarak varsayılan grubu az configure --defaults group=<name>yapılandırabilirsiniz.

--rk --root-key

İç içe uç cihaz sertifikalarını imzalamak için kök özel anahtarın yolu.

--root-pass --rp

Kök anahtar parolası.

--vis --visualize -v

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.).

kabul edilen değerler: false, true

varsayılan değer: False

--yes -y

Mevcut hub cihazlarını silmek için --clean anahtarı kullanıldığında onay istemde bulunmayın.

kabul edilen değerler: false, true

varsayılan değer: False

Global Parametreler

--debug

Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.

--help -h

Bu yardım iletisini göster ve çık.

--only-show-errors

Yalnızca hataları gösterir ve uyarıları gizler.

--output -o

Çıkış biçimi.

kabul edilen değerler: json, jsonc, none, table, tsv, yaml, yamlc

varsayılan değer: json

--query

JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz http://jmespath.org/ .

--subscription

Aboneliğin adı veya kimliği. kullanarak az account set -s NAME_OR_IDvarsayılan aboneliği yapılandırabilirsiniz.

--verbose

Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.