az iot edge deployment

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ı, 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

Name	Description	Tür	Durum
az iot edge deployment create	Hedef IoT Hub bir IoT Edge dağıtımı oluşturun.	Extension	GA
az iot edge deployment delete	IoT Edge dağıtımlarını silme.	Extension	GA
az iot edge deployment list	IoT Hub IoT Edge dağıtımlarını listeleyin.	Extension	GA
az iot edge deployment show	IoT Edge dağıtımının ayrıntılarını alın.	Extension	GA
az iot edge deployment show-metric	IoT Edge dağıtımında tanımlanan hedef sistem ölçümünü değerlendirme.	Extension	GA
az iot edge deployment update	IoT Edge dağıtımının belirtilen özelliklerini güncelleştirin.	Extension	GA

az iot edge deployment create

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

Dağıtım içeriği json 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 doğrulama temel dağıtımlara yöneliktir. İlgili şema kullanılamıyorsa veya temel dağıtım biçimi algılanmazsa, bu adım atlanır. Şema doğrulaması --no-validation anahtarı kullanılarak devre dışı bırakılabilir.

Bir modülün properties.desired.* tanımlanmışsa uç dağıtımı katmanlı olarak sınıflandırılır. Katmanlı dağıtım tarafından hedeflenen tüm uç cihazlara önce bir temel dağıtım uygulanması gerekir.

Bir cihazı hedefleyen katmanlı dağıtımların, bu cihaz için temel dağıtımdan daha yüksek önceliğe sahip olması gerekir.

Not: Modül ikizinin properties.desired alanı katmanlı bir dağıtımda ayarlanırsa properties.desired, düşük öncelikli dağıtımlarda söz konusu modül için istenen özelliklerin üzerine yazar.

az iot edge deployment create --content
                              --deployment-id
                              [--acquire-policy-token]
                              [--auth-type {key, login}]
                              [--change-reference]
                              [--cl --custom-labels]
                              [--cmq --custom-metric-queries]
                              [--hub-name]
                              [--lab --labels]
                              [--layered {false, true}]
                              [--login]
                              [--metrics]
                              [--no-validation {false, true}]
                              [--pri --priority]
                              [--resource-group]
                              [--target-condition --tc]

Örnekler

'Bina 9' içindeki cihazlar için geçerli olan ve ortamı 'test' olan etiketlerle (bash 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 '{"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). Bunun properties.desired.* tanımlandığı için katmanlı dağıtım biçiminde olduğunu unutmayın.

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'}}"

'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). Bunun properties.desired.* tanımlandığı için katmanlı dağıtım biçiminde olduğunu unutmayın.

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"}}'

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

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

Etiketlerin ve ölçümlerin kabuktan bağımsız girişiyle tanımı dosyadan gelen bir dağıtım oluşturun.

az iot edge deployment create -d {deployment_name} -n {iothub_name} --content ./modules_content.json --target-condition "tags.building=9 and tags.environment='test'" --custom-labels key0=value0 key1=value1 --custom-metric-queries mymetric1="select deviceId from devices where tags.location='US'" mymetric2="select *"

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ı. Küçük harf ve şu özel karakterlere izin verilir: [-+%_*!'].

İ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

--change-reference

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

Özellik	Değer
Parametre grubu:	Global Policy Arguments

--cl --custom-labels

--labels için alternatif bir giriş stili (boşlukla ayrılmış anahtar=değer çiftleri) ve gelecekte bunu değiştirmek için tasarlanmıştır. Biçim örneği: key1=value1 key2="bu benim değerim".

--cmq --custom-metric-queries

--metrics için alternatif bir giriş stili (boşlukla ayrılmış anahtar=değer çiftleri) ve gelecekte bunu değiştirmek için tasarlanmıştır. Biçim örneği: metric1="tags.location='US'" metric2="select *" olan cihazlardan deviceId'yi seçin.

--hub-name -n

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

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

--lab --labels

Hedef dağıtıma uygulanacak etiketlerin haritası. Şu biçimi kullanın: '{"key0":"value0", "key1":"value1"}'. --labels yerine --custom-labels kullanılması önerilir.

--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. Katmanlı dağıtımda belirtilen özellikler, temel dağıtımın özellikleriyle birleştirilir. Aynı yola sahip özelliklerin üzerine dağıtım önceliğine göre yazılır. Bu seçenek ,no-validation için bir diğer addır.

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

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

--metrics -m

Dağıtım kullanıcı ölçümü tanımlarını IoT Edge. Dosya yolu veya ham json sağlayın. Kullanıcı ölçümleri {"queries":{...}} biçimindedir veya {"metrics":{"queries":{...}}}. --metrics yerine --custom-metric-queries kullanılması önerilir.

--no-validation

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

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

--pri --priority

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

Özellik	Değer
Default value:	0

--resource-group -g

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

--target-condition --tc -t

Uç dağıtımının uygulandığı hedef koşul. Hedef koşul içermeyen dağıtımlar hiçbir cihazı hedeflemez. Şu biçimi kullanın: "tags.environment='test'".

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

az iot edge deployment delete

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

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

Gerekli Parametreler

--deployment-id -d

Hedef dağıtım adı. Küçük harf ve şu özel karakterlere izin verilir: [-+%_*!'].

İ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

--change-reference

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

Özellik	Değer
Parametre grubu:	Global Policy Arguments

--etag -e

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

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

--resource-group -g

Kaynak grubunun adı. az configure --defaults group=<name>kullanarak varsayılan grubu 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.

Ö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

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

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.

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

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

--resource-group -g

Kaynak grubunun adı. az configure --defaults group=<name>kullanarak varsayılan grubu 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.

Ö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

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ı. Küçük harf ve şu özel karakterlere izin verilir: [-+%_*!'].

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

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

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

--resource-group -g

Kaynak grubunun adı. az configure --defaults group=<name>kullanarak varsayılan grubu 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.

Ö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

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
                                   [--acquire-policy-token]
                                   [--auth-type {key, login}]
                                   [--change-reference]
                                   [--hub-name]
                                   [--login]
                                   [--metric-type --mt {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ı. Küçük harf ve şu özel karakterlere izin verilir: [-+%_*!'].

--metric-id -m

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

İ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

--change-reference

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

Özellik	Değer
Parametre grubu:	Global Policy Arguments

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

--metric-type --mt

Bir ölçümü ararken hangi ölçüm koleksiyonunun kullanılacağını gösterir.

Özellik	Değer
Default value:	user
Kabul edilen değerler:	system, user

--resource-group -g

Kaynak grubunun adı. az configure --defaults group=<name>kullanarak varsayılan grubu 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.

Ö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

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', 'öncelik' ve 'targetCondition' şeklindedir.

az iot edge deployment update --deployment-id
                              [--acquire-policy-token]
                              [--add]
                              [--auth-type {key, login}]
                              [--change-reference]
                              [--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ı. Küçük harf ve şu özel karakterlere izin verilir: [-+%_*!'].

İ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

--add

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

Özellik	Değer
Parametre grubu:	Generic Update Arguments
Default value:	[]

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

--change-reference

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

Özellik	Değer
Parametre grubu:	Global Policy Arguments

--etag -e

Kaynağın son durumuna karşılık gelen etag veya varlık etiketi. Etag sağlanmadıysa '*' 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.

Özellik	Değer
Parametre grubu:	Generic Update Arguments
Default value:	False

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

--remove

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

Özellik	Değer
Parametre grubu:	Generic Update Arguments
Default value:	[]

--resource-group -g

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

--set

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

Özellik	Değer
Parametre grubu:	Generic Update Arguments
Default value:	[]

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