az sig image-version

參考

使用 VM 管理共用資源庫映射版本。

命令

az sig image-version create	建立新的映像版本。
az sig image-version delete	刪除資源庫映射版本。
az sig image-version list	列出資源庫映射定義中的資源庫映射版本。
az sig image-version list-community	列出資源庫社群中的 VM 映射版本。
az sig image-version list-shared	列出資源庫中直接與您訂用帳戶或租使用者共用的 VM 映射版本。
az sig image-version show	擷取資源庫映射版本的相關資訊。
az sig image-version show-community	取得社群資源庫映射版本。
az sig image-version show-shared	取得直接與您的訂用帳戶或租使用者共用的資源庫中的映射版本。
az sig image-version update	更新共用映射版本。
az sig image-version wait	等候映射版本相關作業。

az sig image-version create

建立新的映像版本。

此作業可能需要很長的時間，視複寫區域號碼而定。建議使用「--no-wait」。

az sig image-version create --gallery-image-definition
                            --gallery-image-version
                            --gallery-name
                            --resource-group
                            [--allow-replicated-location-deletion {false, true}]
                            [--data-snapshot-luns]
                            [--data-snapshots]
                            [--data-vhds-luns]
                            [--data-vhds-sa]
                            [--data-vhds-uris]
                            [--end-of-life-date]
                            [--exclude-from-latest {false, true}]
                            [--image-version]
                            [--location]
                            [--managed-image]
                            [--no-wait]
                            [--os-snapshot]
                            [--os-vhd-storage-account]
                            [--os-vhd-uri]
                            [--replica-count]
                            [--replication-mode {Full, Shallow}]
                            [--storage-account-type {Premium_LRS, Standard_LRS, Standard_ZRS}]
                            [--tags]
                            [--target-edge-zone-encryption]
                            [--target-edge-zones]
                            [--target-region-cvm-encryption]
                            [--target-region-encryption]
                            [--target-regions]
                            [--virtual-machine]

範例

從虛擬機器新增映射版本

az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--virtual-machine /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/virtualMachines/MyVM

從受控映射新增映射版本

az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--managed-image /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/images/MyManagedImage

從另一個映射版本新增映射版本

az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--image-version /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/galleries/MyGallery/images/MyImageDefinition/versions/1.0.0

從受控磁片新增映射版本

az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--os-snapshot /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/disks/MyOSDisk

從受控磁片新增映射版本，並新增其他資料磁片

az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--os-snapshot /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/disks/MyOSDisk \
--data-snapshots /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/disks/MyDataDisk \
--data-snapshot-luns 0

從 OS 磁片的快照集新增映射版本。

az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--os-snapshot /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/snapshots/MyOsDiskSnapshot

從 OS 磁片的快照集新增映射版本，並將其他快照集新增為數據磁片

az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--os-snapshot /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/snapshots/MyOsDiskSnapshot \
--data-snapshots /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/snapshots/MyDiskSnapshot \
--data-snapshot-luns 0

從 OS 磁片的 VHD 新增映射版本。

az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--os-vhd-storage-account /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Storage/storageAccounts/mystorageaccount \
--os-vhd-uri https://mystorageaccount.blob.core.windows.net/container/path_to_vhd_file

從 OS 磁片的 VHD 新增映射版本，並將其他 VHD 新增為數據磁片

az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--os-vhd-storage-account /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Storage/storageAccounts/mystorageaccount \
--os-vhd-uri https://mystorageaccount.blob.core.windows.net/container/path_to_vhd_file \
--data-vhds-sa /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Storage/storageAccounts/myotherstorageaccount \
--data-vhds-uris https://myotherstorageaccount.blob.core.windows.net/container/path_to_vhd_file \
--data-vhds-luns 0

您可以結合快照集、受控磁片和 VHD 來建立新的映射版本。使用 VHD 作為 OS 磁片和受控磁片和快照集作為資料磁片來新增映射版本。

