Get-AzVMImage
VMImage のすべてのバージョンを取得します。
構文
Get-AzVMImage
-Location <String>
[-EdgeZone <String>]
-PublisherName <String>
-Offer <String>
-Skus <String>
[-Top <Int32>]
[-OrderBy <String>]
[-Expand <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Get-AzVMImage
-Location <String>
[-EdgeZone <String>]
-PublisherName <String>
-Offer <String>
-Skus <String>
-Version <String>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] 説明
Get-AzVMImage コマンドレットは、VMImage のすべてのバージョンを取得します。
例
例 1: VM イメージ オブジェクトを一覧表示する
Get-AzVMImage -Location "Central US" -PublisherName "MicrosoftWindowsServer" -Offer "windowsserver" -Skus "2025-datacenter"
Version Location PublisherName HyperVGeneration Architecture ImageDeprecationStatus
------- -------- ------------- ---------------- ------------ ----------------------
26100.2033.241004 centralus MicrosoftWindowsServer
26100.2314.241107 centralus MicrosoftWindowsServer
26100.2605.241207 centralus MicrosoftWindowsServer
26100.2894.250113 centralus MicrosoftWindowsServer
26100.3194.250210 centralus MicrosoftWindowsServer
26100.3476.250306 centralus MicrosoftWindowsServer
26100.3775.250406 centralus MicrosoftWindowsServerこのコマンドは、指定した値に一致するすべてのバージョンの VMImage を取得します。
例 2: イメージ非推奨状態の VM イメージ オブジェクトを一覧表示する
Get-AzVMImage -Location "Central US" -PublisherName "MicrosoftWindowsServer" -Offer "windowsserver" -Skus "2025-datacenter" -Expand properties/imageDeprecationStatus
Version Location PublisherName HyperVGeneration Architecture ImageDeprecationStatus
------- -------- ------------- ---------------- ------------ ----------------------
26100.2033.241004 centralus MicrosoftWindowsServer V1 x64 Microsoft.Azure.Management.Compute.Mo…
26100.2314.241107 centralus MicrosoftWindowsServer V1 x64 Microsoft.Azure.Management.Compute.Mo…
26100.2605.241207 centralus MicrosoftWindowsServer V1 x64 Microsoft.Azure.Management.Compute.Mo…
26100.2894.250113 centralus MicrosoftWindowsServer V1 x64 Microsoft.Azure.Management.Compute.Mo…
26100.3194.250210 centralus MicrosoftWindowsServer V1 x64 Microsoft.Azure.Management.Compute.Mo…
26100.3476.250306 centralus MicrosoftWindowsServer V1 x64 Microsoft.Azure.Management.Compute.Mo…
26100.3775.250406 centralus MicrosoftWindowsServer V1 x64 Microsoft.Azure.Management.Compute.Mo…このコマンドは、指定された値とイメージの非推奨の状態と一致するすべてのバージョンの VMImage を取得します。
例 3: VMImage オブジェクトを取得する
Get-AzVMImage -Location "Central US" -PublisherName "MicrosoftWindowsServer" -Offer "windowsserver" -Skus "2025-datacenter" -Version 26100.2033.241004
Id : /Subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/Providers/Microsoft.Compute/Locations/cent
ralus/Publishers/MicrosoftWindowsServer/ArtifactTypes/VMImage/Offers/windowsserver/Skus/2025-d
atacenter/Versions/26100.2033.241004
Location : centralus
PublisherName : MicrosoftWindowsServer
Offer : windowsserver
Skus : 2025-datacenter
Version : 26100.2033.241004
FilterExpression :
Name : 26100.2033.241004
HyperVGeneration : V1
OSDiskImage : {
"operatingSystem": "Windows"
}
PurchasePlan : null
DataDiskImages : []
ImageDeprecationStatus : {
"imageState": "Active",
"scheduledDeprecationTime": null,
"alternativeOption": null
}このコマンドは、指定された値に一致する特定のバージョンの VMImage を取得します。
例 4: VMImage オブジェクトを取得する
Get-AzVMImage -Location "Central US" -PublisherName "MicrosoftWindowsServer" -Offer "windowsserver" -Skus "2025-datacenter" -Version 26100.2* -Expand properties
Version Location PublisherName HyperVGeneration Architecture ImageDeprecationStatus
------- -------- ------------- ---------------- ------------ ----------------------
26100.2033.241004 centralus MicrosoftWindowsServer V1 x64
26100.2314.241107 centralus MicrosoftWindowsServer V1 x64
26100.2605.241207 centralus MicrosoftWindowsServer V1 x64
26100.2894.250113 centralus MicrosoftWindowsServer V1 x64このコマンドは、指定した値に一致するすべてのバージョンの VMImage を、バージョンをフィルター処理して取得します。
パラメーター
-DefaultProfile
Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション。
| 型: | IAzureContextContainer |
| Aliases: | AzContext, AzureRmContext, AzureCredential |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-EdgeZone
EdgeZone の拡張場所名を設定します。 設定されていない場合、VM イメージは Azure メイン リージョンから照会されます。 それ以外の場合は、指定された拡張場所からクエリが実行されます
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-Expand
操作に適用する展開式。 使用可能な値は、'properties'、および 'properties/imageDeprecationStatus' です。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-Location
VMImage の場所を指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-Offer
VMImage オファーの種類を指定します。 イメージ オファーを取得するには、Get-AzVMImageOffer コマンドレットを使用します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-OrderBy
返される結果の順序を指定します。 OData クエリとして書式設定されます。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-PublisherName
VMImage の発行元を指定します。 イメージの発行元を取得するには、Get-AzVMImagePublisher コマンドレットを使用します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-Skus
VMImage SKU を指定します。 SKU を取得するには、Get-AzVMImageSku コマンドレットを使用します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-Top
返される仮想マシン イメージの最大数を指定します。
| 型: | Nullable<T>[Int32] |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-Version
VMImage のバージョンを指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | True |
