az image builder output

管理映射產生器範本輸出散發者。

自訂映射可以散發為受控映射、共用映射庫中的共用映射（SIG），或作為 VHD Blob。

命令

名稱	Description	類型	狀態
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

將 VHD 散發者新增至 cli 物件快取中的映射範本。

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

在 cli 物件快取中，將指定儲存體 URI 的 VHD 散發者新增至映射範本。

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

散發者建立輸出成品之後，將會套用至輸出成品的標記。 空格分隔標籤：key[=value] [key[=value] ...]。使用 「」 清除現有的標記。

--defer

暫時將物件儲存在本機快取中，而不是傳送至 Azure。 使用 az cache 命令來檢視/清除。

--gallery-image-definition

用來建立自訂映射版本的現有 SIG 映射定義名稱或識別碼。

--gallery-name

如果已提供映射定義名稱而非識別碼，則為共用映射庫名稱。

--gallery-replication-regions

要複寫映射版本的區域空間分隔清單。 預設為資源群組的位置。

--ids

一或多個資源識別碼 (以空格分隔)。 它應該是包含 「資源識別碼」引數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」引數。

--is-vhd

輸出是 VHD 散發者。

--managed-image

要建立之自訂受控映射的名稱或識別碼。

--managed-image-location

將建立自訂映射的位置。 預設為資源群組的位置。

--name -n

映射範本的名稱。

--output-name

映射產生器執行輸出的名稱。 預設為受控映射或 sig 映射定義的名稱。

--resource-group -g

資源組名。 您可以使用 來設定預設群組 az configure --defaults group=<name> 。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

--versioning

描述如何為散發產生新的 x.y.z 版本號碼。

接受的值: Latest, Source

--vhd-uri

分散式 VHD Blob 的選擇性Azure 儲存體 URI。 省略以使用預設的 （空字串），在此情況下，VHD 會發佈至預備資源群組中的儲存體帳戶。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 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

一或多個資源識別碼 (以空格分隔)。 它應該是包含 「資源識別碼」引數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」引數。

--name -n

映射範本的名稱。

--resource-group -g

資源組名。 您可以使用 來設定預設群組 az configure --defaults group=<name> 。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 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

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 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

一或多個資源識別碼 (以空格分隔)。 它應該是包含 「資源識別碼」引數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」引數。

--name -n

映射範本的名稱。

--resource-group -g

資源組名。 您可以使用 來設定預設群組 az configure --defaults group=<name> 。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 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

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。