az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--os-vhd-storage-account /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Storage/storageAccounts/mystorageaccount \
--os-vhd-uri https://mystorageaccount.blob.core.windows.net/container/path_to_vhd_file \
--data-snapshots /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/disks/MyDataDisk subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/snapshots/MyDiskSnapshot \
--data-snapshot-luns 0 1

新增映射版本，並將其複製到其他區域。映射版本來源的主位置必須包含在目的地區域清單中。針對每個額外的區域，您可以指定不同的複本計數和儲存體帳戶類型。否則，區域會繼承自全域。預設複本計數為 1，預設儲存體帳戶類型為標準 LRS。在此範例中，eastus2 將有一個複本儲存在標準 ZRS 儲存體上，ukwest 將有 3 個複本儲存在標準 ZRS 儲存體上，southindia 將會有一個複本儲存在標準 LRS 儲存體上，而 brazilsouth 將有 2 個複本儲存在標準 LRS 儲存體上。

az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 --replica-count 1 \
--storage-account-type Standard_ZRS --managed-image image-name \
--target-regions eastus2 ukwest=3 southindia=standard_lrs \
brazilsouth=2=standard_lrs

使用磁片加密集新增具有加密的新映射版本。加密會套用至屬於映射版本一部分的每個磁片。

az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--virtual-machine /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/virtualMachines/MyVM \
--target-regions westus=2=standard eastus \
--target-region-encryption WestUSDiskEncryptionSet1,0,WestUSDiskEncryptionSet2 \
EastUSDiskEncryptionSet1,0,EastUSDiskEncryptionSet2

新增映射版本，並將其複製到擴充位置。

az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 --replica-count 1 \
--storage-account-type Standard_ZRS --managed-image image-name \
--target-edge-zones westus=microsoftlosangeles1 eastus=microsoftlosangeles2=1 \
brazilsouth=2=standard_lrs

新增映射版本，並使用磁片加密集將它複製到具有加密的擴充位置。

az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--virtual-machine /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/virtualMachines/MyVM \
--target-edge-zones westus=microsoftlosangeles1 \
--target-edge-zone-encryption microsoftlosangeles1,WestUSDiskEncryptionSet1,0,WestUSDiskEncryptionSet2

新增映射版本，並不要等待。稍後，您可以在準備好從資源庫映射版本建立 VM 時叫用「az sig image-version wait」命令

az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--virtual-machine /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/virtualMachines/MyVM \
--no-wait

新增映射版本，但將其從考慮中移除為映射定義中的最新版本

az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--virtual-machine /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/virtualMachines/MyVM \
--exclude-from-latest true

新增映射版本，並設定其生命循環結束日期。映射版本仍可在其生命循環結束日期之後用來建立虛擬機器。

az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--virtual-machine /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/virtualMachines/MyVM \
--end-of-life-date 2024-08-02T00:00:00+00:00

必要參數

--gallery-image-definition -i

資源庫映射定義。

--gallery-image-version -e

語意版本模式中的資源庫映射版本。允許的字元為數字和句號。數位必須介於 32 位整數的範圍內，例如。 <MajorVersion>.<MinorVersion>.<Patch>

--gallery-name -r

資源庫名稱。

--resource-group -g

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

選擇性參數

--allow-replicated-location-deletion

指出是否允許從複寫區域移除此資源庫映射版本。

接受的值: false, true

--data-snapshot-luns

邏輯單元編號 (資料磁片快照集的空間分隔) 。

--data-snapshots

資料磁片快照集 (以空格分隔) 的名稱或識別碼。

--data-vhds-luns

邏輯單元編號 (資料磁片來源 VHD URI 的空間分隔) 。

--data-vhds-sa --data-vhds-storage-accounts

資料磁片來源 VHD URI 儲存體帳戶的名稱或識別碼 (以空格分隔) 。

--data-vhds-uris

來源 VHD URI (資料磁片的空間分隔) 。

--end-of-life-date

生命循環結束日期，例如 '2020-12-31'。

