SyntaxShutdown-VMGuest [[-VM] <VirtualMachine>] [[-Server] <VIServer>] [-WhatIf] [-Confirm] [<CommonParameters>]
Related CommandsOnline version
Detailed DescriptionIssues a command to the guest operating system asking it to prepare for a suspend operation. Returns immediately and does not wait for the guest operating system to complete the operation.
|Name||Description||Required?||Pipeline Input||Default Value|
|VM||Specify the virtual machines whose operating systems you want to shut down. The virtual machines must have VMware Tools installed.||false||true (ByValue)|
|Server||vSphere servers to search for virtual machine names. If not specified, the command will use the server currently specified in the $DefaultVIServer variable.||false||false|
|WhatIf||Indicate that the cmdlet is run only to display the changes that would be made and actually no objects are modified.||false||false|
|Confirm||If 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.||false||false||$true|
|Guest||Specify the virtual machine guests you want to shut down.||false||true (ByValue)|
-------------- Example 1 --------------
Get-VM VM | Shutdown-VMGuest
Shutdowns the guest OS of the virtual machine named VM.