az iot edge deployment

Not

Bu başvuru, Azure CLI (sürüm 2.30.0 veya üzeri) için azure-iot uzantısının bir parçasıdır. Uzantı, bir az iot edge deployment komutunu ilk kez çalıştırdığınızda otomatik olarak yüklenir. Uzantılar hakkında daha fazla bilgi edinin.

IoT Edge dağıtımlarını büyük ölçekte yönetin.

Komutlar

az iot edge deployment create	Hedef IoT Hub IoT Edge dağıtımı oluşturun.
az iot edge deployment delete	IoT Edge dağıtımlarını silin.
az iot edge deployment list	IoT Hub IoT Edge dağıtımlarını listeleyin.
az iot edge deployment show	IoT Edge dağıtımının ayrıntılarını alın.
az iot edge deployment show-metric	IoT Edge dağıtımında tanımlanan hedef sistem ölçümünü değerlendirme.
az iot edge deployment update	IoT Edge dağıtımının belirtilen özelliklerini güncelleştirin. Dağıtımı güncelleştirmek için --set ve ardından özellik atamaları kullanın. Not: IoT Edge dağıtım içeriği sabittir. Güncelleştirilebilen dağıtım özellikleri :'etiketler', 'ölçümler', 'priority' ve 'targetCondition'.

az iot edge deployment create

Hedef IoT Hub IoT Edge dağıtımı oluşturun.

