Get-AzVMImage

VMImage'ın tüm sürümlerini alır.

Syntax

ListVMImage

Get-AzVMImage
    -Location <String>
    -PublisherName <String>
    -Offer <String>
    -Skus <String>
    [-EdgeZone <String>]
    [-Top <Int32>]
    [-OrderBy <String>]
    [-Expand <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

GetVMImageDetail

Get-AzVMImage
    -Location <String>
    -PublisherName <String>
    -Offer <String>
    -Skus <String>
    -Version <String>
    [-EdgeZone <String>]
    [-Expand <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

Description

Get-AzVMImage cmdlet'i bir VMImage'ın tüm sürümlerini alır.

Örnekler

Örnek 1: VM Görüntüsü nesnelerini listeleme

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

Bu komut, belirtilen değerlerle eşleşen tüm VMImage sürümlerini alır.

Örnek 2: Görüntü Kullanımdan Kaldırma Durumu ile VM Görüntüsü nesnelerini listeleme

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…

Bu komut, görüntü kullanımdan kaldırma durumlarıyla belirtilen değerlerle eşleşen tüm VMImage sürümlerini alır.

Örnek 3: VMImage nesnesini alma

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
                         }

Bu komut, belirtilen değerlerle eşleşen belirli bir VMImage sürümünü alır.

Örnek 4: VMImage nesnelerini alma

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

Bu komut, sürüm üzerinde filtreleme ile belirtilen değerlerle eşleşen tüm VMImage sürümlerini alır.

Parametreler

-DefaultProfile

Azure ile iletişim için kullanılan kimlik bilgileri, hesap, kiracı ve abonelik.

Parametre özellikleri

Tür:IAzureContextContainer
Default value:None
Joker karakterleri destekler:False
DontShow:False
Diğer adlar:AzContext, AzureRmContext, AzureCredential

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-EdgeZone

EdgeZone için genişletilmiş konum adını ayarlayın. Ayarlanmadıysa, VM Görüntüsü Azure ana bölgeden sorgulanır. Aksi takdirde belirtilen genişletilmiş konumdan sorgulanır

Parametre özellikleri

Tür:String
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:True
Kalan bağımsız değişkenlerden elde edilen değer:False

-Expand

İşleme uygulanacak genişletme ifadesi. Olası değerler şunlardır: 'properties', and 'properties/imageDeprecationStatus'

Parametre özellikleri

Tür:String
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:True
Kalan bağımsız değişkenlerden elde edilen değer:False

-Location

VMImage'ın konumunu belirtir.

Parametre özellikleri

Tür:String
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:Named
Zorunlu:True
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:True
Kalan bağımsız değişkenlerden elde edilen değer:False

-Offer

VMImage teklifinin türünü belirtir. Görüntü teklifi almak için Get-AzVMImageOffer cmdlet'ini kullanın.

Parametre özellikleri

Tür:String
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:Named
Zorunlu:True
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:True
Kalan bağımsız değişkenlerden elde edilen değer:False

-OrderBy

Döndürülen sonuçların sırasını belirtir. OData sorgusu olarak biçimlendirildi.

Parametre özellikleri

Tür:String
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

ListVMImage
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:True
Kalan bağımsız değişkenlerden elde edilen değer:False

-PublisherName

VMImage'ın yayımcısını belirtir. Görüntü yayımcısı edinmek için Get-AzVMImagePublisher cmdlet'ini kullanın.

Parametre özellikleri

Tür:String
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:Named
Zorunlu:True
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:True
Kalan bağımsız değişkenlerden elde edilen değer:False

-Skus

VMImage SKU'su belirtir. SKU almak için Get-AzVMImageSku cmdlet'ini kullanın.

Parametre özellikleri

Tür:String
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:Named
Zorunlu:True
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:True
Kalan bağımsız değişkenlerden elde edilen değer:False

-Top

Döndürülen en fazla sanal makine görüntüsü sayısını belirtir.

Parametre özellikleri

Tür:

Nullable<T>[Int32]

Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

ListVMImage
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:True
Kalan bağımsız değişkenlerden elde edilen değer:False

-Version

VMImage sürümünü belirtir.

Parametre özellikleri

Tür:String
Default value:None
Joker karakterleri destekler:True
DontShow:False

Parametre kümeleri

GetVMImageDetail
Position:Named
Zorunlu:True
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:True
Kalan bağımsız değişkenlerden elde edilen değer:False

CommonParameters

Bu cmdlet yaygın parametreleri destekler: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction ve -WarningVariable. Daha fazla bilgi için bkz. about_CommonParameters.

Girişler

String

Çıkışlar

PSVirtualMachineImage

PSVirtualMachineImageDetail