az image builder output

  • リファレンス

イメージ ビルダー テンプレート出力ディストリビューターを管理する。

カスタマイズされたイメージは、マネージド イメージ、共有イメージ ギャラリー (SIG) 内の共有イメージ、または VHD BLOB として配布できます。

コマンド

名前 説明 型 Status
az image builder output add

イメージ ビルダーの出力ディストリビューターをイメージ ビルダー テンプレートに追加します。

 コア GA
az image builder output clear

イメージ ビルダー テンプレートからすべてのイメージ ビルダー出力ディストリビューターを削除します。

 コア GA
az image builder output remove

イメージ ビルダー テンプレートからイメージ ビルダーの出力ディストリビューターを削除します。

 コア GA
az image builder output versioning

イメージ ビルダー テンプレートの出力バージョナーを管理します。

 コア GA
az image builder output versioning remove

指定した出力のすべてのバージョン管理オプションを削除します。

 コア GA
az image builder output versioning set

イメージ ビルダー テンプレートのイメージ ビルダー出力バージョナーを設定します。

 コア GA
az image builder output versioning show

指定した出力のバージョン管理オプションを表示します。

 コア GA

az image builder output add

イメージ ビルダーの出力ディストリビューターをイメージ ビルダー テンプレートに追加します。

--defer と共に使用する必要があります。 出力ディストリビューターには、マネージド イメージ、ギャラリー イメージ、または VHD BLOB を使用できます。

az image builder output add [--artifact-tags]
                            [--defer]
                            [--gallery-image-definition]
                            [--gallery-name]
                            [--gallery-replication-regions]
                            [--ids]
                            [--is-vhd]
                            [--managed-image]
                            [--managed-image-location]
                            [--name]
                            [--output-name]
                            [--resource-group]
                            [--subscription]
                            [--versioning {Latest, Source}]
                            [--vhd-uri]

例

cli オブジェクト キャッシュ内のイメージ テンプレートにマネージド イメージ ディストリビューターを追加します。 実行出力名を指定します。

az image builder output add -n mytemplate -g my-group \
    --managed-image my_desired_image_name --output-name managed_image_run_01 --defer

cli オブジェクト キャッシュ内のイメージ テンプレートに共有イメージ ギャラリー ディストリビューターを追加します。 レプリケーション リージョンを指定します。

az image builder output add -n mytemplate -g my-group --gallery-name my_shared_gallery \
    --gallery-replication-regions westus brazilsouth \
    --gallery-image-definition linux_image_def --defer

CLI オブジェクト キャッシュ内のイメージ テンプレートに VHD ディストリビューターを追加します。

az image builder output add -n mytemplate -g my-group \
    --output-name my_vhd_image --is-vhd  --defer

ストレージ URI を指定した VHD ディストリビューターを CLI オブジェクト キャッシュのイメージ テンプレートに追加します。

az image builder output add -n mytemplate -g my-group \
    --output-name my_vhd_image --is-vhd --vhd-uri https://mystorageaccount.blob.core.windows.net/container/path_to_vhd_file --defer

省略可能のパラメーター

--artifact-tags

ディストリビューターによって作成された出力成果物に適用されるタグ。 space-separated tags: key[=value] [key[=value] ...].既存のタグをクリアするには、"" を使用します。

--defer

オブジェクトを Azure に送信するのではなく、ローカル キャッシュに一時的に格納します。 コマンドを使用して az cache 表示/クリアします。

--gallery-image-definition

カスタマイズされたイメージ バージョンを作成する既存の SIG イメージ定義の名前または ID。

--gallery-name

ID ではなくイメージ定義名が指定されている場合は、共有イメージ ギャラリー名。

--gallery-replication-regions

イメージ バージョンをレプリケートするリージョンのスペース区切りの一覧。 既定値はリソース グループの場所です。

--ids

1 つまたは複数のリソース ID (スペース区切り)。 これは、'Resource Id' 引数のすべての情報を含む完全なリソース ID である必要があります。 --ids または他の 'Resource Id' 引数を指定する必要があります。

--is-vhd

出力は VHD ディストリビューターです。

--managed-image

作成するカスタマイズされたマネージド イメージの名前または ID。

--managed-image-location

カスタマイズされたイメージが作成される場所。 既定値はリソース グループの場所です。

--name -n

イメージ テンプレートの名前。

--output-name

イメージ ビルダーの実行出力の名前。 既定値は、マネージド イメージまたは sig イメージ定義の名前です。

--resource-group -g

リソース グループの名前。 az configure --defaults group=<name> を使用して、既定のグループを構成できます。

--subscription

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

--versioning

配布用に新しい x.y.z バージョン番号を生成する方法について説明します。

承認された値: Latest, Source
--vhd-uri

分散 VHD BLOB のオプションの Azure Storage URI。 既定値 (空の文字列) は使用しません。その場合、VHD はステージング リソース グループ内のストレージ アカウントに発行されることになります。

グローバル パラメーター
--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 を使います。

az image builder output clear

イメージ ビルダー テンプレートからすべてのイメージ ビルダー出力ディストリビューターを削除します。

--defer と共に使用する必要があります。

az image builder output clear [--defer]
                              [--ids]
                              [--name]
                              [--resource-group]
                              [--subscription]

省略可能のパラメーター

--defer

オブジェクトを Azure に送信するのではなく、ローカル キャッシュに一時的に格納します。 コマンドを使用して az cache 表示/クリアします。

--ids

1 つまたは複数のリソース ID (スペース区切り)。 これは、'Resource Id' 引数のすべての情報を含む完全なリソース ID である必要があります。 --ids または他の 'Resource Id' 引数を指定する必要があります。

--name -n

イメージ テンプレートの名前。

--resource-group -g

リソース グループの名前。 az configure --defaults group=<name> を使用して、既定のグループを構成できます。

--subscription

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

グローバル パラメーター
--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 を使います。

az image builder output remove

イメージ ビルダー テンプレートからイメージ ビルダーの出力ディストリビューターを削除します。

--defer と共に使用する必要があります。

az image builder output remove --output-name
                               [--defer]
                               [--ids]
                               [--name]
                               [--resource-group]
                               [--subscription]

必須のパラメーター

--output-name

イメージ ビルダーの実行出力の名前。

省略可能のパラメーター

--defer

オブジェクトを Azure に送信するのではなく、ローカル キャッシュに一時的に格納します。 コマンドを使用して az cache 表示/クリアします。

--ids

1 つまたは複数のリソース ID (スペース区切り)。 これは、'Resource Id' 引数のすべての情報を含む完全なリソース ID である必要があります。 --ids または他の 'Resource Id' 引数を指定する必要があります。

--name -n

イメージ テンプレートの名前。

--resource-group -g

リソース グループの名前。 az configure --defaults group=<name> を使用して、既定のグループを構成できます。

--subscription

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

グローバル パラメーター
--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 を使います。