az iot du update init

Önizleme

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 du update init komutunu ilk kez çalıştırdığınızda otomatik olarak yüklenir. Uzantılar hakkında daha fazla bilgi edinin.

Bu komut grubu önizleme aşamasında ve geliştirme aşamasındadır. Başvuru ve destek düzeyleri: https://aka.ms/CLI_refstatus

İçeri aktarma bildirimi başlatma yardımcı programı.

Komutlar

Name	Description	Tür	Durum
az iot du update init v5	İstenen durumla bir v5 içeri aktarma bildirimi başlatın.	Extension	Preview

az iot du update init v5

Önizleme

'iot du update init' komut grubu önizleme aşamasında ve geliştirme aşamasındadır. Başvuru ve destek düzeyleri: https://aka.ms/CLI_refstatus

İstenen durumla bir v5 içeri aktarma bildirimi başlatın.

Bu komut v5 içeri aktarma bildiriminin tüm özniteliklerini destekler. ve --step--file--fileile ile arasında --related-file konumsal duyarlılık olduğunu unutmayın. İş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.

Farklı kabuklarda tırnak işaretleri ve kaçış karakterleri kullanma hakkında daha fazla bilgiyi burada bulabilirsiniz: https://aka.ms/aziotcli-json.

az iot du update init v5 --compat
                         --step
                         --update-name
                         --update-provider
                         --update-version
                         [--acquire-policy-token]
                         [--change-reference]
                         [--description]
                         [--file]
                         [--is-deployable {false, true}]
                         [--no-validation {false, true}]
                         [--related-file]

Örnekler

Minimum içerik içeri aktarma manifestosunu başlatın. 'Bash' için iyileştirilmiş satır içi json.

az iot du update init v5 --update-provider Microsoft --update-name myAptUpdate --update-version 1.0.0 --description "My minimum update" --compat manufacturer=Contoso model=Vacuum --step handler=microsoft/apt:1 properties='{"installedCriteria": "1.0"}' --file path=/my/apt/manifest/file

Minimum içerik içeri aktarma manifestosunu başlatın. 'powershell' için iyileştirilmiş satır içi json.

az iot du update init v5 --update-provider Microsoft --update-name myAptUpdate --update-version 1.0.0 --description "My minimum update" --compat manufacturer=Contoso model=Vacuum --step handler=microsoft/apt:1 properties='{\"installedCriteria\": \"1.0\"}' --file path=/my/apt/manifest/file

Minimum içerik içeri aktarma manifestosunu başlatın. 'cmd' için iyileştirilmiş satır içi json.

az iot du update init v5 --update-provider Microsoft --update-name myAptUpdate --update-version 1.0.0 --description "My minimum update" --compat manufacturer=Contoso model=Vacuum --step handler=microsoft/apt:1 properties="{\"installedCriteria\": \"1.0\"}" --file path=/my/apt/manifest/file

Minimum içerik içeri aktarma manifestosunu başlatın. json için dosya girişini kullanın.

az iot du update init v5 --update-provider Microsoft --update-name myAptUpdate --update-version 1.0.0 --description "My minimum update" --compat manufacturer=Contoso model=Vacuum --step handler=microsoft/apt:1 properties="@/path/to/file" --file path=/my/apt/manifest/file

Paketlenmiş bir güncelleştirmede başvurulmak üzere dağıtılamayan bir yaprak güncelleştirme başlatın. 'Bash' için iyileştirilmiş satır içi json.

az iot du update init v5 --update-provider Microsoft --update-name mySwUpdate --update-version 1.1.0 --compat manufacturer=Contoso model=Microphone --step handler=microsoft/swupdate:1 description="Deploy Update" properties='{"installedCriteria": "1.0"}' --file path=/my/update/image/file1 --file path=/my/update/image/file2 --is-deployable false

Yaprak güncelleştirmeye başvuran ve bağımsız adımlar tanımlayan paketlenmiş bir güncelleştirme başlatın. İçeri aktarma bildirimi kesimlerini ayırmak için komut devamlılığı kullanılarak 'bash' için iyileştirilmiş örnek.

