az image builder output

リファレンス

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

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

コマンド

名前	説明	型	状態
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

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

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

コマンド

az image builder output add

例

省略可能のパラメーター

az image builder output clear

省略可能のパラメーター

az image builder output remove

必須のパラメーター

省略可能のパラメーター

その他のリソース