次の方法で共有

az iot du update init

  • プレビュー
  • リファレンス

Note

このリファレンスは、Azure CLI (バージョン 2.46.0 以降) の azure-iot 拡張機能の一部です。 拡張機能は、az iot du update init コマンドを初めて実行するときに自動的にインストールされます。 拡張機能の詳細をご覧ください。

このコマンド グループはプレビュー段階であり、開発中です。 参照レベルとサポート レベル: https://aka.ms/CLI_refstatus

インポート マニフェストの初期化のためのユーティリティ。

コマンド

名前 説明 型 Status
az iot du update init v5

目的の状態で v5 インポート マニフェストを初期化します。

 拡張子 プレビュー

az iot du update init v5

プレビュー

コマンド グループ 'iot du update init' はプレビュー段階であり、開発中です。 参照レベルとサポート レベル: https://aka.ms/CLI_refstatus

目的の状態で v5 インポート マニフェストを初期化します。

このコマンドは、v5 インポート マニフェストのすべての属性をサポートします。 と --file--file--related-file、 の間--stepには位置感度があることに注意してください。 操作を完全に利用する方法の詳細については、例とパラメーターの説明を確認してください。

異なるシェルでの引用符とエスケープ文字の使用の詳細については、 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

この更新プログラムと互換性のあるデバイスのプロパティに対応するスペース区切りのキーと値のペア。 通常、製造元やモデルなどのプロパティを定義するために使用されます。 --compat は 1 回以上使用できます。

--step

'instructions.steps' 要素プロパティに対応するスペース区切りの key=value ペア。 クライアントは、指定されたキー値ペアに基づいて、ステップがインラインステップか参照ステップかを判断します。 インラインまたは参照のいずれかのステップが満たされる場合は、参照ステップが優先されます。 --file の使用法は、最も近いインライン --step エントリに関連付けされ、'files' の値が派生します。 次の参照ステップ キーがサポートされています。 updateId.providerupdateId.nameupdateId.versiondescription 次のインライン ステップ キーがサポートされています handler 。(例: 'microsoft/script:1' または 'microsoft/swupdate:1' または 'microsoft/apt:1') properties 、(エージェントがハンドラーに渡すインライン json オブジェクト)、および description. --step は 1 回以上使用できます。

--update-name

updateId のコンポーネントとしての更新プログラム名。

--update-provider

updateId のコンポーネントとしての更新プロバイダー。

--update-version

updateId のコンポーネントとしての更新バージョン。

省略可能のパラメーター

--description

インポート マニフェストの説明。

--file

'files' 要素プロパティに対応するスペース区切りのキーと値のペア。 --file エントリには、指定された場合、最も近い --related-file エントリを含めることができます。 次のキーがサポートされています。 path [required] local file path to update file, downloadHandler (例: 'microsoft/delta:1') handler for utilizing related files to download payload file, properties (in-line json object the agent will pass to the handler). --file は 1 回以上使用できます。

--is-deployable

更新プログラムが個別に展開可能かどうかを示します。

承認された値: false, true
--no-validation

インポート マニフェスト コンテンツのクライアント側 json スキーマ検証を無効にします。

承認された値: false, true
--related-file

'files[*].relatedFiles' 要素プロパティに対応するスペース区切りの key=value ペア。 関連ファイル エントリが存在する場合は、最も近い --file エントリに関連付けられます。 次のキーがサポートされています。 path [必須] 関連する更新ファイルへのローカル ファイル properties パス (ダウンロード ハンドラーに渡されるインライン json オブジェクト)。 --related-file は 1 回以上使用できます。

グローバル パラメーター
--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告は抑制します。

--output -o

出力形式。

承認された値: json, jsonc, none, table, tsv, yaml, yamlc
既定値: json
--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。