Reset-SCVirtualMachine

Resets a virtual machine by powering off the virtual machine and then starting it.

Description

The Reset-SCVirtualMachine cmdlet resets a virtual machine by powring off the virtual machine and then starting it. This is the equivalent of using the Stop-SCVirtualMachine and Start-SCVirtualMachine cmdlets. To use Reset-SCVirtualMachine, the virtual machine needs to be in a running state.

For information about stopping a virtual machine, type: "Get-Help Stop-SCVirtualMachine -detailed". For information about starting a virtual machine, type: "Get-Help Start-SCVirtualMachine -detailed".

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

Parameters

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. 

VM

Required? false
Accept Pipeline Input? false
Position? named
Specifies a virtual machine object.
Requires a VMM virtual machine object, which can be retrieved by using the Get-SCVirtualMachine cmdlet.

Examples

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

The second command resets the virtual machine stored in $VM.

See Also