az sig image-version

リファレンス

Note

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

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

コマンド

名前	説明	型	状態
az sig image-version create	新しいイメージバージョンを作成します。	コア	GA
az sig image-version delete	ギャラリーイメージのバージョンを削除します。	コア	GA
az sig image-version list	ギャラリーイメージ定義内のギャラリーイメージのバージョンを一覧表示します。	コア	GA
az sig image-version list-community	ギャラリーコミュニティで VM イメージのバージョンを一覧表示します。	コア	GA
az sig image-version list-community (image-gallery 拡張機能)	ギャラリーコミュニティ (プレビュー) で VM イメージのバージョンを一覧表示します。	拡張子	実験用
az sig image-version list-shared	サブスクリプションまたはテナントに直接共有されているギャラリー内の VM イメージのバージョンを一覧表示します。	コア	GA
az sig image-version show	ギャラリーイメージのバージョンに関する情報を取得します。	コア	GA
az sig image-version show-community	コミュニティギャラリーのイメージバージョンを取得します。	コア	GA
az sig image-version show-community (image-gallery 拡張機能)	ギャラリーコミュニティ (プレビュー) でイメージバージョンを取得します。	拡張子	実験用
az sig image-version show-shared	サブスクリプションまたはテナントに直接共有されているギャラリー内のイメージバージョンを取得します。	コア	GA
az sig image-version undelete	論理的に削除されたイメージバージョンを復元します。	コア	プレビュー
az sig image-version update	共有イメージのバージョンを更新します。	コア	GA
az sig image-version wait	イメージバージョンに関連する操作を待機します。	コア	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}]
                            [--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 で、既定のストレージアカウントの種類は 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

必須のパラメーター

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

データディスクスナップショットの名前または 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

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

指定可能な値: 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 ディスクを暗号化する 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

すべてのデバッグログを表示するようにログの詳細レベルを上げます。

--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 sig image-version delete

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

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

省略可能のパラメーター

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

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

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

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

--gallery-name -r

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

--ids

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

--no-wait

実行時間の長い操作の終了を待機しません。

指定可能な値: 0, 1, f, false, n, no, t, true, y, yes

--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 sig image-version list

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

az sig image-version list --gallery-image-definition
                          --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> を使用して、既定のグループを構成できます。

省略可能のパラメーター

--max-items

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

--next-token

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

グローバルパラメーター

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

--location -l

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

--marker

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

--public-gallery-name

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

--show-next-marker

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

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

省略可能のパラメーター

--gallery-image-definition -i

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

--ids

--location -l

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

--marker

--public-gallery-name

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

--show-next-marker

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

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

--location -l

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

--marker

--shared-to

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

指定可能な値: tenant

--show-next-marker

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

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

--gallery-name -r

ギャラリー名。

--resource-group -g

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

省略可能のパラメーター

--expand

操作に適用する展開式 (例: "ReplicationStatus")。

グローバルパラメーター

--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 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 --gallery-image-name -i

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

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

--ids

--location -l

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

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

省略可能のパラメーター

--gallery-image-definition -i

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

--gallery-image-version -e

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

--ids

--location -l

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

--public-gallery-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 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 --gallery-image-name -i

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

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

--gallery-unique-name

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

--ids

--location -l

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

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

--gallery-name -r

ギャラリー名。

--resource-group -g

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

省略可能のパラメーター

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

すべてのデバッグログを表示するようにログの詳細レベルを上げます。

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

--gallery-name -r

ギャラリー名。

--resource-group -g

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

省略可能のパラメーター

--add

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

規定値: []

--allow-replicated-location-deletion

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

指定可能な値: false, true

--force-string

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

規定値: False

--no-wait

実行時間の長い操作の終了を待機しません。

規定値: False

--remove

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

規定値: []

--replica-count

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

--set

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

規定値: []

--target-edge-zones

--target-regions

グローバルパラメーター

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

--gallery-name -r

ギャラリー名。

--resource-group -g

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

省略可能のパラメーター

--created

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

規定値: 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

出力形式。

指定可能な値: 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 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-community (image-gallery 拡張機能)

例

省略可能のパラメーター

az sig image-version list-shared

例

省略可能のパラメーター

az sig image-version show

必須のパラメーター

省略可能のパラメーター

az sig image-version show-community

省略可能のパラメーター

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

例

省略可能のパラメーター

az sig image-version show-shared

例

省略可能のパラメーター

az sig image-version undelete

例

必須のパラメーター

省略可能のパラメーター

az sig image-version update

例

必須のパラメーター

省略可能のパラメーター

az sig image-version wait

例

必須のパラメーター

省略可能のパラメーター

その他のリソース