Get-AzureVMImage

Get-AzureVMImage

Gets all the versions of a VMImage.

Syntax

Parameter Set: GetVMImageDetail
Get-AzureVMImage -Location <System.String> -Offer <System.String> -PublisherName <System.String> -Skus <System.String> -Version <System.String> [-Profile <Microsoft.Azure.Common.Authentication.Models.AzureProfile> ] [ <CommonParameters>]

Parameter Set: ListVMImage
Get-AzureVMImage -Location <System.String> -Offer <System.String> -PublisherName <System.String> -Skus <System.String> [-FilterExpression <System.String> ] [-Profile <Microsoft.Azure.Common.Authentication.Models.AzureProfile> ] [ <CommonParameters>]

Detailed Description

The Get-AzureVMImage cmdlet gets all the versions of a VMImage.

Parameters

-FilterExpression<System.String>

Specifies a filter expression.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Location<System.String>

Specifies the location of a VMImage.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

true(ByPropertyName)

Accept Wildcard Characters?

false

-Offer<System.String>

Specifies the type of VMImage offer. To obtain an image offer, use the Get-AzureVMImageOffer cmdlet.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

true(ByPropertyName)

Accept Wildcard Characters?

false

-Profile<Microsoft.Azure.Common.Authentication.Models.AzureProfile>

Specifies the Azure profile from which this cmdlet reads. If you do not specify a profile, this cmdlet reads from the local default profile.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-PublisherName<System.String>

Specifies the publisher of a VMImage. To obtain an image publisher, use the Get-AzureVMImagePublisher cmdlet.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

true(ByPropertyName)

Accept Wildcard Characters?

false

-Skus<System.String>

Specifies a VMImage SKU. To obtain an SKU, use the Get-AzureVMImageSku cmdlet.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

true(ByPropertyName)

Accept Wildcard Characters?

false

-Version<System.String>

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

true(ByPropertyName)

Accept Wildcard Characters?

false

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see    about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

Outputs

The output type is the type of the objects that the cmdlet emits.

Examples

Example 1: Get VMImage objects

This command gets all the versions of VMImage that match the specified values.

PS C:\> Get-AzureVMImage -Location "Central US" -PublisherName "Canonical" -Offer "UbuntuServer" -Skus "15.04-DAILY"

Get-AzureVMImageOffer

Get-AzureVMImagePublisher

Get-AzureVMImageSku

Save-AzureVMImage