vSphere PowerCLI Reference

Get-VMGuest

Synopsis

Retrieves the guest operating systems of the specified virtual machines.

Syntax

Get-VMGuest [-VM] <VirtualMachine[]> [-Server <VIServer[]>] [<CommonParameters>]

Related Commands

Online version
Suspend-VMGuest
Shutdown-VMGuest
Restart-VMGuest

Detailed Description

Retrieves the guest operating systems of the specified virtual machines. To specify a server different from the default one, use the -Server parameter. When Get-VMGuest is run against a virtual machine that is just starting, the properties of the returned VMGuest object are not filled at one time.

Parameters

Name	Type	Description	Required?	Pipeline Input	Default Value
VM	VirtualMachine[]	Specify the virtual machines whose guest operating systems you want to retrieve.	true	true (ByValue)
Server	VIServer[]	Specify the vSphere servers on which you want to run the cmdlet. If no value is given to this parameter, the command runs on the default servers. For more information about default servers, see the description of Connect-VIServer.	false	false

Return Type

VMGuest

Notes

Examples

-------------- Example 1 --------------

Get-VMGuest -VM VM

Retrieves the guest OS of the virtual machine named VM.