Dağıtım içeriği json biçimindedir ve {"modulesContent":{...}} biçimindedir veya {"content":{"modulesContent":{...}}.

$edgeAgent ve $edgeHub sistem modüllerinin varsayılan özellikleri, IoT uzantısıyla yüklenen şemalarda doğrulanır. Bu, --no-validation anahtarı kullanılarak devre dışı bırakılabilir.

Edge dağıtımları, isteğe bağlı değerlendirme için kullanıcı tanımlı ölçümlerle oluşturulabilir. Kullanıcı ölçümleri json ve {"queries":{...}} biçimindedir veya {"metrics":{"queries":{...}}}.

az iot edge deployment create --content
                              --deployment-id
                              [--auth-type {key, login}]
                              [--hub-name]
                              [--lab]
                              [--layered {false, true}]
                              [--login]
                              [--metrics]
                              [--no-validation {false, true}]
                              [--pri]
                              [--resource-group]
                              [--target-condition]

Örnekler

'Bina 9' içindeki cihazlar için geçerli olan etiketlerle (bash söz dizimi örneği) bir dağıtım oluşturun ve ortam 'test'tir.

az iot edge deployment create -d {deployment_name} -n {iothub_name} --content modules_content.json --labels '{"key0":"value0", "key1":"value1"}' --target-condition "tags.building=9 and tags.environment='test'" --priority 3

'dev' ortamıyla etiketlenmiş cihazlar için geçerli olan etiketlerle (powershell söz dizimi örneği) bir dağıtım oluşturun.

az iot edge deployment create -d {deployment_name} -n {iothub_name} --content modules_content.json --labels "{'key':'value'}" --target-condition "tags.environment='dev'"

'dev' ortamıyla etiketlenmiş cihazlar için geçerli olan katmanlı bir dağıtım oluşturun. Satır içinde tanımlanan hem kullanıcı ölçümleri hem de modül içeriği (powershell söz dizimi örneği).

az iot edge deployment create -d {deployment_name} -n {iothub_name} --content "{'modulesContent':{'`$edgeAgent':{'properties.desired.modules.mymodule0':{ }},'`$edgeHub':{'properties.desired.routes.myroute0':'FROM /messages/* INTO `$upstream'}}}" --target-condition "tags.environment='dev'" --priority 10 --metrics "{'queries':{'mymetrik':'SELECT deviceId from devices where properties.reported.lastDesiredStatus.code = 200'}}" --layered

'Derleme 9' ve 'test' ortamındaki cihazlar için geçerli olan katmanlı bir dağıtım oluşturun. Satır içinde tanımlanan hem kullanıcı ölçümleri hem de modül içeriği (bash söz dizimi örneği).

az iot edge deployment create -d {deployment_name} -n {iothub_name} --content '{"modulesContent":{"$edgeAgent":{"properties.desired.modules.mymodule0":{ }},"$edgeHub":{"properties.desired.routes.myroute0":"FROM /messages/* INTO $upstream"}}}' --target-condition "tags.building=9 and tags.environment='test'" --metrics '{"queries":{"mymetrik":"SELECT deviceId from devices where properties.reported.lastDesiredStatus.code = 200"}}' --layered

'Derleme 9' ve 'test' ortamındaki cihazlar için geçerli olan katmanlı bir dağıtım oluşturun. Hem kullanıcı ölçümleri hem de dosyadan tanımlanan modül içeriği.

az iot edge deployment create -d {deployment_name} -n {iothub_name} --content layered_modules_content.json --target-condition "tags.building=9 and tags.environment='test'" --metrics metrics_content.json --layered

Gerekli Parametreler

--content -k

Dağıtım içeriğini IoT Edge. Dosya yolu veya ham json sağlayın.

--deployment-id -d

Hedef dağıtım adı.

İsteğe Bağlı Parametreler

--auth-type

İşlemin bir ilke anahtarını otomatik olarak türetmesi mi yoksa geçerli Azure AD oturumu mu kullanması gerektiğini gösterir. varsayılanı kullanarak az configure --defaults iothub-data-auth-type=<auth-type-value>yapılandırabilirsiniz.

kabul edilen değerler: key, login

varsayılan değer: key

--hub-name -n

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

--lab --labels

Hedef dağıtıma uygulanacak etiketlerin haritası. Şu biçimi kullanın: '{"key0":"value0", "key1":"value1"}'.

--layered

Katmanlı dağıtımlar, $edgeAgent, $edgeHub ve temel dağıtımın üzerine katmanlanacak kullanıcı modüllerinde istenen özellikleri tanımlamanızı sağlar. Örneğin, katmanlı dağıtımda belirtilen yollar temel dağıtımın yolları ile birleştirilir. Dağıtım önceliğine göre aynı ada sahip yolların üzerine yazılır.

kabul edilen değerler: false, true

--login -l

Bu komut, eylem gerçekleştirme haklarına sahip bir varlık bağlantı dizesini 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ğlanmışsa, bağlantı dizesi öncelik alır. --hub-name sağlanmadıysa gereklidir.

--metrics -m

Dağıtım ölçümü tanımlarını IoT Edge. Dosya yolu veya ham json sağlayın.

--no-validation

Uç dağıtımı oluşturmak için istemci tarafı şema doğrulamasını devre dışı bırakır.

kabul edilen değerler: false, true

--pri --priority

Rakip kurallar (en yüksek galibiyet) durumunda dağıtımın ağırlığı.

--resource-group -g

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

--target-condition --tc -t

Uç dağıtımının uygulandığı hedef koşul. Hedef koşulu olmayan dağıtımlar hiçbir cihazı hedeflemez.

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öster, uyarıları gizle.

--output -o

Çıkış biçimi.

--query

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

--subscription

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

az iot edge deployment delete

IoT Edge dağıtımlarını silin.

az iot edge deployment delete --deployment-id
                              [--auth-type {key, login}]
                              [--etag]
                              [--hub-name]
                              [--login]
                              [--resource-group]

Gerekli Parametreler

--deployment-id -d

Hedef dağıtım adı.

İsteğe Bağlı Parametreler

--auth-type

İşlemin bir ilke anahtarını otomatik olarak türetmesi mi yoksa geçerli Azure AD oturumu mu kullanması gerektiğini gösterir. varsayılanı kullanarak az configure --defaults iothub-data-auth-type=<auth-type-value>yapılandırabilirsiniz.

kabul edilen değerler: key, login

varsayılan değer: key

--etag -e

Kaynağın son durumuna karşılık gelen etag veya varlık etiketi. Etag sağlanmazsa '*' değeri kullanılır.

--hub-name -n

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

--login -l

Bu komut, eylem gerçekleştirme haklarına sahip bir varlık bağlantı dizesini 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ğlanmışsa, bağlantı dizesi öncelik alır. --hub-name sağlanmadıysa gereklidir.

--resource-group -g

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

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öster, uyarıları gizle.

--output -o

Çıkış biçimi.

--query

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

--subscription

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

az iot edge deployment list

IoT Hub IoT Edge dağıtımlarını listeleyin.

az iot edge deployment list [--auth-type {key, login}]
                            [--hub-name]
                            [--login]
                            [--resource-group]
                            [--top]

İsteğe Bağlı Parametreler

--auth-type

İşlemin bir ilke anahtarını otomatik olarak türetmesi mi yoksa geçerli Azure AD oturumu mu kullanması gerektiğini gösterir. varsayılanı kullanarak az configure --defaults iothub-data-auth-type=<auth-type-value>yapılandırabilirsiniz.

kabul edilen değerler: key, login

varsayılan değer: key

--hub-name -n

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

--login -l

Bu komut, eylem gerçekleştirme haklarına sahip bir varlık bağlantı dizesini 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ğlanmışsa, bağlantı dizesi öncelik alır. --hub-name sağlanmadıysa gereklidir.

--resource-group -g

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

--top

Döndürülecek en fazla dağıtım sayısı. Varsayılan olarak tüm dağıtımlar döndürülür.

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öster, uyarıları gizle.

--output -o

Çıkış biçimi.

--query

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

--subscription

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

az iot edge deployment show

IoT Edge dağıtımının ayrıntılarını alın.

az iot edge deployment show --deployment-id
                            [--auth-type {key, login}]
                            [--hub-name]
                            [--login]
                            [--resource-group]

Gerekli Parametreler

--deployment-id -d

Hedef dağıtım adı.

İsteğe Bağlı Parametreler

--auth-type

İşlemin bir ilke anahtarını otomatik olarak türetmesi mi yoksa geçerli Azure AD oturumu mu kullanması gerektiğini gösterir. varsayılanı kullanarak az configure --defaults iothub-data-auth-type=<auth-type-value>yapılandırabilirsiniz.

kabul edilen değerler: key, login

varsayılan değer: key

--hub-name -n

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

--login -l

Bu komut, eylem gerçekleştirme haklarına sahip bir varlık bağlantı dizesini 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ğlanmışsa, bağlantı dizesi öncelik alır. --hub-name sağlanmadıysa gereklidir.

--resource-group -g

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

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öster, uyarıları gizle.

--output -o

Çıkış biçimi.

--query

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

--subscription

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

az iot edge deployment show-metric

IoT Edge dağıtımında tanımlanan hedef sistem ölçümünü değerlendirme.

az iot edge deployment show-metric --deployment-id
                                   --metric-id
                                   [--auth-type {key, login}]
                                   [--hub-name]
                                   [--login]
                                   [--metric-type {system, user}]
                                   [--resource-group]

Örnekler

'appliedCount' sistem ölçümünü değerlendirme

az iot edge deployment show-metric -m appliedCount -d {deployment_name} -n {iothub_name} --mt system

'myCustomMetric' kullanıcı ölçümünü değerlendirme

az iot edge deployment show-metric -m myCustomMetric -d {deployment_name} -n {iothub_name}

Gerekli Parametreler

--deployment-id -d

Hedef dağıtım adı.

--metric-id -m

Değerlendirme için hedef ölçüm.

İsteğe Bağlı Parametreler

--auth-type

İşlemin bir ilke anahtarını otomatik olarak türetmesi mi yoksa geçerli Azure AD oturumu mu kullanması gerektiğini gösterir. varsayılanı kullanarak az configure --defaults iothub-data-auth-type=<auth-type-value>yapılandırabilirsiniz.

kabul edilen değerler: key, login

varsayılan değer: key

--hub-name -n

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

--login -l

Bu komut, eylem gerçekleştirme haklarına sahip bir varlık bağlantı dizesini 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ğlanmışsa, bağlantı dizesi öncelik alır. --hub-name sağlanmadıysa gereklidir.

--metric-type --mt

Bir ölçümü aramak için hangi ölçüm koleksiyonunun kullanılması gerektiğini gösterir.

kabul edilen değerler: system, user

varsayılan değer: user

--resource-group -g

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

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öster, uyarıları gizle.

--output -o

Çıkış biçimi.

--query

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

--subscription

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

az iot edge deployment update

IoT Edge dağıtımının belirtilen özelliklerini güncelleştirin.

Dağıtımı güncelleştirmek için --set ve ardından özellik atamaları kullanın.

Not: IoT Edge dağıtım içeriği sabittir. Güncelleştirilebilen dağıtım özellikleri :'etiketler', 'ölçümler', 'priority' ve 'targetCondition'.

az iot edge deployment update --deployment-id
                              [--add]
                              [--auth-type {key, login}]
                              [--etag]
                              [--force-string]
                              [--hub-name]
                              [--login]
                              [--remove]
                              [--resource-group]
                              [--set]

Örnekler

Mevcut uç dağıtımının etiketlerini ve hedef koşulunu değiştirme

az iot edge deployment update -d {deployment_name} -n {iothub_name} --set labels='{"purpose":"dev", "owners":"IoTEngineering"}' targetCondition='tags.building=9'

Gerekli Parametreler

--deployment-id -d

Hedef dağıtım adı.

İsteğe Bağlı Parametreler

--add

Bir yol ve anahtar değer çiftleri belirterek nesne listesine nesne ekleyin. Örnek: --add property.listProperty <key=value, string veya JSON dize>.

--auth-type

İşlemin bir ilke anahtarını otomatik olarak türetmesi mi yoksa geçerli Azure AD oturumu mu kullanması gerektiğini gösterir. varsayılanı kullanarak az configure --defaults iothub-data-auth-type=<auth-type-value>yapılandırabilirsiniz.

kabul edilen değerler: key, login

varsayılan değer: key

--etag -e

Kaynağın son durumuna karşılık gelen etag veya varlık etiketi. Etag sağlanmazsa '*' değeri kullanılır.

--force-string

'set' veya 'add' kullanırken, JSON'a dönüştürmeye çalışmak yerine dize değişmez değerlerini koruyun.

--hub-name -n

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

--login -l

Bu komut, eylem gerçekleştirme haklarına sahip bir varlık bağlantı dizesini 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ğlanmışsa, bağlantı dizesi öncelik alır. --hub-name sağlanmadıysa gereklidir.

--remove

Bir özelliği veya öğeyi listeden kaldırın. Örnek: --remove property.list OR --remove propertyToRemove.

--resource-group -g

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

--set

Ayarlanacağı özellik yolunu ve değeri belirterek bir nesneyi güncelleştirin. Örnek: --set property1.property2=.

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öster, uyarıları gizle.

--output -o

Çıkış biçimi.

--query

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

--subscription

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