次の方法で共有


az sig image-version

Note

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

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

コマンド

名前 説明 Status
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

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

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

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

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

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

--location -l

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

--marker

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

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

セマンティック バージョン パターンのギャラリー イメージ バージョン。 使用できる文字は数字とピリオドです。 数字は、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

出力形式。

承認された値: 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

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

--ids

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

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

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

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

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

--gallery-unique-name

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

--ids

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

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

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

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

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

--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-edge-zones None" が指定されている場合、ターゲットの拡張場所はクリアされます。

--target-regions

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

グローバル パラメーター
--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

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

--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 を使います。