az iot edge devices

Note

Bu başvuru, Azure CLI (sürüm 2.67.0 veya üzeri) için azure-iot uzantısının bir parçasıdır. uzantı, 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ı yönetme komutları.

Komutlar

Name Description Tür Durum
az iot edge devices create

Bir IoT Hub birden çok uç cihazı oluşturun ve yapılandırın.

 Extension Experimental

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

Bir IoT Hub birden çok uç cihazı oluşturun ve yapılandırın.

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 [--acquire-policy-token]
                           [--auth-type {key, login}]
                           [--cfg --config --config-file]
                           [--change-reference]
                           [--clean {false, true}]
                           [--dct --device-config-template]
                           [--dea --default-agent --default-edge-agent]
                           [--device]
                           [--device-auth --device-auth-type {shared_private_key, x509_thumbprint}]
                           [--hub-name]
                           [--login]
                           [--out --output-path]
                           [--rc --root-cert]
                           [--resource-group]
                           [--rk --root-key]
                           [--root-pass --rp]
                           [--vis --visualize {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

Aşağıdaki parametreler isteğe bağlıdır, ancak bağlama bağlı olarak komutun başarıyla yürütülmesi için bir veya daha fazla parametre gerekli olabilir.

--acquire-policy-token

Bu kaynak işlemi için otomatik olarak bir Azure Policy belirteci alma.

Özellik Değer
Parametre grubu: Global Policy Arguments
--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.

Özellik Değer
Parametre grubu: Access Control Arguments
Default value: key
Kabul edilen değerler: key, login
--cfg --config --config-file

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

--change-reference

Bu kaynak işlemi için ilgili değişiklik başvuru kimliği.

Özellik Değer
Parametre grubu: Global Policy Arguments
--clean -c

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

Özellik Değer
Default value: False
Kabul edilen değerler: false, true
--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ı.

Özellik Değer
Kabul edilen değerler: shared_private_key, x509_thumbprint
--hub-name -n

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

Özellik Değer
Parametre grubu: IoT Hub Identifier Arguments
--login -l

Bu komut, eylem gerçekleştirme haklarına sahip bir varlık connection string destekler. "az login" aracılığıyla oturum açmaktan kaçınmak için kullanın. Hem varlık connection string hem de ad sağlanırsa, connection string öncelik alır. --hub-name sağlanmadıysa gereklidir.

Özellik Değer
Parametre grubu: IoT Hub Identifier Arguments
--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.

Özellik Değer
Parametre grubu: Root Certificate Arguments
--resource-group -g

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

--rk --root-key

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

Özellik Değer
Parametre grubu: Root Certificate Arguments
--root-pass --rp

Kök anahtar parolası.

Özellik Değer
Parametre grubu: Root Certificate Arguments
--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.).

Özellik Değer
Default value: False
Kabul edilen değerler: false, true
--yes -y

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

Özellik Değer
Default value: False
Kabul edilen değerler: false, true
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.

Özellik Değer
Default value: False
--help -h

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

--only-show-errors

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

Özellik Değer
Default value: False
--output -o

Çıkış biçimi.

Özellik Değer
Default value: json
Kabul edilen değerler: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

Aboneliğin adı veya kimliği. az account set -s NAME_OR_IDkullanarak varsayı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.

Özellik Değer
Default value: False