az sig image-version

Note

このコマンド グループには、Azure CLI と少なくとも 1 つの拡張機能の両方で定義されているコマンドがあります。 各拡張機能をインストールして、拡張機能を活用します。 拡張機能の詳細については、 を参照してください。

VM を使用して共有ギャラリー イメージのバージョンを管理します。

コマンド

名前	説明	型	状態
az sig image-version create	新しいイメージ バージョンを作成します。	Core	GA
az sig image-version delete	ギャラリー イメージのバージョンを削除します。	Core	GA
az sig image-version list	ギャラリー イメージ定義内のギャラリー イメージ のバージョンを一覧表示します。	Core	GA
az sig image-version list-community	ギャラリー コミュニティで VM イメージのバージョンを一覧表示します。	Core	GA
az sig image-version list-community (image-gallery 拡張機能)	ギャラリー コミュニティ (プレビュー) で VM イメージのバージョンを一覧表示します。	Extension	Experimental
az sig image-version list-shared	サブスクリプションまたはテナントに直接共有されているギャラリー内の VM イメージ のバージョンを一覧表示します。	Core	GA
az sig image-version show	ギャラリー イメージのバージョンに関する情報を取得します。	Core	GA
az sig image-version show-community	コミュニティ ギャラリーのイメージ バージョンを取得します。	Core	GA
az sig image-version show-community (image-gallery 拡張機能)	ギャラリー コミュニティ (プレビュー) でイメージ バージョンを取得します。	Extension	Experimental
az sig image-version show-shared	サブスクリプションまたはテナントに直接共有されているギャラリー内のイメージ バージョンを取得します。	Core	GA
az sig image-version undelete	論理的に削除されたイメージバージョンを復元します。	Core	Preview
az sig image-version update	共有イメージのバージョンを更新します。	Core	GA
az sig image-version wait	条件が満たされるまで CLI を待機状態にします。	Core	GA

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}]
                            [--block-delete-before-eol --block-deletion-before-end-of-life {false, true}]
                            [--data-snapshot-luns]
                            [--data-snapshots]
                            [--data-vhds-luns]
                            [--data-vhds-sa --data-vhds-storage-accounts]
                            [--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]
                            [--storage-account-type {Premium_LRS, Standard_LRS, Standard_ZRS}]
                            [--tags]
                            [--target-edge-zone-encryption --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 で、既定のストレージ アカウントの種類は Standard LRS です。 この例では、eastus2 には Standard ZRS ストレージに 1 つのレプリカが格納され、ukwest には Standard ZRS ストレージに 3 つのレプリカが格納され、southindia には Standard LRS ストレージに 1 つのレプリカが格納され、brazilsouth には Standard LRS ストレージに 2 つのレプリカが格納されます。

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

新しいイメージ バージョンを追加し、このイメージ バージョンのサポート終了が期限切れになっていない場合は削除をブロックします

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 \
--block-deletion-before-end-of-life true

必須のパラメーター

--gallery-image-definition -i

ギャラリー イメージの定義。

--gallery-image-version -e

セマンティック バージョン パターンのギャラリー イメージ バージョン。 使用できる文字は数字とピリオドです。 数字は、32 ビット整数の範囲内である必要があります (例: <MajorVersion>.<MinorVersion>.<Patch>)。

--gallery-name -r

ギャラリー名。

--resource-group -g

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

オプションのパラメーター

次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。

--allow-replicated-location-deletion

レプリケートされたリージョンからこのギャラリー イメージ バージョンを削除できるかどうかを示します。

プロパティ	値
指定可能な値:	false, true

--block-delete-before-eol --block-deletion-before-end-of-life

有効期限が切れていない場合に、このギャラリー イメージ バージョンの削除がブロックされているかどうかを示します。

プロパティ	値
指定可能な値:	false, true

--data-snapshot-luns

データ ディスク スナップショットの論理ユニット番号 (スペース区切り)。

--data-snapshots

データ ディスク スナップショットの名前または ID (スペース区切り)。

--data-vhds-luns

データ ディスクのソース VHD URI の論理ユニット番号 (スペース区切り)。

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

データ ディスクのソース VHD URI のストレージ アカウントの名前または ID (スペース区切り)。

--data-vhds-uris

データ ディスクのソース VHD URI (スペース区切り)。

--end-of-life-date

有効期間の終了日 (例: '2020-12-31')。

--exclude-from-latest

このフラグは、true に設定されている場合、バージョンが省略された VM をデプロイするユーザーはこのバージョンを使用しないことを意味します。

プロパティ	値
指定可能な値:	false, true

--image-version

ギャラリー イメージ バージョン ソースのリソース ID。

--location -l

Location. 値のソース: az account list-locations az configure --defaults location=<location>を使用して、既定の場所を構成できます。

--managed-image

イメージ名 (同じリソース グループ内にある場合) またはリソース ID。

--no-wait

実行時間の長い操作が完了するまで待つ必要はありません。

プロパティ	値
規定値:	False

--os-snapshot

OS ディスク スナップショットの名前または ID。

--os-vhd-storage-account

OS ディスクのソース VHD URI のストレージ アカウントの名前または ID。

--os-vhd-uri

OS ディスクのソース VHD URI。

--replica-count

リージョンごとに作成されるレプリカの既定の数。 リージョン レプリケーションの数を設定するには、--target-regions を使用します。

--replication-mode

レプリケーションに使用するモードを指定する省略可能なパラメーター。 このプロパティは更新できません。

--storage-account-type

リージョンごとに使用される既定のストレージ アカウントの種類。 リージョンのストレージ アカウントの種類を設定するには、--target-regions を使用します。

プロパティ	値
指定可能な値:	Premium_LRS, Standard_LRS, Standard_ZRS

--tags

スペース区切りのタグ: key[=value] [key[=value] ...]既存のタグをクリアするには、"" を使用します。

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

各リージョンのギャラリー成果物内の OS ディスクとデータ ディスクを暗号化するためのカスタマー マネージド キーのスペース区切りの一覧。 各エッジ ゾーンの形式: <edge zone>,<os_des>,<lun1>,<lun1_des>,<lun2>,<lun2_des>。

--target-edge-zones

リージョン、エッジ ゾーン、レプリカ数、ストレージの種類のスペース区切りの一覧。 <region>=<edge zone>[=<replica count>][=<storage account type>] を使用して、必要に応じて各リージョンのレプリカ数やストレージ アカウントの種類を設定します。 レプリカ数が指定されていない場合は、既定のレプリカ数が使用されます。 ストレージ アカウントの種類が指定されていない場合は、既定のストレージ アカウントの種類が使用されます。 "--target-edge-zones None" が指定されている場合、ターゲットの拡張場所はクリアされます。

--target-region-cvm-encryption

各リージョンのギャラリー成果物内の OS ディスクを暗号化する Confidential 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 ソースのリソース ID。

グローバル パラメーター

--debug

ログの詳細度を上げて、すべてのデバッグ ログを表示します。

プロパティ	値
規定値:	False

--help -h

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

--only-show-errors

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

プロパティ	値
規定値:	False

--output -o

出力フォーマット。

プロパティ	値
規定値:	json
指定可能な値:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

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

--verbose

ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。

プロパティ	値
規定値:	False

az sig image-version delete

ギャラリー イメージのバージョンを削除します。

az sig image-version delete [--gallery-image-definition --gallery-image-name]
                            [--gallery-image-version --gallery-image-version-name]
                            [--gallery-name]
                            [--ids]
                            [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                            [--resource-group]
                            [--subscription]

オプションのパラメーター

次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。

--gallery-image-definition --gallery-image-name -i

イメージ バージョンが存在するギャラリー イメージ定義の名前。

プロパティ	値
パラメーター グループ:	Resource Id Arguments

--gallery-image-version --gallery-image-version-name -e

削除するギャラリー イメージ バージョンの名前。

プロパティ	値
パラメーター グループ:	Resource Id Arguments

--gallery-name -r

イメージ定義が存在する共有イメージ ギャラリーの名前。

プロパティ	値
パラメーター グループ:	Resource Id Arguments

--ids

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

プロパティ	値
パラメーター グループ:	Resource Id Arguments

--no-wait

実行時間の長い操作が完了するまで待つ必要はありません。

プロパティ	値
指定可能な値:	0, 1, f, false, n, no, t, true, y, yes

--resource-group -g

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

プロパティ	値
パラメーター グループ:	Resource Id Arguments

--subscription

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

プロパティ	値
パラメーター グループ:	Resource Id Arguments

グローバル パラメーター

--debug

ログの詳細度を上げて、すべてのデバッグ ログを表示します。

プロパティ	値
規定値:	False

--help -h

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

--only-show-errors

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

プロパティ	値
規定値:	False

--output -o

出力フォーマット。

プロパティ	値
規定値:	json
指定可能な値:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--verbose

ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。

プロパティ	値
規定値:	False

az sig image-version list

ギャラリー イメージ定義内のギャラリー イメージ のバージョンを一覧表示します。

az sig image-version list --gallery-image-definition --gallery-image-name
                          --gallery-name
                          --resource-group
                          [--max-items]
                          [--next-token]

必須のパラメーター

--gallery-image-definition --gallery-image-name -i

ギャラリー イメージの定義。

--gallery-name -r

ギャラリー名。

--resource-group -g

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

オプションのパラメーター

次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。

--max-items

コマンドの出力で返される項目の合計数。 使用可能な項目の合計数が指定された値を超える場合は、コマンドの出力にトークンが提供されます。 改ページ位置の変更を再開するには、後続のコマンドの引数 --next-token トークン値を指定します。

プロパティ	値
パラメーター グループ:	Pagination Arguments

--next-token

ページ分割を開始する場所を指定するトークン。 これは、以前に切り捨てられた応答からのトークン値です。

プロパティ	値
パラメーター グループ:	Pagination Arguments

グローバル パラメーター

--debug

ログの詳細度を上げて、すべてのデバッグ ログを表示します。

プロパティ	値
規定値:	False

--help -h

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

--only-show-errors

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

プロパティ	値
規定値:	False

--output -o

出力フォーマット。

プロパティ	値
規定値:	json
指定可能な値:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

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

--verbose

ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。

プロパティ	値
規定値:	False

az sig image-version list-community

ギャラリー コミュニティで VM イメージのバージョンを一覧表示します。

az sig image-version list-community --gallery-image-definition
                                    --location
                                    --public-gallery-name
                                    [--max-items]
                                    [--next-token]

例

ギャラリー コミュニティのイメージ バージョンを一覧表示します。

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

必須のパラメーター

--gallery-image-definition -i

イメージのバージョンが一覧表示されるコミュニティ ギャラリー イメージ定義の名前。

--location -l

Location. 値のソース: az account list-locations az configure --defaults location=<location>を使用して、既定の場所を構成できます。

--public-gallery-name

コミュニティ ギャラリーのパブリック名。

オプションのパラメーター

次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。

--max-items

コマンドの出力で返される項目の合計数。 使用可能な項目の合計数が指定された値を超える場合は、コマンドの出力にトークンが提供されます。 改ページ位置の変更を再開するには、後続のコマンドの引数 --next-token トークン値を指定します。

プロパティ	値
パラメーター グループ:	Pagination Arguments

--next-token

ページ分割を開始する場所を指定するトークン。 これは、以前に切り捨てられた応答からのトークン値です。

プロパティ	値
パラメーター グループ:	Pagination Arguments

グローバル パラメーター

--debug

ログの詳細度を上げて、すべてのデバッグ ログを表示します。

プロパティ	値
規定値:	False

--help -h

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

--only-show-errors

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

プロパティ	値
規定値:	False

--output -o

出力フォーマット。

プロパティ	値
規定値:	json
指定可能な値:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

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

--verbose

ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。

プロパティ	値
規定値:	False

az sig image-version list-community (image-gallery 拡張機能)

実験用

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

ギャラリー コミュニティ (プレビュー) で VM イメージのバージョンを一覧表示します。

ギャラリー コミュニティで VM イメージのバージョンを一覧表示します (プライベート プレビュー機能、この機能の使用に関心がある場合は、プレビューに登録するために、コミュニティ イメージ ギャラリー チームに電子メール sigpmdev@microsoft.com でお問い合わせください)。

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

オプションのパラメーター

次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。

--gallery-image-definition -i

イメージのバージョンが一覧表示されるコミュニティ ギャラリー イメージ定義の名前。

プロパティ	値
パラメーター グループ:	Resource Id Arguments

--ids

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

プロパティ	値
パラメーター グループ:	Resource Id Arguments

--location -l

Location. 値のソース: az account list-locations az configure --defaults location=<location>を使用して、既定の場所を構成できます。

プロパティ	値
パラメーター グループ:	Resource Id Arguments

--marker

次の一覧表示操作で返されるコンテナーの一覧の部分を識別する文字列値。 一覧表示操作で、現在のページに残っているすべてのコンテナーが返されなかった場合、操作は応答本文内の NextMarker 値を返します。 指定した場合、このジェネレーターは、前のジェネレーターが停止したポイントからの結果の返しを開始します。

--public-gallery-name

コミュニティ ギャラリーのパブリック名。

プロパティ	値
パラメーター グループ:	Resource Id Arguments

--show-next-marker

指定すると、nextMarker が結果に表示されます。

--subscription

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

プロパティ	値
パラメーター グループ:	Resource Id Arguments

グローバル パラメーター

--debug

ログの詳細度を上げて、すべてのデバッグ ログを表示します。

プロパティ	値
規定値:	False

--help -h

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

--only-show-errors

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

プロパティ	値
規定値:	False

--output -o

出力フォーマット。

プロパティ	値
規定値:	json
指定可能な値:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--verbose

ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。

プロパティ	値
規定値:	False

az sig image-version list-shared

サブスクリプションまたはテナントに直接共有されているギャラリー内の VM イメージ のバージョンを一覧表示します。

az sig image-version list-shared --gallery-image-definition
                                 --gallery-unique-name
                                 --location
                                 [--max-items]
                                 [--next-token]
                                 [--shared-to {tenant}]

例

特定の場所とイメージ定義でサブスクリプションに直接共有されているギャラリー内のイメージ バージョンを一覧表示します。

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

共有ギャラリーの一意の名前。

--location -l

Location. 値のソース: az account list-locations az configure --defaults location=<location>を使用して、既定の場所を構成できます。

オプションのパラメーター

次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。

--max-items

コマンドの出力で返される項目の合計数。 使用可能な項目の合計数が指定された値を超える場合は、コマンドの出力にトークンが提供されます。 改ページ位置の変更を再開するには、後続のコマンドの引数 --next-token トークン値を指定します。

プロパティ	値
パラメーター グループ:	Pagination Arguments

--next-token

ページ分割を開始する場所を指定するトークン。 これは、以前に切り捨てられた応答からのトークン値です。

プロパティ	値
パラメーター グループ:	Pagination Arguments

--shared-to

一覧表示操作の実行時にフェッチする共有ギャラリーを決定するクエリ パラメーター。 指定しない場合は、サブスクリプション ID で一覧表示します。

プロパティ	値
指定可能な値:	tenant

グローバル パラメーター

--debug

ログの詳細度を上げて、すべてのデバッグ ログを表示します。

プロパティ	値
規定値:	False

--help -h

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

--only-show-errors

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

プロパティ	値
規定値:	False

--output -o

出力フォーマット。

プロパティ	値
規定値:	json
指定可能な値:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

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

--verbose

ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。

プロパティ	値
規定値:	False

az sig image-version show

ギャラリー イメージのバージョンに関する情報を取得します。

az sig image-version show [--expand {ReplicationStatus, UefiSettings}]
                          [--gallery-image-definition]
                          [--gallery-image-version --gallery-image-version-name]
                          [--gallery-name]
                          [--ids]
                          [--resource-group]
                          [--subscription]

オプションのパラメーター

次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。

--expand

操作に適用する展開式。

プロパティ	値
指定可能な値:	ReplicationStatus, UefiSettings

--gallery-image-definition -i

イメージ バージョンが存在するギャラリー イメージ定義の名前。

プロパティ	値
パラメーター グループ:	Resource Id Arguments

--gallery-image-version --gallery-image-version-name -e

削除するギャラリー イメージ バージョンの名前。

プロパティ	値
パラメーター グループ:	Resource Id Arguments

--gallery-name -r

イメージ定義が存在する共有イメージ ギャラリーの名前。

プロパティ	値
パラメーター グループ:	Resource Id Arguments

--ids

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

プロパティ	値
パラメーター グループ:	Resource Id Arguments

--resource-group -g

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

プロパティ	値
パラメーター グループ:	Resource Id Arguments

--subscription

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

プロパティ	値
パラメーター グループ:	Resource Id Arguments

グローバル パラメーター

--debug

ログの詳細度を上げて、すべてのデバッグ ログを表示します。

プロパティ	値
規定値:	False

--help -h

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

--only-show-errors

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

プロパティ	値
規定値:	False

--output -o

出力フォーマット。

プロパティ	値
規定値:	json
指定可能な値:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--verbose

ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。

プロパティ	値
規定値:	False

az sig image-version show-community

コミュニティ ギャラリーのイメージ バージョンを取得します。

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

オプションのパラメーター

次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。

--gallery-image-definition --gallery-image-name -i

イメージのバージョンが一覧表示されるコミュニティ ギャラリー イメージ定義の名前。

プロパティ	値
パラメーター グループ:	Resource Id Arguments

--gallery-image-version --gallery-image-version-name -e

セマンティック バージョン パターンのギャラリー イメージ バージョン。 使用できる文字は数字とピリオドです。 数字は、32 ビット整数の範囲内である必要があります (例: <MajorVersion>.<MinorVersion>.<Patch>)。

プロパティ	値
パラメーター グループ:	Resource Id Arguments

--ids

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

プロパティ	値
パラメーター グループ:	Resource Id Arguments

--location -l

Location. 値のソース: az account list-locations az configure --defaults location=<location>を使用して、既定の場所を構成できます。

プロパティ	値
パラメーター グループ:	Resource Id Arguments

--public-gallery-name

コミュニティ ギャラリーのパブリック名。

プロパティ	値
パラメーター グループ:	Resource Id Arguments

--subscription

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

プロパティ	値
パラメーター グループ:	Resource Id Arguments

グローバル パラメーター

--debug

ログの詳細度を上げて、すべてのデバッグ ログを表示します。

プロパティ	値
規定値:	False

--help -h

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

--only-show-errors

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

プロパティ	値
規定値:	False

--output -o

出力フォーマット。

プロパティ	値
規定値:	json
指定可能な値:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--verbose

ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。

プロパティ	値
規定値:	False

az sig image-version show-community (image-gallery 拡張機能)

実験用

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

ギャラリー コミュニティ (プレビュー) でイメージ バージョンを取得します。

ギャラリー コミュニティでイメージ バージョンを取得します (プライベート プレビュー機能、この機能の使用に関心がある場合は、プレビューに登録するために、コミュニティ イメージ ギャラリー チームに電子メール sigpmdev@microsoft.com で問い合わせてください)。

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

例

特定の場所にあるギャラリー コミュニティでイメージ バージョンを取得します。

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

オプションのパラメーター

次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。

--gallery-image-definition -i

イメージのバージョンが一覧表示されるコミュニティ ギャラリー イメージ定義の名前。

プロパティ	値
パラメーター グループ:	Resource Id Arguments

--gallery-image-version -e

作成するギャラリー イメージ バージョンの名前。 セマンティック バージョン名パターンに従う必要がある: 使用できる文字は数字とピリオドです。 数字は、32 ビット整数の範囲内である必要があります。 形式: <MajorVersion>.<MinorVersion>.<Patch>.

プロパティ	値
パラメーター グループ:	Resource Id Arguments

--ids

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

プロパティ	値
パラメーター グループ:	Resource Id Arguments

--location -l

Location. 値のソース: az account list-locations az configure --defaults location=<location>を使用して、既定の場所を構成できます。

プロパティ	値
パラメーター グループ:	Resource Id Arguments

--public-gallery-name

コミュニティ ギャラリーのパブリック名。

プロパティ	値
パラメーター グループ:	Resource Id Arguments

--subscription

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

プロパティ	値
パラメーター グループ:	Resource Id Arguments

グローバル パラメーター

--debug

ログの詳細度を上げて、すべてのデバッグ ログを表示します。

プロパティ	値
規定値:	False

--help -h

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

--only-show-errors

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

プロパティ	値
規定値:	False

--output -o

出力フォーマット。

プロパティ	値
規定値:	json
指定可能な値:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--verbose

ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。

プロパティ	値
規定値:	False

az sig image-version show-shared

サブスクリプションまたはテナントに直接共有されているギャラリー内のイメージ バージョンを取得します。

az sig image-version show-shared [--gallery-image-definition --gallery-image-name]
                                 [--gallery-image-version --gallery-image-version-name]
                                 [--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

オプションのパラメーター

次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。

--gallery-image-definition --gallery-image-name -i

イメージ バージョンが一覧表示される共有ギャラリー イメージ定義の名前。

プロパティ	値
パラメーター グループ:	Resource Id Arguments

--gallery-image-version --gallery-image-version-name -e

作成するギャラリー イメージ バージョンの名前。 セマンティック バージョン名パターンに従う必要がある: 使用できる文字は数字とピリオドです。 数字は、32 ビット整数の範囲内である必要があります。 形式: <MajorVersion>.<MinorVersion>.<Patch>.

プロパティ	値
パラメーター グループ:	Resource Id Arguments

--gallery-unique-name

共有ギャラリーの一意の名前。

プロパティ	値
パラメーター グループ:	Resource Id Arguments

--ids

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

プロパティ	値
パラメーター グループ:	Resource Id Arguments

--location -l

Location. 値のソース: az account list-locations az configure --defaults location=<location>を使用して、既定の場所を構成できます。

プロパティ	値
パラメーター グループ:	Resource Id Arguments

--subscription

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

プロパティ	値
パラメーター グループ:	Resource Id Arguments

グローバル パラメーター

--debug

ログの詳細度を上げて、すべてのデバッグ ログを表示します。

プロパティ	値
規定値:	False

--help -h

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

--only-show-errors

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

プロパティ	値
規定値:	False

--output -o

出力フォーマット。

プロパティ	値
規定値:	json
指定可能な値:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--verbose

ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。

プロパティ	値
規定値:	False

az sig image-version undelete

プレビュー

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

論理的に削除されたイメージバージョンを復元します。

操作は、論理的な削除がオンになっているギャラリー内で使用した場合にのみ成功します。

az sig image-version undelete --gallery-image-definition
                              --gallery-image-version
                              --gallery-name
                              --resource-group
                              [--allow-replicated-location-deletion {false, true}]
                              [--location]
                              [--no-wait]
                              [--tags]

例

論理的に削除されたイメージ バージョンを復元する

az sig image-version undelete --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.1.1

必須のパラメーター

--gallery-image-definition -i

ギャラリー イメージの定義。

--gallery-image-version -e

セマンティック バージョン パターンのギャラリー イメージ バージョン。 使用できる文字は数字とピリオドです。 数字は、32 ビット整数の範囲内である必要があります (例: <MajorVersion>.<MinorVersion>.<Patch>)。

--gallery-name -r

ギャラリー名。

--resource-group -g

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

オプションのパラメーター

次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。

--allow-replicated-location-deletion

レプリケートされたリージョンからこのギャラリー イメージ バージョンを削除できるかどうかを示します。

プロパティ	値
指定可能な値:	false, true

--location -l

Location. 値のソース: az account list-locations az configure --defaults location=<location>を使用して、既定の場所を構成できます。

--no-wait

実行時間の長い操作が完了するまで待つ必要はありません。

プロパティ	値
規定値:	False

--tags

スペース区切りのタグ: key[=value] [key[=value] ...]既存のタグをクリアするには、"" を使用します。

グローバル パラメーター

--debug

ログの詳細度を上げて、すべてのデバッグ ログを表示します。

プロパティ	値
規定値:	False

--help -h

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

--only-show-errors

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

プロパティ	値
規定値:	False

--output -o

出力フォーマット。

プロパティ	値
規定値:	json
指定可能な値:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

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

--verbose

ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。

プロパティ	値
規定値:	False

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}]
                            [--block-delete-before-eol --block-deletion-before-end-of-life {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

このギャラリー イメージ バージョンのサポート終了が期限切れになっていない場合は、削除をブロックします。

az sig image-version update -g MyResourceGroup --gallery-name MyGallery \
--gallery-image-definition MyImage --gallery-image-version 1.0.0 \
--block-deletion-before-end-of-life true

必須のパラメーター

--gallery-image-definition -i

ギャラリー イメージの定義。

--gallery-image-version -e

セマンティック バージョン パターンのギャラリー イメージ バージョン。 使用できる文字は数字とピリオドです。 数字は、32 ビット整数の範囲内である必要があります (例: <MajorVersion>.<MinorVersion>.<Patch>)。

--gallery-name -r

ギャラリー名。

--resource-group -g

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

オプションのパラメーター

次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。

--add

パスとキー値のペアを指定して、オブジェクトの一覧にオブジェクトを追加します。 例: --add property.listProperty <key=value, string or JSON string>。

プロパティ	値
パラメーター グループ:	Generic Update Arguments
規定値:	[]

--allow-replicated-location-deletion

レプリケートされたリージョンからこのギャラリー イメージ バージョンを削除できるかどうかを示します。

プロパティ	値
指定可能な値:	false, true

--block-delete-before-eol --block-deletion-before-end-of-life

有効期限が切れていない場合に、このギャラリー イメージ バージョンの削除がブロックされているかどうかを示します。

プロパティ	値
指定可能な値:	false, true

--force-string

'set' または 'add' を使用する場合は、JSON に変換するのではなく、文字列リテラルを保持します。

プロパティ	値
パラメーター グループ:	Generic Update Arguments
規定値:	False

--no-wait

実行時間の長い操作が完了するまで待つ必要はありません。

プロパティ	値
規定値:	False

--remove

リストからプロパティまたは要素を削除します。 例: --remove property.list <indexToRemove> OR --remove propertyToRemove。

プロパティ	値
パラメーター グループ:	Generic Update Arguments
規定値:	[]

--replica-count

リージョンごとに作成されるレプリカの既定の数。 リージョン レプリケーションの数を設定するには、--target-regions を使用します。

--set

設定するプロパティ パスと値を指定して、オブジェクトを更新します。 例: --set property1.property2=<value>。

プロパティ	値
パラメーター グループ:	Generic Update Arguments
規定値:	[]

--target-edge-zones

リージョン、エッジ ゾーン、レプリカ数、ストレージの種類のスペース区切りの一覧。 <region>=<edge zone>[=<replica count>][=<storage account type>] を使用して、必要に応じて各リージョンのレプリカ数やストレージ アカウントの種類を設定します。 レプリカ数が指定されていない場合は、既定のレプリカ数が使用されます。 ストレージ アカウントの種類が指定されていない場合は、既定のストレージ アカウントの種類が使用されます。 "--target-edge-zones None" が指定されている場合、ターゲットの拡張場所はクリアされます。

--target-regions

領域で区切られたリージョンとそのレプリカ数の一覧。 <region>[=<replica count>][=<storage account type>] を使用して、必要に応じて各リージョンのレプリカ数やストレージ アカウントの種類を設定します。 レプリカ数が指定されていない場合は、既定のレプリカ数が使用されます。 ストレージ アカウントの種類が指定されていない場合は、既定のストレージ アカウントの種類が使用されます。

グローバル パラメーター

--debug

ログの詳細度を上げて、すべてのデバッグ ログを表示します。

プロパティ	値
規定値:	False

--help -h

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

--only-show-errors

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

プロパティ	値
規定値:	False

--output -o

出力フォーマット。

プロパティ	値
規定値:	json
指定可能な値:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

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

--verbose

ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。

プロパティ	値
規定値:	False

az sig image-version wait

条件が満たされるまで CLI を待機状態にします。

az sig image-version wait [--created]
                          [--custom]
                          [--deleted]
                          [--exists]
                          [--expand {ReplicationStatus, UefiSettings}]
                          [--gallery-image-definition]
                          [--gallery-image-version --gallery-image-version-name]
                          [--gallery-name]
                          [--ids]
                          [--interval]
                          [--resource-group]
                          [--subscription]
                          [--timeout]
                          [--updated]

オプションのパラメーター

次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。

--created

'provisioningState' が 'Succeeded' で作成されるまで待ちます。

プロパティ	値
パラメーター グループ:	Wait Condition Arguments
規定値:	False

--custom

条件がカスタム JMESPath クエリを満たすまで待ちます。 例: provisioningState!='InProgress'、instanceView.statuses[?code=='PowerState/running']。

プロパティ	値
パラメーター グループ:	Wait Condition Arguments

--deleted

削除されるまで待ちます。

プロパティ	値
パラメーター グループ:	Wait Condition Arguments
規定値:	False

--exists

リソースが存在するまで待ちます。

プロパティ	値
パラメーター グループ:	Wait Condition Arguments
規定値:	False

--expand

操作に適用する展開式。

プロパティ	値
指定可能な値:	ReplicationStatus, UefiSettings

--gallery-image-definition -i

イメージ バージョンが存在するギャラリー イメージ定義の名前。

プロパティ	値
パラメーター グループ:	Resource Id Arguments

--gallery-image-version --gallery-image-version-name -e

削除するギャラリー イメージ バージョンの名前。

プロパティ	値
パラメーター グループ:	Resource Id Arguments

--gallery-name -r

イメージ定義が存在する共有イメージ ギャラリーの名前。

プロパティ	値
パラメーター グループ:	Resource Id Arguments

--ids

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

プロパティ	値
パラメーター グループ:	Resource Id Arguments

--interval

ポーリング間隔 (秒単位)。

プロパティ	値
パラメーター グループ:	Wait Condition Arguments
規定値:	30

--resource-group -g

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

プロパティ	値
パラメーター グループ:	Resource Id Arguments

--subscription

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

プロパティ	値
パラメーター グループ:	Resource Id Arguments

--timeout

最大待機時間 (秒単位)。

プロパティ	値
パラメーター グループ:	Wait Condition Arguments
規定値:	3600

--updated

provisioningState が 'Succeeded' で更新されるまで待ちます。

プロパティ	値
パラメーター グループ:	Wait Condition Arguments
規定値:	False

グローバル パラメーター

--debug

ログの詳細度を上げて、すべてのデバッグ ログを表示します。

プロパティ	値
規定値:	False

--help -h

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

--only-show-errors

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

プロパティ	値
規定値:	False

--output -o

出力フォーマット。

プロパティ	値
規定値:	json
指定可能な値:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--verbose

ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。

プロパティ	値
規定値:	False