Suspend-SCVirtualMachine

Suspends a virtual machine managed by VMM.

Description

The Suspend-SCVirtualMachine cmdlet suspends one or more virtual machines deployed on hosts managed by System Center Virtual Machine Manager (VMM). Suspending a virtual machine pauses activity on that virtual machine and returns its object in a paused state. 

To resume running a suspended virtual machine, use the Resume-SCVirtualMachine cmdlet.

For more information about Suspend-SCVirtualMachine, type: "Get-Help Suspend-SCVirtualMachine -online".

Parameters

VM

Required? true
Accept Pipeline Input? true (ByValue)
Position? 0
Specifies a virtual machine object.

JobVariable

Required? false
Accept Pipeline Input? false
Position? named
Specifies that job progress is tracked and stored in the variable named by this parameter. 

PROTipID

Required? false
Accept Pipeline Input? false
Position? named
Specifies the ID of the PRO tip that triggered this action. This allows for auditing of PRO tips.

RunAsynchronously

Required? false
Accept Pipeline Input? false
Position? named
Indicates that the job runs asynchronously so that control returns to the command shell immediately. 
Requires a virtual machine object, which can be retrieved by using the Get-SCVirtualMachine cmdlet.

Examples

1: Suspend a specified virtual machine.
PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> Suspend-SCVirtualMachine -VM $VM
The first command gets the virtual machine object named VM01 and stores the object in the $VM variable.

The second command pauses the virtual machine stored in $VM (in this case, VM01) and displays information about the paused object to the user. 

See Also