vSphere PowerCLI Reference

Restart-VMGuest

Synopsis

Restarts the virtual machine guest operating systems.

Syntax

Restart-VMGuest [[-VM] <VirtualMachine[]>] [[-Server] <VIServer[]>] [-WhatIf] [-Confirm] [<CommonParameters>]
Restart-VMGuest [[-Guest] <VMGuest[]>] [-WhatIf] [-Confirm] [<CommonParameters>]

Related Commands

Online version
Get-VMGuest
Shutdown-VMGuest
Suspend-VMGuest

Detailed Description

Restarts the virtual machine guest operating systems.

Parameters

NameTypeDescriptionRequired?Pipeline InputDefault Value
GuestVMGuest[]Specify the virtual machine guest operating systems you want to restart.falsetrue (ByValue)
VMVirtualMachine[]Specify the virtual machines whose operating systems you want to restart. The specified virtual machines must have VMware Tools installed.falsetrue (ByValue)
ServerVIServer[]One or more vSphere servers to search for virtual machines. If not specified, the command will use the server currently specified in the $DefaultVIServer variable.falsefalse
ConfirmSwitchParameterIf the value is $true, indicates that the cmdlet asks for confirmation before running. If the value is $false, the cmdlet runs without asking for user confirmation.falsefalse$true
WhatIfSwitchParameterIndicate that the cmdlet is run only to display the changes that would be made and actually no objects are modified.falsefalse

Return Type

VMGuest

Notes

Examples

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

Get-VM VM | Restart-VMGuest

Restarts the guest OS of the virtual machine named VM.


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