az iot du update init v5 \
--update-provider Microsoft --update-name myBundled --update-version 2.0 \
--compat manufacturer=Contoso model=SpaceStation \
--step handler=microsoft/script:1 properties='{"arguments": "--pre"}' description="Pre-install script" \
--file path=/my/update/scripts/preinstall.sh downloadHandler=microsoft/delta:1 \
--related-file path=/my/update/scripts/related_preinstall.json properties='{"microsoft.sourceFileHashAlgorithm": "sha256"}' \
--step updateId.provider=Microsoft updateId.name=SwUpdate updateId.version=1.1 \
--step handler=microsoft/script:1 properties='{"arguments": "--post"}' description="Post-install script" \
--file path=/my/update/scripts/postinstall.sh

Gerekli Parametreler

--compat

Bu güncelleştirmenin uyumlu olduğu bir cihazın özelliklerine karşılık gelen boşlukla ayrılmış anahtar=değer çiftleri. Genellikle üretici ve model gibi özellikleri tanımlamak için kullanılır. --compat 1 veya daha fazla kez kullanılabilir.

--step

'instructions.steps' öğesi özelliklerine karşılık gelen boşlukla ayrılmış anahtar=değer çiftleri. İstemci, sağlanan anahtar değer çiftlerini temel alan bir adımın satır içi bir adım mı yoksa başvuru adımı mı olduğunu belirler. Satır içi veya başvuru adımı karşılanabilirse, başvuru adımı önceliklendirilir. --file kullanımı en yakın satır içi --step girişiyle ilişkilendirilir ve 'dosyalar' için değer türetilir. Aşağıdaki başvuru adımı anahtarları desteklenir: updateId.provider, updateId.name, updateId.version ve description. Aşağıdaki satır içi adım anahtarları desteklenir: handler (örneğin: 'microsoft/script:1' veya 'microsoft/swupdate:1' veya 'microsoft/apt:1'), properties (aracının işleyiciye geçireceği satır içi json nesnesi) ve description. --step 1 veya daha fazla kez kullanılabilir.

--update-name

UpdateId'nin bir bileşeni olarak güncelleştirme adı.

--update-provider

UpdateId'nin bir bileşeni olarak güncelleştirme sağlayıcısı.

--update-version

UpdateId'nin bir bileşeni olarak güncelleştirme sürü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

--change-reference

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

Özellik	Değer
Parametre grubu:	Global Policy Arguments

--description

İçeri aktarma bildiriminin açıklaması.

--file

'files' öğesi özelliklerine karşılık gelen boşlukla ayrılmış anahtar=değer çiftleri. --file girdisi, sağlanmışsa en yakın --related-file girdilerini içerebilir. Aşağıdaki anahtarlar desteklenir: path [gerekli] dosyayı güncelleştirmek için yerel dosya yolu, yük dosyasını indirmek için ilgili dosyaları kullanmak için downloadHandler (örneğin: 'microsoft/delta:1') işleyicisi, properties (aracının işleyiciye ileteceği satır içi json nesnesi). --file 1 veya daha fazla kez kullanılabilir.

--is-deployable

Güncelleştirmenin bağımsız olarak dağıtılabilir olup olmadığını gösterir.

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

--no-validation

İçeri aktarma bildirimi içeriğinin istemci tarafı json şema doğrulamasını devre dışı bırakır.

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

--related-file

'files[*].relatedFiles' öğesi özelliklerine karşılık gelen boşlukla ayrılmış anahtar=değer çiftleri. Varsa, bir --related-file girdisi en yakın --file girdisi ile ilişkilendirilecektir. Aşağıdaki anahtarlar desteklenir: path [gerekli] ilgili güncelleştirme dosyasının yerel dosya yolu, properties (indirme işleyicisine geçirilen satır içi json nesnesi). --related-file 1 veya daha fazla kez kullanılabilir.

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

Geri Bildirim

Bu sayfayı yararlı buldunuz mu?