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 0OS ディスクのスナップショットから新しいイメージ バージョンを追加します。
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/MyOsDiskSnapshotOS ディスクのスナップショットから新しいイメージ バージョンを追加し、データ ディスクとしてスナップショットを追加する
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 0OS ディスクの 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_fileOS ディスクの 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必須のパラメーター
ギャラリー イメージの定義。
セマンティック バージョン パターンのギャラリー イメージ バージョン。 使用できる文字は数字とピリオドです。 数字は、32 ビット整数の範囲内である必要があります 。例: <MajorVersion>.<MinorVersion>.<Patch>
ギャラリー名。
リソース グループの名前。 az configure --defaults group=<name> を使用して、既定のグループを構成できます。
省略可能のパラメーター
レプリケートされたリージョンからこのギャラリー イメージ バージョンを削除できるかどうかを示します。
データ ディスク スナップショットの論理ユニット番号 (スペース区切り)。
データ ディスク スナップショットの名前または ID (スペース区切り)。
データ ディスクのソース VHD URI の論理ユニット番号 (スペース区切り)。
データ ディスクのソース VHD URI のストレージ アカウントの名前または ID (スペース区切り)。
データ ディスクのソース VHD URI (スペース区切り)。
有効期間の終了日 (例: '2020-12-31')。
このフラグは、true に設定されている場合、バージョンが省略された VM をデプロイするユーザーはこのバージョンを使用しないことを意味します。
ギャラリー イメージ バージョン ソースのリソース ID。
Location。 値のソース: az account list-locations az configure --defaults location=<location> を使用して、既定の場所を構成できます。
イメージ名 (同じリソース グループ内にある場合) またはリソース ID。
実行時間の長い操作の終了を待機しません。
OS ディスク スナップショットの名前または ID。
OS ディスクのソース VHD URI のストレージ アカウントの名前または ID。
OS ディスクのソース VHD URI。
リージョンごとに作成されるレプリカの既定の数。 リージョン レプリケーションの数を設定するには、--target-regions を使用します。
レプリケーションに使用するモードを指定する省略可能なパラメーター。 このプロパティは更新できません。
リージョンごとに使用される既定のストレージ アカウントの種類。 リージョンのストレージ アカウントの種類を設定するには、--target-regions を使用します。
スペース区切りのタグ: key[=value] [key[=value] ...]既存のタグをクリアするには、"" を使用します。
各リージョンのギャラリー成果物内の OS ディスクとデータ ディスクを暗号化するためのカスタマー マネージド キーのスペース区切りの一覧。 各エッジ ゾーンの形式: ,<os_des,lun1_des,lun2_des>>><<.
リージョン、エッジ ゾーン、レプリカ数、ストレージの種類のスペース区切りの一覧。 必要に応じて、各リージョンのレプリカ数やストレージ アカウントの種類を設定するには、=[=][=] を使用します。 レプリカ数が指定されていない場合は、既定のレプリカ数が使用されます。 ストレージ アカウントの種類が指定されていない場合は、既定のストレージ アカウントの種類が使用されます。 "--target-edge-zones None" が指定されている場合、ターゲットの拡張場所はクリアされます。
各リージョンのギャラリー成果物内の OS ディスクを暗号化する Confidential VM のカスタマー マネージド キーのスペース区切りの一覧。 各リージョンの形式: <os_cvm_encryption_type>,<os_cvm_des> os_cvm_encryption_typeの有効な値は、EncryptedVMGuestStateOnlyWithPmk、EncryptedWithPmk、EncryptedWithCmk です。
各リージョンのギャラリー成果物内の OS ディスクとデータ ディスクを暗号化するためのカスタマー マネージド キーのスペース区切りの一覧。 各リージョンの形式: <os_des>,<lun1>,<lun1_des>,<lun2>,<lun2_des> プレースホルダーとして "null" を使用します。
領域で区切られたリージョンとそのレプリカ数の一覧。 必要に応じて、リージョンごとにレプリカ数やストレージ アカウントの種類を設定するために使用 <region>[=<replica count>][=<storage account type>] します。 レプリカ数が指定されていない場合は、既定のレプリカ数が使用されます。 ストレージ アカウントの種類が指定されていない場合は、既定のストレージ アカウントの種類が使用されます。
VM ソースのリソース ID。
グローバル パラメーター
すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告は抑制します。
出力形式。
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。
サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。
ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --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]省略可能のパラメーター
イメージ バージョンが存在するギャラリー イメージ定義の名前。
削除するギャラリー イメージ バージョンの名前。
イメージ定義が存在する共有イメージ ギャラリーの名前。
1 つまたは複数のリソース ID (スペース区切り)。 これは、'Resource Id' 引数のすべての情報を含む完全なリソース ID である必要があります。 --ids または他の 'Resource Id' 引数を指定する必要があります。
実行時間の長い操作の終了を待機しません。
リソース グループの名前。 az configure --defaults group=<name> を使用して、既定のグループを構成できます。
サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。
グローバル パラメーター
すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告は抑制します。
出力形式。
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。
サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。
ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。
az sig image-version list
ギャラリー イメージ定義内のギャラリー イメージ のバージョンを一覧表示します。
az sig image-version list --gallery-image-definition
--gallery-name
--resource-group
[--max-items]
[--next-token]必須のパラメーター
ギャラリー イメージの定義。
ギャラリー名。
リソース グループの名前。 az configure --defaults group=<name> を使用して、既定のグループを構成できます。
省略可能のパラメーター
コマンドの出力で返される項目の合計数。 使用可能な項目の合計数が指定された値を超える場合は、コマンドの出力にトークンが提供されます。 改ページ位置の変更を再開するには、後続のコマンドの引数に --next-token トークン値を指定します。
ページ分割を開始する場所を指定するトークン。 これは、以前に切り捨てられた応答からのトークン値です。
グローバル パラメーター
すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告は抑制します。
出力形式。
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。
サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。
ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --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省略可能のパラメーター
イメージのバージョンが一覧表示されるコミュニティ ギャラリー イメージ定義の名前。
1 つまたは複数のリソース ID (スペース区切り)。 これは、'Resource Id' 引数のすべての情報を含む完全なリソース ID である必要があります。 --ids または他の 'Resource Id' 引数を指定する必要があります。
Location。 値のソース: az account list-locations az configure --defaults location=<location> を使用して、既定の場所を構成できます。
次の一覧表示操作で返されるコンテナーの一覧の部分を識別する文字列値。 この操作は、一覧表示操作ですべてのコンテナーが返されなかった場合に、応答本文内の NextMarker 値を返しますメイン現在のページと共に一覧表示されます。 指定した場合、このジェネレーターは、前のジェネレーターが停止したポイントからの結果の返しを開始します。
コミュニティ ギャラリーのパブリック名。
指定すると、nextMarker が結果に表示されます。
サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。
グローバル パラメーター
すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告は抑制します。
出力形式。
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。
サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。
ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --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省略可能のパラメーター
イメージのバージョンが一覧表示されるコミュニティ ギャラリー イメージ定義の名前。
1 つまたは複数のリソース ID (スペース区切り)。 これは、'Resource Id' 引数のすべての情報を含む完全なリソース ID である必要があります。 --ids または他の 'Resource Id' 引数を指定する必要があります。
Location。 値のソース: az account list-locations az configure --defaults location=<location> を使用して、既定の場所を構成できます。
次の一覧表示操作で返されるコンテナーの一覧の部分を識別する文字列値。 この操作は、一覧表示操作ですべてのコンテナーが返されなかった場合に、応答本文内の NextMarker 値を返しますメイン現在のページと共に一覧表示されます。 指定した場合、このジェネレーターは、前のジェネレーターが停止したポイントからの結果の返しを開始します。
コミュニティ ギャラリーのパブリック名。
指定すると、nextMarker が結果に表示されます。
サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。
グローバル パラメーター
すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告は抑制します。
出力形式。
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。
サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。
ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --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省略可能のパラメーター
イメージ バージョンが一覧表示される共有ギャラリー イメージ定義の名前。
共有ギャラリーの一意の名前。
1 つまたは複数のリソース ID (スペース区切り)。 これは、'Resource Id' 引数のすべての情報を含む完全なリソース ID である必要があります。 --ids または他の 'Resource Id' 引数を指定する必要があります。
Location。 値のソース: az account list-locations az configure --defaults location=<location> を使用して、既定の場所を構成できます。
次の一覧表示操作で返されるコンテナーの一覧の部分を識別する文字列値。 この操作は、一覧表示操作ですべてのコンテナーが返されなかった場合に、応答本文内の NextMarker 値を返しますメイン現在のページと共に一覧表示されます。 指定した場合、このジェネレーターは、前のジェネレーターが停止したポイントからの結果の返しを開始します。
一覧表示操作の実行時にフェッチする共有ギャラリーを決定するクエリ パラメーター。 指定しない場合は、サブスクリプション ID で一覧表示します。
指定すると、nextMarker が結果に表示されます。
サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。
グローバル パラメーター
すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告は抑制します。
出力形式。
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。
サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。
ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。
az sig image-version show
ギャラリー イメージのバージョンに関する情報を取得します。
az sig image-version show --gallery-image-definition
--gallery-image-version
--gallery-name
--resource-group
[--expand]必須のパラメーター
ギャラリー イメージの定義。
セマンティック バージョン パターンのギャラリー イメージ バージョン。 使用できる文字は数字とピリオドです。 数字は、32 ビット整数の範囲内である必要があります 。例: <MajorVersion>.<MinorVersion>.<Patch>
ギャラリー名。
リソース グループの名前。 az configure --defaults group=<name> を使用して、既定のグループを構成できます。
省略可能のパラメーター
操作に適用する展開式 (例: "ReplicationStatus")。
グローバル パラメーター
すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告は抑制します。
出力形式。
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。
サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。
ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --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]省略可能のパラメーター
イメージのバージョンが一覧表示されるコミュニティ ギャラリー イメージ定義の名前。
セマンティック バージョン パターンのギャラリー イメージ バージョン。 使用できる文字は数字とピリオドです。 数字は、32 ビット整数の範囲内である必要があります 。例: <MajorVersion>.<MinorVersion>.<Patch>
1 つまたは複数のリソース ID (スペース区切り)。 これは、'Resource Id' 引数のすべての情報を含む完全なリソース ID である必要があります。 --ids または他の 'Resource Id' 引数を指定する必要があります。
Location。 値のソース: az account list-locations az configure --defaults location=<location> を使用して、既定の場所を構成できます。
コミュニティ ギャラリーのパブリック名。
サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。
グローバル パラメーター
すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告は抑制します。
出力形式。
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。
サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。
ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --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省略可能のパラメーター
イメージのバージョンが一覧表示されるコミュニティ ギャラリー イメージ定義の名前。
作成するギャラリー イメージ バージョンの名前。 セマンティック バージョン名パターンに従う必要がある: 使用できる文字は数字とピリオドです。 数字は、32 ビット整数の範囲内である必要があります。 形式：。。。
1 つまたは複数のリソース ID (スペース区切り)。 これは、'Resource Id' 引数のすべての情報を含む完全なリソース ID である必要があります。 --ids または他の 'Resource Id' 引数を指定する必要があります。
Location。 値のソース: az account list-locations az configure --defaults location=<location> を使用して、既定の場所を構成できます。
コミュニティ ギャラリーのパブリック名。
サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。
グローバル パラメーター
すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告は抑制します。
出力形式。
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。
サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。
ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --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省略可能のパラメーター
イメージ バージョンが一覧表示される共有ギャラリー イメージ定義の名前。
作成するギャラリー イメージ バージョンの名前。 セマンティック バージョン名パターンに従う必要がある: 使用できる文字は数字とピリオドです。 数字は、32 ビット整数の範囲内である必要があります。 形式：。。。
共有ギャラリーの一意の名前。
1 つまたは複数のリソース ID (スペース区切り)。 これは、'Resource Id' 引数のすべての情報を含む完全なリソース ID である必要があります。 --ids または他の 'Resource Id' 引数を指定する必要があります。
Location。 値のソース: az account list-locations az configure --defaults location=<location> を使用して、既定の場所を構成できます。
サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。
グローバル パラメーター
すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告は抑制します。
出力形式。
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。
サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。
ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --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必須のパラメーター
ギャラリー イメージの定義。
セマンティック バージョン パターンのギャラリー イメージ バージョン。 使用できる文字は数字とピリオドです。 数字は、32 ビット整数の範囲内である必要があります 。例: <MajorVersion>.<MinorVersion>.<Patch>
ギャラリー名。
リソース グループの名前。 az configure --defaults group=<name> を使用して、既定のグループを構成できます。
省略可能のパラメーター
レプリケートされたリージョンからこのギャラリー イメージ バージョンを削除できるかどうかを示します。
Location。 値のソース: az account list-locations az configure --defaults location=<location> を使用して、既定の場所を構成できます。
実行時間の長い操作の終了を待機しません。
スペース区切りのタグ: key[=value] [key[=value] ...]既存のタグをクリアするには、"" を使用します。
グローバル パラメーター
すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告は抑制します。
出力形式。
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。
サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。
ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --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必須のパラメーター
ギャラリー イメージの定義。
セマンティック バージョン パターンのギャラリー イメージ バージョン。 使用できる文字は数字とピリオドです。 数字は、32 ビット整数の範囲内である必要があります 。例: <MajorVersion>.<MinorVersion>.<Patch>
ギャラリー名。
リソース グループの名前。 az configure --defaults group=<name> を使用して、既定のグループを構成できます。
省略可能のパラメーター
パスとキー値のペアを指定して、オブジェクトの一覧にオブジェクトを追加します。 例: --add property.listProperty <key=value, string or JSON string>。
レプリケートされたリージョンからこのギャラリー イメージ バージョンを削除できるかどうかを示します。
'set' または 'add' を使用する場合は、JSON に変換するのではなく、文字列リテラルを保持します。
実行時間の長い操作の終了を待機しません。
リストからプロパティまたは要素を削除します。 例: --remove property.list <indexToRemove> OR --remove propertyToRemove.
リージョンごとに作成されるレプリカの既定の数。 リージョン レプリケーションの数を設定するには、--target-regions を使用します。
設定するプロパティ パスと値を指定して、オブジェクトを更新します。 例: --set property1.property2=<value>。
リージョン、エッジ ゾーン、レプリカ数、ストレージの種類のスペース区切りの一覧。 必要に応じて、各リージョンのレプリカ数やストレージ アカウントの種類を設定するには、=[=][=] を使用します。 レプリカ数が指定されていない場合は、既定のレプリカ数が使用されます。 ストレージ アカウントの種類が指定されていない場合は、既定のストレージ アカウントの種類が使用されます。 "--target-edge-zones None" が指定されている場合、ターゲットの拡張場所はクリアされます。
領域で区切られたリージョンとそのレプリカ数の一覧。 必要に応じて、リージョンごとにレプリカ数やストレージ アカウントの種類を設定するために使用 <region>[=<replica count>][=<storage account type>] します。 レプリカ数が指定されていない場合は、既定のレプリカ数が使用されます。 ストレージ アカウントの種類が指定されていない場合は、既定のストレージ アカウントの種類が使用されます。
グローバル パラメーター
すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告は抑制します。
出力形式。
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。
サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。
ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --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必須のパラメーター
ギャラリー イメージの定義。
セマンティック バージョン パターンのギャラリー イメージ バージョン。 使用できる文字は数字とピリオドです。 数字は、32 ビット整数の範囲内である必要があります 。例: <MajorVersion>.<MinorVersion>.<Patch>
ギャラリー名。
リソース グループの名前。 az configure --defaults group=<name> を使用して、既定のグループを構成できます。
省略可能のパラメーター
'provisioningState' が 'Succeeded' で作成されるまで待ちます。
条件がカスタム JMESPath クエリを満たすまで待ちます。 例: provisioningState!='InProgress'、instanceView.statuses[?code=='PowerState/running']。
削除されるまで待ちます。
リソースが存在するまで待ちます。
操作に適用する展開式。 'ReplicationStatus' 既定値は None です。
ポーリング間隔 (秒単位)。
最大待機時間 (秒単位)。
provisioningState が 'Succeeded' で更新されるまで待ちます。
グローバル パラメーター
すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告は抑制します。
出力形式。
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。
サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。
ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示