--exclude-from-latest

旗標表示如果設定為 true，省略版本部署 VM 的人員將不會使用此版本。

接受的值: false, true

--image-version

資源庫映射版本來源的資源識別碼。

--location -l

位置。值的來源：az account list-locations。您可以使用 az configure --defaults location=<location> 來設定預設位置。

--managed-image

在相同的資源群組) 或資源識別碼中，映射名稱 (。

--no-wait

不等候長時間執行的作業完成。

預設值: False

--os-snapshot

OS 磁片快照集的名稱或識別碼。

--os-vhd-storage-account

OS 磁片來源 VHD URI 的儲存體帳戶名稱或識別碼。

--os-vhd-uri

OS 磁片的來源 VHD URI。

--replica-count

每個區域要建立的預設複本數目。若要設定區域複寫計數，請使用 --target-regions。

--replication-mode

選擇性參數，指定要用於複寫的模式。這個屬性無法更新。

接受的值: Full, Shallow

--storage-account-type

每個區域要使用的預設儲存體帳戶類型。若要設定區域儲存體帳戶類型，請使用 --target-regions。

接受的值: Premium_LRS, Standard_LRS, Standard_ZRS

--tags

空格分隔標記：key[=value] [key[=value] ...]。使用「」清除現有的標記。

--target-edge-zone-encryption --zone-encryption

用於加密每個區域資源庫成品中 OS 和資料磁片的客戶受控金鑰空間分隔清單。每個邊緣區域的格式：、 < os_des > 、 < lun1_des > 、 < lun2_des > 。

--target-edge-zones

區域、邊緣區域、複本計數和儲存體類型的空間分隔清單。使用 =[=][=] 選擇性地為每個區域設定複本計數和/或儲存體帳戶類型。如果未指定複本計數，則會使用預設複本計數。如果未指定儲存體帳戶類型，則會使用預設儲存體帳戶類型。如果指定「--target-edge-zones None」，將會清除目標擴充位置。

--target-region-cvm-encryption

加密每個區域資源庫成品中 OS 磁片之機密 VM 的客戶受控金鑰空間分隔清單。每個區域的格式： <os_cvm_encryption_type>,<os_cvm_des> 。 os_cvm_encryption_type的有效值為 EncryptedVMGuestStateOnlyWithPmk、EncryptedWithPmk、EncryptedWithCmk。

--target-region-encryption

用於加密每個區域資源庫成品中 OS 和資料磁片的客戶受控金鑰空間分隔清單。每個區域的格式： <os_des>,<lun1>,<lun1_des>,<lun2>,<lun2_des> 。使用「null」作為預留位置。

--target-regions

區域及其複本計數的空間分隔清單。使用 <region>[=<replica count>][=<storage account type>] 選擇性地為每個區域設定複本計數和/或儲存體帳戶類型。如果未指定複本計數，則會使用預設複本計數。如果未指定儲存體帳戶類型，則會使用預設儲存體帳戶類型。

--virtual-machine

VM 來源的資源識別碼。

全域參數

--debug

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

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

--query

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

--subscription

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

--verbose

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

az sig image-version delete

刪除資源庫映射版本。

az sig image-version delete --gallery-image-definition
                            --gallery-image-version
                            --gallery-name
                            --resource-group

必要參數

--gallery-image-definition -i

資源庫映射定義。

--gallery-image-version -e

語意版本模式中的資源庫映射版本。允許的字元為數字和句號。數位必須介於 32 位整數的範圍內，例如。 <MajorVersion>.<MinorVersion>.<Patch>

--gallery-name -r

資源庫名稱。

--resource-group -g

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

全域參數

--debug

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

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

--query

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

--subscription

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

--verbose

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

az sig image-version list

列出資源庫映射定義中的資源庫映射版本。

az sig image-version list --gallery-image-definition
                          --gallery-name
                          --resource-group

必要參數

--gallery-image-definition -i

資源庫映射定義。

--gallery-name -r

資源庫名稱。

--resource-group -g

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

全域參數

--debug

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

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

--query

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

--subscription

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

--verbose

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

az sig image-version list-community

列出資源庫社群中的 VM 映射版本。

az sig image-version list-community [--gallery-image-definition]
                                    [--ids]
                                    [--location]
                                    [--marker]
                                    [--public-gallery-name]
                                    [--show-next-marker]
                                    [--subscription]

範例

列出資源庫社群中的映射版本。

az sig image-version list-community --public-gallery-name publicGalleryName \
--gallery-image-definition MyImage --location myLocation

選擇性參數

--gallery-image-definition -i

要從中列出映射版本的社群資源庫映射定義名稱。

--ids

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

--location -l

位置。值的來源：az account list-locations。您可以使用 az configure --defaults location=<location> 來設定預設位置。

--marker

字串值，識別下一個清單作業所要傳回之容器清單的部分。如果清單作業未傳回剩餘的所有容器，則會傳迴響應本文內的 NextMarker 值，以使用目前頁面列出。如果指定，這個產生器會從先前產生器停止的點開始傳回結果。

--public-gallery-name

社群資源庫的公用名稱。

--show-next-marker

指定時，顯示結果中的 nextMarker。

--subscription

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

全域參數

--debug

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

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

--query

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

--subscription

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

--verbose

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

az sig image-version list-shared

列出資源庫中直接與您訂用帳戶或租使用者共用的 VM 映射版本。

az sig image-version list-shared [--gallery-image-definition]
                                 [--gallery-unique-name]
                                 [--ids]
                                 [--location]
                                 [--marker]
                                 [--shared-to {tenant}]
                                 [--show-next-marker]
                                 [--subscription]

範例

列出資源庫中直接共用至指定位置和映射定義的訂用帳戶中的映射版本。

az sig image-version list-shared --gallery-unique-name galleryUniqueName \
--gallery-image-definition MyImage --location myLocation

列出資源庫中直接在指定位置和映射定義中共用給租使用者的映射版本。

az sig image-version list-shared --gallery-unique-name galleryUniqueName \
--gallery-image-definition MyImage --location myLocation --shared-to tenant

選擇性參數

--gallery-image-definition -i

要從中列出映射版本的共用資源庫映射定義名稱。

--gallery-unique-name

共用資源庫的唯一名稱。

--ids

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

--location -l

位置。值的來源：az account list-locations。您可以使用 az configure --defaults location=<location> 來設定預設位置。

--marker

--shared-to

查詢參數，決定執行清單作業時要擷取哪些共用資源庫。如果未指定，請依訂用帳戶識別碼列出。

接受的值: tenant

--show-next-marker

指定時，顯示結果中的 nextMarker。

--subscription

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

全域參數

--debug

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

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

--query

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

--subscription

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

--verbose

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

az sig image-version show

擷取資源庫映射版本的相關資訊。

az sig image-version show --gallery-image-definition
                          --gallery-image-version
                          --gallery-name
                          --resource-group
                          [--expand]

必要參數

--gallery-image-definition -i

資源庫映射定義。

--gallery-image-version -e

語意版本模式中的資源庫映射版本。允許的字元為數字和句號。數位必須介於 32 位整數的範圍內，例如。 <MajorVersion>.<MinorVersion>.<Patch>

--gallery-name -r

資源庫名稱。

--resource-group -g

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

選擇性參數

--expand

要套用至作業的展開運算式，例如 'ReplicationStatus'。

全域參數

--debug

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

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

--query

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

--subscription

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

--verbose

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

az sig image-version show-community

取得社群資源庫映射版本。

az sig image-version show-community [--gallery-image-definition]
                                    [--gallery-image-version]
                                    [--ids]
                                    [--location]
                                    [--public-gallery-name]
                                    [--subscription]

選擇性參數

--gallery-image-definition -i

要從中列出映射版本的社群資源庫映射定義名稱。

--gallery-image-version -e

要建立的資源庫映射版本名稱。必須遵循語意版本名稱模式：允許的字元為數字和句號。數位必須介於 32 位整數的範圍內。格式：。。。

--ids

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

--location -l

位置。值的來源：az account list-locations。您可以使用 az configure --defaults location=<location> 來設定預設位置。

--public-gallery-name

社群資源庫的公用名稱。

--subscription

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

全域參數

--debug

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

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

--query

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

--subscription

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

--verbose

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

az sig image-version show-shared

取得資源庫中直接共用給訂用帳戶或租使用者的映射版本。

取得直接與您的訂用帳戶或租使用者共用的資源庫中的映射版本。

az sig image-version show-shared [--gallery-image-definition]
                                 [--gallery-image-version]
                                 [--gallery-unique-name]
                                 [--ids]
                                 [--location]
                                 [--subscription]

範例

取得資源庫中的映射版本，直接共用至指定位置中的訂用帳戶或租使用者。

az sig image-version show-shared --gallery-unique-name galleryUniqueName \
--gallery-image-definition MyImage --gallery-image-version 1.0.0 --location myLocation

選擇性參數

--gallery-image-definition -i

要從中列出映射版本的共用資源庫映射定義名稱。

--gallery-image-version -e

要建立的資源庫映射版本名稱。必須遵循語意版本名稱模式：允許的字元為數字和句號。數位必須介於 32 位整數的範圍內。格式：。。。

--gallery-unique-name

共用資源庫的唯一名稱。

--ids

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

--location -l

位置。值的來源：az account list-locations。您可以使用 az configure --defaults location=<location> 來設定預設位置。

--subscription

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

全域參數

--debug

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

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

--query

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

--subscription

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

--verbose

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

az sig image-version update

更新共用映射版本。

az sig image-version update --gallery-image-definition
                            --gallery-image-version
                            --gallery-name
                            --resource-group
                            [--add]
                            [--allow-replicated-location-deletion {false, true}]
                            [--force-string]
                            [--no-wait]
                            [--remove]
                            [--replica-count]
                            [--set]
                            [--target-edge-zones]
                            [--target-regions]

範例

變更複寫區域和複本計數

az sig image-version update --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--target-regions westcentralus=2 eastus2

變更複寫擴充位置

az sig image-version update --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--target-edge-zones westus=microsoftlosangeles1 eastus=microsoftlosangeles2=1

清除複寫擴充位置

az sig image-version update --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--target-edge-zones None

複寫至其他區域。您可以選擇性地設定區域的複本計數，並在使用最新版本的映射定義時排除此映射。

az sig image-version update --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--add publishingProfile.targetRegions name=westcentralus \
regionalReplicaCount=3 excludeFromLatest=true

針對映射定義中的最新版本，變更是否應該考慮映射。將此值設定為 true 會排除影像的考慮，並將此值設定為 false 包含要考慮的影像。

az sig image-version update -g MyResourceGroup --gallery-name MyGallery \
--gallery-image-definition MyImage --gallery-image-version 1.0.0 \
--set publishingProfile.excludeFromLatest=true

變更映射版本的生命循環結束日期。映射仍可用來在生命循環結束日期之後建立虛擬機器。

az sig image-version update -g MyResourceGroup --gallery-name MyGallery \
--gallery-image-definition MyImage --gallery-image-version 1.0.0 \
--set publishingProfile.endOfLifeDate=2024-08-02T00:00:00+00:00

允許從複寫的區域移除資源庫映射版本。

az sig image-version update -g MyResourceGroup --gallery-name MyGallery \
--gallery-image-definition MyImage --gallery-image-version 1.0.0 \
--set safetyProfile.allowDeletionOfReplicatedLocations=true

必要參數

--gallery-image-definition -i

資源庫映射定義。

--gallery-image-version -e

語意版本模式中的資源庫映射版本。允許的字元為數字和句號。數位必須介於 32 位整數的範圍內，例如 <MajorVersion>.<MinorVersion>.<Patch> 。

--gallery-name -r

資源庫名稱。

--resource-group -g

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

選擇性參數

--add

藉由指定路徑和索引鍵值組，將物件新增至物件清單。範例：--add property.listProperty < key=value、string 或 JSON 字串 > 。

預設值: []

--allow-replicated-location-deletion

指出是否允許從複寫區域移除此資源庫映射版本。

接受的值: false, true

--force-string

使用 'set' 或 'add' 時，請保留字元串常值，而不是嘗試轉換成 JSON。

預設值: False

--no-wait

不等候長時間執行的作業完成。

預設值: False

--remove

從清單中移除屬性或專案。範例：--remove property.list OR --remove propertyToRemove。

預設值: []

--replica-count

每個區域要建立的預設複本數目。若要設定區域複寫計數，請使用 --target-regions。

--set

指定要設定的屬性路徑和值來更新物件。範例：--set property1.property2=。

預設值: []

--target-edge-zones

區域、邊緣區域、複本計數和儲存體類型的空格分隔清單。使用 =[=][=] 選擇性地為每個區域設定複本計數和/或儲存體帳戶類型。如果未指定複本計數，則會使用預設複本計數。如果未指定儲存體帳戶類型，則會使用預設儲存體帳戶類型。如果指定了「--target-edge-zones None」，則會清除目標擴充位置。

--target-regions

以空格分隔的區域清單及其複本計數。使用 <region>[=<replica count>][=<storage account type>] 選擇性地為每個區域設定複本計數和/或儲存體帳戶類型。如果未指定複本計數，則會使用預設複本計數。如果未指定儲存體帳戶類型，則會使用預設儲存體帳戶類型。

全域參數

--debug

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

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

--query

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

--subscription

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

--verbose

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

az sig image-version wait

等候映射版本相關作業。

az sig image-version wait --gallery-image-definition
                          --gallery-image-version
                          --gallery-name
                          --resource-group
                          [--created]
                          [--custom]
                          [--deleted]
                          [--exists]
                          [--expand]
                          [--interval]
                          [--timeout]
                          [--updated]

範例

等候映射版本更新

az sig image-version wait --updated --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0

等候映射版本相關作業。自動產生的 ()

az sig image-version wait --created --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0

必要參數

--gallery-image-definition -i

資源庫映射定義。

--gallery-image-version -e

語意版本模式中的資源庫映射版本。允許的字元為數字和句號。數位必須介於 32 位整數的範圍內，例如 <MajorVersion>.<MinorVersion>.<Patch> 。

--gallery-name -r

資源庫名稱。

--resource-group -g

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

選擇性參數

--created

等候在 'Succeeded' 使用 'provisioningState' 建立。

預設值: False

--custom

等到條件符合自訂 JMESPath 查詢為止。例如 provisioningState！='InProgress'，instanceView.statuses[？code=='PowerState/running']。

--deleted

等到刪除為止。

預設值: False

--exists

等到資源存在為止。

預設值: False

--expand

要套用至作業的展開運算式。「ReplicationStatus」預設值為 None。

--interval

以秒為單位輪詢間隔。

預設值: 30

--timeout

等候時間上限，以秒為單位。

預設值: 3600

--updated

等候 provisioningState 更新為 'Succeeded'。

預設值: False

全域參數

--debug

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

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

--query

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

--subscription

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

--verbose

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

az sig image-version

命令

az sig image-version create

範例

必要參數

選擇性參數

az sig image-version delete

必要參數

az sig image-version list

必要參數

az sig image-version list-community

範例

選擇性參數

az sig image-version list-shared

範例

選擇性參數

az sig image-version show

必要參數

選擇性參數

az sig image-version show-community

選擇性參數

az sig image-version show-shared

範例

選擇性參數

az sig image-version update

範例

必要參數

選擇性參數

az sig image-version wait

範例

必要參數

選擇性參數

意見反應

其他資源