< Back

Get-GceImage

Mon Jan 13, 2020 11:11 pm

NAME Get-GceImage



SYNOPSIS

Gets information about Google Compute Engine disk images.





SYNTAX

Get-GceImage [-Name] <string> [[-Project] <string[]>] [<CommonParameters>]



Get-GceImage -Family <string> [[-Project] <string[]>] [<CommonParameters>]



Get-GceImage [[-Project] <string[]>] [-IncludeDeprecated <SwitchParameter>] [<CommonParameters>]





DESCRIPTION

Gets information about Google Compute Engine disk images. These images can be used to as the inital state of a

disk, whether created manually, as part of a new instance, or from an instance tempalte.





PARAMETERS

-Name <string>

The name of the image to get. e.g. "windows-server-2012-r2-dc-v20160623".



Required? true

Position? 0

Default value

Accept pipeline input? true (ByValue)

Accept wildcard characters? false



-Family <string>

The name of the image family to get the latest image of. e.g. "windows-2012-r2".



Required? true

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-Project <string[]>

The project that owns the image. This defaults to a standard set of public image projects.



Required? false

Position? 1

Default value System.String[]

Accept pipeline input? false

Accept wildcard characters? false



-IncludeDeprecated <SwitchParameter>

If set, deprecated images will be included.



Required? false

Position? named

Default value False

Accept pipeline input? false

Accept wildcard characters? false



<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug,

ErrorAction, ErrorVariable, WarningAction, WarningVariable,

OutBuffer, PipelineVariable, and OutVariable. For more information, see

about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).



INPUTS

System.String

The name of the image to get. e.g. "windows-server-2012-r2-dc-v20160623".





OUTPUTS

Google.Apis.Compute.v1.Data.Image





---------- EXAMPLE 1 ----------



PS C:\\> Get-GceImage



Lists all the standard up to date images.

---------- EXAMPLE 2 ----------



PS C:\\> Get-GceImage -Family "window-2012-r2"



Gets the latest windows 2012 r2 image from the windows-cloud project.

---------- EXAMPLE 3 ----------



PS C:\\> Get-GceImage "windows-server-2008-r2-dc-v20160719"



Gets the image named windows-server-2008-r2-dc-v20160719 from the windows-cloud project.

---------- EXAMPLE 4 ----------



PS C:\\> Get-GceImage "my-image" -Project "my-project"



Gets the custom image named "my-image" from the private project "my-project".

---------- EXAMPLE 5 ----------



PS C:\\> Get-GceImage -Project "my-project" -IncludeDeprecated



Lists all images in project "my-project", including images marked as deprecated.



RELATED LINKS

[Image resource definition] (https://cloud.google.com/compute/docs/r ... s#resource)

[Google Cloud Platform images] (https://cloud.google.com/compute/docs/images)