Get-AzVMImage

Referentie

Module:: Az.Compute

Hiermee haalt u alle versies van een VMImage op.

Notitie

Dit is de vorige versie van onze documentatie. Raadpleeg de meest recente versie voor actuele informatie.

Syntax

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

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

Description

De cmdlet Get-AzVMImage haalt alle versies van een VMImage op.

Voorbeelden

Voorbeeld 1: VMImage-objecten ophalen

Get-AzVMImage -Location "Central US" -PublisherName "MicrosoftWindowsServer" -Offer "windowsserver" -Skus "2012-R2-Datacenter"

Version        Skus               Offer         PublisherName          Location  Id
-------        ----               -----         -------------          --------  --
4.127.20180315 2012-R2-Datacenter windowsserver MicrosoftWindowsServer centralus /Subscriptions/9e2...
4.127.20180510 2012-R2-Datacenter windowsserver MicrosoftWindowsServer centralus /Subscriptions/9e2...
4.127.20180815 2012-R2-Datacenter windowsserver MicrosoftWindowsServer centralus /Subscriptions/9e2...
4.127.20180912 2012-R2-Datacenter windowsserver MicrosoftWindowsServer centralus /Subscriptions/9e2...
4.127.20181010 2012-R2-Datacenter windowsserver MicrosoftWindowsServer centralus /Subscriptions/9e2...
4.127.20181125 2012-R2-Datacenter windowsserver MicrosoftWindowsServer centralus /Subscriptions/9e2...
4.127.20190104 2012-R2-Datacenter windowsserver MicrosoftWindowsServer centralus /Subscriptions/9e2...
4.127.20190115 2012-R2-Datacenter windowsserver MicrosoftWindowsServer centralus /Subscriptions/9e2...
4.127.20190204 2012-R2-Datacenter windowsserver MicrosoftWindowsServer centralus /Subscriptions/9e2...
4.127.20190218 2012-R2-Datacenter windowsserver MicrosoftWindowsServer centralus /Subscriptions/9e2...

Met deze opdracht worden alle versies van VMImage opgehaald die overeenkomen met de opgegeven waarden.

Voorbeeld 2: VMImage-object ophalen

Get-AzVMImage -Location "Central US" -PublisherName "MicrosoftWindowsServer" -Offer "windowsserver" -Skus "2012-R2-Datacenter" -Version 4.127.20180315

Id               : /Subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/Providers/Microsoft.Compute/Locations/centralus/
                   Publishers/MicrosoftWindowsServer/ArtifactTypes/VMImage/Offers/windowsserver/Skus/2012-R2-Datacenter
                   /Versions/4.127.20180315
Location         : centralus
PublisherName    : MicrosoftWindowsServer
Offer            : windowsserver
Skus             : 2012-R2-Datacenter
Version          : 4.127.20180315
Name             : 4.127.20180315
OSDiskImage      : {
                     "operatingSystem": "Windows"
                   }
PurchasePlan     : null
DataDiskImages   : []

Met deze opdracht wordt een specifieke versie van VMImage opgehaald die overeenkomt met de opgegeven waarden.

Voorbeeld 3: VMImage-objecten ophalen

Get-AzVMImage -Location "Central US" -PublisherName "MicrosoftWindowsServer" -Offer "windowsserver" -Skus "2012-R2-Datacenter" -Version 4.127.2018*

Version        Skus               Offer         PublisherName          Location  Id
-------        ----               -----         -------------          --------  --
4.127.20180315 2012-R2-Datacenter windowsserver MicrosoftWindowsServer centralus /Subscriptions/9e2...
4.127.20180510 2012-R2-Datacenter windowsserver MicrosoftWindowsServer centralus /Subscriptions/9e2...
4.127.20180815 2012-R2-Datacenter windowsserver MicrosoftWindowsServer centralus /Subscriptions/9e2...
4.127.20180912 2012-R2-Datacenter windowsserver MicrosoftWindowsServer centralus /Subscriptions/9e2...
4.127.20181010 2012-R2-Datacenter windowsserver MicrosoftWindowsServer centralus /Subscriptions/9e2...
4.127.20181125 2012-R2-Datacenter windowsserver MicrosoftWindowsServer centralus /Subscriptions/9e2...

Met deze opdracht worden alle versies van VMImage opgehaald die overeenkomen met de opgegeven waarden met filteren op versie.

Parameters

-DefaultProfile

De referenties, accounts, tenants en abonnementen die worden gebruikt voor communicatie met Azure.

Type:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-EdgeZone

Stel de naam van de uitgebreide locatie in voor EdgeZone. Als deze niet is ingesteld, wordt de VM-installatiekopieën opgevraagd vanuit de hoofdregio van Azure. Anders wordt er een query uitgevoerd vanaf de opgegeven uitgebreide locatie

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-Location

Hiermee geeft u de locatie van een VMImage.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-Offer

Hiermee geeft u het type VMImage-aanbieding op. Gebruik de cmdlet Get-AzVMImageOffer om een installatiekopieënaanbieding te verkrijgen.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-OrderBy

Hiermee geeft u de volgorde op van de geretourneerde resultaten. Opgemaakt als een OData-query.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-PublisherName

Hiermee geeft u de uitgever van een VMImage. Gebruik de cmdlet Get-AzVMImagePublisher om een uitgever van een installatiekopieën op te halen.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-Skus

Hiermee geeft u een VMImage-SKU op. Gebruik de Get-AzVMImageSku-cmdlet om een SKU te verkrijgen.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-Top

Hiermee geeft u het maximum aantal geretourneerde installatiekopieën van virtuele machines op.

Type:	Nullable<T>[Int32]
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-Version

Hiermee geeft u de versie van de VMImage.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	True

Invoerwaarden

String

Uitvoerwaarden

PSVirtualMachineImage

PSVirtualMachineImageDetail