az iot du update init
Note
このリファレンスは、Azure CLI (バージョン 2.67.0 以降) の azure-iot 拡張機能の一部です。 拡張機能は、az iot du update init コマンドを初めて実行するときに自動的にインストールされます。 拡張機能の詳細については、 を参照してください。
このコマンド グループはプレビュー段階であり、開発中です。 参照レベルとサポート レベル: https://aka.ms/CLI_refstatus
インポート マニフェストの初期化のためのユーティリティ。
コマンド
| 名前 | 説明 | 型 | 状態 |
|---|---|---|---|
| az iot du update init v5 |
目的の状態で v5 インポート マニフェストを初期化します。 |
Extension | Preview |
az iot du update init v5
コマンド グループ 'iot du update init' はプレビュー段階であり、開発中です。 参照レベルとサポート レベル: https://aka.ms/CLI_refstatus
目的の状態で v5 インポート マニフェストを初期化します。
このコマンドは、v5 インポート マニフェストのすべての属性をサポートします。
--stepと--fileの間には、--fileと--related-fileの位置の感度があることに注意してください。 操作を完全に利用する方法の詳細については、例とパラメーターの説明を確認してください。
さまざまなシェルで引用符とエスケープ文字を使用する方法の詳細については、 https://aka.ms/aziotcli-jsonを参照してください。
az iot du update init v5 --compat
--step
--update-name
--update-provider
--update-version
[--description]
[--file]
[--is-deployable {false, true}]
[--no-validation {false, true}]
[--related-file]
例
最小限のコンテンツ インポート マニフェストを初期化します。 'bash' 用に最適化されたインライン 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
最小限のコンテンツ インポート マニフェストを初期化します。 'powershell' 用に最適化されたインライン 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
最小限のコンテンツ インポート マニフェストを初期化します。 'cmd' 用に最適化されたインライン 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
最小限のコンテンツ インポート マニフェストを初期化します。 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="@/path/to/file" --file path=/my/apt/manifest/file
バンドルされた更新プログラムで参照されるように、展開不可能なリーフ更新を初期化します。 'bash' 用に最適化されたインライン 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
リーフ更新を参照し、独立した手順を定義するバンドルされた更新プログラムを初期化します。 コマンド継続を使用してインポート マニフェスト セグメントを示すために 'bash' 用に最適化された例。
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
必須のパラメーター
この更新プログラムと互換性のあるデバイスのプロパティに対応するスペース区切りのキーと値のペア。 通常、製造元やモデルなどのプロパティを定義するために使用されます。 --compat は 1 回以上使用できます。
'instructions.steps' 要素プロパティに対応するスペース区切りの key=value ペア。 クライアントは、指定されたキー値ペアに基づいて、ステップがインラインステップか参照ステップかを判断します。 インラインまたは参照のいずれかのステップが満たされる場合は、参照ステップが優先されます。 --file の使用法は、最も近いインライン --step エントリに関連付けされ、'files' の値が派生します。 次の参照ステップ キーがサポートされています:updateId.provider、updateId.name、updateId.version、description。 次のインライン ステップ キーがサポートされています。handler (例: 'microsoft/script:1' または 'microsoft/swupdate:1' または 'microsoft/apt:1')、properties (エージェントがハンドラーに渡すインライン json オブジェクト)、および description。 --step は 1 回以上使用できます。
updateId のコンポーネントとしての更新プログラム名。
updateId のコンポーネントとしての更新プロバイダー。
updateId のコンポーネントとしての更新バージョン。
オプションのパラメーター
次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。
インポート マニフェストの説明。
'files' 要素プロパティに対応するスペース区切りのキーと値のペア。 --file エントリには、指定された場合、最も近い --related-file エントリを含めることができます。 次のキーがサポートされています。 path [必須] ローカル ファイル パスを更新するには、downloadHandler (例: 'microsoft/delta:1') ハンドラーを使用して関連ファイルを使用してペイロード ファイルをダウンロード properties (エージェントがハンドラーに渡すインライン json オブジェクト)。 --file は 1 回以上使用できます。
更新プログラムが個別に展開可能かどうかを示します。
| プロパティ | 値 |
|---|---|
| 指定可能な値: | false, true |
インポート マニフェスト コンテンツのクライアント側 json スキーマ検証を無効にします。
| プロパティ | 値 |
|---|---|
| 指定可能な値: | false, true |
'files[*].relatedFiles' 要素プロパティに対応するスペース区切りの key=value ペア。 関連ファイル エントリが存在する場合は、最も近い --file エントリに関連付けられます。 次のキーがサポートされています。関連する更新ファイルへの path [必須] ローカル ファイル パス、properties (ダウンロード ハンドラーに渡されるインライン json オブジェクト)。 --related-file は 1 回以上使用できます。
グローバル パラメーター
ログの詳細度を上げて、すべてのデバッグ ログを表示します。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告を抑制します。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
出力フォーマット。
| プロパティ | 値 |
|---|---|
| 規定値: | json |
| 指定可能な値: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。
サブスクリプションの名前または ID。
az account set -s NAME_OR_IDを使用して既定のサブスクリプションを構成できます。
ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。
| プロパティ | 値 |
|---|---|
| 規定値: | False |