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

NameTypeDescriptionRequired?Pipeline InputDefault Value
VMVirtualMachine[]Specify the virtual machines whose guest operating systems you want to retrieve.truetrue (ByValue)
ServerVIServer[]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.falsefalse

Return Type

VMGuest

Notes

Examples

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

Get-VMGuest -VM VM

Retrieves the guest OS of the virtual machine named VM.


Copyright © 1998 - 2011 VMware, Inc. All rights reserved.