Start-SCVirtualMachine

Starts a virtual machine managed by VMM.

Description

The Start-SCVirtualMachine cmdlet starts one or more virtual machines on hosts managed by System Center Virtual Machine Manager (VMM) when the machines are in a stopped state. Starting a stopped virtual machine restores it to a running state and returns its object in a running state. When the virtual machine is running again, you can resume activity on that virtual machine. 

If you run Start-SCVirtualMachine on a virtual machine that is already running, the cmdlet returns the object but does not change the state of the virtual machine.

To stop a running virtual machine, use the Stop-SCVirtualMachine cmdlet.

For more information about Start-SCVirtualMachine, type: "Get-Help Start-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: Start a virtual machine that is turned off. 
PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> Start-SCVirtualMachine -VM $VM

The first command gets the virtual machine object named VM01 and stores the object in the $VM variable.

The second command starts the virtual machine stored in $VM, and displays information about the running virtual machine object to the user.
2: Start all virtual machines that are turned off. 
PS C:\> $VMs = Get-SCVirtualMachine -VMMServer "VMMServer01.Contoso.com" | where { $_.Status -eq "PowerOff" }
PS C:\> $VMs | Start-SCVirtualMachine

The first command gets all virtual machine objects on VMMServer01 that are in a stopped state, and stores the objects in the $VMs object array. 

The second command passes each virtual machine object stored in $VMs to the Start-SCVirtualMachine cmdlet, which starts each virtual machine in the array.

See Also